答案是phpenv下需先通过php --ini或phpinfo()确认实际加载的php.ini路径，再修改对应SAPI（如PHP-FPM）的配置文件，而非默认~/.phpenv/versions/x.x.x/etc/php.ini；常见生效路径为/etc/php/x.x/fpm/php.ini或/usr/local/etc/php/x.x/php.ini，修改后须重启PHP-FPM及Web服务器。
phpenv 下改哪个 php.ini？先确认当前生效的配置文件
phpenv 管理多个 PHP 版本，但 php.ini 不是随版本自动切换的「默认路径」，它取决于你当前用的 SAPI（如 CLI、Apache、PHP-FPM）和加载方式。直接在 ~/.phpenv/versions/8.2.10/etc/php.ini 里改，很可能不生效——因为 Web 请求走的是 PHP-FPM 或 Apache 模块加载的配置，不是 CLI 的那个。
必须先查清实际加载的 php.ini 路径：
- 运行
php --ini（CLI 场景）或php -r "phpinfo();"（Web 场景），重点看Loaded Configuration File行 - 常见路径有：
~/.phpenv/versions/8.2.10/etc/php.ini（CLI）、/usr/local/etc/php/8.2/php.ini（macOS Homebrew + phpenv 混合环境）、或系统级路径如/etc/php/8.2/fpm/php.ini（Ubuntu + PHP-FPM） - 如果你用的是 Nginx + PHP-FPM，99% 是
/etc/php/8.2/fpm/php.ini或类似路径，不是 phpenv 自己的etc/
upload_max_filesize 改了但上传失败？检查 post_max_size 是否同步调大
只改 upload_max_filesize 是无效的。PHP 在接收 POST 数据时，会先校验整个请求体大小，这个上限由 post_max_size 控制。哪怕你设了 upload_max_filesize = 100M，但 post_max_size = 8M，上传就会静默失败（$_FILES 为空，$_POST 也为空）。
必须同时设置且满足关系：
立即学习“PHP免费学习笔记（深入）”；
upload_max_filesize = 100M-
post_max_size = 105M（建议比 upload 大 5M 左右，留出表单字段空间） -
memory_limit = 128M（至少 ≥post_max_size，否则解析 POST 时内存溢出） -
max_execution_time = 300和max_input_time = 300（大文件上传慢，超时会导致中断）
phpenv 环境下重启服务容易漏掉 PHP-FPM
phpenv 本身不管理 Web 服务进程。你改完 php.ini 后，如果用的是 PHP-FPM（绝大多数生产/本地开发环境都是），必须重启 php-fpm，而不是只重启 Apache/Nginx。
常见操作顺序：
- 确认你改的是 PHP-FPM 加载的
php.ini（比如/etc/php/8.2/fpm/php.ini） - 执行
sudo systemctl restart php8.2-fpm（Ubuntu/Debian）或brew services restart php@8.2（macOS Homebrew + phpenv） - 再重启 Web 服务器：
sudo systemctl restart nginx或sudo apachectl restart - 验证：上传一个略大于原限制的文件，同时检查 PHP 错误日志（路径见
phpinfo()中的error_log）——典型报错PHP Warning: POST Content-Length of XXX bytes exceeds the limit of YYY bytes就说明post_max_size还没调够
Nginx 层 client_max_body_size 必须对齐 PHP 限制
即使 PHP 配置全调高了，Nginx 会在请求进入 PHP 前就拦截超大的请求体。错误现象是直接返回 413 Request Entity Too Large，连 PHP 日志都不会写。
在 Nginx 配置中（通常是站点 server 块或 http 块），必须加：
client_max_body_size 105M;
注意三点：
- 该值应 ≥
post_max_size（建议完全一致，比如都设为105M） - 修改后必须
sudo nginx -t && sudo systemctl restart nginx - 如果用的是宝塔、LNMP 一键包等集成环境，别去改全局
nginx.conf，优先在对应网站的「配置修改」里加，避免被覆盖
最常被忽略的点：你以为改了 phpenv 目录下的 php.ini 就万事大吉，其实 Web 请求根本没加载它；还有人只调 upload_max_filesize，结果 post_max_size 卡死在 8M，上传时 $_FILES 直接为空，连错误都不报。
