Laravel 7.30.4如何为API和后台配置独立域名路由
Laravel 7.30.4 独立用户API域名配置方案
全程不会修改原有Admin API的guard、鉴权逻辑,仅调整路由绑定和服务端配置:
1. 路由层域名绑定配置
打开app/Providers/RouteServiceProvider.php文件,找到用户API路由(users.php)的注册逻辑,添加域名约束:
// 原有用户API路由注册逻辑一般类似如下结构 protected function mapUserApiRoutes() { Route::domain('api.test.com') // 新增这一行,绑定独立域名 ->prefix('userApi') ->middleware('api') ->namespace($this->namespace) ->group(base_path('routes/users.php')); }
多环境适配建议:在
.env文件中添加配置项API_DOMAIN=api.test.com,上述代码替换为->domain(env('API_DOMAIN'))即可兼容本地、测试、生产环境。
为避免Admin API被新域名意外访问,可给Admin API的路由注册也添加对应域名约束:
protected function mapAdminApiRoutes() { Route::domain('admin.test.com') // 新增这一行 ->prefix('admin') // 原有admin中间件、guard、命名空间等配置保持不变 ->group(base_path('routes/admin.php')); }
配置完成后执行路由缓存清理命令生效:php artisan route:clear && php artisan route:cache
2. Web服务配置
将新域名api.test.com的请求指向同一个Laravel项目的public目录即可:
- Nginx配置:复制原有
admin.test.com的server配置块,仅修改server_name为api.test.com,其余根目录、PHP解析规则完全保持不变,修改完成后执行nginx -s reload重载配置 - Apache配置:新增虚拟主机配置,
DocumentRoot指定为项目public目录,ServerName填写api.test.com,重启Apache生效
3. 跨域配置调整(如有配置CORS)
如果项目安装了跨域扩展,打开config/cors.php,将api.test.com添加到allowed_origins列表中,同时确认paths配置包含userApi/*路径即可。
4. 功能验证
- 访问原有Admin API地址
https://admin.test.com/admin/xxx,确认后台接口功能、鉴权逻辑完全正常 - 访问新用户API地址
https://api.test.com/userApi/xxx,确认返回结果与原地址https://admin.test.com/userApi/xxx完全一致 - 尝试访问
https://api.test.com/admin/xxx,确认无法正常请求,避免Admin路由泄露
内容的提问来源于stack exchange,提问作者Bala Murugan
相关产品推荐
相关产品推荐

