PHP跨域配置教程：CORS中间件设置

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《PHP框架跨域配置教程\CORS中间件设置》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

跨域问题在前后端分离开发中很常见。当浏览器发起请求的目标地址与当前页面域名不同时，就会触发同源策略限制。为解决这个问题，PHP框架通常通过CORS（Cross-Origin Resource Sharing）中间件来允许指定的域名访问接口。

CORS中间件作用

CORS中间件用于在HTTP响应头中添加必要的字段，如 Access-Control-Allow-Origin、Access-Control-Allow-Methods 等，使浏览器放行跨域请求。

不同PHP框架配置方式略有差异，但核心思路一致：在请求处理前或响应返回前注入响应头。

Laravel框架配置CORS

Laravel自带 fruitcake/laravel-cors 包支持CORS配置。

安装方式：

• 运行命令 composer require fruitcake/laravel-cors
• Laravel 7+ 会自动注册服务，无需手动添加
• 修改配置文件 config/cors.php 设置规则

常用配置项示例：

[
    'paths' => ['api/*'],
    'allowed_methods' => ['*'],
    'allowed_origins' => ['http://localhost:3000', 'https://your-frontend.com'],
    'allowed_headers' => ['*'],
    'supports_credentials' => true,
]

设置后，所有匹配路径的API将自动携带跨域头信息。

Symfony框架启用CORS

Symfony可通过 NelmioCorsBundle 快速实现CORS支持。

• 安装包：composer require nelmio/cors-bundle
• 在 config/bundles.php 中注册 Nelmio\Bundle\CorsBundle\NelmioCorsBundle
• 配置 config/packages/nelmio_cors.yaml

配置示例：

nelmio_cors:
    defaults:
        origin_regex: true
        allow_origin: ['^https?://(localhost|your-site\.com)$']
        allow_methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS']
        allow_headers: ['*']
        max_age: 3600

此配置支持正则匹配来源域名，适合多环境调试。

自定义中间件实现CORS（通用方法）

若使用轻量框架或原生结构，可手动创建中间件处理 OPTIONS 预检请求并添加响应头。

示例代码：

function handle($request, $next)
{
    header('Access-Control-Allow-Origin: http://localhost:8080');
    header('Access-Control-Allow-Credentials: true');
    header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS');
    header('Access-Control-Allow-Headers: Content-Type, Authorization');

    if ($request->getMethod() === 'OPTIONS') {
        exit(); // 预检请求直接结束
    }

    return $next($request);
}

将该逻辑注册到路由或全局中间件中即可生效。

基本上就这些。根据所用框架选择合适方式，关键是正确设置 Allow-Origin 和处理 OPTIONS 请求。不复杂但容易忽略细节，比如凭证支持时origin不能为*。

好了，本文到此结束，带大家了解了《PHP跨域配置教程：CORS中间件设置》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！