命名路由匹配逻辑与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'])），命名路由必须使用注册时指定的名称，而不是URI。

原理并不复杂，但容易忽略的是：命名路由匹配完全依赖于name()方法的输出。因此，在定义路由时务必显式调用->name('xxx')，否则routeIs()将始终返回false。