零基础PHP注释与使用场景

注释，一般放在代码的上方或者尾部，对一段代码或一个方法进行文字说明，用来帮助我们理解这段代码的含义。注释内容可以有很多种，例如一个变量的名词解释、这个函数的作者是谁、代码写于哪天、用途又是什么等，这些都可以当作注释写到PHP文件中。

PHP支持三种注释风格，每种注释都有其不同的使用场景。

1．单行注释（C++语言风格）

注释符号：//这里是注释内容

单行注释，一般写在代码的上方，用来解释下面的代码含义。

动手写3.2.1

单行注释放在代码的后面，同样可以很清楚地表达代码含义。

动手写3.2.2

提示

注释只是用来进行代码解释的，在程序运行时所有注释会被去掉，不会在程序中运行。注释不要放在代码的下面，因为这不利于理解。

2．多行注释（C语言风格）

注释符号：/*这里是注释内容*/

多行注释，可以注释更多的内容，比如一段代码在当前版本不希望发布，则可以对它进行注释。

动手写3.2.3

(www.xing528.com)

代码在运行时，不会执行被注释的代码。

运行结果如图3.2.1所示。

图3.2.1　注释后的网页运行效果

我们再将注释去掉：

动手写3.2.4

代码再次执行，所有内容都会呈现在浏览器上，运行结果如图3.2.2所示。

图3.2.2　没有注释的网页运行效果

3．#符号注释（SHELL语言风格）

注释符号：#这里是注释内容

#符号注释也属于单行注释，既可以单独一行，也可以放在一行代码的后面。

动手写3.2.5

在“#”和文字之间，加入一个空格，可以让注释和符号不再紧凑，利于阅读，在本章的最后会深入讲解代码规范的相关建议。