[转]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

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

转载于:https://my.oschina.net/u/574397/blog/137790