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

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

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

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

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

1. 打开终端，用你熟悉的编辑器（比如nano或vim）打开配置文件。路径通常是/etc/php/7.x/apache2/php.ini（请将7.x替换为你实际的PHP版本号）。

   sudo nano /etc/php/7.x/apache2/php.ini

2. 在文件里找到并修改下面这几个关键参数，它们直接决定了上传功能的“天花板”：

   • 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

3. 保存文件并退出编辑器。别忘了，修改配置后需要重启Web服务（如Apache或Nginx）才能生效：

   sudo systemctl restart apache2

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

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

1. 先创建一个专门用来存放上传文件的目录，比如放在网站根目录下：

   sudo mkdir -p /var/www/html/uploads

2. 然后，把这个目录的所有权交给Web服务器用户，并设置合适的访问权限：

   sudo chown -R www-data:www-data /var/www/html/uploads
   sudo chmod -R 755 /var/www/html/uploads

   这两条命令的意思是：让www-data用户完全拥有这个目录，并允许它读取、写入和执行。

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

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

1. 在网站根目录下创建一个新文件，比如叫upload.php：

   sudo nano /var/www/html/upload.php

2. 将以下代码复制进去。这个脚本做了几件事：检查是否是图片、限制文件大小、只允许特定图片格式，最后将文件从临时目录移动到我们准备好的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 "抱歉，上传过程中间出现错误。";
           }
       }
   }
   ?>
   
   
   
   
       选择要上传的图片：
       
       
   
   
   

3. 保存并关闭文件。

最后一步：实际测试一下

理论配置完成，是骡子是马得拉出来遛遛。

1. 打开浏览器，访问你的服务器地址加上脚本名，例如：http://你的服务器IP/upload.php。
2. 页面上会出现一个文件选择按钮，挑一个符合要求的图片文件（比如小于500KB的JPG图片）点击上传。
3. 如果页面显示成功信息，你可以通过终端验证一下文件是否真的出现在了指定位置：

   ls -la /var/www/html/uploads/

走完以上四步，一个基础的Ubuntu PHP文件上传功能就配置妥当了。当然，实际生产环境中，你可能还需要考虑更严格的安全措施，比如重命名文件防止覆盖、病毒扫描、或者将上传目录放在Web根目录之外以防止直接访问。但无论如何，上面这套流程，已经为你搭好了最核心的架子。