PHP 7从入门到精通（视频教学版）
上QQ阅读APP看书，第一时间看更新
上一章目录下一章

3.2 编码规范

由于现在的Web开发往往是多人一起合作完成的，因此使用相同的编码规范显得非常重要，特别是新的开发人员参与时，通常需要知道前面开发代码中变量或函数的作用等，这就需要统一的编码规范。

3.2.1 什么是编码规范

编码规范是一套某种编程语言的导引手册，这种导引手册规定了一系列语言的默认编程风格，以增强语言的可读性、规范性和可维护性。一个语言的编码规范主要包括文件组织、缩进、注释、声明、空格处理、命名规则等。

遵守编码规范有以下好处。

● 编码规范是团队开发中对每个成员的基本要求。编码规范的好坏是一个程序员成熟程度的表现。

● 提高程序的可读性，有利于开发人员互相交流。

● 良好一致的编程风格，在团队开发中可以达到事半功倍的效果。

● 有助于程序的维护，降低软件成本。

3.2.2 PHP中的编码规范

PHP作为一种高级语言，十分强调编码规范。

1．表述

在PHP的正常表述中，每一句PHP语句都是以“; ”结尾，这个规范就告诉PHP要执行此语句，例如：

    <? php
      echo "php以分号表示语句的结束和执行。";
    ?>

2．指令分隔符

在PHP代码中，每个语句后需要用分号结束命令。一段PHP代码中的结束标记隐含表示了一个分号，所以在PHP代码段中的最后一行可以不用分号结束。例如：

    <? php
      echo "这是第一个语句";       // 每个语句都加入分号
      echo "这是第二个语句";
      echo "这是最后一个语句"? >   // 结束标记“? >”隐含了分号，这里可以省略分号

3．空白符

PHP对空格、回车造成的新行、Tab等留下的空白的处理也遵循编码规范。PHP对它们都进行了忽略。这跟浏览器对HTML语言中的空白的处理是一样的。

合理利用空白符可以增强代码的可读性和清晰性。

⑴下列情况应该总是使用两个空白行：

① 两个类的声明之间。

② 一个源文件的两个代码片段之间。

⑵ 下列情况应该总是使用一个空白行：

① 两个函数声明之间。

② 函数内的局部变量和函数的第一个语句之间。

③ 块注释或单行注释之前。

④ 一个函数内的两个逻辑代码段之间。

⑶ 合理利用空格缩进可以提高代码的可读性。

① 空格通常使用于关键字与括号之间，但是函数名称与左括号之间不能使用空格分开。

② 函数参数列表中的逗号后面通常会插入空格。

③ for语句的表达式应该用逗号分开，后面添加空格。

4．注释

为了增强可读性，在很多情况下，程序员都需要在程序语句的后面添加文字说明。而PHP要把它们与程序语句区分开，就需要让这些文字注释符合编码规范。

这些注释的风格包括C语言风格、C++风格和SHELL风格。

（1）C语言风格如下：

    /*这是C语言风格的注释内容*/

这种方法还可以多行使用：

    /*这是
      C语言风格
      的注释内容
    */

（2）C++风格如下：

    //这是C++风格的注释内容行一
    //这是C++风格的注释内容行二

（3）SHELL风格如下：

    #这是SHELL风格的注释内容

C++风格和SHELL风格的只能一句注释占用一行，既可单独一行，也可使用在PHP语句之后的同一行。

5．与HTML语言混合搭配

凡是在一对PHP开始和结束标记之外的内容都会被PHP解析器忽略，这使得PHP文件可以具备混合内容，使PHP嵌入到HTML文档中。例如：

    <HTML>
    <HEAD>
        <TITLE>PHP与HTML混合</TITLE>
    </HEAD>
    <BODY>
    <? php
          echo "嵌入的PHP代码";
    ?>
    </BODY>
    <HTML>
上一章目录下一章