Laravel路由集合(RouteCollection)的迭代器遍历【集合操作】-php教程-PHP中文网

routecollection 不是 laravel 的 collection 类型，不支持 map/filter 等链式操作；它仅提供 getiterator() 供 foreach 遍历 route 对象，如需 collection 方法必须显式调用 collect() 转换。

laravel路由集合(routecollection)的迭代器遍历【集合操作】

RouteCollection 本身不是 Laravel 的 Collection 类型，它不支持直接用 foreach 遍历元素后链式调用 map/filter 等方法。它是一个专门管理 Route 对象的容器类，底层用数组存储路由，但对外暴露的是面向路由匹配与查找的接口，而非通用数据集合操作。

RouteCollection 怎么“遍历”

它提供 getIterator() 方法返回标准 PHP ArrayIterator，因此可用 foreach 遍历，但仅限读取，不能调用 Collection 方法：

✅ 正确：用 foreach 逐个取出 Route 实例，访问其属性（如 $route->uri()、$route->methods()、$route->getName()）
❌ 错误：尝试写 $routes->map(...) 或 $routes->filter(...) —— RouteCollection 没有这些方法
⚠️ 注意：遍历时拿到的是 Illuminate\Routing\Route 对象，不是数组或普通键值对，不能直接按 key 取字段

想用 Collection 方法？先转成 collect()

若需链式筛选、映射、分组等操作，必须显式转为 Collection：

在SEO发布前，从路由清单生成XML网站地图和robots.txt

当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。

下载

获取全部路由对象： $routes = Route::getRoutes();
转为 Collection： $collection = collect($routes->getIterator());（或简写 collect($routes->getRoutes())）
之后可安全使用：$collection->where('name', '!=', null)->pluck('uri', 'name')->all()

常见实用场景示例

比如导出所有带 name 的 GET 路由 URI 和名称：

collect(Route::getRoutes()->getIterator())
->filter(fn($r) => $r->getName() && in_array('GET', $r->methods()))
->mapWithKeys(fn($r) => [$r->getName() => $r->uri()])
->all(); // 得到 ['home' => '/', 'user.show' => 'user/{id}']

别混淆：RouteCollection 不是 Collection

虽然名字都含 “Collection”，但 RouteCollection 是路由系统的专用仓储类，和 Illuminate\Support\Collection 完全无关。它没有 all()、first()、pluck()、groupBy() 等方法，也不支持惰性求值或管道式处理。它的设计目标是高效匹配，不是数据转换。