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

如何解决前端跨域访问 PHP 接口时的 CORS 阻止问题

雨涛大大_7938

雨涛大大_7938

发布时间:2026-03-26 17:05:03

|

690人浏览过

|

来源于php中文网

原创

如何解决前端跨域访问 PHP 接口时的 CORS 阻止问题

本文详解如何在 php 后端正确配置 cors 响应头,使本地前端(如 http://127.0.0.1:5500)能安全、合法地调用远程 php api(如 http://cop4331-5.com/lampapi/login.php),彻底解决 “no 'access-control-allow-origin' header is present” 报错。

本文详解如何在 php 后端正确配置 cors 响应头,使本地前端(如 http://127.0.0.1:5500)能安全、合法地调用远程 php api(如 http://cop4331-5.com/lampapi/login.php),彻底解决 “no 'access-control-allow-origin' header is present” 报错。

当使用 XMLHttpRequest 或 fetch 从本地开发服务器(如 VS Code Live Server 的 http://127.0.0.1:5500)向远程 PHP 接口(如 http://cop4331-5.com/LAMPAPI/Login.php)发起请求时,浏览器会强制执行同源策略(Same-Origin Policy)。若 PHP 服务端未显式声明跨域许可,预检请求(preflight)将失败,并抛出经典错误:

Access to XMLHttpRequest at 'http://cop4331-5.com/LAMPAPI/Login.php' 
from origin 'http://127.0.0.1:5500' has been blocked by CORS policy: 
Response to preflight request doesn't pass access control check: 
No 'Access-Control-Allow-Origin' header is present on the requested resource.

该错误根源不在前端代码(你的 XMLHttpRequest 写法完全正确),而在于 PHP 服务端缺失必要的 HTTP 响应头。解决方案是:在 PHP 脚本(如 Login.php)顶部添加标准 CORS 头,确保响应中包含 Access-Control-Allow-Origin 等关键字段。

✅ 正确的 PHP CORS 配置方式(推荐)

在 Login.php 文件最开头(任何输出之前,即 <?php 后立即写入)添加以下代码:

前端设计优化skill
前端设计优化skill

前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。

下载
<?php
// 允许指定源(生产环境推荐)
header('Access-Control-Allow-Origin: http://127.0.0.1:5500');
// 或允许所有源(仅限开发调试,禁止用于生产)
// header('Access-Control-Allow-Origin: *');

// 允许的请求方法
header('Access-Control-Allow-Methods: POST, OPTIONS');
// 允许携带的请求头(与前端 xhr.setRequestHeader 一致)
header('Access-Control-Allow-Headers: Content-Type, X-Requested-With');
// 允许前端读取的响应头(如自定义 token 字段)
header('Access-Control-Expose-Headers: X-Auth-Token');

// 处理预检请求(OPTIONS)
if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
    http_response_code(200);
    exit;
}

// 后续原有业务逻辑(如接收 JSON、验证登录等)保持不变
$rawData = file_get_contents('php://input');
$data = json_decode($rawData, true);

// 示例:简单响应结构
if (isset($data['login']) && isset($data['password'])) {
    // 这里插入你的认证逻辑...
    $response = [
        'id' => 123,
        'firstName' => 'John',
        'lastName' => 'Doe'
    ];
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode($response);
} else {
    http_response_code(400);
    echo json_encode(['error' => 'Missing login or password']);
}
?>

⚠️ 关键注意事项

  • 顺序至关重要:header() 必须在任何 HTML 输出、echo、空格或 BOM 字符之前调用,否则会触发 headers already sent 错误;
  • * 不适用于带凭证的请求:若前端设置了 xhr.withCredentials = true(例如需传递 Cookie),则 Access-Control-Allow-Origin 不能为 *,必须明确指定源(如 http://127.0.0.1:5500),并额外添加:
    header('Access-Control-Allow-Credentials: true');

    同时前端需启用凭证支持:

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

    xhr.withCredentials = true; // 在 xhr.open() 后添加
  • 避免代理“绕过”CORS:使用 CORS 代理(如 cors-anywhere)仅是临时调试手段,存在安全与稳定性风险,不应作为生产方案;根本解法永远是服务端正确配置 CORS;
  • Apache/Nginx 补充建议:若无法修改 PHP 文件,也可在 Web 服务器层统一配置(如 Apache 的 .htaccess):
    Header set Access-Control-Allow-Origin "http://127.0.0.1:5500"
    Header set Access-Control-Allow-Methods "POST, OPTIONS"
    Header set Access-Control-Allow-Headers "Content-Type, X-Requested-With"

✅ 总结

CORS 是浏览器的安全机制,而非 bug。解决 Unable to access php resource from remote IP 的核心思路是:让服务端主动声明“我允许谁来调用我”。通过在 PHP 中精准设置 Access-Control-Allow-Origin 及配套头信息,即可实现安全、合规的跨域通信。开发阶段可适度放宽策略,上线前务必收敛至最小必要权限,兼顾功能性与安全性。

相关文章

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

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

下载

相关标签:

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

热门AI工具

更多
豆包大模型

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Laper
Laper Hot

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

DeepSeek

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

火山引擎

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

WorkBuddy

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

Seko
Seko Hot

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

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

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

2603

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5623

2023.10.09

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

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

6610

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6298

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

883

2024.05.22

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

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

11224

2023.09.01

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

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

6501

2023.10.11

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

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

2155

2023.10.11

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

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

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