win7搭建php环境本地测试接口跨域解决

落枫同学_7868

落枫同学_7868

2026-10-14

163人浏览

原创

win7本地php跨域只需在脚本开头加5行header并处理options请求:必须确保header()在任何输出前执行、禁用bom、动态匹配origin、显式响应options预检,否则浏览器因端口不同(如localhost:8080→localhost:80)直接拦截。

win7搭建php环境本地测试接口跨域解决

Win7 上本地测试 PHP 接口时遇到跨域问题,根本不用动前端、也不用装 nginx 或配代理——直接在 PHP 脚本开头加几行 header() 就能跑通,但必须满足两个硬条件:输出不能提前、OPTIONS 请求得单独处理。

为什么 localhost:8080 访问 localhost:80 会跨域

协议、域名、端口三者任一不同即跨域。哪怕都是 localhost,只要端口不一样(比如前端开在 http://localhost:8080,PHP 接口跑在 http://localhost:80 或集成环境的 :8081),浏览器就拦你。这不是 PHP 报错,是控制台里清清楚楚写着:Access to XMLHttpRequest at 'http://localhost:8081/api.php' from origin 'http://localhost:8080' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

PHP 文件开头必须加这 5 行 header

别写在 echo 后面,别写在 print 后面,别包含任何空格或 BOM 字符——所有 header() 必须在脚本第一行可执行逻辑之前。

  • header('Access-Control-Allow-Origin: http://localhost:8080'); —— 生产环境必须写死域名,开发阶段可以先这么写;别用 * 配带凭证的请求(比如要传 Cookie)
  • header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS'); —— 前端发什么方法,这里就得列什么
  • header('Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With'); —— 前端如果手动设了 Content-Type: application/json 或加了 Authorization 头,这里不声明就会卡在预检
  • header('Access-Control-Allow-Credentials: true'); —— 只有需要读写 Cookie 或带认证头时才加;加了这句,Access-Control-Allow-Origin 就不能是 *
  • if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') { http_response_code(200); exit(); } —— 浏览器发预检请求(OPTIONS)时,PHP 必须立刻返回 200 并终止,否则后续业务逻辑会执行两次

phpstudy/XAMPP 环境下常见踩坑点

Win7 用户大概率用的是 phpstudy 或 XAMPP,这两个环境默认开启 output_buffering,但依然挡不住“页面顶部有空行”或“UTF-8 BOM”导致 header() 失效。

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

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

下载
  • 用 Notepad++ 打开 PHP 文件 → 编码菜单 → 选“转为 UTF-8 无 BOM 格式”
  • 检查文件开头有没有空行、<?php 前有没有空格或不可见字符
  • 别在 header() 前做任何 echo、var_dump、print_r,哪怕只是调试用也不行
  • phpstudy 的“网站根目录”里如果放了 index.html,又通过浏览器直接打开这个 HTML(file:// 协议),那根本不是跨域,是浏览器禁止 AJAX 读取本地文件——必须用 http:// 协议访问(比如 http://localhost/test.html)

测试是否生效的最快方式

别等前端改完再试,用最简 PHP 脚本验证:

<?php header('Access-Control-Allow-Origin: http://localhost:8080');
header('Access-Control-Allow-Methods: GET, POST, OPTIONS');
header('Access-Control-Allow-Headers: Content-Type');
header('Access-Control-Allow-Credentials: true');

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

echo json_encode(['status' => 'ok', 'data' => 'from php']);
?>

保存为 api.php,用浏览器访问 http://localhost/api.php 看是否返回 JSON;再用前端代码发起带 credentials: 'include' 的 fetch,看控制台有没有跨域报错。没报错,说明头设置对了;报错但提示 has credentials 相关,说明 Access-Control-Allow-Origin 还写了 *;报错说 preflight 失败,八成是 OPTIONS 没拦截住或者 Allow-Headers 漏了字段。

Win7 系统本身不干预 HTTP 头,真正卡人的永远是输出顺序、BOM、和预检逻辑这三处——调通之后,接口就能本地稳稳跑起来。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

一键重装系统工具
一键重装系统工具

一键重装系统工具是一款专注装机小白用的一键电脑重装系统软件。支持一键重装win7、win10、win11电脑系统。在线装机,无需光驱U盘,无需电脑技术,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

php环境搭建 php win7

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

相关专题

更多
php文件怎么打开
php文件怎么打开

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

2023.09.01

10644

6

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

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

2023.10.11

6221

5

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

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

2023.10.11

2135

5

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

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

2023.10.23

3928

4

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

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

2023.10.23

4634

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3631

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5197

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4082

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12002

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习