在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 nginx7.x为你的PHP版本)
第五步:验证配置是否生效
重启之后,怎么知道修改成功了呢?创建一个简单的PHP信息测试页是最可靠的办法。新建一个文件(比如叫info.php),内容如下:
然后通过浏览器访问这个文件。在输出的庞大信息页面里,搜索“upload_max_filesize”和“post_max_size”,确认它们的值已经变成了你刚才设置的新数值。看到这里,就大功告成了。
整个过程其实就像调整水龙头的阀门,找准位置(配置文件),拧对开关(两个参数),然后让水流重新循环(重启服务),新的流量限制就生效了。下次再遇到上传限制的报错,不妨先来检查一下这两个关键参数吧。
