phpEnv怎么配置Nginx请求体限制 phpEnv解决LargeClientHeader方法-php教程-PHP中文网

需在 phpenv 站点配置文件的 location 块（如 /phpenv/nginx/vhosts/your-site.conf 中 location ~ \.php$）内添加 client_max_body_size 50m;，并同步调整 php 的 post_max_size 和 upload_max_filesize，最后执行 phpenv restart nginx && phpenv restart php-fpm 生效。

phpenv怎么配置nginx请求体限制 phpenv解决largeclientheader方法

phpEnv 中 Nginx 的 `client_max_body_size` 怎么配

phpEnv 默认的 Nginx 配置对上传和大请求体非常保守，client_max_body_size 通常保持默认的 1m，一旦前端 POST 超过 1MB 的 JSON 或上传文件，立刻返回 413 Request Entity Too Large。

直接改 nginx.conf 不够——phpEnv 的配置分两层：主配置（/phpenv/nginx/conf/nginx.conf）和站点配置（如 /phpenv/nginx/vhosts/your-site.conf），优先级后者更高。实操建议：

在站点 location / 或 location ~ \.php$ 块内加 client_max_body_size 50m;，比全局设更安全
避免写在 if 块里（Nginx 不允许）或 http 块顶层（影响所有站点）
单位用 m（如 50m）比 MB 可靠，Nginx 只认 k/m/g
改完必须执行 phpenv restart nginx（不是 reload），否则 phpEnv 的守护进程不生效

phpEnv 报 `400 Bad Request` 或 `414 Request-URI Too Large` 怎么调 `large_client_header_buffers`

这类错误不是 Body 大小问题，而是请求头（Header）超限，常见于带长 JWT、多段 Cookie、或 WAP 类客户端。phpEnv 默认的 client_header_buffer_size 是 1k，large_client_header_buffers 是 4 8k，不够应付现代前端框架发的复杂鉴权头。

关键不是盲目调大，而是精准匹配实际 Header 长度：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

先用 ngrep -W byline 'GET /' 'tcp and dst port 80' 抓包，再用 awk -vRS='#+' '{print length()}' 看 header 实际长度
若多数请求头在 4K 内，但个别达 16K，就设 client_header_buffer_size 4k; + large_client_header_buffers 4 16k;
缓冲区数量（第一个数字）别设太大，比如 8 16k 会预占 128KB 内存/连接，高并发时易 OOM
该配置只能放在 http 或 server 块，不能进 location

为什么改了 Nginx 还是 413？检查 phpEnv 的 PHP 层限制

Nginx 放行了，PHP 还可能拦第二道。phpEnv 自带的 php.ini（路径类似 /phpenv/php/etc/php.ini）里必须同步放开：

post_max_size = 64M（必须 ≥ Nginx 的 client_max_body_size）
upload_max_filesize = 64M（仅影响 $_FILES，不影响纯 JSON POST）
max_input_vars = 5000（如果 POST 含大量表单字段，这个也会触发静默截断）
改完要 phpenv restart php-fpm，光重启 Nginx 没用

注意：post_max_size 是总请求体上限，包含所有字段+文件，不是单个文件大小。

OPTIONS 预检失败导致跨域上传卡住？phpEnv 的 CORS 配置要点

大 Body 跨域上传失败，90% 是 OPTIONS 预检没过，而不是 Body 限制本身。phpEnv 的 Nginx 不自带 CORS 头，必须手动补全：

在站点配置的 location /api/ 块里，加 add_header Access-Control-Allow-Headers 'Content-Type,Authorization,X-Requested-With'; ——漏掉 Content-Type，带 JSON 的 POST 就会被浏览器拒掉
单独处理 OPTIONS：if ($request_method = 'OPTIONS') { add_header Access-Control-Allow-Origin '*'; add_header Access-Control-Allow-Methods 'POST,OPTIONS'; add_header Access-Control-Max-Age 86400; add_header Content-Length 0; return 204; }
生产环境禁用 *，换成具体域名；Access-Control-Allow-Credentials true 时，Origin 不能为 *