1.3.4 注释
对于阅读代码的人来说,注释其实就相当于代码的解释和说明。注释可以用来解释脚本的用途、脚本编写人、为什么要按如此的方法编写代码、上一次修改的时间等。
通常,读者将在所有脚本中发现注释,最简单的PHP脚本除外。
PHP解释器将忽略注释中的任何文本。事实上,PHP分析器将跳过等同于空格字符的注释。
PHP支持C、C++和Shell脚本风格的注释。
如下所示的是一个C风格的注释,多行注释可以出现在PHP脚本的开始处:
/*Author:Bob Smith
Last modified:April 10
This script processes the customer orders.
*/
多行注释应该以/为开始,/为结束。与C语言中相同,多行注释是无法嵌套的。
你也可以使用C++风格的单行注释:
echo'<p>Order processed.</p>';//Start printing order
或者Shell脚本风格:
echo'<p>Order processed.</p>';#Start printing order
无论何种风格的注释,在注释符号(#或//)之后行结束之前,或PHP结束标记之前的所有内容都是注释。
在如下所示的代码行中,关闭标记之前的文本,"here is a comment"是注释的一部分。而关闭标记之后文本,"here is not"将被当作是HTML,因为它位于关闭标记之外。
//here is a comment?>here is not