保持冷静,使用变量没什么不好,你应该经常使用它们.它们通常会使您的代码更具描述性,甚至更快.

这里的描述部分就是更具描述性的部分,如果你查看那一行,你会看到哪个参数是因为它现在有一个名字.

but shouldn’t we use PHPDoc blocks instead?

嗯,实际上这与(docblock)评论无关.即使在函数定义中,也没有对该参数的注释：

function getContent($isAdmin = true) {

它只是通过它的名称来定义参数. docblock参数也只有在您定义函数时：

...
 * @param $isAdmin bool (optional) true or false,true by default
...
function getContent($isAdmin = true) {

但是,这不是函数调用的地方：

$content = getContent($isAdmin = false)

因此,如果您查看该行(并且在按任何热键或鼠标按钮之前),您已经阅读过该行.没有什么需要,只有代码.即使在记事本或未配置的gedit中也能正常工作.

$nonAdmin = false;
$content = getContent($nonAdmin);

顺便说一句,如果您的代码需要注释,这通常表明它太复杂了.参数的名称也比它的docblock重要得多.一个好名字通常意味着你不需要有一个docblock标签(这意味着：维护的代码更少),因为这个名字不言而喻.

现代IDE也通过静态分析了解参数的类型,因此您也不需要docblock标记.所以不,你不应该总是使用PHPDocblocks.