phpdocumentor 安装以及使用说明

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了phpdocumentor 安装以及使用说明，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含2166字，纯文字阅读大概需要4分钟。

内容图文

一  缘由       

        最近改版公司网站和app端的api，发现很多函数和方法都没写注释，搞得每次调用之前还需要看底层实现，有的方法名和功能还类似，区分不出使用哪个最优！为了避免给后人挖坑，除了将代码写得规范外，还想自动生成api文档，方便后来人！于是就研究上了phpdocumentor。今天说下它的安装以及使用。首先需要声明的是，网站的教程很多，但问题在于，按照网上的一些教程来，坑爹，老失败。于是干脆自己动手写一篇，记录下自己的经历。

二  安装

    安装的环境是win10+xampp，

    1      php.exe的路径是：C:\xampp\php；首先就是查看自己的php.exe目录下有无pear这个文件，好吧，我这个是没有的。那么， 将https://pear.php.net/go-pear.phar另存为go-pear.phar文件，并保存到php.exe所在路径中

    2     第二步很重要，很多文章中都是说，直接进入到php的安装目录，执行命令  php go-pear.phar

问题就出在这里：报错，提示 ：

PHP Warning: mkdir(): File exists in phar://C:/xampp/php/go-pear.phar/System.php on line 294

Warning: mkdir(): File exists in phar://C:/xampp/php/go-pear.phar/System.php on line 294
PHP Warning: mkdir(): No such file or directory in phar://C:/xampp/php/go-pear.phar/System.php on line 294

Warning: mkdir(): No such file or directory in phar://C:/xampp/php/go-pear.phar/System.php on line 294
Unable to create Temporary directory for processing C:\xampp\php\phpdoc\tmp.
Run this script as administrator or pick another location.

C:\xampp\php>PHP Warning: mkdir(): File exists in phar://C:/xampp/php/go-pear.phar/System.php on line 294
Could not open input file: Warning:

如图所示：

找了好久，终于找到原因了：权限不够导致的！！！需要以管理员的权限进入到dos下，我直接在C:\Windows\System32目录下，以管理员的方式进入dos中：

然后切换到刚才的目录下，执行 php go-pear.phar， 按回车默认system然后继续。后面操作均为默认。最后成功安装，查看php.exe同目录就可以看到pear这个文件了：

安装成功后，再来执行pear install phpdocumentor即可。

三 使用phpdocumentor

输入phpdoc -h 会有如下提示：

一般，用得多的几个参数解释如下：

-f 要进行分析的文件名，多个文件用逗号隔开
-d 要分析的目录，多个目录用逗号分割
-t 生成的文档的存放路径
-o 输出的文档格式，结构为输出格式：转换器名：模板目录。

例如，我这边生成doc的命令是：

phpdoc -d "C:\www\web"  -t  "C:\www\web\doc"

然后在对应的目录下去查看生成的文档即可！

内容总结

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

内容备注

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

内容手机端