在 Windows 下為 PHP 5.4 安裝 PEAR、PHPUnit 及 phpDoc2

php 5.4 的 windows 包中沒有自帶 pear，下載下傳 http://pear.php.net/go-pear.phar 到php目錄，并運作:

<code>php go-pear.phar</code>

安裝完成後php目錄下會産生一個名為 pear.bat 的批處理檔案，并且會在系統中添加以下環境變量(使用者變量，假定php安裝在c:\php):

<code>php_pear_bin_dir=c:\php</code>

<code>php_pear_data_dir=c:\php\data</code>

<code>php_pear_doc_dir=c:\php\docs</code>

<code>php_pear_install_dir=c:\php\pear</code>

<code>php_pear_php_bin=c:\php\php.exe</code>

<code>php_pear_sysconf_dir=c:\php</code>

<code>php_pear_test_dir=c:\php\tests</code>

在寫使用了 php 的批處理腳本時可以好好利用下這些環境變量。

在指令行輸入:

<code>pear version</code>

如果有顯示類似如下資訊，說明 pear 已經成功安裝：

<code>pear version: 1.9.4</code>

<code>php version: 5.4.4</code>

<code>zend engine version: 2.4.0</code>

<code>running on: windows nt acer-tm4750g 5.1 build 2600 (windows xp professional service pack 3) i586</code>

phpunit 3.6 需要 php 5.2.7 (或更改版本) 但強烈推薦使用 php 5.3.9 (或更高版本)。

phpunit 使用pear進行安裝:

<code>pear config-</code><code>set</code> <code>auto_discover 1</code>

<code>pear </code><code>install</code> <code>pear.phpunit.de/phpunit</code>

安裝完成後php目錄下會産生一個名為 phpunit.bat 的批處理檔案。

<code>phpunit --version</code>

如果有顯示類似如下資訊，說明 phpunit 已經成功安裝：

<code>phpunit 3.6.11 by sebastian bergmann.</code>

注意，在 php 官方 pear 頻道上也有兩個 phpunit 的包，名稱分别為 phpunit 和 phpunit2 ，這兩個包都是舊版本，分别是 1.x 和 2.x 的版本，如果你使用下面的方式直接安裝：

<code>pear </code><code>install</code> <code>phpunit</code>

那你安裝的就是為 php 4.x 提供的舊版本 phpunit 1.x 了，要使用最新的 phpunit 3.x 版本，你需要使用 pear.phpunit.de 這個頻道。

使用phpunit:

<code>%php_pear_bin_dir%\phpunit </code><code>test</code><code>.php</code>

phpdocumentor 2 是為php 5.3 或更高版本的所有特性生成 api 文檔而建立。

phpdocumentor 2 同樣使用pear進行安裝:

<code>pear channel-discover pear.phpdoc.org</code>

<code>pear </code><code>install</code> <code>phpdoc/phpdocumentor-alpha</code>

安裝完成後php目錄下會産生一個名為 phpdoc.bat 的批處理檔案。

<code>phpdoc --version</code>

如果有顯示類似如下資訊，說明 phpdocumenter 2 已經成功安裝：

<code>phpdocumentor version 2.0.0a7</code>

使用方法，在要生成文檔的項目所在目錄運作:

<code>%php_pear_bin_dir%\phpdoc -d . -t docs</code>