金色的骷髅 发表于 2015-2-16 00:27:42

PHP编程:PHP文档东西

参加PHP开发学习,或许只是一次偶然的想法吧!只是想在走向社会之前体验、学习在一个公司或者说是项目团队之中如何去更有效的沟通、交流、共同合作,还有就是为毕业实习找工作增加伐码。   写文档是一项有趣却不能不做的任务,而编写API级的文档更是意味着大批的反复休息和难以坚持的分歧性。这里咱们要保举给人人的,是撑持PHP5语法剖析的文档东西――phpDocumentor。

利用phpDocumentor不但可以主动从代码中提掏出函数和办法界说,还可以主动处置各个class之间的关系,并据今生成class tree。你还可以选择将文档生成html、chm或pdf。有了phpDocumentor,文档任务变得轻松了良多。



装置phpDocumentor

在pear下装置phpDocumentor是一件极为复杂的工作,只需求在cmd窗口中cd 到php装置目次下,然后输出

Pear install phpDocumentor


Pear就会本人下载并完成phpDocumentor的装置。

在phpDocumentor胜利装置后,php装置目次下会多出来一个phpdoc.bat。这个文件就是咱们用来生成文档的批处置文件了。

<? 相干常识 ?>

phpDocumentor是phpDoc的晋级版本,是专门为撑持php5语法而重写的文档东西,当你的php版本为5时,运转phpDoc.bat,它会主动去挪用phpDocumentor。所以文章中的提到的phpDoc和phpDocumentor实践上是不异的。




在phpdoc.bat地点目次下,输出

Phpdoc Ch


会失掉一个phpDocumentor的具体参数列表。

咱们从个中选出几个经常使用的来看看:

<? 号令注释 ?>

-f
要停止剖析的文件名,多个文件用逗号朋分

-d
要剖析的目次,多个目次用逗号朋分

-t
生成的文档的寄存途径

-o
输入的文档格局,布局为输入格局:转换器名:模版目次,例如:HTML:frames:phpedit




咱们会用到的就这几个了,其他的号令请人人浏览help的提醒信息。



试用phpDocumentor

上面咱们就以pear中的phpUnit2为例,演示一下若何利用phpDocumentor来生成文档。

起首,把咱们需求的参数肯定上去:

<? 号令参数 ?>

-d
C:\Program Files\EasyPHP5\php\PEAR\PHPUnit2

-t
C:\Program Files\EasyPHP5\php\phpunit2doc

-o
HTML:frames:phpedit


依据上边的参数,咱们组合出下边的号令:

Phpdoc -d “C:\Program Files\EasyPHP5\php\PEAR\PHPUnit2” -t “C:\Program Files\EasyPHP5\php\phpunit2doc” -o “HTML:frames:phpedit”


运转上边的号令后,phpDocumentor入手下手解析源文件并输入任务信息。




号令运转完成后,咱们的文档就已生成好了。 进入咱们指定的方针目次,用阅读器翻开index.html就能够看见生成的文档了。 文档界面由frame分红了三个局部,左上是包信息,左下是导航信息,右侧则是具体的信息出现页。




上边的图很清晰地描写出了文档的内容:

索引、函数列表、类列表、文件列表和子包。

点击上边的class(es)链接,咱们可以明晰的看见全部包的class tree。




咱们点击个中一个class,就进入了class的描写页面。

Class描写页面次要包括以下几方面内容:



l 描写:版权、作者、类条理等

l 类变量

l 类常量

l 办法

l 承继的变量

l 承继的办法:十分有效的一个功效






怎样,是否是很具体呢?假如要生成chm,可以把前边的-o参数改成”CHM:default: default”,如许phpDocumentor会为你生成好chm项目文件,只需用微软的chm东西停止编译就能够失掉可用的chm文件了。



用phpDocumentor为本人的代码生成文档

固然phpDocumentor可以主动从代码平分析出一些信息,然而,要构成一份详实的文档仍是需求咱们在编码中停止共同的。为了让phpDocumentor读懂咱们的代码,咱们需求注重一些编码标准和在正文中增添一些tag:



<? Tags ?>

@author
作者信息

@const
由define界说的常量

@deprecate
不建议利用的API

@global
全局变量

@package
包信息

@param
函数参数

@return
前往值

@see
参考函数

@since
引入工夫

@static
静态变量

@var
类成员变量




这里只是复杂的列出了经常使用的一些Tag,人人可以浏览phpDocumentor的文档,里边有十分具体的编码标准。关于phpDocumento就引见到这里,但愿人人都能好好使用这个东西来标准本人的文档。



