首页 > 编程笔记 > PHP笔记 阅读:3

PHP注释(单行注释和多行注释)

注释能够被插入代码,对指定的代码进行解释,方便对代码进行阅读和维护。它的作用不可低估。

PHP 程序注释有两种类型,一种是单行注释,另一种是多行注释。

PHP单行注释

在一行代码中,所有“//”符号右侧的文本都被视为注释,因为 PHP 解析器会忽略该代码行“//”右侧的所有内容。

【实例 1】将注释和代码放在同一行,对输出语句进行注释。
<?php
echo "helloword"; //输出语句
?>

【实例 2】将注释和代码放在不同行,对输出语句进行注释。
<?php
//输出语句
echo "helloword";
?>

【实例 3】直接将代码注释掉。
<?php
//echo "helloword";
?>

PHP多行注释

多行注释不同于单行注释,它需要有注释的开始符号与注释的结束符号,开始符号为“/*”,结束符号为“*/”。

【实例 4】多行注释代码。
<?php
/*
*函数功能
*@param $param1, int参数含义
*@param $param2, string参数含义
*@return boolean参数含义
*/
function func1($param1, $param2){
//将代码放在此处……
return 'somthing';
}
?>

HTML注释

由于多行注释是针对 PHP 语句的注释,该注释对 HTML 标记和 PHP 标记无效,只能够在 PHP 语句的开始标记和结束标记之前使用。若需要注释整个 PHP 语句块,将无法得到用户满意的执行效果。

【实例 5】多行注释代码。
<html>
<body>
/*
<?php
echo "我会被显示出来吗";
?>
*/
</body>
</html>
运行结果如下图所示:


图 1 多行注释运行结果

【实例 6】多行注释代码。
<html>
<body>
<!--
<?php
echo "我会被显示出来吗";
?>
-->
</body>
</html>
运行上述 PHP 代码,在浏览器中不会显示任何内容。

总结,如果需要注释掉整个 PHP 语句块,则需要通过 HTML 注释来实现对 PHP 标记的彻底注释。HTML 注释的开始符号为“<!--”,结束符号为“-->”。

在服务器上运行 PHP 文件时,系统会去寻找“<?php”(开始符号)与“?>”结束符号,其中的代码会被系统执行,然后返回一个HTML文件。此时的 HTML 代码是没有被处理过的,只有“<?php”与“?>”之间的代码才会被处理,所以 PHP 执行了,然后返回了 html<!-- /* 执行 PHP 产生的 html*/ -->,在源代码中能看到,浏览器解析时会忽略注释。

相关文章