zoukankan      html  css  js  c++  java
  • 码农雷林鹏:PHP注释

      注释(Comments)是指在程序编写过程中,对程序文件或者代码片段额外添加的一个备注说明。通过注释可以提高代码可读性,让自己或其他开发人员更快速地理解程序的。

      注释在程序编程中非常重要,恰当的注释程序不仅是程序员的个人习惯,更是责任的体现。但在实际过程中,大部分程序员都没有良好的对程序进行注释习惯,这往往会在日后对自己或他人造成相当大的麻烦。

      PHP 注释不属于 PHP 程序的一部分,其内容也不参与程序中的任何功能计算,在编辑器中以特殊颜色(如绿色)显示。

      PHP 注释符号

      PHP 支持 C++,C 和 Unix Shell 风格(Perl 风格)的注释,所以也产生了 3 种PHP注释符号:

      C++ 风格:// 这是 C+ 风格的注释

      C 风格:/* 这是 C 风格的注释 */

      Unix Shell 风格:# 这是 Unix Shell 风格的注释

      一般大家都习惯使用 C 风格与 C++ 风格的注释。

      PHP 注释格式

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

      1.PHP 单行注释

      以上三种符号都可用于单行注释,只是使用 // 或 # 注释符时,注释符号后面的文本(本行内)都被视作注释内容,而 /* */ 风格注释符必须以 */ 结尾。

      例子:

      

      // 这是单行注释

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

      /* 这个注释风格也不错 */

      # 较少用的风格

      ?>

      上面的行尾注释,通常只是对本行前面的内容进行注释,单写一行的注释可能是对下面的一行或多行代码进行注释,也可能是为了程序的整体美观。

      2.PHP 多行注释

      多行注释一般使用 C 风格注释符,以 /* 开头,*/ 结尾来包含多行注释内容:

      

      echo "你好!";

      /*

      这是多行大块注释

      这里面都是注释内容

      更多注释内容等

      */

      ?>

      注意:不要嵌套使用 C 风格注释符,因为在碰到第一个 */ 时系统即认为该段注释结束,在注释掉一大块代码时很容易出现该错误。如下述用法将产生 PHP 语法错误:

      

      echo '你好!';

      /*

      这是多行大块注释

      echo '输出另一些内容'; /* 添加的本行注释 */

      */

      ?>

      也可以多次使用 // 符号来注释多行代码,但一般只限于有限的几行:

      

      // 分页显示定制

      // upPage:上一页

      // downPage:下一页

      protected $config = array(

      'header' => '条记录',

      'prev' => '上一页',

      'next' => '下一页',

      }

      ?>

      提示:PHP 注释中不能包含 PHP 代码结束符即:?>,因为在任何地方,PHP 检测到该结束符,即认为该段 PHP 代码结束而跳出 PHP 的执行。(编辑:雷林鹏 来源:网络|侵删)

  • 相关阅读:
    windows phone中三种解析XML的方法
    windows phone因为墓碑化导致“正在恢复”的分析
    windows phone之获取当前连接WIFI的SSID
    在wp中,使用NavigationService.Navigate导航页面出现错误
    数据结构之单链表,c#实现
    数据结构之顺序表,c#实现
    优化C#程序的48种方法
    一次js代码修改不更新问题的解决
    Java与Unicode
    JAVA中线程同步的方法
  • 原文地址:https://www.cnblogs.com/pengpeng1208/p/13885137.html
Copyright © 2011-2022 走看看