PHP注释:单行注释与多行注释的关系

注释通常在 PHP 代码块中编写的,它是一个不可执行的部分,不会显示在输出结果中,在程序运行过程中会被解释器直接忽略。



规范的注释可以让我们的源代码更易于理解,同时也可以帮助我们理解别人或者自己以前编写的代码。那么如何进行代码注释呢?本节就来给大家介绍一下在 PHP 中进行注释的几种方式。



在 PHP 中有两种类型的注释,分别是单行注释和多行注释。

1. 单行注释

每行必须单独使用注释标记,称为单行注释。它用于进行简短说明。声明单行注释有两种方式,分别是使用“#”和反斜杠“//”。



示例代码如下:


  1. <?php
  2. #这是第一行注释
  3. echo "C语言中文网<br>";
  4. //这是第二行注释
  5. echo "http://c.biancheng.net/php/";
  6. // echo "PHP 注释";
  7. ?>

上面的代码中示例中,第二行使用“#”定义了一条注释,并分别在第四行和第六行使用“//”定义了一条注释。 运行结果如下:

C语言中文网 http://c.biancheng.net/php/

提示:单行注释中使用最广泛是使用双斜杠“//”来定义注释。

2. 多行注释

多行注释用于注释多行内容,经常用于多行文本的注释。注释的内容需要包含在(/* 和 */)中,以“/*”开头,以“*/”结尾。

提示:多行注释不能相互嵌套使用。

示例代码如下:


  1. <?php
  2. /*
  3. 这是一个多行注释
  4. 输出网站名称及链接地址
  5. */
  6. echo "C语言中文网<br>";
  7. echo "http://c.biancheng.net/php/";
  8. /* echo "PHP 注释"; */
  9. ?>

运行结果如下:

C语言中文网 http://c.biancheng.net/php/

多行注释经常被开发人员用来介绍某个函数或方法的功能以及参数。另外需要注意的是,多行注释是由“/*”和“*/”两个标记构成的,忽略任何一个都不行。

3. 如何有效使用注释

注释是程序开发过程中的一个重要环节,主要用来解释程序的用途、版权说明、版本号、生成日期、作者、内容等,有助于对程序的阅读理解。

【声明】:芜湖站长网内容转载自互联网,其相关言论仅代表作者个人观点绝非权威,不代表本站立场。如您发现内容存在版权问题,请提交相关链接至邮箱:bqsm@foxmail.com,我们将及时予以处理。

相关文章