pear 安裝 phpdocumentor2 失敗

原本執行：
pear install phpdoc/phpDocumentor-alpha

還有其他相依套件沒有安裝，所以要加上「--alldeps」參數，變成：
pear install --alldeps phpdoc/phpDocumentor-alpha

才行。

另外，由於 phpDocumentor2 需要 XSL 這個 extension ，故需要在安裝的時候開啟，否則也會出現錯誤訊息。

pear 安裝套件失敗

透過 pear 安裝 Zend Framework 時，發生錯誤如下：
No releases available for package "pear.zfcampus.org/zf"
install failed

查了一下，應該是 cache 的問題，清一下就好了，命令如下：
pear clear-cache

Wamp 安裝 Zend Framework

網路上很多資料，大概如下：

转载的文章：
WINDOWS 下WAMP环境下 的 Zend Framework 配置
1，安装WampServer 
下载WAMPSERVER并安装，在本例中，安装在C:\wamp下。
2 安装Zend Framework 
解压缩 Zend Framework 压缩包中 \library\ 至 C:\wamp\library （这里面没有library目录，要自己建一个）
3 开启支持rewrite module
编辑 httpd.conf。
- 编辑 C:\wamp\bin\apache\Apache2.2.10\conf\httpd.conf 文件。或
- 右击托盘里WampServer小图标 --> Apache --> httpd.conf
# LoadModule rewrite_module modules/mod_rewrite.so
去掉 '#'，改为：
LoadModule rewrite_module modules/mod_rewrite.so
4 PHP library 设置 
- 编辑 C:\wamp\bin\php\php5.2.7\php.ini，或
- 右击托盘里WampServer小图标 --> PHP --> php.ini
; Windows: "\path1;\path2"
; include_path = ".;c:\php\includes"
去掉 ';'，并且加上Zend Framework 压缩包安装路径，改为：
; Windows: "\path1;\path2" （这里的分号没有去掉）
include_path = ".;c:\php\includes;c:\wamp\library;"
5. 生产quickstart项目
Windows开始菜单点击运行，输入"CMD"，打开Dos命令窗口，
运行命令："set path=%path%;C:\wamp\bin\php\php5.2.9-2;"注册php.exe的路径
运行命令："cd C:\wamp\www"，将当前路径切换到WAMP的网站文档www路径
运行命令："ZendStudio\ZendFramework-1.8.1\bin\zf.bat create project quickstart
注意将zf.bat的路径换成你自己的路径，稍候，zf.bat建立quickstart项目："Creating project at C:/wamp/www/quickstart"
6. 测试示例项目
打开浏览器，浏览"http://localhost/quickstart/public/"，可以看见"Welcome to the Zend Framework!"的页面了。（如果没有显示请重启wmap）

實際上自己安裝的時候，發生路徑不正確的問題。

要先進到 Zend  的安裝目錄，執行：
zf --setup config-file

產生 config 檔，再修改此一 config 檔內容，將 include_path 加上上述的第4點 (PHP library)。

在 netbeans 裡以 PhpDocumentor2 做為 PhpDoc 產生器-5

產生的 Doc 檔出現錯誤

1. timezone
雖然在 php.ini 裡設定了，但是還是沒用，所以直接到發生問題的檔案裡處理：
[php安裝目錄]\PhpDocumentor\phpDocumentor\Smarty-2.6.0\libs\Smarty_Compiler.class.php

在370行附近，應該可以看到：
strftime("%Y-%m-%d %H:%M:%S")

這在一行之前，加上：
date_default_timezone_set("Asia/Taipei");

不同時區自行修改 "Asia/Taipei" 內容。

 2.編碼問題
將 [pear 安裝目錄]\data\PhpDocumentor\phpDocumentor\Converters
底下所有檔案拖曳到 Notepad++ 中(檔案多，要等一下)，將所有文件中的「iso-8859-1」取代為「utf-8」即可。

在 netbeans 裡以 PhpDocumentor2 做為 PhpDoc 產生器-4

測試

在 Netbeans 裡，開啟一個新的 Project ，選擇：
PHP -> PHP Application

直接按下 Finish，建立完成。
在 index.php 檔中，將內容修改為以下：

                echo getTestString();

        /**
         * this is a test
         * 這是用來傳回「test」字樣用的數
         * @return string
         */
        function getTestString() {
            date_default_timezone_set("Asia/Taipei");
            echo date_default_timezone_get();
            return "test";
        }

        /**
         * 加法函數，用以計算二個數的相加之後的結果
         *
         * 這是個簡單的加法計算，函數接收二個引數：a, b，再return 他們的和
         *
         * @param int 加數
         * @param int 被加數
         * @return integer 總和
         */
        function Add($a, $b) {
            return $a + $b;
        }
        ?>

存檔後，在 Project  Name (PhpApplication)上，按下右鍵，選擇「Generate PhpDoc」即可。

在 netbeans 裡以 PhpDocumentor2 做為 PhpDoc 產生器-3

開啟 Netbeans (version： 7.1.2，已安裝  PHP plugin)，
Options -> PHP -> PhpDoc

在「PhpDoc script」 欄位中，輸入：
[pear 安裝目錄]\phpdoc.bat

在 netbeans 裡以 PhpDocumentor2 做為 PhpDoc 產生器-2

2. 安裝 PhpDocumentor2
官網： http://www.phpdoc.org/


已安裝 pear 的狀況下，並不需要太複雜的安裝過程，只要在命令模式下，執行以下二個指令即可：

$ pear channel-discover pear.phpdoc.org

$ pear install phpdoc/phpDocumentor-alpha

注意：
1. 需將 pear.bat 加入到系統 path 路徑中。
2. 中間會需要下載檔案、解壓縮等工作，但畫面會都是黑的，一直到下載完成，才會出現下一個畫面，要等一段時間。

如果安裝成功，將會在 pear\data 目錄下，多出一個「PhpDocumentor」的目錄。

在 netbeans 裡以 PhpDocumentor2 做為 PhpDoc 產生器-1

1. 安裝pear
pear 官網： https://pear.php.net/index.php
installation 網頁： https://pear.php.net/manual/en/installation.php
安裝檔： http://pear.php.net/go-pear.phar

這個安裝檔是用 php 寫成的，所以要用 php.exe 直接執行，可以將 php.exe 加到系統 path 路徑裡。
在命令模式中，執行：
php go-pear.phar

出現：
Are you installing a system-wide PEAR or a local copy?
(system|local) [system] :

輸入「local」Enter

再指定各個參數的路徑即可。