PHP注释的应用


注释即代码的解释和说明,一般放在代码的上方或代码的尾部,用来说明代码或函数的编写人、用途、时间等。注释不会影响到程序的执行,因为在执行时,注释部分会被解释器忽略不计。

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

单行注释(//)

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

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

也可以写在PHP语句的后方。

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

多行注释 (/.../)

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

块注释:

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

文档注释:

<?php
/*说明:项目工具类
 *作者:CloudDream
 *E-mail:[email protected]
 */
class Util
{
    /*方式说明:给字符串加前缀
     *参数:String $str
     *返回值:String
     */
    function addPrefix ($str)
    {
        $str.='CloudDream';
        return $str;
    }
}
?>
注意:多行注释是不允许进行嵌套操作的。

井号的风格注释(#)

<?php
    echo '这里是#号风格的注释';
?>
注意:在单行注释中的内容不要出现“?>”标志,因为解释器会认为 PHP 脚本结束,而不去执行“>”后面的代码。

例如:

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

运行结果为:

这样会出错的!!!!!!           //不会看到?>

声明:云梦博客|版权所有,违者必究|如未注明,均为原创|本网站采用BY-NC-SA协议进行授权

转载:转载请注明原文链接 - PHP注释的应用


绳锯木断,水滴石穿。