我把產生出來的php manaul tags分享出來 phpdoc-20110526.tar.gz，需要又懶得自已動手的人歡迎下載回去用。
網路上提供的tags都太舊了，所以就自已動手產生吧！我今天在FreeBSD上做了一遍，現在用Mac寫文章，所以這邊就以Mac的環境說一下流程，我不太清楚Mac OS X Server和XCode預設裝了哪些東西，所以我把環境列上來提供參考：
操作環境
Mac OS X Server v10.6.7
XCode 4.0.2
PHP 5.3.4
一、安裝PEAR
Mac OS X Server出廠就有LAMP stack的環境了，但PHP沒編--with-pear，所以要自已裝，基本上是照著pear官網的文件，但我沒有加-d detect_unicode=0。
$ curl http://pear.php.net/go-pear.phar > go-pear.phar $ sudo php -q go-pear.phar Below is a suggested file layout for your new PEAR installation. To change individual locations, type the number in front of the directory. Type 'all' to change all of them or simply press Enter to accept these locations. 1. Installation base ($prefix) : /usr/local 2. Temporary directory for processing : /tmp/pear/install 3. Temporary directory for downloads : /tmp/pear/install 4. Binaries directory : /usr/local/bin 5. PHP code directory ($php_dir) : /usr/local/share/pear 6. Documentation directory : /usr/local/docs 7. Data directory : /usr/local/data 8. User-modifiable configuration files directory : /usr/local/cfg 9. Public Web Files directory : /usr/local/www 10. Tests directory : /usr/local/tests 11. Name of configuration file : /Users/gasol/.pearrc 1-11, 'all' or Enter to continue:預設會裝在個人的home目錄，這邊我把prefix改成/usr/local，如果是裝在別的地方，注意一下PATH要找的到pear，最後會詢問是否要在php.ini把pear的路徑加在include_path。
裝完再用pear裝待會兒會用到的PhD和XML_Parser
$ sudo pear install doc.php.net/phd_php Did not download optional dependencies: phpdocs/PhD_PEAR, phpdocs/PhD_IDE, use --alldeps to download automatically phpdocs/PhD_PHP can optionally use PHP extension "haru" phpdocs/PhD can optionally use package "phpdocs/PhD_PEAR" phpdocs/PhD can optionally use package "phpdocs/PhD_IDE" phpdocs/PhD can optionally use PHP extension "haru" phpdocs/PhD_Generic can optionally use PHP extension "haru" downloading PhD_PHP-1.1.0.tgz ... Starting to download PhD_PHP-1.1.0.tgz (24,067 bytes) ........done: 24,067 bytes downloading PhD-1.1.0.tgz ... Starting to download PhD-1.1.0.tgz (42,303 bytes) ...done: 42,303 bytes downloading PhD_Generic-1.1.0.tgz ... Starting to download PhD_Generic-1.1.0.tgz (28,104 bytes) ...done: 28,104 bytes install ok: channel://doc.php.net/PhD_Generic-1.1.0 install ok: channel://doc.php.net/PhD-1.1.0 install ok: channel://doc.php.net/PhD_PHP-1.1.0 $ sudo pear install XML_Parser downloading XML_Parser-1.3.4.tgz ... Starting to download XML_Parser-1.3.4.tgz (16,040 bytes) ......done: 16,040 bytes install ok: channel://pear.php.net/XML_Parser-1.3.4詳細安裝方式可以參考 https://wiki.php.net/doc/phd/install。
二、從SVN Repository產生PHP Documentation.
svn co http://svn.php.net/repository/phpdoc/modules/doc-en phpdoc
... ignore ...
A phpdoc/en/features/figures/simple-array.png
A phpdoc/en/features/figures/simple-array2.png
A phpdoc/en/features/figures/leak-array.png
A phpdoc/en/features/commandline.xml
A phpdoc/en/features/sessions.xml
A phpdoc/en/features/gc.xml
A phpdoc/en/features/remote-files.xml
A phpdoc/en/features/cookies.xml
A phpdoc/en/features/http-auth.xml
A phpdoc/en/features/xforms.xml
U phpdoc/en
Checked out external at revision 311445.
Checked out revision 311445.
會clone一堆xml下來，接著執行./build.sh$ cd phpdoc phpdoc/ $ ./build.sh configure.php: $Id: configure.php 310808 2011-05-06 16:11:39Z bjori $ PHP version: 5.3.4 LibXML 2.7.4+ added a 'feature' to break things, typically namespace related, and unfortunately we must require it. For a few related details, see: http://www.mail-archive.com/debian-bugs-dist@lists.debian.org/msg777646.html Please recompile PHP with a LibXML version 2.7.4 or greater. Version detected: 2.7.3 Or, pass in --disable-libxml-check if doing so feels safe. Checking for source directory... /Users/gasol/tmp/phpdoc/doc-base Checking for output filename... /Users/gasol/tmp/phpdoc/doc-base/.manual.xml Checking whether to include CHM... no Checking for PHP executable... /usr/bin/php Checking for language to build... en Checking whether the language is supported... yes Checking for partial build... no Checking whether to enable detailed XML error messages... yes Checking libxml version... 2.7.3 Checking whether to enable detailed error reporting (may segfault)... yes Checking whether to optimize out the DTD (performance gain, but segfaults)... yes Generating /Users/gasol/tmp/phpdoc/doc-base/manual.xml... done Generating /Users/gasol/tmp/phpdoc/doc-base/install-unix.xml... done Generating /Users/gasol/tmp/phpdoc/doc-base/install-win.xml... done Generating /Users/gasol/tmp/phpdoc/doc-base/developer.template.xml... done Generating /Users/gasol/tmp/phpdoc/doc-base/entities/version.ent... done Generating /Users/gasol/tmp/phpdoc/doc-base/scripts/file-entities.php... done Iterating over extension specific version files... OK Saving it... OK Creating file /Users/gasol/tmp/phpdoc/doc-base/entities/file-entities.ent... done Checking for if we should generate a simplified file... no Checking whether to save an invalid .manual.xml... no Loading and parsing manual.xml... done. Validating manual.xml... done. All good. Saving .manual.xml... done. All you have to do now is run 'phd -d /Users/gasol/tmp/phpdoc/doc-base/.manual.xml' If the script hangs here, you can abort with ^C. (Run `nice php configure.php` next time!) PHP will segfault now :) - Don't worry though, the .manual.xml has been saved :D [23:42:04 - Heads up ] Creating output directory.. [23:42:04 - Indexing ] Indexing... [23:44:02 - Indexing ] Indexing done [23:44:02 - Rendering Style ] Running full build [23:44:03 - Rendering Format ] Starting PHP-Chunked-XHTML rendering [23:46:30 - Rendering Format ] Writing search indexes.. [23:46:30 - Rendering Format ] Index written [23:46:30 - Rendering Format ] Finished rendering結束後就可以看到日期是今天最新的PHP Documentation.
三、把HTML轉換成VIM helptags
到作者的網頁下載Parser，這隻script年代有點久遠，所以我加了
點料
patch讓它可以順利執行
在phpdoc的上一層目錄執行parser2.php
$ curl http://blog.planetxml.de/uploads/source/php/phpdoc/parser2.php.txt > parser2.php $ patch -p1 < parser2.diff patching file parser2.php Hunk #1 succeeded at 344 with fuzz 1. $ mkdir out $ php parser2.php recursing into phpdoc/en/reference/mcrypt/functions/.svn/tmp/props recursing into phpdoc/en/reference/mcrypt/functions/.svn/tmp/text-base recursing into phpdoc/en/reference/mcrypt/functions/.svn/tmp recursing into phpdoc/en/reference/mcrypt/functions/.svn processing phpdoc/en/reference/mcrypt/functions/mcrypt-cbc.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-cfb.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-create-iv.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-decrypt.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-ecb.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-get-algorithms-name.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-get-block-size.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-get-iv-size.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-get-key-size.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-get-modes-name.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-get-supported-key-sizes.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm-mode.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-is-block-algorithm.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-is-block-mode.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-enc-self-test.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-encrypt.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-generic-deinit.xml processing phpdoc/en/reference/mcrypt/functions/mcrypt-generic-end.xml processing phpdoc/en/reference/zlib/functions/gzwrite.xml processing phpdoc/en/reference/zlib/functions/readgzfile.xml processing phpdoc/en/reference/zlib/functions/zlib-get-coding-type.xml recursing into phpdoc/en/reference/zlib/functions recursing into phpdoc/en/reference/zlib sorting tags這邊時間要久一點，
四、設定VIM
把上一步在out目錄產生的所有檔案搬到$HOME/.vim/doc，有用pathogen的話要把pathogen#helptags()拿掉，它會自動執行helptags把tags檔覆蓋過去，我個人是用pathogen擺在$HOME/.vim/bundle/phpdoc/doc底下，接著在.vimrc加上一行autocmd BufNewFile,BufRead *.php set keywordprg="help"就大功告成了！
最後，開一個php檔到處在funciton按K測試看看吧，在沒有雙瑩幕的環境，用這方法看manual可以結省不少切換視窗的時間，helptags的應用可以參考李果正 - 大家來學VIM 12.5.2節。
