我常常會用到 PHP 手冊,其中 chm 格式支援了索引和搜尋的功能,是我比較喜歡的查詢方式。可是官方的 chm 手冊更新速度比較慢一點,因此隔一陣子我都會自行編譯 chm 格式的 PHP 手冊。
其實已經有對岸已經有一位名為「深空」的高手寫過這類的文章了,這裡我借用他的步驟,然後依循我自己的風格,重新寫一篇關於正體中文的版本。
需要的軟體
先列出我們會用到的幾個軟體:
- Microsoft HTML Help : 由微軟推出的 chm 製作軟體,這是我們編譯 PHP 手冊必備的工具。
- TortoiseCVS : 用來取得利用 CVS 控制的專案,若已經有其他代用方案的話,不下載也沒關係。
至於這兩個軟體的安裝就不詳述了,因為我懶得抓安裝畫面。
取得 PHP 手冊編譯檔的 CVS 版本
如果已經裝好了 TortoiseCVS ,那麼就透過檔案總管在你想暫時放置編譯檔案的目錄下按滑鼠右鍵,選擇 CVS Checkout 。我以 D:\Workspace 為例:

在接下來的 Checout Module 畫面中,在 CVSROOT 的欄位上輸入:
1
| |
並在 Module 的欄位上輸入:
1
| |

然後按下 OK 。
跟著 TortoiseCVS 就會開始幫我們下載 chm 所需要的英文版編譯檔案。
註:英文版的 PHP 手冊通常會是最新的。

等到 OK 鍵可以按之後,就表示已下載完成。

往後如果需要新的版本,就可以直接在 phpdoc 目錄上按下滑鼠右鍵,選擇 CVS Update 即可更新。

下載 PHP 手冊 HTML 英文版
剛剛的 CVS 編譯檔案只是協助我們能夠編譯而已,而重要的說明檔其實要另外下載。
首先我們要到 PHP 官方網站的手冊下載頁,下載最新的英文版 Many HTML files :

將下載回來的 php_manual_en.tar.gz 解開,裡面會有一個 html 資料夾,把它放到 D:\Workspace\phpdoc\ 目錄下。
開始編譯
打開命令提示列 (cmd.exe) ,切換目錄到 D:\Workspace\phpdoc\ 下,輸入以下指令:
1
| |
這時候編譯程式就開始幫我們編譯 chm 檔案。
註:你要先在系統環境變數 PATH 中指定 php.exe 的路徑。

幾分鐘後,編譯程式就會告訴我們成功的訊息了。

現在,你可以到 D:\Workspace\phpdoc\chm\ 下找到 php_manual_en.chm ,這就是我們編譯好的 chm 格式的 PHP 手冊!
更好的選擇
除了自行編譯 chm 檔案,你還可以直接下載附有更強大功能的 Extended HTML Help 的 chm 格式 PHP 手冊,這個也會常常更新。

它不但擁有 chm 格式的索引及搜尋功能,而且附有 User Notes 與 IDE 整合的功能,如果常參考 PHP 手冊的話,建議直接下載它就可以了。