现象
把 upload_max_filesize 从 2M 改成 64M,重启 php-fpm 后上传 10M 文件仍失败,phpinfo 页面显示的还是 2M。打开终端执行 php --ini,Loaded Configuration File 指向 /etc/php/8.3/CLI/php.ini,和网站实际使用的配置不是同一个。
原因
PHP 按 SAPI 区分配置文件,CLI、FPM、Apache 模块各读各的目录。改的是 cli/php.ini,FPM 自然看不到;conf.d 目录下后加载的 ini 也可能把值覆盖回去;容器部署时宿主机配置常被镜像内文件覆盖,改了外面不生效。
解决步骤
第一步,确认 FPM 加载了哪个文件。用 FPM 的二进制查看配置路径,而不是用命令行 php,两者结论经常不同。
php --ini
php-fpm8.3 -i | grep "Loaded Configuration"
php-fpm8.3 -i | grep "Scan this dir"
第二步,找出后加载的覆盖项。全局搜索该配置项,按文件名排序,编号越大的 ini 越晚加载,最后写入的值生效。
grep -r "upload_max_filesize" /etc/php/8.3/
ls /etc/php/8.3/fpm/conf.d/
第三步,新建高编号配置并重启。在 FPM 的 conf.d 下建 99 开头的文件写入目标值,重启而不是 reload,再用 phpinfo 或 ini_get 确认。
echo 'upload_max_filesize=64M' > /etc/php/8.3/fpm/conf.d/99.ini
systemctl restart php8.3-fpm
php -r "var_dump(ini_get('upload_max_filesize'));"
验证
站点 phpinfo 里 upload_max_filesize 显示 64M,post_max_size 同步调大后大文件上传成功,FPM 与 CLI 的值不再混淆。
小结
改配置先确认 SAPI 和加载顺序。用 FPM 自己的 -i 输出定位文件,再建高编号 ini 覆盖,最后重启验证。
