PHP编码规范之注释规范
作者:bea
注释在每种语言中都有,理解不同的注释类型之间的区别是很重要的。有些注释是方便程序员阅读程序的,但是有些注释的内容实际上是和程序一起存储的。 先来看看PHP的注释类型有哪些。 1、单行注释 如下代码就是PHP中的单行注释: 上面注释是PHP代码的单行注释 2、多行注释 如下代码是PHP代码的多行注释 3、文档注释 如下代码是PHP代码的文档注释 多行注释和文档注释初看起来没有
注释在每种语言中都有,理解不同的注释类型之间的区别是很重要的。有些注释是方便程序员阅读程序的,但是有些注释的内容实际上是和程序一起存储的。
先来看看PHP的注释类型有哪些。
1、单行注释
如下代码就是PHP中的单行注释:
上面注释是PHP代码的单行注释
2、多行注释
如下代码是PHP代码的多行注释
3、文档注释
如下代码是PHP代码的文档注释
多行注释和文档注释初看起来没有什么不同,但是文档注释多了一个“*”号。但是PHP会以不同的方式来解析多行注释和文档注释。
单行注释仅仅是方便人来读程序,但是对PHP来说没有多大意义。
多行注释就多了一些额外的工作,多行注释的数据和程序代码会在一块存储,这些数据可能会被其他的程序使用,这是为了获得关于如何与程序打交道的更多信息。
值得注意的是:文档注释的要求非常的严格,一定要把文档注释放在说明代码的前面,否则他们是不会关联在一起的。
所以在自己编写代码的过程中不要小看了注释,它其实也是非常重要的。想成为一名高级PHP程序员,小地方注意了,代码的效率等各方面都会有一定的提高。
在团队合作中代码规范是相当重要的,希望PHP程序员们不要遗漏小的方面。 有用 | 无用
先来看看PHP的注释类型有哪些。
1、单行注释
如下代码就是PHP中的单行注释:
上面注释是PHP代码的单行注释
2、多行注释
如下代码是PHP代码的多行注释
3、文档注释
如下代码是PHP代码的文档注释
多行注释和文档注释初看起来没有什么不同,但是文档注释多了一个“*”号。但是PHP会以不同的方式来解析多行注释和文档注释。
单行注释仅仅是方便人来读程序,但是对PHP来说没有多大意义。
多行注释就多了一些额外的工作,多行注释的数据和程序代码会在一块存储,这些数据可能会被其他的程序使用,这是为了获得关于如何与程序打交道的更多信息。
值得注意的是:文档注释的要求非常的严格,一定要把文档注释放在说明代码的前面,否则他们是不会关联在一起的。
所以在自己编写代码的过程中不要小看了注释,它其实也是非常重要的。想成为一名高级PHP程序员,小地方注意了,代码的效率等各方面都会有一定的提高。
在团队合作中代码规范是相当重要的,希望PHP程序员们不要遗漏小的方面。 有用 | 无用
猜你喜欢
您可能感兴趣的文章:
- .htaccess重写规则以及参数说明
- PHP中如何设置session过期
- PHP模板引擎Smarty的工作原理
- smarty的安装、配置和使用实例
- 给大家介绍几个PHP模板引擎
- 强烈推荐一个PHP写的验证码类
- 配置.htaccess文件实现URL地址重写
- 建立友好于搜索引擎的URL地址
- PHP将sql文件导入到phpmyadmin
- 分享一个PHP写的分页类
- PHP连接mysql数据库的二种方法
- PHP数组合并函数array_merge
- php会话控制cookie的应用
- PHP学习:遍历数组的几种方法
- PHP查询指定字符在字符串出现的次数
- 优化PHP程序效率的一些细节
- 推荐几本好的PHP书籍
- 向大家推荐几款好用的php开发工具
- PHP中异常处理机制介绍