thinkphp 8.0手册是基于代码即文档理念的活体知识系统，核心配置在config/目录，扩展须通过composer安装并遵循psr-4规范，偏离标准路径将导致服务注册失败或类加载报错。
ThinkPHP 8.0手册不是翻页式PDF文档，而是以代码即文档为核心理念的活体知识系统——扩展必须通过Composer安装、自定义组件需遵循PSR-4命名空间规范、配置项必须写入对应config目录而非硬编码，任意一步偏离标准路径，就会导致服务注册失败或类自动加载报错。
查手册不如查源码：定位核心配置与扩展入口
打开项目根目录下的config/文件夹，这里就是手册的物理载体。所有框架行为都由该目录下文件控制：app.php决定应用模式，route.php管理全局路由，annotation.php开关注解功能，middleware.php声明中间件顺序。不要在控制器里写配置，也不要在bootstrap.php里覆盖config值——这些操作会绕过框架配置合并机制，导致后续命令行工具（如php think route:list）读取不到真实配置。
进入vendor/topthink/thinkphp/src/目录，这才是真正的“手册源码”。比如想确认Cache::tag()是否支持TP8，直接搜TagCache类；想知道validate()方法参数规则，打开Validate.php看check()方法签名。官方手册滞后于代码，而源码永远准确。
安装官方扩展：think-annotation与think-multi-app
方法一：注解路由扩展
执行composer require topthink/think-annotation，安装完成后检查config/annotation.php是否存在且'route' => ['enable' => true]已启用。若无此文件，运行php think annotation:publish生成默认配置。
方法二：多应用扩展
【不装这个扩展，整个多应用流程就无法启动】。执行composer require topthink/think-multi-app，然后手动检查config/app.php中providers数组末尾是否包含 hinkmultiAppServiceProvider::class。漏掉这行，框架压根不会识别app/admin子目录。
方法三：验证扩展是否生效
运行php think list，观察输出中是否出现annotation:或multi-app:命令前缀。没有则说明扩展未正确注册，此时不要继续配置路由或域名绑定，先回退检查composer autoload和provider注册。
开发自己的扩展包：从零创建可复用组件
第一步：初始化项目结构
新建目录my-thinkphp-extension/，内部按标准PSR-4布局：src/YourService.php、composer.json、README.md。
第二步：编写composer.json关键字段
确保"require": {"php": ">=8.0.0", "topthink/framework": "^8.0"}，"autoload": {"psr-4": {"MyExtension\": "src/"}}。命名空间前缀MyExtension\必须与src/下实际目录结构严格对应，否则自动加载失败。
第三步：注册服务提供者
在src/Provider.php中继承thinkService，重写register()方法绑定容器实例，再在composer.json的"extra"字段添加"think-service-provider": "MyExtension\Provider"。这一步不做，你的服务永远不会被框架感知。
第四步：本地测试安装
回到主项目根目录，执行composer config repositories.myext path ./path/to/my-thinkphp-extension，再运行composer require my-name/my-package:dev-main。成功后php think list应出现你定义的命令。
自定义中间件与验证器：嵌入框架生命周期
中间件必须放在app/middleware/目录下，类名需与文件名一致，且实现thinkMiddlewareInterface。例如app/middleware/AuthCheck.php内容必须是class AuthCheck implements MiddlewareInterface。命名空间写成appmiddleware，不能写AppMiddleware——大小写敏感，框架只认小写app前缀。
验证器类必须继承thinkValidate，并放在app/validate/目录（单应用）或app/index/validate/（多应用）。若验证器类名为UserValidate，对应文件必须是UserValidate.php，且命名空间为app alidate。调用时用validate('User')，框架会自动拼接命名空间并加载，写错路径或命名空间会导致ClassNotFoundException。
验证规则数组必须返回array类型，不能用const RULES = []——PHP 8.0+对常量数组支持有限，框架内部用is_array()判断，常量会被判定为false。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
