Laravel多模块项目怎么规划路由-Laravel-PHP中文网

laravel本身不内置「模块」概念，所谓多模块路由本质是通过route::group()组合前缀、命名空间、中间件和命名实现路径与控制器的逻辑隔离，无需修改框架源码；所有模块路由可统一写在web.php或拆分至独立文件（如admin.php），但必须在routeserviceprovider中显式加载，且命名空间需与物理路径严格一致、大小写敏感。

laravel多模块项目怎么规划路由

直接说结论：Laravel 本身不内置「模块」概念，所谓多模块路由，本质是靠 Route::group() + 命名空间 + 路由前缀 + 中间件组合实现的路径隔离和控制器组织，不是靠文件夹自动扫描或插件注册。

怎么用 Route::group() 划分 admin / api / shop 等逻辑模块

这是最常用、最稳妥的方式，不需要改框架源码或重写服务提供者。所有模块路由都写在 routes/web.php 或各自独立的子文件里（如 routes/admin.php），再用 Route::group() 统一约束。

前缀统一：比如后台全部加 /admin，API 加 /api/v1，商城加 /shop
命名空间对齐：确保控制器路径和命名空间严格匹配，例如 App\Http\Controllers\Admin\UserController 对应 ->namespace('App\Http\Controllers\Admin')
中间件按需绑定：auth、role:admin、throttle 等不要堆在全局，而是在 group 内指定
命名前缀别漏掉：->name('admin.') 后，route('admin.users.index') 才能正确生成 URL

示例：

Route::group([
    'prefix' => 'admin',
    'namespace' => 'App\Http\Controllers\Admin',
    'middleware' => ['auth', 'role:admin'],
    'name' => 'admin.'
], function () {
    Route::get('/dashboard', [DashboardController::class, 'index'])->name('dashboard');
    Route::resource('users', UserController::class)->except(['create', 'edit']);
});

要不要把路由拆到多个 PHP 文件（如 admin.php）

可以，但必须手动加载——Laravel 不会自动扫描 routes/ 下所有 PHP 文件。只认 web.php 和 api.php 这两个默认入口，其余都要显式引入。

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

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

下载

在 app/Providers/RouteServiceProvider.php 的 map() 方法里加调用，比如 $this->mapAdminRoutes();
对应方法里用 Route::group(...)->group(base_path('routes/admin.php')); 加载
注意：如果用了 namespace，要写全命名空间，不能只写 'Admin'，得是 'App\Http\Controllers\Admin'
别忘了在 app/Http/Kernel.php 的 $middlewareGroups 里补上自定义中间件组（如 'admin'），否则中间件名无法识别

为什么 RouteServiceProvider::mapApiRoutes() 自动加 /api 前缀，而我自己的 admin 却 404

因为 Laravel 默认只对 api.php 做了特殊处理：它在 RouteServiceProvider 里被显式调用，并绑定了 api 中间件组和 /api 前缀。你新建的 admin.php 没有被调用，自然不会生效。

常见错误：只建了 routes/admin.php，没在 RouteServiceProvider 里加 mapAdminRoutes() 调用
另一个坑：mapAdminRoutes() 方法写了，但忘记在 map() 里调用它
还有人复制 mapApiRoutes() 代码时，漏改 ->middleware('api') 成你自己的中间件组名，导致中间件找不到报错
最后检查 php artisan route:list 输出里有没有你的路由，没有就说明根本没加载

命名空间嵌套太深（如 Api\V1\UsersController）怎么配

命名空间必须和物理路径完全一致，且 PSR-4 自动加载规则不能破。比如 App\Http\Controllers\Api\V1\UsersController 对应文件必须是 app/Http/Controllers/Api/V1/UsersController.php。

路由里写 ->namespace('App\Http\Controllers\Api\V1')，不是 'Api\V1'
别试图用 use 导入缩短命名空间——路由闭包或字符串控制器写法不支持
如果用数组写法 [UsersController::class, 'index']，类名必须带完整命名空间，或确保 use 已导入（仅限该文件内）
版本化 API 推荐用 prefix('api/v1') + namespace('App\Http\Controllers\Api\V1') 组合，避免后期升级 v2 时路由混杂

真正容易被忽略的是：命名空间拼错一个字母、大小写不一致（Windows 可能不报错，Linux 直接 Class not found）、或者 composer autoload 没更新（改完命名空间后记得 composer dump-autoload）。