[转]netbean下利用apigen生成php文档安装配置

利用piwigo进行了项目的二次开发以后，有感于这个开源框架的博大精深，想留个念想，因此想利用phpDocumentor在sublime下面生成文档。安装以后，控制台报错。找群友商量以后，有朋友推荐用netbean与apigen配合生成文档。并且这位群友还来出了本身生的案例。
感受用netbean与apigen生成的文档的界面的确舒服，加上sublime下面的phpDocumentor出错提示，也让人无头绪。因此决定仍是用netbean,必竟有很长一段时间，netbean(如今用的 7.2版)与sublime我会结合着使用。
第一步：php运行环境的安装
第一点，在windows平台上面安装php.我用的版本是php-5.3.18-Win32-VC9-x86.zip( 强调一点，低于5.0版本php,最新的apigen不支持了 。)php安装好以后，要注意的是在系统的环境变量path中加入php安装的目录



第二点，为了支持phpMyAdmin，打开mbstring。打开“php.ini”，找到“;exte nsion=php_mbs tring.dll”，将最前面的分号去掉；

第二步：pear的安装（必须）
首页去PEAR官网，下载一个文件 go-pear.phar .
下载地址为  http://pear.php.net/go-pear.phar
而后在命令行运行 php go-pear.phar.在运行以前，首页要保证php.ini 文件的存在。我下载的php-5.3.18-Win32-VC9-x86.zip中将php.i ni-development更名便可。由于在pear安装的最后一 步，会生成一个pear.ini并且其中有一部运行路径，将会提示你是否要添加到php.ini中。选Y ES,回车继续。安装成功的 PEAR的几个文件，都会显示OK.成功安装pear以后，会生成一个针对window平台的注册表文件 PEAR_ENV.reg ，双击它，加它进注册表中。到了这一步，才标志着你的pear安装成功！


备注：这个提示针对是不少网站给出的一个地址生成的go-pear.php，在命令行运行 php go-pear.php所产生的出错提示。提示中，给出一个链节，让开发者去下载一个文件，就是咱们须要的go-pear.phar文件。

第三步，经过pear安装 apigen.
安装的命令能够参照apigen的官网上面的步骤。基本上前面两步作好了，到这里是很简单的。
我第一次用pear安装apigen，彻底成功。由于php.ini的里面的mbstring没有开启，并且没有加入正确的php ext
运行路径，致使在netbean中一直没法让apigen启动运行，加上netbean的控制台中也一直没有报错，因此也没法定位错误，让我痛苦万分。这个时候，新的问题产生了，我觉得是个人apigen没有装好，因此我用pear命令重装
了apigen，可是一直报错，说是没有安装包。我想多是由于删除的时候，注册表中的文件没有删除干净导到致。因此我用了另一种方式来安装，就是直接在apigen的官网下载了最新版的 ApiGen-2.8.0-standalone.zip将解压文件所有复制到php文件夹下面。
而后，在netbean下面终于出现了我期待以久的画面。

可爱的紫色 apige出现了。而后就是生成文档的过程。
备注：
在执行时报错：

    Used 98% of the current memory limit, please increase the limit to generate the whole documentation.

    修复方法：修改你系统中所安装PHP的配置文件（php.ini），将其中的 memory_limit  值设置到一个合适的值。

我要强调的一点是，若是没有配置好pear，直接解压apigen到php中，是不能够的。
还有就是，个人netbean中的一处，与官网的视频讲的不一样，直接上图，更能说明问题
若是按照官网的方法来安装apigen脚本，依然不能输出API文档

若是指向 apigen.bat，我这里是没法运行的，不知道，元芳，是怎么看的？

可是若是将apigent的脚本指向 apigen.php,哪么是能够正常生成api文档的。



说实话，我真的不知道事件的真相是怎么一回事，大人。在说，我也没有时间去细查了。若是有知道结果的朋友欢迎评论留言。

Windows下PHP PEAR的安装方法介绍

http://www.leapsoul.cn/?p=357

Netbeans配置ApiGen自动生成api文档
http://www.cnblogs.com/lfire/archive/2012/10/10/2718974.html

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++