国内使用 laravel 路由管理的核心是通过 laravel 中文网(laravel-china.org)直连访问同步至 11.x 的官方文档,结合 routes/web.php 与 api.php 配置 get、资源、命名、模型绑定等路由,并实践前缀分组、多语言、nginx 重写等增强方案。

国内使用 Laravel 路由管理,核心是绕过网络限制稳定访问官方文档,并结合本地开发环境完成标准配置。Laravel 中文网(laravel-china.org)已同步最新英文文档,且服务器位于国内,无需代理即可快速查阅。
官方文档入口(国内直连)
直接访问:https://laravel-china.org/docs/laravel/11.x/routing
该站点由社区维护,与 Laravel 官网英文文档实时同步(截至 2026 年 6 月,已更新至 Laravel 11.x),涵盖所有路由类型、命名、分组、模型绑定、限流等完整章节。
基础路由配置(Laravel 11 默认结构)
路由文件位于 routes/web.php(Web 请求)和 routes/api.php(API 请求),默认已启用 CSRF 保护和中间件自动绑定。
- 普通 GET 路由:
Route::get('/home', [HomeController::class, 'index']); - 资源路由(含 7 个标准动作):
Route::resource('photos', PhotoController::class); - 带命名的路由(便于生成 URL):
Route::get('/user/{id}', [UserController::class, 'show'])->name('user.show'); - 路由模型绑定(自动注入 Eloquent 模型):
Route::get('/post/{post}', [PostController::class, 'show']);—— 只要Post模型存在,$post就是已查询实例
中文环境下常用增强配置
国内项目常需支持多语言路径、后台路由前缀、或与 Nginx 配合隐藏 index.php,以下为高频实践:
- 添加后台路由组(如
/admin):Route::prefix('admin')->middleware(['auth', 'verified'])->group(function () { Route::get('/dashboard', [AdminController::class, 'index']); }); - 启用多语言路由前缀(需配合
laravel-lang/lang或自定义中间件):Route::prefix('{locale}')->where(['locale' => '[a-z]{2}'])->group(...) - Nginx 隐藏
index.php:确保 server 块中包含try_files $uri $uri/ /index.php?$query_string;,并关闭APP_DEBUG=false后的调试提示干扰
调试与验证技巧
运行 php artisan route:list 可查看全部注册路由(含中间件、域名、HTTP 方法)。若出现“Route not defined”错误,检查是否遗漏 ->name('xxx') 或拼写不一致;若页面 404,确认 APP_URL 和 Nginx/Apache 重写规则正确。











