Ubuntu系统PHP文件上传功能配置指南

首页

编程语言

热心网友

转载

2026-05-06

想在Ubuntu服务器上实现文件上传功能？这事儿说简单也简单，但几个关键配置要是没对上，分分钟就能让你卡住。别担心，下面这份从配置到测试的完整指南，能帮你把路铺平。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

如何在Ubuntu上配置PHP文件上传

整个过程可以拆解为三个核心环节：调整PHP的“开关”、给服务器目录“放行”，最后再写一个“接待员”脚本。咱们一步步来。

第一步：调整PHP的“总开关”

文件上传能不能成，首先得看PHP的全局配置允不允许。这就需要修改php.ini这个核心配置文件。

打开终端，用你熟悉的编辑器（比如nano或vim）打开配置文件。路径通常是/etc/php/7.x/apache2/php.ini（请将7.x替换为你实际的PHP版本号）。
```
sudo nano /etc/php/7.x/apache2/php.ini
```
在文件里找到并修改下面这几个关键参数，它们直接决定了上传功能的“天花板”：
- file_uploads = On：这是总开关，必须打开。
- upload_max_filesize = 10M：单次上传文件的最大体积，按需调整（比如20M）。
- post_max_size = 10M：整个POST请求的最大数据量，必须大于或等于上面的upload_max_filesize。
- upload_tmp_dir：上传文件的临时中转站。保持默认的/tmp通常就行，如果追求性能，可以指定一个更快的存储路径。
修改后的效果类似这样：
```
file_uploads = On
upload_max_filesize = 10M
post_max_size = 10M
upload_tmp_dir = /tmp
```
保存文件并退出编辑器。别忘了，修改配置后需要重启Web服务（如Apache或Nginx）才能生效：
```
sudo systemctl restart apache2
```

第二步：给服务器目录“开绿灯”

配置允许上传了，但文件最终得有个地方放。你得确保Web服务器进程（通常是www-data用户）有权限写入目标目录。

先创建一个专门用来存放上传文件的目录，比如放在网站根目录下：
```
sudo mkdir -p /var/www/html/uploads
```
然后，把这个目录的所有权交给Web服务器用户，并设置合适的访问权限：
```
sudo chown -R www-data:www-data /var/www/html/uploads
sudo chmod -R 755 /var/www/html/uploads
```
这两条命令的意思是：让www-data用户完全拥有这个目录，并允许它读取、写入和执行。

第三步：编写文件上传的“接待员”

最后一步，我们需要一个PHP脚本来接收并处理用户上传的文件。下面是一个基础但功能完整的示例，它包含了文件类型检查、大小验证和保存逻辑。

在网站根目录下创建一个新文件，比如叫upload.php：
```
sudo nano /var/www/html/upload.php
```

将以下代码复制进去。这个脚本做了几件事：检查是否是图片、限制文件大小、只允许特定图片格式，最后将文件从临时目录移动到我们准备好的uploads文件夹。

 500000) {
        echo "抱歉，文件过大。";
        $uploadOk = 0;
    }

    // 只允许JPG, PNG, JPEG, GIF格式
    if($imageFileType != "jpg" && $imageFileType != "png" && $imageFileType != "jpeg"
    && $imageFileType != "gif" ) {
        echo "抱歉，仅支持 JPG, JPEG, PNG 和 GIF 格式的文件。";
        $uploadOk = 0;
    }

    // 如果所有检查都通过，则移动文件
    if ($uploadOk == 0) {
        echo "抱歉，文件上传失败。";
    } else {
        if (move_uploaded_file($_FILES["fileToUpload"]["tmp_name"], $target_file)) {
            echo "文件 ". htmlspecialchars(basename($_FILES["fileToUpload"]["name"])). " 上传成功。";
        } else {
            echo "抱歉，上传过程中间出现错误。";
        }
    }
}
?>




    选择要上传的图片：