最新消息:文章中包含代码时,请遵守代码高亮规范!

phpDocumentor 2 学习笔记【原创】【PHP】

PHP Jay 1909浏览 0评论

近期在研究php文档自动生成的方法,找到了很厉害的

phpDocumentor

我自己下了两个版本,第一个是在百度上找的1.4版本的 一个是官方下载的最新版本2.9,其中1.4版本可以生成doc,pdf以及html等等格式的文档,但是在我生成的过程中常有报错,后来查了一下是由于低版本的不兼容php5.0以上,无奈只能放弃,孤身一人投入谷歌,进行淘沙之旅。

在phpDocumentor的官网上我下了最新版本的2.6版本,据说可以支持php7。 安装之后,研究了一段时间,成功的生成了网站版本,完美无暇可以这么说,然后我开始研究doc,pdf格式的怎么生成,经过不断的查询,研究,确认了目前2以上 官方的提供源码中主要都是各种样式不同的html版本的模板,而doc,pdf都没有集成,虽然官方说可以自己自定义模板,但在说的很模糊,没看懂。指望去谷歌上去看看有没有大神搞出来,下一个。悲惨的是网上这方面的资料很少,寥寥的几篇都说目前没有,可能是由于我的查找能力很差的造成的吧,现在只能暂时研究到这了。

下面和大家简单的说一下手动安装和简单使用phpDocemtor2,如果想要了解pear的安装方法,请点击下列链接,进入官方文档,自学成材。谢谢

官网地址:https://www.phpdoc.org/

手动安装:下载官方源码

进入官网,按照下图的标记依次点击可以进入源码的下载页面

QQ截图20160824164907

【下载页面】

QQ截图20160824165126

 

下载到本地之后,解压,放在哪里都可以。然后打开你的命令行工具【按照您的系统来】,进入到下载文件的bin目录下

QQ截图20160824170338

然后生成文件

QQ截图20160824171053

成功后进入您放置生成数据的目录打开index.html就能看到效果了

QQ截图20160824171536

【效果】效果是通过你选择的模板而定的

QQ截图20160824171632

文章的最后,我们来说说上面的生成指令是什么意思把,详见官方文档 https://phpdoc.org/docs/latest/getting-started/changing-the-look-and-feel.html

php phpdoc

-d   待生成的目录

-f   待生成的文件

-t   生成文件存放目录

--template   模板

 

转载时请注明出处及相应链接,本文永久地址:https://blog.yayuanzi.com/17937.html


pay_weixin
pay_weixin
微信打赏
pay_weixin
支付宝打赏
感谢您对作者Jay的打赏,我们会更加努力!    如果您想成为作者,请点我

发表我的评论
取消评论

表情