2017年8月19日 上午11:34
官方网站:https://phpdoc.org/
起因:我最近在看TP的源码,想做出一个html文档作为辅助
牢骚
- 官方网站中的system requrement,能不能标明那些是必须的、哪些是附加的!出现错误的时候至少排除不是环境的问题
- 官方网站中能不能有一个Q&A,出了错我都不知道去哪找,百度中的资料,大家的情况基本上都不一样,抄来抄去,不但学不到东西、弄不懂原理,而且八成还解决不了问题
- phpDocument你行不行,不知道大家用的不同的系统的,能不能说一说不同电脑之间的区别。百度上都没有一个关于mac上用pear安装phpDocument的文档,注意是一个!我安装下来各种报错
- 最后埋怨埋怨我
- 看资料能不能不着急!尤其是english,你不知道english不好吗!
- 把 “PHAR”看成“PEAR”,这不是第一次了。这最起码就浪费了1个多小时
- 看Stack Overflow里的文章,先看懂人家的情况和自己一样不,不要就是着急找答案,人家问题你都不仔细看,能找见个屁!
- 学习不是一日之工,是水到渠成。还是不要着急,保持一个清晰的思维
- 看资料能不能不着急!尤其是english,你不知道english不好吗!
- TP你能为啥就不按phpDocument的格式写,你瞧不起外国人的东西啊(做的好!)
这次的问题我做的比较好的地方(第三点是最核心的)
- 学习phpDocument首先想到是官方文档,先进行了文档的阅读,按着文档的思路来做
- 我最后实在解决不了问题1、问题2。是按着官方文档的方法去试的第二种,从百度中乱七八糟的东西中抽出身来。事实证明我是对的
- 对于那些报错,我最后觉得是我解决不了的问题,因为他的报错中涉及到了这个软件本身的代码,以及一些php整个原理上的东西。我首先对人家代码不了解,其次我对php整个的运行过程并不熟悉,只是会做不涉及php本质的项目。我既然目前的知识体系不足,就没必要在自己肯定解决不了的问题中徘徊,弄的自己蓬头垢面
附录:
Pear安装过程
1 | czhdeMacBook-Pro:.ssh czh$ sudo pear channel-discover pear.phpdoc.org |
(第一个错)-解决不了
1 | czhdeMacBook-Pro:thinkphp_3.2.3 czh$ php phpDocumentor.phar -d . -t docs/api |
(更改路径之后报的第二个错)—解决不了也
1 | czhdeMacBook-Pro:thinkphp_3.2.3 czh$ phpdoc -d ./ThinkPHP -t ./docs/api |
我换用PHAR安装后,发现能行了(phpDocumentor.phar方式)
1 | bogon:~ czh$ php phpDocumentor.phar -d test -t docs/api |
(报的第三个错)(phpDocumentor.phar方式)
说明:phpDocumentor.phar 这个必须在当前目录下(我觉着改改路径其他目录也行,没试)
1 | bogon:htdocs czh$ php phpDocumentor.phar -d test -t docs/api |
看看成果吧!


注:我倒是没琢磨这个具体怎么用,和javadoc有区别









%E6%B5%AE%E5%8A%A8%20%E6%80%BB%E7%BB%93/D6D4DCD9-C240-4624-A4E1-1A3ECAE0BFBC.png)
%E6%B5%AE%E5%8A%A8%20%E6%80%BB%E7%BB%93/8B0570E8-3146-468E-99D8-E3F5A965C362.png)
%E6%B5%AE%E5%8A%A8%20%E6%80%BB%E7%BB%93/5EFE1638-487A-4687-9AF0-3AF7624DE87B.png)
%E6%B5%AE%E5%8A%A8%20%E6%80%BB%E7%BB%93/819C4DAA-5E3B-422C-9379-9431E94E9906.png)
%E6%B5%AE%E5%8A%A8%20%E6%80%BB%E7%BB%93/EAEB0E88-FBE0-441A-B6F4-70265C88F515.png)