Laravel CORS终极指南：10分钟搞定跨域资源共享完整配置

Laravel CORS终极指南：10分钟搞定跨域资源共享完整配置

【免费下载链接】laravel-cors Adds CORS (Cross-Origin Resource Sharing) headers support in your Laravel application 项目地址: https://gitcode.com/gh_mirrors/la/laravel-cors

还在为Laravel API跨域请求问题烦恼吗？🤔 今天我将为你带来最全面的Laravel CORS配置教程，让你在短短10分钟内彻底掌握跨域资源共享的核心技巧！

什么是CORS跨域资源共享？

CORS（Cross-Origin Resource Sharing）跨域资源共享是现代Web开发中不可或缺的技术。当你的前端应用（如Vue.js、React或Angular）尝试从不同域名访问Laravel后端API时，浏览器会执行安全策略检查。如果没有正确配置CORS，即使API正常工作，浏览器也会阻止请求，导致开发受阻。

Laravel CORS包的核心功能

这个强大的laravel-cors包为你的Laravel应用提供了完整的CORS支持：

✅ 处理CORS预检OPTIONS请求 - 自动响应浏览器的预检检查 ✅ 添加CORS头到响应 - 确保跨域请求顺利通过 ✅ 路由匹配机制 - 只为特定路由启用CORS，保持安全性

快速安装步骤

首先，通过Composer安装包：

composer require fruitcake/laravel-cors

全局配置方法

要让CORS对所有路由生效，只需在app/Http/Kernel.php中添加中间件：

protected $middleware = [
    \Fruitcake\Cors\HandleCors::class,
    // 其他中间件...
];

配置文件详解

发布配置文件到你的项目中：

php artisan vendor:publish --tag="cors"

打开config/cors.php，你会看到完整的配置选项：

核心配置参数

配置项	说明	默认值
paths	启用CORS的路径模式	[]
allowed_methods	允许的HTTP方法	['*']
allowed_origins	允许的源域名	['*']
allowed_headers	允许的请求头	['*']
supports_credentials	是否支持凭证	false

实战配置示例

假设你正在开发一个Vue.js应用，需要访问api.example.com的Laravel API：

'paths' => ['api/*', 'sanctum/csrf-cookie'],
'allowed_origins' => ['https://vue-app.example.com'],
'allowed_methods' => ['GET', 'POST', 'PUT', 'DELETE'],
'supports_credentials' => true,

常见问题解决方案

❌ CORS头未添加

解决方法： 确保HandleCors中间件是全局中间件列表中的第一个

❌ 凭证模式错误

解决方法： 当使用Authorization头时，设置supports_credentials为true

❌ 配置缓存问题

解决方法： 每次修改配置后运行：

php artisan config:clear

进阶配置技巧

使用正则表达式匹配域名

'allowed_origins_patterns' => ['/^https:\/\/app-\w+\.example\.com$/'],

设置缓存时间

'max_age' => 86400, // 24小时

Lumen框架配置

对于Lumen用户，在bootstrap/app.php中注册服务提供者：

$app->register(Fruitcake\Cors\CorsServiceProvider::class);
$app->configure('cors');

最佳实践建议

🔒 安全性优先： 不要在生产环境中使用['*']，应明确指定允许的域名

⚡ 性能优化： 合理设置max_age减少预检请求

🎯 精确配置： 只为需要的路由启用CORS

升级到Laravel 9+的注意事项

从Laravel 9.2开始，CORS中间件已集成到框架核心中。升级步骤：

1. 从composer.json移除"fruitcake/laravel-cors"
2. 在app/Http/Kernel.php中替换：
   • \Fruitcake\Cors\HandleCors::class
   • 为 \Illuminate\Http\Middleware\HandleCors::class

总结

通过这个完整的Laravel CORS配置指南，你现在应该能够：

✅ 快速安装和配置CORS包 ✅ 理解各个配置参数的作用 ✅ 解决常见的跨域问题 ✅ 应用最佳实践确保安全性

记住，正确的CORS配置是现代化Web应用开发的关键环节。花10分钟掌握这些技巧，将为你的开发工作节省大量时间！🚀

想要了解更多高级用法，可以参考官方文档或查看源码实现。

【免费下载链接】laravel-cors Adds CORS (Cross-Origin Resource Sharing) headers support in your Laravel application 项目地址: https://gitcode.com/gh_mirrors/la/laravel-cors