phpinfo() 中找不到 upload_max_filesize 是因为 file_uploads = Off 时该配置项被跳过加载;需确认 Loaded Configuration File、file_uploads 状态、CLI 与 Web 配置一致性,并同步检查 post_max_size、memory_limit 和 Nginx 的 client_max_body_size。

phpinfo() 页面确实会显示 upload_max_filesize 的当前值,但仅当该配置项被实际加载并生效时才可见——它不会出现在“未启用文件上传”的 PHP 环境中。
为什么有时在 phpinfo() 里找不到 upload_max_filesize?
PHP 默认开启文件上传功能,但若编译时禁用了 --disable-fileinfo 或更关键的 --disable-maintainer-zts 并配合某些 SAPI(如部分嵌入式或精简版 CGI),file_uploads 可能被强制设为 Off。此时 PHP 内部会跳过加载与上传相关的 ini 项,upload_max_filesize 就不会出现在 phpinfo() 的输出表格中。
-
file_uploads = Off时,upload_max_filesize和post_max_size均不生效,也不显示 - 即使 ini 文件写了
upload_max_filesize = 64M,若所在配置段(如[Path])不匹配当前脚本路径,该值也不会被应用,phpinfo() 中显示的仍是默认值(通常2M) - CLI 模式下运行
php -i输出的配置,和 Web SAPI(如 Apache/FPM)的配置可能完全不同,不能混用
如何确认你看到的 upload_max_filesize 是真实生效值?
不要只信 phpinfo() 表格里那一行。必须交叉验证:
- 检查 phpinfo() 页面顶部的
Loaded Configuration File路径,用grep upload_max_filesize /path/to/php.ini确认该文件中是否真有定义 - 查看同一页面中
file_uploads的值是否为On;若为Off,后面所有上传相关配置都无效 - 运行
php -r "echo ini_get('upload_max_filesize');"对比 CLI 下的值,若与 Web 端不一致,说明 FPM/Apache 使用了独立的 php.ini
upload_max_filesize 和 post_max_size 的关系必须手动对齐
phpinfo() 会分别列出这两个值,但它们之间没有自动联动。哪怕 upload_max_filesize = 128M,只要 post_max_size = 8M,单个文件仍无法超过 8MB —— 因为整个 POST 请求体(含其他字段+文件)不能超限。
立即学习“PHP免费学习笔记(深入)”;
-
post_max_size必须 ≥upload_max_filesize,否则上传直接失败,且错误日志里常只报PHP Warning: Unknown: POST Content-Length of XXX bytes exceeds the limit of YYY bytes - 若启用了
memory_limit,它也需 ≥post_max_size,否则大文件上传中途可能因内存不足被 kill - 修改后务必重启对应服务:Apache 需
sudo systemctl restart apache2,PHP-FPM 需sudo systemctl restart php*-fpm(版本号要匹配)
真正容易被忽略的是:Nginx 自身也有 client_max_body_size,它在 PHP 执行前就拦截请求。即使 phpinfo() 显示 upload_max_filesize 是 256M,Nginx 默认只允许 1M,上传照样 413。这个值不在 phpinfo() 里,得去 Nginx 配置查。











