[PHP] Documentor (phpdoc) 備忘

Linux 安裝指令
sudo pear install -o PhpDocumentor


Windows 安裝指令
C:\wamp\bin\php\php5.2.4\pear.bat install -o PhpDocumentor


使用方式

phpdoc --parseprivate \
    --output HTML:frames:earthli \
    --ignore Smarty/ \
    --directory /var/www/lib,/var/www/data_mod,/var/www/etc \
    --target /var/www/docs

phpdoc 參數說明

-f	--filename	要解析的檔案名稱，可使用 ‘,’分隔多個檔案 “file1,file2”，可以包含完整路徑和使用 * ? 萬用符號。
-d	--directory	要解析的目錄路徑，可使用 ‘,’分隔多個目錄路徑 “directory1，directory2”。
-t	--target	指定要輸出的目錄。
-i	--ignore	要忽略的檔案名稱，可使用 ‘,’分隔多個檔案 “file1,file2”，可以使用 * ? 萬用符號。
-is	--ignoresymlinks	忽略系統連結的檔案或目錄，預設是關閉的。
-it	--ignore-tags	忽略解析的標籤。 @package, @subpackage, @access, @ignore 可能是無法忽視。
-q	--quiet	不顯示解析/轉換的訊息，在 cron 排程時可以選擇開啟，預設是關閉的。
-ti	--title	產生出的文件的標題，預設為 ‘Generated Documentation’。
-h	--help	顯示幫助訊息。
-pp	--parseprivate	將私有(private)成員函式或私有變數也都加入程式文件裡。不然產生出的文件裡只會有公開(public)和保護(protected)的成員函式和變數。
-o	--output	設置輸出文件的格式
HTML:frames:* - 包含iframe的HTML格式 HTML:frames:default – Javadoc風格的文檔模板，很少有格式 HTML:frames:earthli – 漂亮的模板（作者：Marco von Ballmoos） HTML:frames:l0l33t – 流行模板 HTML:frames:phpdoc.de – 類似於phpdoc.de的PHPDoc輸出 HTML:frames:phphtmllib – 非常棒的用戶貢獻模板 HTML:frames:phpedit – 基於PHPEdit Help Generator的文檔 HTML:Smarty:* - 不使用iframe的HTML格式 HTML:Smarty:default – 使用css控制的黑體模板 HTML:Smarty:HandS – 基於PHP的格式，但是經過優化，帶有logo圖片 HTML:Smarty:PHP – 風格接近PHP官網 CHM:default:* - 輸出CHM幫助文檔 CHM:default:default – windows幫助文檔，基於HTML:frames:l0l33t PDF:default:* - PDF格式 PDF:default:default – 標準純文本PDF格式 XML:DocBook:* - 以DocBook格式輸出的XML XML:DocBook/peardoc2:default – 可以被編譯成peardoc的文檔
-j	--javadocdesc	相容 JavaDoc 的格式，預設是關閉的

中文亂碼的問題
新版的 phpdoc 輸出的格式已經是 UTF-8 了，所以只要在目錄下增加一個 .htaccess 文件，然後內容為：
AddCharset UTF-8 .html


參考文件：
多采多姿的程式筆記: phpDocumentor筆記 - 0 立即體驗
phpDocumentor Tutorial
phpDocumentor学习记录