3.2 PHP注释的应用

3.2 PHP注释的应用

视频讲解：光盘TMlx302 PHP注释的应用．mp4

注释即代码的解释和说明，一般放在代码的上方或代码的尾部（放尾部时，代码和注释之间以Tab键进行分隔，以方便程序阅读），用来说明代码或函数的编写人、用途、时间等。注释不会影响到程序的执行，因为在执行时，注释部分会被解释器忽略不计。

PHP支持3种风格的程序注释。

单行注释（//）

这是一种来源于C++语言语法的注释模式，可以写在PHP语句的上方，也可以写在后方。

<?php //这是写在PHP语句上方的单行注释 echo ’使用C++风格的注释’; ?> <?php echo’使用C++风格的注释’; //这是写在PHP语句后面的单行注释 ?>

多行注释（/*…*/）

这是一种来源于C语言语法的注释模式，可以分为块注释和文档注释。

块注释：

<?php /＊ $a = 1; $b = 2; echo ($a + $b); ＊/ echo 'PHP的多行注释’; ?>

文档注释：

<?php /＊ 说明：项目工具类 ＊ 作者：小辛 ＊ E-mail:[email protected] ＊/ class Util { /＊＊ ＊ 方法说明：给字符串加前缀 ＊ 参数：String$str ＊ 返回值：String ＊/ function addPrefix ($str) { $str.= 'mingri'; return $str; } } ?>

注意

多行注释是不允许进行嵌套操作的。

#风格的注释（#）

<?php echo’这是#风格的注释’; #这是#风格的单行注释 ?>

注意

在单行注释中的内容不要出现“?>”标志，因为解释器会认为PHP脚本结束，而不去执行“?>”后面的代码。例如：

<?php echo’这样会出错的！! ! ! ! ' //不会看到?>会看到 ?>

结果为：这样会出错的！! ! ! ！会看到?>