PHP使用cURL发送POST请求时$_POST为空数组问题咨询

• 本地测试环境使用PHP cURL扩展模拟POST请求，共编写2个测试文件：
  • test-api-key.php（请求发起端）：构造包含firstName、lastName字段的测试数组，初始化cURL后配置CURLOPT_URL指向本地接收地址、CURLOPT_POST=true、CURLOPT_POSTFIELDS传入经http_build_query()处理的测试数据、CURLOPT_RETURNTRANSFER=true，执行请求后输出返回响应，同时调用var_dump()、printf()打印当前页面$_POST变量做调试
  • request.php（请求接收端）：读取并打印$_POST数组中的firstName、lastName字段值
• 测试异常表现：
  1. 访问test-api-key.php时，cURL返回的响应内容中可以正常读到两个姓名字段值，但当前页面打印的$_POST为空数组
  2. 直接单独访问request.php时，同样无法读取到$_POST内的字段数据
• 后续需求：实现跨服务器POST数据对接，已拿到正式API要求的请求头配置，需要排查$_POST为空的根因，理清cURL POST的运行逻辑，支撑正式功能开发

PHP的$_POST是请求上下文绑定的超全局变量，仅存储当前HTTP请求的发起方传给当前运行脚本的POST表单数据，不会存储当前脚本主动向外发送的请求参数，你遇到的两个“为空”的表现都是请求上下文隔离导致的正常现象，不是代码逻辑错误：

• 访问test-api-key.php时，你通过浏览器发起的是对test-api-key.php本身的HTTP请求，这个请求没有携带任何POST参数，所以test-api-key.php里打印自身的$_POST必然是空数组。而cURL是test-api-key.php在服务端运行时，由服务器作为客户端单独向request.php发起的第二层独立HTTP请求，这层请求的POST数据只存在于request.php的运行上下文中，所以cURL拿到的request.php返回内容能正常读到字段值，恰恰说明你的cURL POST发送逻辑是生效的。
• 直接在浏览器地址栏访问request.php时，浏览器默认发起的是GET请求，本身没有携带任何POST表单参数，request.php的$_POST自然为空。只有其他客户端以POST方法、携带符合格式要求的参数请求request.php时，它的$_POST才会填充对应数据。

两个脚本的运行分属两个完全独立的HTTP请求上下文，链路如下：

1. 第一层请求：你在浏览器输入test-api-key.php地址发起访问，请求方是你的浏览器，接收方是Web服务器上的test-api-key.php脚本。这层请求的请求方法、携带参数，仅决定test-api-key.php自身的$_GET、$_POST等超全局变量的取值。
2. 内部请求发起：test-api-key.php运行到cURL相关代码时，Web服务器会临时充当HTTP客户端，按照你配置的cURL参数发起第二层独立的HTTP请求，目标地址是CURLOPT_URL配置的request.php地址，这层请求的POST参数、请求头都是你通过cURL配置项单独设置的，和第一层请求没有任何数据关联，参数只会填充到第二层请求接收方（即request.php）的运行上下文中。
3. 响应返回：request.php收到第二层cURL请求后，读取自身上下文中的$_POST数据处理，将处理结果返回给发起cURL请求的Web服务器，这个结果就是curl_exec()的返回值。test-api-key.php拿到结果后拼接自身输出内容，作为第一层请求的响应返回给你的浏览器。

• 本地cURL逻辑验证：不需要在test-api-key.php中打印自身的$_POST，只要cURL返回的request.php输出内容中能正常读到firstName、lastName的值，就说明POST请求发送逻辑完全正常。
• request.php单独测试：不要直接通过浏览器地址栏访问（默认GET请求无POST参数），可以用接口测试工具构造POST请求、携带对应参数访问，才能看到$_POST的正确取值。
• 跨服务正式对接注意事项：
  • 如果正式API要求application/x-www-form-urlencoded格式的表单参数，你当前用http_build_query()处理数组后传入CURLOPT_POSTFIELDS的写法是正确的，服务端可以正常从$_POST中读取参数。
  • 如果正式API要求application/json格式参数，不要调用http_build_query()，直接将数组通过json_encode()处理后传入CURLOPT_POSTFIELDS，同时手动添加Content-Type: application/json请求头即可。注意这种格式下PHP编写的服务端无法从$_POST读取参数，需要从php://input原始输入流中获取内容后解析。
  • 正式代码建议增加错误处理：配置合理的CURLOPT_TIMEOUT超时时间，HTTPS请求根据部署环境调整CURLOPT_SSL_VERIFYPEER、CURLOPT_SSL_VERIFYHOST配置，执行curl_exec()后先通过curl_errno()判断是否有请求错误，拿到错误信息及时排查，避免请求失败时无调试依据。

内容的提问来源于stack exchange，提问作者Yenmangu