phpEnv下PHP上传500错误主因是Nginx的client_body_temp目录权限不足或client_max_body_size等缓冲配置过小，需确认Nginx运行用户、赋权临时目录、调大client_max_body_size与PHP层upload_max_filesize并同步重启。
phpEnv 环境下 PHP 文件上传触发 500 错误，绝大多数情况不是代码问题，而是 client_body_temp 目录权限或 Nginx 缓冲区配置不匹配导致的 —— 尤其当小文件能传、大文件必报错时，基本可以锁定这点。
确认 phpEnv 是否真在用 Nginx + PHP-FPM
phpEnv 默认集成的是 Nginx（非 Apache），所以 .htaccess 无效，client_body_temp 和 client_max_body_size 这类 Nginx 指令才起作用。如果误按 Apache 方式排查（比如改 .htaccess 或 mod_rewrite），会白费时间。
- 打开 phpEnv 控制面板 → 查看「服务状态」，确认运行的是
nginx和php-fpm，不是apache - 终端执行
ps aux | grep nginx或netstat -tuln | grep :80，验证监听进程归属 - 若实际走的是 Apache（极少见），则需切换排查思路：检查
LimitRequestBody和httpd.conf中的Timeout
检查 client_body_temp 目录权限和归属
Nginx 接收上传文件时，会先写入临时目录 client_body_temp，再交给 PHP 处理。如果该目录不可写、无执行权限，或属主不是 Nginx 工作用户（通常是 www 或 nginx），就会静默返回 500。
- 找到 Nginx 配置中定义的路径：
grep client_body_temp /path/to/phpenv/nginx/conf/nginx.conf，常见位置如/phpenv/nginx/client_body_temp或/tmp/nginx/client_body_temp - 执行
ls -ld /phpenv/nginx/client_body_temp，确认权限至少为755，且属主是 Nginx 运行用户（如www:www） - 若目录不存在，手动创建并赋权：
mkdir -p /phpenv/nginx/client_body_temp && chown www:www /phpenv/nginx/client_body_temp && chmod 755 /phpenv/nginx/client_body_temp - 注意：不要设成
777，Nginx 默认拒绝 world-writable 的 temp 目录
核对 client_max_body_size 和 client_body_buffer_size
默认值往往太小（如 1MB），而表单中 MAX_FILE_SIZE 只是前端提示，真正拦住上传的是 Nginx 层限制。超限后不报 413，反而抛 500，这是 phpEnv 常见表现。
立即学习“PHP免费学习笔记（深入）”；
- 编辑
/phpenv/nginx/conf/nginx.conf，在http或对应server块中添加或修改：
client_max_body_size 20M; client_body_buffer_size 128k;
client_max_body_size 必须 ≥ 你期望上传的最大单文件体积；client_body_buffer_size 建议设为 client_max_body_size 的 1/16～1/8，避免频繁刷盘/phpenv/nginx/sbin/nginx -s reload（不是 stop/start）upload_max_filesize 和 post_max_size 也得同步调大，否则 PHP 会自己截断并报错为什么错误日志里可能看不到线索
phpEnv 的 Nginx error log 默认级别较粗，且部分底层失败（如内核 write 权限拒绝）不会记入 error.log，只出现在系统日志或 strace 中。
- 先查
/phpenv/nginx/logs/error.log，但别只盯它 —— 同时运行tail -f /var/log/messages | grep nginx（Linux）或log show --predicate 'process contains "nginx"' --last 5m（macOS） - 若仍无输出，用
strace抓 PHP-FPM 子进程：strace -p $(pgrep -f "php-fpm.*www") -e trace=write,openat -s 256 2>&1 | grep -i "denied\|no such" - 常见真实报错其实是：
openat(AT_FDCWD, "/phpenv/nginx/client_body_temp/xxx", O_WRONLY|O_CREAT|O_EXCL, 0600) = -1 EACCES (Permission denied)
真正卡住人的地方，往往不是配置项本身，而是 phpEnv 把 Nginx 和 PHP-FPM 的用户、路径、日志分散在不同子目录里，又没统一文档说明。动手前务必用 ps aux | grep nginx 和 ps aux | grep php-fpm 确认实际进程用户和配置加载路径，别凭经验猜。
