自己用PHP5.5已经有段时间了,由于本人很懒,一直也没去更新Vim中的PHP离线手册,到前几天为止都还停留在PHP5.3的版本,内容过时,加之原来的手册排版较乱,不太直观,于是抽了个时间自制了一份格(个)式(人)漂(喜)亮(好)的PHP5.5的函数手册,用于在Vim中作为帮助文档方便离线查看。顺便打包了个Vim插件,同时也加入了快捷查看在线手册的功能,有需要的同学可以下载回来使用。插件的地址在 https://github.com/alvan/vim-php-manual

生成手册的脚本自然用的是PHP,调用系统命令w3m辅助排版,再处理后输出适合在Vim中查看的帮助文档和标签文件。具体的操作步骤如下:

  1. http://php.net/get/php_manual_en.tar.gz/from/a/mirror 下载最新的多文件版本的PHP手册;
     
  2. 解压下载回来的压缩包,将目标目录重命名为src/,和doc.php文件放在同一级目录下;
     
  3. 安装w3m,Ubuntu下通常只需要在终端执行:
    sudo apt-get install w3m
  4. 在终端运行命令:
    php doc.php

    如无意外,会生成一个doc/目录,手册相关的文件就都在里面了;

  5. 最后一步是打开Vim,编辑doc/tags,执行:%sort排序之后:wq保存并退出即可。
     

手册生成完毕之后,在Vim中编辑PHP文件时,只需要按<Shift-k>即可打开帮助窗口浏览当前光标下的内容相关的文档。
附上使用截图: