3.2　注释

无论是为你自己着想，还是为以后负责维护代码的程序员考虑，都需要对代码添加充分的注释，其重要性再强调都不为过。PHP提供了几种注释语法，将在这一节分别介绍。

3.2.1　单行C++语法

注释通常不会超过一行。因为这种注释很简短，所以没必要界定注释的结束，换行符（\n）完全可以满足此需要。PHP支持C++的单行注释语法，以双斜线（//）开头，如下：

3.2.2　Shell语法

PHP还支持另一种C++风格的单行语法，称为shell语法，它以#符号开头。可以将前面的例子重写如下：

3.2.3　多行C语法

代码中通常需要有一些详细的功能描述或其他解释内容，这些说明可能包括多行。虽然可以在每一行前面都加上C++或shell风格的定界符，不过，PHP还支持一种多行形式，同时标注注释的开始和结束。考虑下面的多行注释：

多行注释语法对于根据代码生成文档尤其有用，因为这样可以很明确地区分出各个注释，如果使用单行语法很难做到如此方便。