ThinkPHP5的完全手册我翻过不下二十遍，每次都有新发现。手册这不是完全客套话——去年排查一个诡异的缓存问题，最后定位到是手册Request::instance()在命令行下返回了null，手册里一行小字写着“CLI模式下需手动绑定”，完全我当时就想摔键盘。手册

官方文档写得像本字典，完全按字母排序那种。手册可真正用起来，完全你得知道where和whereOr的手册优先级陷阱，知道paginate()在关联查询时会多出几条废SQL。完全这些坑手册里都有，手册但藏得深，完全像老父亲藏私房钱。手册

我最喜欢的完全是它的事务嵌套处理。别的框架搞个事务得小心翼翼，TP5直接Db::transaction(function(){ })，闭包里再套一个，内部自动帮你处理了保存点。这设计干净得让人想给作者递烟。但注意，别在闭包里用return false想回滚——手册没明说，实际上你得抛异常才能触发回滚，这个我踩了整整一个下午。

路由这块儿，手册把规则讲得清清楚楚，但实际项目里最有用的是route('blog/read', ['id'=>1])这种反向生成。我以前写死URL，后来改了路由规则，整站链接全废了。现在学乖了，所有跳转都用路由方法，改规则只动一处。手册里叫“URL生成”，这功能救了我的命。

模型事件也是个好东西。我做个文章系统，每次浏览量加一得更新缓存。直接在模型里挂个afterRead事件，比在控制器里到处写Cache::set()干净得多。手册里给了个例子是修改时间戳，实际场景比这复杂多了——但你理解了机制，就能玩出花来。

有人嫌TP5手册太干，全是代码块和参数表。我倒觉得这才实在，框架文档要什么花活？有个晚上我调分页样式，翻到分页类源码，发现它继承了think\paginator\driver\Bootstrap，手册里只提了句“可自定义驱动”，我就照着写了个微信小程序风格的分页。这种“留白”反而是手册最妙的地方——它告诉你地基在哪，楼怎么盖你随意。

最后说个冷知识：手册附录里有完整的错误码对照表。有次生产环境报了个10501，我百度半天没结果，翻手册附录两秒定位是“模板标签错误”。从那以后，我遇到异常先查附录，比搜索引擎靠谱多了。

TP5手册不完美，有些章节写得像天书，比如容器和依赖注入那章我看了六遍才懂。但它的价值在于实在——每个函数都标了参数类型和返回值，每个方法都有示例代码。这年头，肯把文档写到这个份上的框架不多了。