phpDocumentor是用php語(yǔ)言寫(xiě)的一個(gè)非常強(qiáng)大的文檔自動(dòng)生成工具,利用它可以贊助我們編寫(xiě)規(guī)范的注釋,生成易于理解,結(jié)構(gòu)清晰的文檔,對(duì)我們的代碼升級(jí),維護(hù),移交等都有非常大的贊助

安裝pear

依賴(lài)pear安裝：

首先是查看本身的php.exe同目錄下是否存在pear這個(gè)文件,沒(méi)有下載.

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

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

用治理員權(quán)限運(yùn)行cmd,注意選擇local、按回車(chē)默認(rèn)system然后繼續(xù)

安裝Phpdocumentor

pear list用來(lái)查看pear目錄中是否存在phpdocumentor當(dāng)?shù)匕?/p>

繼續(xù)在dos的php目錄,輸入pear install -a phpdocumentor.(沒(méi)有會(huì)自動(dòng)下載)

此時(shí)會(huì)有以下文件:

輸入phpdoc -h會(huì)有以下提示

用到最多的幾個(gè)參數(shù)：

-f 要進(jìn)行闡發(fā)的文件名,多個(gè)文件用逗號(hào)隔開(kāi)

-d 要闡發(fā)的目錄,多個(gè)目錄用逗號(hào)分割

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

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

測(cè)試：

1.php的內(nèi)容

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

上述命令執(zhí)行完成后：會(huì)在docs文件下的default中生成一個(gè)文件：haha.html

用閱讀器打開(kāi)：