ThinkPHP8.0路由规则怎么用_ThinkPHP8.0路由规则配置【指南】-ThinkPHP-PHP中文网

注解路由不生效需先确认是否正确安装think-annotation扩展并调用annotationroute::init()初始化，且config/annotation.php中route.enable必须为true；控制器须在匹配命名空间的app/controller或配置的多应用路径下，方法需为public；#get仅支持简单路由，复杂配置（如middleware、domain）必须用#route并显式声明method和pattern。

thinkphp8.0路由规则怎么用_thinkphp8.0路由规则配置【指南】

注解路由不生效？先确认扩展是否装对、是否初始化

TP8 的注解路由不是默认开启的功能，#[Route]、#[Get] 这类属性不会被自动识别。必须满足两个硬性条件：已执行 composer require topthink/think-annotation，且在 app/bootstrap.php 或服务提供者中调用了 AnnotationRoute::init()。

漏掉任一环节，php think route:list 就看不到注解注册的路由，也不会报错——只会静默忽略。

检查 config/annotation.php 是否存在，里面 'route' => ['enable' => true] 必须为 true
控制器类必须位于 app/controller/（单应用）或按多应用结构匹配命名空间，例如 appdmincontrollerIndex 对应 appdmincontroller
方法必须是 public，否则注解解析器直接跳过

#[Get] 和 #[Route] 别混用，参数支持范围差别很大

#[Get("user/:id")] 是快捷写法，等价于 #[Route("user/:id", method="GET")]，但仅此而已。它不支持中间件、域名、变量规则等关键配置。

如果你需要加权限控制或限定访问域，只能用 #[Route]：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

#[Route("admin/:id", method="GET", middleware="auth", domain="admin.example.com", pattern: ["id" => "d+"])]
public function detail($id)
{
    // ...
}

#[Get] / #[Post] 适合简单接口，写起来快，但扩展性差
#[Route] 才是完整能力入口，middleware、domain、pattern、name 都只在这里生效
别在 #[Get] 里硬塞 middleware 参数——会被完全忽略，连 warning 都没有

多应用下注解扫描不到？改 config/annotation.php 的 controllers 配置

默认情况下，topthink/think-annotation 只扫描 appcontroller 命名空间。你建了 appdmin 应用，它的控制器在 appdmincontroller，自然被跳过。

解决办法是显式补充扫描路径，在 config/annotation.php 中修改 'controllers' 配置项：

'route' => [
    'enable' => true,
    'controllers' => [
        'app\controller',
        'app\admin\controller',
        'app\api\controller',
    ],
],

路径必须用双反斜杠转义，写成 appcontroller 会解析失败
每个字符串代表一个命名空间前缀，对应一个目录，不要带末尾 controller 子路径
改完后必须执行 php think clear:route，否则缓存仍用旧扫描结果

路由能访问但参数为空？检查变量规则和 method 匹配

比如写了 #[Route("user/:id")]，访问 /user/123 却收不到 $id，常见原因有两个：

没指定 method，而当前请求是 POST，但注解默认只注册 GET 路由（#[Get] 显式限定 GET，#[Route] 不写 method 默认也是 GET）
变量未定义规则，:id 允许任意字符，但框架内部可能因正则不匹配导致参数丢弃；建议加 pattern：#[Route("user/:id", pattern: ["id" => "d+"])]
URL 中有大小写或特殊字符，而默认变量规则不兼容；可全局设置 config/route.php 中的 'param_convert' => false 关闭自动类型转换