thinkphp5官网
打开 thinkphp.cn 的官网文档页面，5.0 和 5.1 的官网版本号并排挂着，像两本被翻旧了的官网手册。ThinkPHP5 的官网官网从来不是那种花哨的产品站，它更像一个工具箱——你要找的官网钩子、行为、官网路由规则，官网全在左侧导航栏里排着队。官网我第一次用 TP5 是官网 2017 年，那时候官网文档里「架构」章节还写着「模块化设计」几个字，官网点进去全是官网目录树，没有一句废话。官网
官网首页最显眼的官网位置给了「快速入门」。点进去，官网第一段代码是官网 composer create-project topthink/think tp5。这个命令到现在还能跑，虽然 Composer 的版本已经换了好几轮。TP5 的安装方式在当时算激进的——放弃了自己那套下载解压的流程，全面拥抱 Composer。好处是依赖管理清爽了，坏处是很多从 TP3 转过来的开发者卡在命令行那一步。官网文档里专门有一节「Composer 安装」，配了截图，但截图里的终端窗口还是 Windows 7 的样式，蓝底白字，有点年代感。
文档的写法很「中国本土框架」。它不跟你绕弯子，比如讲路由，直接甩出 Route::get('hello/:name', 'index/hello')，然后告诉你访问 /hello/thinkphp 就能看到输出。没有长篇大论的原理铺垫，先跑起来再说。这种风格贯穿整个官网——控制器、模型、视图、模板引擎，每个章节都是「配置项 + 代码示例 + 注意事项」的三段式。你翻多了会发现，有些示例代码里的注释比正文还长，比如模型关联那一节，注释里写着「这里用 hasMany 而不是 belongsTo，因为一篇文章有多条评论」，这种口语化的解释在官方文档里不多见。
官网的搜索功能是个痛点。你想找 fetchSql 的用法，搜出来的结果里混着 3.2 和 5.0 的文档，版本切换的按钮藏在页面右下角，不太显眼。我见过有人在论坛里抱怨，说搜「软删除」出来的全是 TP3.2 的 delete_time 配置，而 TP5 已经改成了 useSoftDelete 属性。这种版本割裂感在 5.0 和 5.1 之间更明显——5.1 把很多 5.0 的写法标记为「废弃」，但官网没有提供一个统一的迁移对照表，你得自己翻两个版本的文档来回比对。
扩展库那块值得单独说。TP5 官网有个「扩展」频道，里面列着官方出的 think-captcha、think-queue 这些包。每个包的文档页都很短，基本就是「安装 → 配置 → 使用」三步。但有些包的最后更新日期停在 2018 年，比如 think-image，下面的评论里有人问「PHP 7.4 能用吗」，没人回复。这种半维护状态在开源项目里常见，不过官网没有标注「已停止维护」的标签，新用户容易踩坑。
社区入口在导航栏最右边，点进去是论坛和问答。论坛的帖子质量参差不齐，置顶的「新手提问规范」里写着「不要直接贴报错截图」，但下面照样有人贴。有意思的是，官方开发团队成员偶尔会出现在问答区，回复通常很短，比如「看文档 路由章节 第三段」，语气直接，不客套。这种风格和官网文档一脉相承——能一句话说清的事，不写一段。
TP5 官网的移动端适配做得一般。在手机上打开文档，代码块会横向溢出，得左右滑动才能看全。侧边栏的折叠菜单反应有点慢，点一下要等半秒才展开。不过话说回来，真有人用手机写 TP5 代码吗？可能只是查个函数名。官网的「函数参考」页面倒是挺全，request()、db()、config() 这些助手函数的参数列表和返回值都列得清楚，比翻源码快。
最后提一个细节：官网底部写着「ThinkPHP 遵循 Apache2 开源协议」，下面还有一行小字「2006-2023」。这个年份跨度说明它活得够久，也说明文档里沉淀了太多历史痕迹。你读 5.0 的「升级指导」时，能看到从 3.2 升上来的注意事项，那些 namespace 的改动、Loader 的废弃，都是真实项目里踩过的坑。官网没有把这些旧内容藏起来，而是按版本归档，这点比很多框架的官网做得好——你知道去哪里找旧东西，也知道新东西在哪。