php cors请求失败怎么办？常见错误和解决方法汇总。

发布日期： 2025-10-06 阅读量： 作者： admin

今天来说说搞PHP时候碰到的跨域问题，也就是那个烦人的CORS。

我记得当时是这样的，我这边用PHP写了些API接口，然后前端那边用的是另一套东西，跑在另一个端口或者域名上。结果前端一调我的接口，浏览器控制台就报那个经典的错，大概意思就是说来源不同，不让访问。这就是所谓的跨域了。

我有点懵，寻思这咋回事。上网查了查，才知道浏览器有个安全策略，默认不让随便跨着域请求资源。

开始动手解决

明白了原因，就得想办法解决了。主要思路就是在PHP这边，告诉浏览器：“那个来源的请求，我允许它访问！” 这个通过设置HTTP响应头来实现。

第一步：找到处理请求的PHP文件

得定位到是哪个PHP文件在处理前端发来的请求。可能是一个入口文件，也可能是具体的API处理脚本。

第二步：在脚本开头加响应头

关键就在这了。在PHP脚本的在输出任何内容之前，得加上几个header()函数调用。

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

这个是最核心的，表示允许任何来源访问。刚开始测试或者接口不敏感的时候，可以用，图个方便。但如果是正经项目，强烈建议把换成你前端应用的那个具体来源地址，比如header("Access-Control-Allow-Origin: http://你的前端域名.com"); 这样更安全。

header("Access-Control-Allow-Methods: GET, POST, OPTIONS, PUT, DELETE");

这个是告诉浏览器，我这边允许哪些HTTP请求方法。根据你接口实际用到的方法来写，常用的GET、POST肯定要有，如果用了PUT、DELETE这些也要加上。OPTIONS方法通常也需要加上，后面会说到。

header("Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With");

这个是允许前端请求里带哪些特殊的请求头。比如你用Content-Type来指定请求体是JSON，或者用了Authorization头来传身份令牌（token），那就要在这里声明，不然浏览器也会拦。

第三步：处理预检请求（OPTIONS）

这个坑我刚开始也踩过。对于一些“非简单请求”（比如用了PUT方法，或者带了自定义头），浏览器会先发一个OPTIONS方法的“预检”请求过来，问问服务器允不允许接下来那个实际的请求。我们得响应这个OPTIONS请求。

在设置完上面那堆header()之后，可以加个判断：

if ($_SERVER['REQUEST_METHOD'] == 'OPTIONS') {
// 确认上面的Allow-头已经发送了
exit; // 直接退出，不需要执行后面的业务逻辑

这样，当收到OPTIONS请求时，PHP发送完许可头信息就直接结束了，浏览器拿到许可，接着才会发实际的GET或POST请求过来。

整合和测试

完整的处理逻辑大概是这样，放在处理API请求的PHP文件最前面：

<?php
// 允许来自特定来源的请求，生产环境务必替换成具体的前端域名
header("Access-Control-Allow-Origin: "); // 或者 '*'

// 允许的请求方法
header("Access-Control-Allow-Methods: GET, POST, OPTIONS, PUT, DELETE");

// 允许的请求头
header("Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With");

// 如果需要支持携带凭证（例如cookies）
// header("Access-Control-Allow-Credentials: true");

// 响应OPTIONS预检请求
if ($_SERVER['REQUEST_METHOD'] == 'OPTIONS') {
http_response_code(200); // 可以明确指定状态码 200 OK
exit;

// ... 这里开始是你正常的API业务逻辑代码 ...
?>

把这段代码加好后，清一下浏览器缓存，再让前端那边重新请求一次接口。打开浏览器的开发者工具（F12），看看Network（网络）面板，找到那个API请求。先看它的状态是不是200 OK了，再点开看Response Headers（响应头），确认有没有我们设置的那几个Access-Control-Allow-头信息。如果都有，并且控制台不报错了，那就说明搞定了。

如果用的是PHP框架，比如Laravel或Symfony，它们通常有更好的方式来处理CORS，比如通过中间件统一配置，这样就不用在每个控制器或者路由文件里都写一遍了，更方便管理。但原理都是一样的，就是设置这些响应头。

PHP处理CORS跨域这事儿，核心就是用header()函数在响应里加上那几个关键的Access-Control-Allow-头，并且别忘了处理OPTIONS预检请求。搞清楚流程，也不算复杂。

上一篇: net域名申请全攻略：新手也能轻松搞定！

php cors请求失败怎么办？常见错误和解决方法汇总。

随便看看