nginx限制上传大小和超时时间设置说明，php限制上传大小

封面图 • 2025-11-01 • PHP

在使用 Nginx 和 PHP 时，限制上传文件大小和超时时间是常见的配置需求。以下是对 Nginx 和 PHP 相关参数的说明与设置方法：

---

## ✅ 一、Nginx 限制上传大小和超时时间

### 1. **限制上传文件大小（`client_max_body_size`）**

Nginx 默认允许的最大请求体大小为 `1MB`，要上传大文件需要调整这个参数。

#### 配置位置：
通常在 Nginx 的配置文件中，例如 `/etc/nginx/nginx.conf` 或站点配置文件（如 `/etc/nginx/sites-available/your-site`）中添加：

```nginx
http {
    ...
    client_max_body_size 20M;  # 设置最大上传文件大小为 20MB
    ...
}
```

或者在某个 server 块中设置：

```nginx
server {
    listen 80;
    server_name example.com;

client_max_body_size 20M;

location /upload {
        ...
    }
}
```

> ⚠️ 注意：如果设置为 `0`，表示不限制大小。

---

### 2. **限制请求超时时间（`proxy_read_timeout`, `proxy_connect_timeout`, `proxy_send_timeout`）**

对于大文件上传，可能需要延长超时时间。

#### 示例配置：

```nginx
location /upload {
    proxy_pass http://php-fpm;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;

# 超时设置（单位秒）
    proxy_connect_timeout 600;
    proxy_send_timeout 600;
    proxy_read_timeout 600;
}
```

> - `proxy_connect_timeout`: 连接到后端服务器的超时时间。
> - `proxy_send_timeout`: 发送请求到后端服务器的超时时间。
> - `proxy_read_timeout`: 等待后端服务器响应的超时时间。

---

## ✅ 二、PHP 限制上传大小

PHP 也对上传文件大小有限制，主要通过以下配置项控制：

### 1. **`upload_max_filesize`**  
限制单个文件的最大大小。

### 2. **`post_max_size`**  
限制整个 POST 请求的大小（包括文件和其他表单数据）。

### 3. **`max_input_time`**  
限制脚本执行时间（用于处理上传）。

### 4. **`memory_limit`**  
PHP 内存限制，上传大文件可能需要增加内存。

---

### 修改方式：

#### 1. **修改 `php.ini` 文件**

找到你的 `php.ini` 文件路径（可以通过 `phpinfo()` 查看），然后修改如下内容：

```ini
upload_max_filesize = 20M
post_max_size = 25M
max_input_time = 300
memory_limit = 256M
```

> - `post_max_size` 应大于或等于 `upload_max_filesize`。
> - 如果使用的是 FastCGI（如 php-fpm），可能需要在对应的 `php-fpm.conf` 或 `pool.d` 中配置。

---

#### 2. **通过 `.htaccess` 或 `ini_set()` 动态设置（不推荐）**

虽然可以使用 `ini_set()` 动态设置部分参数，但某些参数（如 `upload_max_filesize`）**不能在运行时修改**。

```php
// 不推荐，部分配置无法动态更改
ini_set('upload_max_filesize', '20M');
ini_set('post_max_size', '25M');
```

---

## ✅ 三、注意事项

| 项目 | 说明 |
|------|------|
| `client_max_body_size` | Nginx 控制客户端上传的文件大小 |
| `upload_max_filesize` | PHP 控制单个文件大小 |
| `post_max_size` | PHP 控制整个 POST 请求的大小 |
| `proxy_read_timeout` | Nginx 控制等待 PHP 处理的时间 |
| `max_input_time` | PHP 控制脚本处理时间 |

---

## ✅ 四、验证配置是否生效

1. 创建一个 `info.php` 文件：

```php
<?php
phpinfo();
?>
```

访问该页面，查看 `upload_max_filesize`、`post_max_size` 等值是否已更新。

2. 检查 Nginx 配置是否正确：

```bash
nginx -t
systemctl reload nginx
```

---

## ✅ 五、常见错误处理

- **“413 Request Entity Too Large”**：Nginx 报错，说明上传文件超过 `client_max_body_size`。
- **“The uploaded file was only partially uploaded”**：可能是 PHP 的 `upload_max_filesize` 或 `post_max_size` 设置过小。
- **“Maximum execution time of X seconds exceeded”**：可能是 `max_input_time` 或 `max_execution_time` 设置过小。

---

如果你有具体的场景（比如上传视频、图片等），我可以进一步帮你优化相关配置。欢迎继续提问！