命名路由匹配逻辑与Route::is()通配符实现算法解析

命名路由的匹配方式，通常被误解为需要解析URL并逐段比较。实际上，Laravel 并不会拆分 /admin/users/5/edit 这类路径，而是直接调用 Route::current()->named()，获取已注册的路由名称（例如 admin.users.edit），再与目标名称进行字符串层面的比对。该方法稳定可靠，且完全不受URL参数值的影响。

通配符的工作原理同样不涉及正则表达式。admin.* 是 Laravel 内置的前缀匹配机制：将目标名称按点号 . 分割，判断当前路由名称是否以该前缀开头，且后续内容不为空（即不能完全相等）。示例说明：

• request()->routeIs(['admin.*']) 可匹配 admin.dashboard、admin.users.index，但不匹配 admin 本身；
• request()->routeIs(['api.v1.*', 'home']) 支持同时匹配多个前缀以及一个精确名称；
• 关键点：通配符仅作用于路由名称，与路由定义的路径、URL解析或正则引擎无关。

为什么 Route::is() 不支持数组和通配符？

Route::is() 作为静态门面方法，设计初衷是单名称精确匹配。底层实现为 Router::current()->getName() === $name，未包含数组或通配符扩展逻辑。若传入数组，PHP 会直接报类型错误；传入 'admin.*' 字符串则进行字面匹配，因为该方法未内置通配符解析机制。

routeIs() 的内部执行流程

调用 request()->routeIs(['user.login', 'user.register']) 时，框架执行以下步骤：

• 获取当前请求绑定的路由实例（$request->route()）；
• 调用 $route->getName() 获得当前路由的命名字符串；
• 遍历传入数组，对每个元素分别判断：
  — 若元素包含 *，则进行前缀匹配（Str::startsWith($currentName, $pattern)）；
  — 否则执行严格相等判断；
• 一旦任一匹配成功，立即返回 true，停止遍历。

常见误用与规避建议

容易踩坑之处：请勿将通配符写成正则形式（例如 'admin..*'），它会被视作普通字符串处理，导致匹配失败。此外，不要将命名判断与路径判断混淆（例如 request()->routeIs(['/admin'])），命名路由必须使用注册时指定的 name，不能用 URI。

需要注意，命名路由匹配完全依赖于 name() 方法的输出。定义路由时务必显式调用 ->name('xxx')，否则 routeIs() 始终返回 false。