phpDocumentor是用php語言寫的一個非常強大的文檔自動生成工具,利用它可以贊助我們編寫規范的注釋,生成易于理解,結構清晰的文檔,對我們的代碼升級,維護,移交等都有非常大的贊助

安裝pear

依賴pear安裝：

首先是查看本身的php.exe同目錄下是否存在pear這個文件,沒有下載.

http://pear.php.net/go-pear.phar下載另存為go-pear.phar文件

這個文件放到php.exe地點的PHP安裝目錄下,我這里安裝目錄是D:\wamp64\bin\php\php5.6.25\

用治理員權限運行cmd,注意選擇local、按回車默認system然后繼續

安裝Phpdocumentor

pear list用來查看pear目錄中是否存在phpdocumentor當地包

繼續在dos的php目錄,輸入pear install -a phpdocumentor.(沒有會自動下載)

此時會有以下文件:

輸入phpdoc -h會有以下提示

用到最多的幾個參數：

-f 要進行闡發的文件名,多個文件用逗號隔開

-d 要闡發的目錄,多個目錄用逗號分割

-t 生成的文檔的寄存路徑

-o 輸出的文檔格式,布局為輸出格式：轉換器名：模板目錄.

測試：

1.php的內容

phpdoc -o HTML:frames:earthli -f D:\wamp64\www\one\1.php -t docs

上述命令執行完成后：會在docs文件下的default中生成一個文件：haha.html

用閱讀器打開：