PS:phpDocumentor也有Web界面的,你可以会见http://phpdoc.org获得Web版本。Web版本的装置很复杂,直接放到web可以会见的目次就能够运转了。



<? 情况请求 ?>

PHP:5.0.0

OS: 平台自力,本文演示OS为windows

在我开始学习PHP以前,我从未想过要做软件工程,即便是在去听过华育国际的关于软件工程的美好前景后,因为我一直都没有想过要与代码打交道,而是想学好所学专业,做个网络工程师或者是网络安全人员。

莫相离 发表于 2015-2-16 03:25:29

基础有没有对学习php没有太大区别,关键是兴趣。

小妖女 发表于 2015-2-28 01:04:28

其实也不算什么什么心得,在各位大侠算是小巫见大巫了吧,望大家不要见笑,若其中有错误的地方请各位大虾斧正。

飘灵儿 发表于 2015-3-9 17:42:22

多看优秀程序员编写的代码,仔细理解他们解决问题的方法,对自身有很大的帮助。

admin 发表于 2015-3-12 16:35:30

因为blog这样的可以让你接触更多要学的知识,可以接触用到类,模板,js ,ajax

若天明 发表于 2015-3-19 23:44:32

本文当是我的笔记啦,遇到的问题随时填充

透明 发表于 2015-4-3 13:54:12

php是动态网站开发的优秀语言,在学习的时候万万不能冒进。在系统的学习前,我认为不应该只是追求实现某种效果,因为即使你复制他人的代码调试成功,实现了你所期望的效果,你也不了解其中的原理。

冷月葬花魂 发表于 2015-4-10 21:25:00

首先声明:我是一个菜鸟,是一个初学者。学习了一段php后总是感觉自己没有提高,无奈。经过反思我认为我学习过程中存在很多问题,我改变了学习方法后自我感觉有了明显的进步。

灵魂腐蚀 发表于 2015-4-13 01:52:33

因为blog这样的可以让你接触更多要学的知识,可以接触用到类,模板,js ,ajax

不帅 发表于 2015-4-15 23:43:10

建数据库表的时候,int型要输入长度的,其实是个摆设的输入几位都没影响的,只要大于4就行,囧。

小魔女 发表于 2015-4-17 14:40:49

再就是混迹于论坛啦,咱们的phpchina的论坛就很强大,提出的问题一般都是有达人去解答的,以前的帖子也要多看看也能学到不少前辈们的经验。别的不错的论坛例如php100,javaeye也是很不错的。

再现理想 发表于 2015-4-17 18:20:26

当留言板完成的时候,下步可以把做1个单人的blog程序,做为目标,

愤怒的大鸟 发表于 2015-4-22 05:21:25

如果你可以写完像留言板这样的程序,那么你可以去一些别人的代码了,

金色的骷髅 发表于 2015-4-24 00:38:27

使用 jquery 等js框架的时候,要随时注意浏览器的更新情况,不然很容易发生框架不能使用。

飘飘悠悠 发表于 2015-6-10 23:56:21

遇到出错的时候,我经常把错误信息直接复制到 google的搜索栏,一般情况都是能搜到结果的,不过有时候会搜出来一大片英文的出来,这时候就得过滤一下,吧中文的弄出来,挨着式方法。

仓酷云 发表于 2015-6-12 19:40:57

开发工具也会慢慢的更专业,每个公司的可能不一样,但是zend studio是个大伙都会用的。

若相依 发表于 2015-6-17 20:52:35

开发工具也会慢慢的更专业,每个公司的可能不一样,但是zend studio是个大伙都会用的。

只想知道 发表于 2015-7-8 11:03:45

首先声明:我是一个菜鸟,是一个初学者。学习了一段php后总是感觉自己没有提高,无奈。经过反思我认为我学习过程中存在很多问题,我改变了学习方法后自我感觉有了明显的进步。

兰色精灵 发表于 2015-7-9 21:41:39

在我安装pear包的时候老是提示,缺少某某文件,才发现 那群extension 的排列是应该有一点的顺序,而我安装的版本的排序不是正常的排序。没办法我只好把那群冒号加了上去,只留下我需要使用的扩展。

活着的死人 发表于 2015-7-14 01:08:08

学习php的目的往往是为了开发动态网站,phper就业的要求也涵盖了很多。我大致总结为:精通php和mysql
页: [1] 2
查看完整版本: PHP编程:PHP文档东西