PHP文件上传限制问题排查教程

首先修改php.ini中的upload_max_filesize、post_max_size等参数，然后重启Web服务器，并检查.htaccess和Apache的LimitRequestBody设置以确保文件上传限制被正确解除。

如果您尝试通过PHP应用上传文件，但进程在完成前中断或提示文件过大，则很可能是服务器的文件上传大小限制所致。以下是解决此问题的步骤：

一、修改php.ini核心参数

php.ini是PHP的主要配置文件，调整其中的关键参数是解决上传限制的根本方法。需要同时修改多个相互关联的设置以确保生效。

1、通过运行php --ini命令找到当前加载的php.ini文件的准确路径。

2、使用文本编辑器（如vim或nano）打开该php.ini文件。

3、在文件中搜索并修改以下配置项：

upload_max_filesize = 100M 将此值设置为您期望允许上传的单个文件最大大小，例如100M表示100兆字节。

post_max_size = 100M 此值必须大于或等于upload_max_filesize，因为它限制了整个POST请求的数据总量，包含文件和表单数据。

memory_limit = 256M PHP脚本可用的最大内存。建议将其设置为post_max_size的1.5到2倍，以防止处理大文件时内存耗尽导致Fatal error。

max_execution_time = 300 脚本最长执行时间（秒）。上传大文件耗时较长，增大此值可避免超时中断。

max_input_time = 300 解析输入数据的最长时间（秒），也应相应增加以匹配大文件上传的需求。

4、保存对php.ini文件的修改并退出编辑器。

二、重启Web服务器

PHP配置文件的更改不会自动应用，必须重启托管PHP的Web服务才能使新设置生效。

1、如果使用Apache作为Web服务器，请执行以下命令之一来重启服务：

sudo systemctl restart apache2 （适用于Debian/Ubuntu系统）

sudo systemctl restart httpd （适用于CentOS/RHEL系统）

2、如果使用Nginx与PHP-FPM组合，请分别重启两个服务：

sudo systemctl restart nginx

sudo systemctl restart php-fpm

三、检查.htaccess覆盖配置

对于共享主机环境或无法直接修改主php.ini的情况，可以在网站根目录或特定目录下使用.htaccess文件来覆盖部分PHP设置。

1、导航到您的网站文档根目录，查找名为.htaccess的文件。

2、如果文件不存在，可以创建一个新文件。

3、在.htaccess文件中添加以下指令：

php_value upload_max_filesize 100M

php_value post_max_size 100M

php_value max_execution_time 300

4、保存文件。这些指令将作用于该目录及其子目录下的PHP脚本。

四、验证Apache的LimitRequestBody设置

Apache服务器自身的LimitRequestBody指令会限制客户端请求体的总大小，这可能独立于PHP设置构成瓶颈。

1、找到Apache的主配置文件httpd.conf或虚拟主机配置文件。

2、在相应的、或全局上下文中查找LimitRequestBody指令。

3、如果该指令存在且值过小（例如默认可能为512K），请将其修改为更大的值，单位为字节。例如，要允许1GB的上传：

LimitRequestBody 1073741824

4、如果希望完全移除此限制，可以将值设为0，但这可能存在安全风险。

5、修改后，必须重启Apache服务使配置生效。