
本文介绍如何在 blade 视图中安全、高效地获取并展示当前应用所有注册路由的结构化信息(含 domain、method、uri、middleware、name、action),避免使用 cli 命令,而是通过 laravel 路由服务容器直接提取数据并渲染为 html 表格。
本文介绍如何在 blade 视图中安全、高效地获取并展示当前应用所有注册路由的结构化信息(含 domain、method、uri、middleware、name、action),避免使用 cli 命令,而是通过 laravel 路由服务容器直接提取数据并渲染为 html 表格。
在 Laravel 中,php artisan route:list 是开发调试时查看路由配置的常用命令,但其输出仅限于终端,无法直接用于 Web 界面。若需在 Blade 模板中动态呈现完整的路由表(如用于内部管理后台或开发文档页),必须绕过 CLI 调用(Artisan::call('route:list') 在 Web 请求中无效且不返回结构化数据),转而利用框架底层的 IlluminateRoutingRouter 实例进行程序化解析。
✅ 推荐实现方式:控制器中预处理路由数据
首先,在控制器中注入 Router 服务,遍历所有已注册路由,并将其标准化为数组格式:
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
<?php
namespace AppHttpControllers;
use IlluminateHttpRequest;
use IlluminateRoutingRouter;
use IlluminateSupportStr;
class RouteListController extends Controller
{
protected $router;
public function __construct(Router $router)
{
$this->router = $router;
}
public function index()
{
$routes = collect($this->router->getRoutes())
->map(fn ($route) => $this->formatRoute($route))
->filter()
->values()
->all();
return view('routes.list', compact('routes'));
}
protected function formatRoute($route): array
{
$action = $route->getActionName();
$action = $action === 'Closure' ? 'Closure' : ltrim($action, '\');
return [
'domain' => $route->domain() ?: '—',
'method' => implode('|', $route->methods()),
'uri' => $route->uri(),
'name' => $route->getName() ?: '—',
'action' => $action,
'middleware' => $this->extractMiddlewareNames($route),
];
}
protected function extractMiddlewareNames($route): string
{
return collect($this->router->gatherRouteMiddleware($route))
->map(fn ($m) => is_string($m) ? $m : get_class($m))
->implode('<br>');
}
}⚠️ 注意事项:
- 性能敏感场景慎用:route:list 数据量大时(如数百路由),此操作会增加首屏渲染开销;建议配合缓存(如 Cache::remember('route_list', 3600, fn() => [...]));
- 权限控制:该页面应严格限制访问(如仅 local 环境或 admin 中间件),避免生产环境暴露路由结构;
- 中间件兼容性:$route->middleware() 返回原始定义,gatherRouteMiddleware() 才能解析出最终生效的中间件类名(含 web, auth 等全局中间件);
- 闭包路由处理:getActionName() 对匿名函数返回 'Closure',无需额外反射判断,简化逻辑。
? Blade 模板渲染(resources/views/routes/list.blade.php)
@extends('layouts.app')
@section('content')
<div class="container mt-4">
<h2 class="mb-4">All Registered Routes</h2>
<div class="table-responsive">
<table class="table table-sm table-bordered table-hover">
<thead class="table-light">
<tr>
<th>Domain</th>
<th>Method</th>
<th>URI</th>
<th>Middlewares</th>
<th>Name</th>
<th>Action</th>
</tr>
</thead>
<tbody>
@forelse ($routes as $route)
<tr>
<td>{{ $route['domain'] }}</td>
<td><code>{{ $route['method'] }}</code></td>
<td><code>{{ $route['uri'] }}</code></td>
<td>{!! nl2br(e($route['middleware'])) !!}</td>
<td><code>{{ $route['name'] }}</code></td>
<td><code>{{ Str::limit($route['action'], 60) }}</code></td>
</tr>
@empty
<tr>
<td colspan="6" class="text-center text-muted">No routes found.</td>
</tr>
@endforelse
</tbody>
</table>
</div>
</div>
@endsection? 总结
- ✅ 此方案完全基于 Laravel 内置服务,无需外部依赖或 hack CLI;
- ✅ 数据结构清晰、可扩展(如需添加 Group, Prefix, Binding 等字段,可继续调用 $route->getPrefix() 或 $route->parameterNames());
- ✅ 输出为标准 HTML 表格,支持排序、搜索(可结合 DataTables.js 进一步增强);
- ❌ 切勿在生产环境公开此页面,建议添加环境校验:app()->environment('local') 或角色授权。
通过这种方式,你就能在 Blade 中获得与 artisan route:list 高度一致、且可自由定制的 Web 可视化路由清单。


















