ThinkPHP8.0如何定义路由_ThinkPHP8.0路由规则【基础】-ThinkPHP-PHP中文网

ThinkPHP 8.0中路由必须显式注册于route/app.php，禁用隐式URL模式；注解路由需手动安装扩展、调用AnnotationRoute::init()并清缓存，且仅对app/controller/下public方法生效。

thinkphp8.0如何定义路由_thinkphp8.0路由规则【基础】

ThinkPHP 8.0 中定义路由不能靠“猜路径”或拼接 URL 参数，必须显式注册 —— 否则直接访问 /index/test 或 ?s=/index/test 会 404 或报错，因为隐式 URL 模式（?s=）已被彻底废弃。

所有手动定义的路由都应写在 route/app.php 文件中，框架启动时只加载这个文件（除非你主动改了配置）。它返回一个数组，键是路由表达式，值是路由地址。

Route::get('user/:id', 'user/read') 是推荐写法，比数组式更清晰、支持链式调用（如 ->pattern(['id' => '\d+'])）
字符串式定义（如 'user/:id' => 'user/read'）仍可用，但不支持中间件、变量规则等高级能力
别把路由写进 config/app.php 或控制器里 —— 那些地方只控制开关（如 auto_bind_module），不定义具体路由
修改后记得清缓存：php think clear:route，否则旧路由可能还在生效

注解路由不是默认开启的功能，#[Route] 或 @Get 这类写法在没配好前完全无效，连报错都不会有，只会静默忽略。

先执行 composer require topthink/think-annotation
在 app/bootstrap.php 末尾加一行：think\annotation\Route\AnnotationRoute::init();
注解只能写在 app/controller/ 下的 public 方法上方；写在类上、写在 protected 方法上、或控制器不在该命名空间下，都会被跳过
修改注解后必须运行 php think clear:route，否则缓存不刷新，新路由不会出现在 php think route:list 里

ThinkPHP 8 不再默认接受任意方法访问同一路由。如果你用 Route::get() 定义了路由，那 POST 请求过去就是 405 Method Not Allowed，而不是自动 fallback。

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

需要同时支持 GET 和 POST？用 Route::any()，或分别注册 Route::get() 和 Route::post()
RESTful 场景优先用 Route::resource('blog', 'Blog')，它自动生成标准的 7 个 CRUD 路由，且方法严格对应
快捷注解如 #[Get('user/:id')] 底层转成 #[Route('user/:id', method: 'GET')]，但不支持 middleware 或 domain 字段 —— 这些只能用完整 #[Route]
参数校验建议在路由层做：->pattern(['id' => '\d+'])，比在控制器里 if (!is_numeric($id)) 更早拦截

默认注解路由只扫 app/controller/，如果你建了 admin 或 api 应用，它们的控制器不会被自动发现 —— 这是线上部署后路由“突然消失”的最常见原因。

检查 config/annotation.php，找到 'scan_path' 配置项
改成数组形式，显式列出所有要扫描的目录：['app/controller/', 'admin/controller/', 'api/controller/']
确保这些目录下的控制器命名空间与路径一致（如 admin\controller\User 必须在 admin/controller/User.php）
如果用了域名路由（如 admin.example.com），还要确认 Route::domain('admin', ...) 的闭包里是否包含了对应路由定义