登录
首页 >  文章 >  php教程

查看PHP上传限制方法:upload_max_filesize设置详解

时间:2026-01-25 16:48:48 433浏览 收藏

小伙伴们有没有觉得学习文章很有意思?有意思就对了!今天就给大家带来《查看PHP上传限制方法:upload_max_filesize值详解》,以下内容将会涉及到,若是在学习中对其中部分知识点有疑问,或许看了本文就能帮到你!

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值法【查证】

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_filesizepost_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_filesizepost_max_size 的关系必须手动对齐

phpinfo() 会分别列出这两个值,但它们之间没有自动联动。哪怕 upload_max_filesize = 128M,只要 post_max_size = 8M,单个文件仍无法超过 8MB —— 因为整个 POST 请求体(含其他字段+文件)不能超限。

  • 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 配置查。

今天带大家了解了的相关知识,希望对你有所帮助;关于文章的技术知识我们会一点点深入介绍,欢迎大家关注golang学习网公众号,一起学习编程~

前往漫画官网入口并下载 ➜
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>