background image

PHP 注释符号与注释格式

PHP 注释

注释(Comments)是指在程序编写过程中,对程序文件或者代码片段额外添加的一个备
注说明。通过注释可以提高代码可读性,让自己或其他开发人员更快速地理解程序的。
注释在程序编程中非常重要,恰当的注释程序不仅是程序员的个人习惯,更是责任的体
现。但在实际过程中,大部分程序员都没有良好的对程序进行注释习惯,这往往会在日后
对自己或他人造成相当大的麻烦。
PHP 

 

注释不属于 PHP 程序的一部分,其内容也不参与程序中的任何功能计算,在编辑器

中以特殊颜色(如绿色)显示。

PHP 注释符号

PHP 

 

支持 C++,C   

和 Unix Shell 风格(Perl 

 

风格)的注释,所以也产生了 3 种 PHP 注释

符号:

C++ 风格:// 

 

这是 C+ 风格的注释

C 风格:/* 

 

这是 C 

 

风格的注释 */

Unix Shell 风格:# 

 

这是 Unix Shell 风格的注释

 

一般大家都习惯使用 C 

 

风格与 C++ 风格的注释。在一些系统配置文档中,如前面

PHP

 

     开

   

发环境安装

§章节的

Apache 

 

 安装与配置

 

 

§》一文中,httpd.conf 

 

配置文件使用的就是 # 注释

符号。

PHP 注释格式

PHP 注释格式分为单行注释与多行注释。

PHP 单行注释

 

以上三种符号都可用于单行注释,只是使用 //   

或 # 注释符时,注释符号后面的文本(本

 

行内)都被视作注释内容,而 /* */ 

 

风格注释符必须以 */ 结尾。

例子:

<?php

// 这是单行注释

echo '你好!'; // 这是单行注释,写在一行代码后面也叫行尾注释

/* 

 

这个注释风格也不错 */

# 较少用的风格

?>

上面的行尾注释,通常只是对本行前面的内容进行注释,单写一行的注释可能是对下面