CentOS系统下配置PHP上传文件限制详细教程

在使用PHP开发文件上传相关功能时，默认的配置往往无法满足大文件上传的需求，比如上传超过2MB的文件就会失败。本文将以CentOS系统为例，详细介绍如何修改PHP配置来调整文件上传相关限制，适配不同的业务场景。

一、前置准备

操作前需要确认当前系统已经安装了PHP环境，并且要知道PHP配置文件php.ini的具体路径。可以通过以下命令快速查看php.ini的位置：

# 查看PHP配置文件路径，适用于PHP 7.x及以上版本
php --ini | grep "Loaded Configuration File"

# 如果是通过yum安装的PHP，通常路径为 /etc/php.ini 或者 /etc/php.d/ 目录下的配置文件

如果输出结果为Loaded Configuration File: /etc/php.ini，说明主配置文件就是/etc/php.ini，后续修改都针对这个文件操作即可。

二、核心配置项说明

PHP中与文件上传相关的核心配置项有以下几个，我们需要根据实际需求调整这些参数的值：

三、修改配置步骤

1. 备份原配置文件

为了防止修改出错无法恢复，首先备份原有的php.ini文件：

cp /etc/php.ini /etc/php.ini.bak

2. 编辑php.ini文件

使用vim或者nano编辑器打开php.ini文件：

vim /etc/php.ini

在文件中找到上述提到的配置项，按照需求修改数值，比如需要支持最大100MB的文件上传，同时单次最多上传10个文件，可以修改如下：

; 开启文件上传功能
file_uploads = On

; 单个文件最大100MB
upload_max_filesize = 100M

; POST请求最大110MB，略大于单个文件大小，避免边界问题
post_max_size = 110M

; 单次最多上传10个文件
max_file_uploads = 10

; 自定义临时目录，需要确保目录存在且有写入权限
upload_tmp_dir = /tmp/php_upload_tmp

修改完成后保存退出编辑器，如果是vim编辑器，按Esc后输入:wq回车即可保存。

3. 创建并配置临时目录（可选）

如果自定义了upload_tmp_dir的路径，需要手动创建目录并赋予正确的权限，避免上传时出现权限错误：

# 创建临时目录
mkdir -p /tmp/php_upload_tmp

# 赋予目录写入权限，根据实际运行PHP的用户调整，比如apache或者nginx用户
chown apache:apache /tmp/php_upload_tmp
chmod 755 /tmp/php_upload_tmp

4. 重启PHP服务生效配置

修改完配置后需要重启对应的PHP服务才能让配置生效，不同的PHP运行模式重启方式不同：

• 如果是PHP-FPM模式（搭配Nginx等Web服务器），执行：
• 如果是Apache模块模式，执行：

四、验证配置是否生效

可以创建一个简单的PHP文件来验证配置是否修改成功，在网站根目录下创建info.php文件，内容如下：

<?php
// 输出PHP配置信息，搜索upload相关参数查看数值是否正确
phpinfo();
?>

在浏览器中访问http://你的服务器IP/info.php，找到文件上传相关的配置项，确认数值和修改后的内容一致即可。验证完成后建议删除这个文件，避免暴露服务器配置信息。

五、常见问题排查

• 修改配置后不生效：检查是否重启了对应的PHP服务，或者是否修改了正确的php.ini文件，有些环境可能存在多个php.ini文件，需要确认加载的是哪一个。
• 上传文件提示权限错误：检查upload_tmp_dir目录的权限是否正确，运行PHP的用户是否有写入权限。
• 大文件上传仍然失败：检查Web服务器是否有上传大小限制，比如Nginx需要修改client_max_body_size参数，Apache需要修改LimitRequestBody参数，确保Web服务器的限制大于等于PHP的上传限制。

CentOSPHP上传限制php.ini配置大文件上传文件上传教程