Thanks, Facebook developers: phpsh is nice.
It needs a file that describes your project, to give you fast access to your function docs. The file is generated by exuberant ctags. (sudo port install ctags.) To avoid warnings when generating the tags file: let ctags recurse, and ignore the non-PHP languages in your source tree:
$ ctags -R --languages=-JavaScript,Python
Now, you’re supposed to be able to do:
php> d my_func
[{'type': 'f', 'context': 'function my_func($cmd, $row = 0) {', 'file': 'thatfile.php'}]
/Users/olle/svn/project/web/some_functions.php, lines 98-101:
/**
* return one row, the first by default, as an array
*/