PHP编程：第4版

词法结构

｜

17

$greed

) ;

或用更少的空白符 ：

raisePrices($inventory,$inflation,$costOfLiving,$greed);

可以利用这种灵活的格式使代码更易读（将赋值语句排成一列、缩进等）。一些懒惰的

程序员滥用这种自由形式，写出的代码根本不可读——这是不推荐的。

注释

注释可以给阅读代码的人提供信息，但

PHP

在执行时会忽略这些。即使你认为你是唯

一一个会阅读自己代码的人，在代码中加注释也是一个好做法——当你回顾几个月前写

的代码时，其看起来很可能像是一个陌生人写的。

好的做法是让你的注释尽可能少，但又足以说明发生了什么。不要注释显而易见的事情，

免得掩盖了真正需要的注释。例如，下面这个注释是没有意义的 ：

$x = 17; //

将

17

存储到变量

$x

中

而对这个复杂的正则表达式的注释将有助于别人维护你的代码 ：

//

将实体

&#nnn;

转换成字符

$text = preg_replace('/&#([0-9])+;/', "chr('\\1')", $text);

PHP

提供了多种在代码中加注释的方式，这些方式都借鉴自现有的语言（如

C

、

C++

和

UNIX shell

）。一般情况下，为代码添加

C

风格或者

C++

风格的注释。

shell

风格的注释

当

PHP

在代码中遇到哈希标记字符（＃）时，从哈希标记开始到本行结束或

PHP

代码

段结束（二者取其先）的这一部分都被认为是注释。这种注释方法可以在

UNIX shell

脚

本语言中找到，而且可用于注释单行代码或进行简短说明。 ...