php doc生成工具,一直没有跟进php的升级版本,两个主要的生成工具,都已经不再更新了,以下是两个老版的php doc generater:
不过在中间漫长的空荡期中,出现了一个叫做PHPXref的产品,但是他并不适合用作生成php doc,但是用以php项目代码分析却十分不错。
这里要带出今天的主角:phpdoctor
phpdoctor简化了phpDocumentor里面大量无用的注释标签,他可以生成一套完整的如JDK手册风格的document,他的 config配置文件拥有更加详细全面的设置,支持自定义编码格式,而不再需要手动去修改该死的phpDocumentor的模版编码了,他的语法解析十 分细致,可定制化程度很高,甚至包含了$GLOBALS,他都能捕捉到。
phpdoctor的诸多好处,实在无法一一细述,列举几个官方提供的文档案例:
下面提供一些常用的说明的入口:
有话要说