Ubuntu中如何配置PHP文件上传大小限制

在Ubuntu系统中配置PHP文件上传大小限制

处理大文件上传时，PHP的默认限制常常让人头疼。好在调整这个限制并不复杂，核心就在于修改一个配置文件。下面就来详细拆解一下在Ubuntu系统上，如何一步步搞定PHP文件上传大小的配置。

第一步：定位php.ini配置文件

所有魔法都始于找到正确的配置文件——php.ini。不过，系统里可能不止一个，具体用哪个取决于PHP的运行模式。最直接的方法，就是让PHP自己告诉你。打开终端，输入下面这条命令：

php --ini

命令执行后，它会清晰地列出当前加载的配置文件路径。通常，如果你通过Apache运行PHP，路径会是 /etc/php/7.x/apache2/php.ini；如果是命令行（CLI）模式，则可能是 /etc/php/7.x/cli/php.ini。这里的关键是，务必根据你Web应用实际使用的PHP模式来选择对应的文件，修改错了地方可不会生效。

第二步：编辑配置文件

找到目标文件后，就需要用文本编辑器打开它进行修改了。这里以常用的nano编辑器为例，记得在前面加上sudo来获取必要的权限：

sudo nano /etc/php/7.x/apache2/php.ini

注意，请把命令中的 7.x 替换成你服务器上实际的PHP主版本号，比如 7.4 或 8.1。

第三步：调整关键参数

在打开的php.ini文件中，你需要关注两个“黄金搭档”参数：

• upload_max_filesize：这个参数决定了单个文件允许上传的最大体积。
• post_max_size：这个参数控制了整个POST请求（可能包含多个文件和其他表单数据）的最大体积。

这里有个重要原则：post_max_size 的值必须设置得比 upload_max_filesize 大。道理很简单，整个包裹（POST请求）的尺寸肯定不能小于里面最大的那件物品（单个文件）。

举个例子，如果你希望允许上传最大10MB的单个文件，那么整个POST请求的限额可以设为20MB。找到这两行（可以使用编辑器的搜索功能），修改如下：

upload_max_filesize = 10M
post_max_size = 20M

第四步：保存并重启服务

修改完成后，在nano编辑器中按 Ctrl + X，然后输入 Y 确认保存，再按 Enter 退出即可。

但先别急，修改配置文件只是第一步，必须重启Web服务让新设置加载生效。根据你的服务器环境，执行对应的重启命令：

• 如果使用Apache：

  sudo systemctl restart apache2

• 如果使用Nginx + PHP-FPM：

  sudo systemctl restart php7.x-fpm
  sudo systemctl restart nginx

  （同样，别忘了替换7.x为你的PHP版本）

第五步：验证配置是否生效

重启之后，怎么知道修改成功了呢？创建一个简单的PHP信息测试页是最可靠的办法。新建一个文件（比如叫info.php），内容如下：

然后通过浏览器访问这个文件。在输出的庞大信息页面里，搜索“upload_max_filesize”和“post_max_size”，确认它们的值已经变成了你刚才设置的新数值。看到这里，就大功告成了。

整个过程其实就像调整水龙头的阀门，找准位置（配置文件），拧对开关（两个参数），然后让水流重新循环（重启服务），新的流量限制就生效了。下次再遇到上传限制的报错，不妨先来检查一下这两个关键参数吧。