开发者学堂课程【PHP 基础入门课程（上） ：PHP 注释】学习笔记，与课程紧密联系，让用户快速学习知识。
课程地址：https://developer.aliyun.com/learning/course/709/detail/12581
PHP 注释
内容介绍：
一、学习目标及概念
二、注释分类
三、使用规则及举例
四、示例
五、小结
一、学习目标及概念
写代码时充分利用注释，能够让自己或者团队清晰地了解代码的具体作用。
目标:掌握注释的实际运用。
注释:是一种使用代码符号之外的，通俗易懂的文字描述代码作用或者逻辑的符号。PHP 引整在解析时，会忽略注释标记及被注释的内容。
二、注释的分类
1. 行注释：#或者//，标记当前行符号后面的内容
2. 块注释：/*...*/标记起始和结束符号内的所有内容
三、使用规则及举例
1.行注释：当前注释描述的内容不多，或者不会超过一行
独占一行使用
在代码之后使用
举例：新建 02php_comment.php ，编写独立的 PHP 文件
（1）先写注释，表明编写该脚本的用途
#当前脚本是用来练习注释的
（2）返回并运行，输入 02php_comment.php，打开后发现是空白，且打开源码也为空白。
原因为：
PHP 不管注释。此时已完成了一个行注释；行注释独占一行。
输入内容 echo ‘hello world’;
//输出，此时也为一个行注释。
2.块注释；当前注释描述的内容较多，通常会有多种信息或者内容较多超过一行
（1）独占一行开始：/*
（2）独占一行结束：*/
举例：一行注释不够时，通常/*（换行）*/，为保证结构美观性，通常会*@作者：小爱，系统会自动进行补充*@功能；注释
此时有多种信息，就建议分行，使用块注释；运行后块注释也会被 PHP 忽略掉，而不进行解析。
四、示例
1.这是一行独立的注释，下面的内容将输出 hello world（建议）
echo 'hello world’;//
2.简单内容也可以在代码后直接写（不建议）
/*
3. 从这开始全是注释
@Cauthor 作者信息
@date 开发日期
*/
五、小结
1. 注释是为了让人在看代码时能够容易看懂代码。
2. 注释分为两种基本类型
·行注释:使用#或者//，用来注释简单描述。
·块注释:使用/，用来注释复杂描述。
3.一个具有良好职业素养的程序员应该尽可能多的使用注释来描述自己的代码，以保证以后自己或别人能够看懂。
