玩转PMan

标签: Technical PHP Shell | 发表时间:2011-09-07 17:49 | 作者:老王 学
出处:http://huoding.com

所谓PMan,指的是PHP Man Pages,可以通过它方便的在命令行上查看PHP文档。

安装

假设你的系统已经存在pear命令了,那么接下来就是一招鲜了:

shell> pear install doc.php.net/pman

安装好后使用非常方便,就和Linux下常见的man命令一样的用法:

shell> pman strlen

显示效果上也和man命令一样,如下图所示:

PMan Command

PMan Command

扩展

以前我习惯于使用CHM格式的PHP文档,因为它的检索功能很方便,只要记住开头几个字母就能查到想要的内容,可惜坏消息是PMan在这方面比较衰,但是好消息是不用重复发明轮子,bash-completion已经实现了我们想要的大部分功能。

下面以CentOS为例(其它Linux可能有差异),前提是先安装EPEL,然后执行命令:

shell> yum install bash-completion

缺省会安装不少现成的bash-completion脚本,可以参考它们实现PMan的对应脚本:

shell> cat /usr/share/bash-completion/pman
# pman(1) completion

have pman &&
_pman()
{
    local cur manpath

    COMPREPLY=()

    cur="${COMP_WORDS[COMP_CWORD]}"

    manpath="$(tail -n 1 $(which pman))"
    manpath="$(echo ${manpath%/*} | awk '{print $NF}')"

    if [ -n "$cur" ]; then
        COMPREPLY=($manpath/man*/$cur*)
    else
        COMPREPLY=($manpath/man*/*)
    fi

    COMPREPLY=(${COMPREPLY[@]##*/})
    COMPREPLY=(${COMPREPLY[@]%.*.*})

    COMPREPLY=($(compgen -W '${COMPREPLY[@]}' -- "$cur"))

    return 0
} &&
complete -F _pman pman

接着还需要在指定目录做一个软连接以便激活脚本:

shell> ln -s /usr/share/bash-completion/pman /etc/bash_completion.d/pman

重新登录后,PMan就拥有按TAB键提示的功能了,如下图所示:

PMan Bash Completion

PMan Bash Completion

技巧

VIM是命令行下最常用的编辑器之一,PMan和VIM可以完美结合,在命令模式下键入如下指令,就可以即时显示函数的文档内容:

:!pman strlen

实际上还可以更方便些,编辑VIM配置文件,加入keywordprg设置:

shell> cat ~/.vimrc
set keywordprg=pman

打开PHP文件后,把光标移动到某个函数下,按大写的K键即可查看函数的文档内容。

注:如果想退出文档界面,回到VIM界面,只需连按两次q键即可。

相关 [pman] 推荐:

玩转PMan

- 学 - 火丁笔记
所谓PMan,指的是PHP Man Pages,可以通过它方便的在命令行上查看PHP文档. 假设你的系统已经存在pear命令了,那么接下来就是一招鲜了:. 安装好后使用非常方便,就和Linux下常见的man命令一样的用法:. 显示效果上也和man命令一样,如下图所示:. 以前我习惯于使用CHM格式的PHP文档,因为它的检索功能很方便,只要记住开头几个字母就能查到想要的内容,可惜坏消息是PMan在这方面比较衰,但是好消息是不用重复发明轮子,bash-completion已经实现了我们想要的大部分功能.

pman – 官方的PHP Man,热爱命令行的PHP程序员有福了

- Platinum - Chen Ze的日志
有unix/linux开发或者管理经验的程序员或者系统管理员都知道man是超级好用的一个命令. 例如man malloc就可以看到malloc函数的用法,而man ssh则可以看到ssh客户端的各个参数的详细说明. 因为觉得man非常好用,所以我很早之前就想写一个php man,但是一直都没去做. 07还是08年我写过一个php的ctags,通过解析php的html文档来生成tags文件,使得可以在vim方便地查看php函数定义.