NuSphere PhpED是我编写PHP时最喜欢用的一个IDE,但PhpED安装后,在默认设置下,对于函数或方法的注释并不十分规范,会出现下面这种注释的书写方法:
<?php /** * This is Test! * * @param string $a */ function test($a) { if($a == '') { $a = 'test'; } return $a; } ?>
注意到了吗?注释部分从第2行开始到结束,缩进的位置都是与第1行一样的,这是PhpED在默认设置下,当输入/**并按回车后,自动完成注释剩余部分,但没有处理好缩进,当然这并不是什么错误。但对于完美主义者来说,一段完美的注释应该是下面这个样子的: