讲师中心 微信公众号
AI工具推荐 视频效率加速

PHP框架快速部署:解决跨域请求与CORS配置【前后端分离】

胖墨同学_8051

胖墨同学_8051

发布时间:2026-08-07 19:04:02

|

277人浏览过

|

来源于php中文网

原创

跨域问题源于浏览器拦截而非PHP拒绝,需服务端正确响应CORS头。推荐Laravel用spatie/laravel-cors包、Symfony用NelmioCorsBundle、原生PHP手动校验Origin并处理OPTIONS、Apache用.htaccess、Nginx用map动态匹配Origin并统一注入头。

php框架快速部署:解决跨域请求与cors配置【前后端分离】

前后端分离开发中,前端请求PHP后端接口时被浏览器拦截报错“CORS header ‘Access-Control-Allow-Origin’ missing”,说明服务端未正确响应跨域协商——这不是PHP拒绝请求,而是浏览器因缺少必要响应头而主动丢弃响应内容。

用Laravel框架一键启用CORS

推荐使用官方维护的 spatie/laravel-cors 包,避免手写中间件遗漏OPTIONS处理或白名单校验漏洞。

第一步:执行安装命令 → composer require spatie/laravel-cors

第二步:发布配置文件 → php artisan vendor:publish --tag="cors"

立即学习“PHP免费学习笔记(深入)”;

第三步:编辑 config/cors.php,将 【'allowed_origins' => ['*'] 改为具体域名列表】,例如:['https://app.example.com', 'http://localhost:5173']。生产环境若保留 * 且启用了 credentials,请求将直接失败。

第四步:确保 'supports_credentials' => true 已开启(如需携带 Cookie 或 Token),同时前端 fetch 必须配 credentials: 'include',否则后端下发的 PHPSESSID 不会被浏览器发送。

在Symfony中通过Bundle配置跨域

适合已集成 NelmioCorsBundle 的项目,规则集中、支持正则匹配,便于多环境切换。

方法一:修改 config/packages/nelmio_cors.yaml

取消注释并填写实际域名白名单,例如:allow_origin: ['^https?://(localhost|myapp\.com)$']。注意正则末尾的 $ 防止子域名泛匹配越权。

方法二:对特定路由组单独启用

在 config/routes.yaml 中为 API 路由添加 cors: true 标签,比全局配置更精准,避免管理后台等敏感路径意外暴露。

原生PHP脚本快速修复跨域

适用于无框架轻量接口、调试阶段或临时补丁,必须放在任何输出之前,否则 header() 会触发 “headers already sent” 错误。

① 获取 Origin 并校验是否在白名单内:

$origin = $_SERVER['HTTP_ORIGIN'] ?? '';

$allowed = ['https://admin.example.com', 'http://localhost:3000'];

② 仅当匹配成功才设置响应头:

if (in_array($origin, $allowed)) {

  header("Access-Control-Allow-Origin: $origin");

  header("Access-Control-Allow-Credentials: true");

  header("Vary: Origin"); // 告知CDN按Origin缓存不同版本

}

③ 强制处理 OPTIONS 预检请求:

if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') { exit(); }

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

这一步操作起来很简单,直接把这段代码贴到 PHP 文件最顶部即可生效。但漏掉 【exit() 必须放在所有业务逻辑之前】,否则预检失败仍会执行后续代码,导致响应体污染,浏览器判定 CORS 协商失败。

Apache服务器统一注入CORS头

适合共享主机或无法修改PHP代码的场景,用 .htaccess 实现零侵入配置。

确认服务器已启用 mod_headers 模块 → 进入 API 所在目录 → 创建或编辑 .htaccess 文件。

写入以下三行:

Header set Access-Control-Allow-Origin "https://app.example.com"

Header set Access-Control-Allow-Methods "GET,POST,PUT,DELETE,OPTIONS"

Header set Access-Control-Allow-Headers "Content-Type,Authorization,X-Requested-With"

注意:Apache 2.4+ 才支持 Header 指令,旧版本需改用 mod_setenvif + mod_headers 组合方式。如果部署在虚拟主机且无权限启用模块,此方案不可用。

Nginx配置跨域响应头

生产环境推荐方式,性能更高、规则更稳定,避免每个PHP脚本重复判断Origin。

编辑站点 server 块,在 location ~ \.php$ 内添加:

add_header 'Access-Control-Allow-Origin' '$sent_http_access_control_allow_origin' always;

先用 map 指令动态映射 Origin(防止非法域名伪造):

map $http_origin $cors_origin {

  default "";

  ~^https?://(localhost|app\.example\.com)(:[0-9]+)?$ "$http_origin";

}

再在 server 块中添加:

add_header Access-Control-Allow-Origin $cors_origin always;

add_header Access-Control-Allow-Methods "GET, POST, OPTIONS" always;

add_header Access-Control-Allow-Credentials "true" always;

add_header Access-Control-Allow-Headers "Content-Type, Authorization" always;

最后为 OPTIONS 请求返回 204 状态码:

if ($request_method = 'OPTIONS') { return 204; }

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2743

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6890

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

6366

2024.03.19

php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

11784

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

6761

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2195

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4308

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5014

2023.10.23

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Composer手册
Composer手册

共0课时 | 0人学习

墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn