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

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