我觉得你被这么多“浪费”深深震撼.
保持冷静,使用变量没什么不好,你应该经常使用它们.它们通常会使您的代码更具描述性,甚至更快.
这里的描述部分就是更具描述性的部分,如果你查看那一行,你会看到哪个参数是因为它现在有一个名字.
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.