在 WampServer 安裝 PEAR

阿恆

若果只用一句說話來解釋 PEAR，它是一個用來發佈和管理 PHP 可再用元件的系統，若果你還是不懂，下面有更詳細的說明，暫時你明白 PEAR 對 PHP 開發工作非常重要便夠了。很可惜的是 WampServer 並不包括 PEAR，所以我們需要手動安裝，幸好整個過程只需兩、三分鐘，讓我們看看應該怎樣做。

PEAR 是甚麼？

PHP Pear PEAR 是 PHP Extension and Application Repository 的縮寫，即「PHP 擴展與應用庫」，英文 pear 是梨子的意思，這便成了 PEAR 的標誌。

根據 PEAR 官方文件，它的目的是：

  • 一個為 PHP 開發人員而設的結構性開放源碼庫
  • 一個程式碼發佈和軟件包維護系統
  • 一個 PHP 程式碼的標準風格
  • PECL (PHP Extension Community Library - PHP 擴展元件庫)
  • 支援 PHP / PEAR 的網站、電郵名冊、和下載鏡像網站

很多極受歡迎的軟件包都是透過官方的 PEAR 網站或者自設的 PEAR 頻道發佈，例如大名鼎鼎的 PHPUnit (一個單元測試的工具)、Text_CAPTCHA (一個用來測試網站訪客是否真人的工具) 等等。若果沒有用過 PEAR，建議你現在便到官方網站瀏覽一下，也可直接查看軟件包列表，你下一個要編寫的功能很有可能已經有前輩高手替你做好了。

安裝在哪兒？

PEAR 和它包含的軟件包都不是 Windows 的應用程式，所以不會安裝在 c:\program files\ 之類的目錄內。

一般人會把它安裝在 c:\pear\，也有人喜歡把它安裝在 WampServer 的安裝目錄內 (即 c:\wamp)，這些都是合理的選擇。

網上有些人把 PEAR 安裝在 PHP 的安裝目錄內 (例如 C:\wamp\bin\php\php5.3.9)，我認為不理想，因為 PEAR 變成與特定版本的 PHP 掛鉤了，令將來升級 PHP 做成一定的麻煩。

有些人把 PEAR 安裝在網站的 document root 之下，這也未嘗不可，但須注意把 PEAR 的安裝目錄設定為無法瀏覽 (透過 .htaccess)。

我個人把 PEAR 安裝在 WampServer 安裝目錄裏面的 PEAR 子目錄，即 c:\wamp\pear\，以下的解說即以此為基礎，你可以選擇自己喜歡的安裝位置，只要把適當地更改我的例子中的目錄便可以了。

安裝過程

為了方便解說，我假設你已經安裝了 WampServer，安裝目錄是 c:\wamp\。若果你尚未安裝 WampServer，可以瀏覽「在 Windows 7 安裝 WampServer」。

  1. 首先請在 c:\wamp\ 中新增子目錄 pear。

  2. 然後從 PEAR 官方網站下載安裝程式 go-pear.phar，這個程式本身由 PHP 寫成，若果你沒有安裝 WampServer 或者任何 PHP 系統，將無法使用 PEAR。請把 go-pear.phar 儲存在 c:\wamp\pear\。

  3. 檢查你正在使用的 PHP 版本。請在瀏覽器輸入網址 http://localhost/，你將會見到類似下面的頁面，紅框的地方便是正在使用的版本。你的版本數字可能不同，請在後面的程序中自行替換適當的版本數字。 Check PHP Version

  4. 開啟 DOS 視窗。在屏幕的左下角按「開始」鍵，在搜尋欄輸入「cmd」，然後按 Enter。

  5. 輸入「cd c:\wamp\pear\」進入 PEAR 安裝目錄，然後輸入「C:\wamp\bin\php\php5.3.9\php go-pear.phar」。 Start go-pear.phar

  6. 安裝程式首先問你要進行系統性安裝還是局部安裝，請輸入「local」後按 Enter，安裝程式要求你確認 (的確有點囉嗦)，請輸入「yes」然後再按 Enter。兩者的分別在於設定檔案 pear.ini 放在甚麼地方，系統性安裝的話 pear.ini 儲存在 c:\windows\，局部安裝的話則儲存在 c:\wamp\pear，在 WampServer 這種純粹個人使用的開發環境，兩者沒有分別。但須注意在 Windows 7 中，c:\windows\ 是受保護的系統目錄，PEAR 安裝程式無法寫入，雖然有解決辦法，但既然兩者沒有實質的分別，我們便選用局部安裝 (local) 好了。 Pear install system or local

  7. 跟著安裝程式要求你確認 12 項目錄設定，必須確保所有項目都不是空白的，尤其是第 12 項 (Path to CLI php.exe) 不能空白。一般來說預設的目錄都可以接受，只需要補充空白的項目便可以了。當一切都輸入好後，按 Enter 繼續。 Pear specify directories

  8. 安裝程式開始安裝 PEAR 檔案，這包括了設定檔 pear.ini，5 個預裝的軟件包 - Archive_Tar、CConsole_Getopt、Structures_Graph、XML_Util、和 PEAR。 Pear install complete

  9. 安裝程式替你修改了 php.ini，在變量 include_path 增加了目錄 c:\wamp\pear，可惜的是它弄錯了真正的 php.ini，WampServer 使用 C:\wamp\bin\apache\Apache2.2.21\bin\php.ini，但是安裝程卻修改了 c:\wamp\bin\php\php5.3.9\php.ini，所以你需要手動修改 C:\wamp\bin\apache\Apache2.2.21\bin\php.ini 中的 include_path 變量，若果這個變量已經設定，可以加上 c:\wamp\pear\pear，若果這個變量尚未設定，便把它設定為 .;c:\wamp\pear\pear。其實也難怪的，因為當我們用命令行執行 PHP 時，它的確使用 c:\wamp\bin\php\php5.3.9\php.ini，不過當透過 Apache 執行時，卻使用 C:\wamp\bin\apache\Apache2.2.21\bin\php.ini。 Pear include path

  10. 現在要告訴 PEAR 你的 php.ini 放在哪兒 (應該在 c:\wamp\pear)，若果你用 Windows 7 的話，請到 Control Panel -> System and Security -> System，點選 Advanced system settings，然後選擇 Advanced 分頁，在近底部有一個 Environment Variables 按鈕，點選後便可以設定系統環境變量。舊版本的安裝程式會產生一個設定 Windows Registry 的檔案，只需執行這個檔案便自動設定好環境變量，但是在新版本的安裝程式卻要我們手動設定。 Pear PHP_PEAR_SYSCONF_DIR

  11. 最後這一步可以不做，就是把 PEAR 的安裝目錄加入 Windows 的 PATH 環境變量中，這樣你便可以隨時在命令行輸入 pear 來執行 PEAR 主程式。

你在 Windows 7 和 WampServer 的環境中安裝 PEAR 是否順利？遇到了甚麼問題沒有？你怎樣解決這些問題？歡迎提出來分享。