首页 / PHP / 使用phpdoc/phpDocumentor来生成api文档

使用phpdoc/phpDocumentor来生成api文档

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了使用phpdoc/phpDocumentor来生成api文档，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含1280字，纯文字阅读大概需要2分钟。

内容图文

phpDocumentor是一个非常强大的文档自动生成工具，利用它可以帮助我们编写规范的注释，生成易于理解，结构清晰的文档，
对我们的代码升级，维护,移交等都有非常大的帮助。
网上关于phpdoc的文档的介绍虽然不少，但是有点麻烦：
1、网上通常介绍的内容太多，不容易被新手看懂。个人觉得，教程应该本着简单易懂，在能解决问题的前提下，能有多简单就多简单。
更多的内容，应该以附录的形式，或者留下其他更详细的资料链接供读者去阅读（而不是把一大块都复制进自己的文章）
2、phpdoc的安装稍微麻烦。他们没有介绍一种简单易上手的方法给读者
3、phpdoc的默认编码是ISO-8859-1，此时生成的HTML文档会中文乱码。尽管说网上有提供了解决方案——但是，为什么不直接提供一个可支持中文的版本给读者呢？
基于以上几点，我想写篇博文，跟大家分享一个使用phpdoc的简单方法(windows环境下)
在使用phpdoc之前，你首先需要了解代码注释的语法规则（如果你已经懂，请忽略）。
可参考维基本科 http://zh.wikipedia.org/wiki/PHPDoc 中关于注释格式的描述部分。
接着，可下载这个经过优化的phpdoc版本:
下载后解压，比如说解压到”D:/phpdoc”路径下。
用文本编辑器打开phpdoc.bat（注意，不是双击运行），第16行：
SET phpCli=D:\Program Files\php5.3.11\php.exe
将这里的PHP.exe的路径改为你电脑的php环境执行文件所在的路径。（如果你是PHPer，我相信你在本机有安装了php环境吧。）
然后，打开命令提示符。（开始-运行-cmd），在命令行中，进入phpdoc所在的目录，（比如说，输入“cd D:/phpdoc”）。
进入目录后，输入下面的命令，便可快速生成HTML文档：
phpdoc -d D:\website\Api -t D:\website\Api\doc -dn shilianwang -dc shilianwang -ti 事联网文档 -o HTML:Smarty:PHP
上述命令中，D:\website\Api是源php文件所在目录。D:\website\Api\doc 是生成的文档存放目录。
shilianwang是子目录，包、标题。HTML:Smarty:PHP 表示使用HTML模块生成
上面的命令，如果你想详细了解，可在命令行输入phpdoc -h ，了解更多。
最后，附上三种效果图：
 技术分享
 注释的样式：

该注释生成的效果图：

技术分享


PhpDocumentor手册-安装和标签使用

谢谢关注websites博客!

原文：http://blog.csdn.net/websites/article/details/45308835

内容总结

以上是互联网集市为您收集整理的使用phpdoc/phpDocumentor来生成api文档全部内容，希望文章能够帮你解决使用phpdoc/phpDocumentor来生成api文档所遇到的程序开发问题。 如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端

扫描二维码推送至手机访问。

本文链接：https://qyyshop.com/info/1209163.html

来源：【匿名】