在使用phpEnv搭建本地开发环境时，提交大型JSON数据的POST请求经常会出现请求失败的情况，常见表现为返回413状态码或者请求无响应，这通常是服务器对请求体大小做了默认限制导致的。
问题产生的原因
Nginx默认会将客户端请求体的大小限制在1M以内，当提交的JSON数据超过这个阈值时，Nginx会直接拒绝请求并返回413 Request Entity Too Large错误。同时PHP默认也对POST请求的大小做了限制，即使Nginx放行了请求，PHP也可能无法正确接收数据。
配置Nginx参数
首先打开phpEnv的安装目录，找到Nginx的配置文件，通常路径为phpEnvnginxconfnginx.conf，如果是站点单独配置的话，也可以修改对应站点的conf文件。
在http块或者对应的server块中添加或修改以下参数：
http {
# 设置允许接收的最大请求体大小为20M，可根据实际需求调整
client_max_body_size 20m;
# 设置请求体缓冲区的临时存储路径，默认即可
client_body_temp_path temp/client_body_temp;
# 请求体读取超时时间，避免大文件传输超时
client_body_timeout 60s;
server {
listen 80;
server_name localhost;
location / {
root html;
index index.php index.html;
}
# PHP处理配置
location ~ .php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
# 可选：调整fastcgi读取请求体的超时时间
fastcgi_read_timeout 60s;
}
}
}
修改完成后保存文件，在phpEnv的控制面板中重启Nginx服务让配置生效。
配置PHP参数
Nginx配置完成后还需要调整PHP的相关参数，打开phpEnv中的PHP配置文件php.ini，不同PHP版本的路径类似phpEnvphpphp-7.x.xphp.ini。
找到以下参数并修改对应的值：
| 参数名 | 默认值 | 建议修改值 | 说明 |
|---|---|---|---|
| post_max_size | 8M | 20M | POST请求最大允许的大小，需要和Nginx的client_max_body_size保持一致或更大 |
| upload_max_filesize | 2M | 20M | 上传文件的最大大小，虽然JSON不是文件，但该参数也会影响大体积数据的接收 |
| max_input_time | 60 | 120 | 接收POST数据的最大时间，避免大体积JSON传输超时 |
| max_execution_time | 30 | 60 | PHP脚本最大执行时间，处理大JSON时可能需要更长时间 |
修改完成后保存文件，在phpEnv控制面板中重启PHP服务。
验证配置是否生效
可以编写一个简单的PHP测试脚本来验证配置是否生效，创建test_json.php文件，内容如下：
<?php
// 获取原始POST数据
$json_data = file_get_contents('php://input');
// 解析JSON数据
$data = json_decode($json_data, true);
if (json_last_error() === JSON_ERROR_NONE) {
echo '接收JSON数据成功，数据长度：' . strlen($json_data);
} else {
echo 'JSON解析失败：' . json_last_error_msg();
}
?>
然后使用Postman或者curl工具发送一个超过1M的JSON数据POST请求到该脚本，如果返回接收成功的信息，说明配置已经生效。
注意事项
- client_max_body_size参数不要设置得过大，避免恶意用户发送超大请求占用服务器资源。
- 修改配置后一定要重启对应的服务，否则配置不会生效。
- 如果还是出现请求失败的情况，可以查看Nginx的错误日志
phpEnvnginxlogserror.log排查问题。
phpEnvNginxJSON_POST请求large_json_data修改时间：2026-07-15 19:45:26