码迷,mamicode.com
首页 > Web开发 > 详细

phpDoc使用说明

时间:2014-07-27 09:47:22      阅读:473      评论:0      收藏:0      [点我收藏+]

标签:

技术文档可以使人们更好得使用他人的代码库,然而,作为开发人员,编写文档确是一件让人头疼的事情。PHPDoc是PHP文档注释的一个标准,它可以实现为代码生成API文档。

PHPDoc注释规范:

块注释的开始及结束标志分别为"/**" 、"*/" ,它的后面必需紧跟着被注释的函数,如下所示:

bubuko.com,布布扣
1 /**
2  * 块注释
3  */
4  public foo()
5 {
6 }
View Code

块注释中可以包含标签:

bubuko.com,布布扣

 

此外,在phpstorm中,可以通过:

1、Code->Generate->PHPDoc Blocks…                     自动生成phpDoc的注释

2、File->Settings->File and Code Templates            修改注释模板

 

参考资料:

1、http://wenku.baidu.com/link?url=qL1Sc-S1HcFHezyFOGBTsR2RiuYJed-GvZhYu-ca2L0NXh3OatksYWIILzzhP1usk35GNURmM-SheklqqJsd_XqM5j99GA3YC18fYq7X4vG

2、http://www.cnblogs.com/picaso/archive/2012/10/04/2711435.html

3、http://en.wikipedia.org/wiki/Phpdoc

phpDoc使用说明

标签:

原文地址:http://www.cnblogs.com/nerrissa/p/3870362.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!