3.1.4 注释的功能很强大

所谓注释,汉语解释可以为:注解。更为准确一些。
因为代码是英文的、并且代码很长,时间长了人会忘。
所以我们会加上注释

注释的功能有很多:

  1. 对重点进行标注
  2. 时间长了容易忘快速回忆,方便查找
  3. 让其他人看的时候快速看懂
  4. 还可以生成文档,代码写完相关的文档就写完了,提高工作效率
  5. 注释、空行、回车之后的代码看起来更优美
  6. 注释可用来排错。不确定代码中哪一块写错了,可以将一大段注释,确定错误区间
  7. 注释中间的部分的内容,电脑不会执行它

先给大家看看我们觉得优美的代码,整齐、规范、说明清楚、一看就懂。(不需要理解代码的含义):

2015-07-26/55b45e4f5550a

再看看我们眼中觉得丑陋的代码,对齐丑陋不说,并且没有功能说明(不需要理解代码的含义):

2015-07-26/55b45dfadd672

我们了解了注释的好处,接下来我们来说PHP的注释,注释分别:

  • 单行注释(只注释一行)
  • 多行注释(注释多行)

  • 单行注释

    //   表示单行注释
    

* 多行注释

/*

多行注释 这里是注释区域代码

*/


单行注释举例:

<?php

//声明一部iphone6手机的价格变量
$iphone6_price = 6088;

//显示输出手机价格
echo $iphone6_price;
?>

注:通过上例我们知道,注释通常写代码上面。

多行注释举例:

<?php
/
作者:李文凯
时间:2048.12.23
功能:这是一个假的多行注释的例子
/

/
声明一个爱情变量
$love 是指爱情
爱情是一个变量,因为人的爱总是在发生变化
所以,爱情变量的值为250
/
$love = 250;

?>


注:通过上面的例子我们发现,我们要写上很多注释的时候,使用多行注释。



* * * * *
注:暂时不讲解如何通过专门的工具生成注释
文章导航