同事贴来一段报错,说函数参数顺序记不清,问我要手册链接。我一般直接回 php.net,后面接函数名,比如 php.net/strlen,浏览器会跳到对应页面。
php手册这个说法容易让人以为是某个本地文件,其实它指的是官网那套在线文档,中文版只是其中一部分。路径是 php.net/manual/zh/,函数页左侧是签名、参数说明、返回值、范例,底下还有用户留言。签名那行最值得看,哪个参数必填、哪个可选、默认值是多少,全写在那里。函数名记不全,搜索框里写 site:php.net 加关键词,能跳过一堆搬运站。
中文版的进度会慢半拍
中文翻译靠志愿者维护,新函数或者改过行为的页面,可能还停留在英文。看到页面顶部提示翻译未完成,就切到英文版对照,签名和范例基本不用读长句也能懂。
不确定某个函数在当前版本还在不在,翻页面上的版本标记,或者用 php -r 跑一行测试。手册写的是行为,不是你机器上的实际环境。国内不少镜像站抄的是几年前的版本,函数行为已经改过,照抄会踩坑。收藏夹里留官网一个地址就够,其余来源只当参考。
离线包适合没网的时候
官网提供 php手册 的打包下载,有单文件 HTML 和 chm 两种,体积不小,适合经常出差或者内网开发的人。chm 在 Windows 上双击就能开,缺点是搜索只覆盖标题,全文检索不如网页版好用。
我自己的做法是留一份 HTML 包在本地,再在 IDE 里配手册地址,选中函数按快捷键直接跳页面。PhpStorm 的设置里能填这个地址,填一次管很久。下载前看一眼打包日期,太旧的包不如不看。
用户留言要看,但别照抄
每个函数页底部的用户贡献笔记,常有边界情况的补充,比如空字符串返回值、64 位系统上的溢出。这些内容没有官方审核,年份可能很早,看到依赖旧版本的写法要先验证。判断取舍:查函数签名用网页版最快,写复杂逻辑以官方示例为准,用户笔记只当线索。手册不会告诉你业务该怎么写,它只保证这个函数在你这个版本上干什么。