PHP 檔上傳


通過 PHP,可以把檔上傳到伺服器。

本章節實例在 test 專案下完成,目錄結構為:

test
|-----upload             # 檔上傳的目錄
|-----form.html          # 表單檔

|-----upload_file.php    # php 上傳代碼

源碼下載


創建一個檔上傳表單

允許用戶從表單上傳檔是非常有用的。

請看下麵這個供上傳檔的 HTML 表單:

<html>
<head>
<meta charset="utf-8">
<title>IT研修(xuhuhu.com)</title>
</head>
<body>

<form action="upload_file.php" method="post" enctype="multipart/form-data">
    <label for="file">檔案名:</label>
    <input type="file" name="file" id="file"><br>
    <input type="submit" name="submit" value="提交">
</form>

</body>
</html>

將以上代碼保存到 form.html 檔中。

有關上面的 HTML 表單的一些注意項列舉如下:

  • <form> 標籤的 enctype 屬性規定了在提交表單時要使用哪種內容類型。在表單需要二進位數據時,比如檔內容,請使用 "multipart/form-data"。
  • <input> 標籤的 type="file" 屬性規定了應該把輸入作為檔來處理。舉例來說,當在流覽器中預覽時,會看到輸入框旁邊有一個流覽按鈕。

注釋:允許用戶上傳檔是一個巨大的安全風險。請僅僅允許可信的用戶執行檔上傳操作。


創建上傳腳本

"upload_file.php" 檔含有供上傳檔的代碼:

<?php
if ($_FILES["file"]["error"] > 0)
{
    echo "錯誤:" . $_FILES["file"]["error"] . "<br>";
}
else
{
    echo "上傳檔案名: " . $_FILES["file"]["name"] . "<br>";
    echo "檔類型: " . $_FILES["file"]["type"] . "<br>";
    echo "檔大小: " . ($_FILES["file"]["size"] / 1024) . " kB<br>";
    echo "檔臨時存儲的位置: " . $_FILES["file"]["tmp_name"];
}
?>

通過使用 PHP 的全局數組 $_FILES,你可以從客戶電腦向遠程伺服器上傳檔。

第一個參數是表單的 input name,第二個下標可以是 "name"、"type"、"size"、"tmp_name" 或 "error"。如下所示:

  • $_FILES["file"]["name"] - 上傳檔的名稱
  • $_FILES["file"]["type"] - 上傳檔的類型
  • $_FILES["file"]["size"] - 上傳檔的大小,以位元組計
  • $_FILES["file"]["tmp_name"] - 存儲在伺服器的檔的臨時副本的名稱
  • $_FILES["file"]["error"] - 由檔上傳導致的錯誤代碼

這是一種非常簡單檔上傳方式。基於安全方面的考慮,您應當增加有關允許哪些用戶上傳檔的限制。


上傳限制

在這個腳本中,我們增加了對檔上傳的限制。用戶只能上傳 .gif、.jpeg、.jpg、.png 檔,檔大小必須小於 200 kB:

<?php
// 允許上傳的圖片尾碼

$allowedExts = array("gif", "jpeg", "jpg", "png");
$temp = explode(".", $_FILES["file"]["name"]);
$extension = end($temp);        // 獲取檔尾碼名
if ((($_FILES["file"]["type"] == "image/gif")
|| ($_FILES["file"]["type"] == "image/jpeg")
|| ($_FILES["file"]["type"] == "image/jpg")
|| ($_FILES["file"]["type"] == "image/pjpeg")
|| ($_FILES["file"]["type"] == "image/x-png")
|| ($_FILES["file"]["type"] == "image/png"))
&& ($_FILES["file"]["size"] < 204800)    // 小於 200 kb
&& in_array($extension, $allowedExts))
{
    if ($_FILES["file"]["error"] > 0)
    {
        echo "錯誤:: " . $_FILES["file"]["error"] . "<br>";
    }
    else
    {
        echo "上傳檔案名: " . $_FILES["file"]["name"] . "<br>";
        echo "檔類型: " . $_FILES["file"]["type"] . "<br>";
        echo "檔大小: " . ($_FILES["file"]["size"] / 1024) . " kB<br>";
        echo "檔臨時存儲的位置: " . $_FILES["file"]["tmp_name"];
    }
}
else
{
    echo "非法的檔格式";
}
?>


保存被上傳的檔

上面的實例在伺服器的 PHP 臨時檔夾中創建了一個被上傳檔的臨時副本。

這個臨時的副本檔會在腳本結束時消失。要保存被上傳的檔,我們需要把它拷貝到另外的位置:

<?php
// 允許上傳的圖片尾碼

$allowedExts = array("gif", "jpeg", "jpg", "png");
$temp = explode(".", $_FILES["file"]["name"]);
echo $_FILES["file"]["size"];
$extension = end($temp);     // 獲取檔尾碼名
if ((($_FILES["file"]["type"] == "image/gif")
|| ($_FILES["file"]["type"] == "image/jpeg")
|| ($_FILES["file"]["type"] == "image/jpg")
|| ($_FILES["file"]["type"] == "image/pjpeg")
|| ($_FILES["file"]["type"] == "image/x-png")
|| ($_FILES["file"]["type"] == "image/png"))
&& ($_FILES["file"]["size"] < 204800)   // 小於 200 kb
&& in_array($extension, $allowedExts))
{
    if ($_FILES["file"]["error"] > 0)
    {
        echo "錯誤:: " . $_FILES["file"]["error"] . "<br>";
    }
    else
    {
        echo "上傳檔案名: " . $_FILES["file"]["name"] . "<br>";
        echo "檔類型: " . $_FILES["file"]["type"] . "<br>";
        echo "檔大小: " . ($_FILES["file"]["size"] / 1024) . " kB<br>";
        echo "檔臨時存儲的位置: " . $_FILES["file"]["tmp_name"] . "<br>";
        
        // 判斷當期目錄下的 upload 目錄是否存在該檔
        // 如果沒有 upload 目錄,你需要創建它,upload 目錄許可權為 777
        if (file_exists("upload/" . $_FILES["file"]["name"]))
        {
            echo $_FILES["file"]["name"] . " 檔已經存在。 ";
        }
        else
        {
            // 如果 upload 目錄不存在該檔則將檔上傳到 upload 目錄下

            move_uploaded_file($_FILES["file"]["tmp_name"], "upload/" . $_FILES["file"]["name"]);
            echo "檔存儲在: " . "upload/" . $_FILES["file"]["name"];
        }
    }
}
else
{
    echo "非法的檔格式";
}
?>

上面的腳本檢測了檔是否已存在,如果不存在,則把檔拷貝到名為 "upload" 的目錄下。

檔上傳演示操作如下所示: