DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
動手做一個 PHP 檔案上傳類別:含縮圖生成與錯誤碼設計
編輯:AJAX詳解     

檔案上傳是網站最基礎也最容易出錯的功能之一。本文以一個自製的 IEb_upload 類別為例,說明如何把表單接收、大小檢查、副檔名判斷、隨機命名、本體寫入與縮圖產生這幾件事,收攏到一個可重複使用的元件裡。

功能盤點

  • 接收並驗證上傳的檔案
  • 取得原始檔名、副檔名與檔案大小(可指定 B 或 MB)
  • 以「時間戳 + 隨機碼 + 副檔名」產生新檔名,避免重名覆寫
  • 將檔案寫入指定目錄,並回傳最終檔名與完整路徑
  • 針對 JPG/GIF/PNG 產生指定尺寸的縮圖
  • 以數字錯誤碼回報每一步的失敗原因

類別實作

class IEb_upload {
    var $FormName;   // 檔案欄位名稱
    var $Directroy;  // 上傳目標目錄
    var $MaxSize;    // 允許的最大檔案大小
    var $CanUpload;  // 是否可以繼續上傳
    var $doUpFile;   // 上傳後的檔名
    var $sm_File;    // 縮圖檔名
    var $Error;      // 錯誤碼

    function IEb_upload($formName='', $dirPath='', $maxSize=2097152)
    // (1024*1024)*2 = 2097152,也就是 2MB
    {
        global $FormName, $Directroy, $MaxSize, $CanUpload, $Error, $doUpFile, $sm_File;
        $FormName  = $formName;
        $MaxSize   = $maxSize;
        $CanUpload = true;
        $doUpFile  = '';
        $sm_File   = '';
        $Error     = 0;

        if ($formName == '') {
            $CanUpload = false;
            $Error = 1;
            return;
        }

        if ($dirPath == '') {
            $Directroy = $dirPath;
        } else {
            $Directroy = $dirPath.'/';
        }
    }

    // 取得檔案大小,format 可為 'B' 或 'M'
    function getSize($format = 'B')
    {
        global $FormName, $Error, $CanUpload;
        if ($CanUpload) {
            if ($_FILES[$FormName]['size'] == 0) {
                $Error = 3;
                $CanUpload = false;
            }
            switch ($format) {
                case 'B': return $_FILES[$FormName]['size'];
                case 'M': return $_FILES[$FormName]['size'] / (1024*1024);
            }
        }
    }

    // 取得副檔名
    function getExt()
    {
        global $FormName, $Error, $CanUpload;
        if ($CanUpload) {
            $extStr = explode('.', $_FILES[$FormName]['name']);
            $count  = count($extStr) - 1;
            return $extStr[$count];
        }
    }

    // 取得原始檔名
    function getName()
    {
        global $FormName, $CanUpload;
        if ($CanUpload) {
            return $_FILES[$FormName]['name'];
        }
    }

    // 產生新檔名
    function newName()
    {
        global $CanUpload, $FormName;
        if ($CanUpload) {
            $extStr = explode('.', $_FILES[$FormName]['name']);
            $ext    = $extStr[count($extStr) - 1];
            return date('YmdHis').rand(0,9).'.'.$ext;
        }
    }

    // 上傳檔案
    function upload($fileName = '')
    {
        global $FormName, $Directroy, $CanUpload, $Error, $doUpFile;

        if ($CanUpload && $_FILES[$FormName]['size'] == 0) {
            $Error = 3;
            $CanUpload = false;
            return $Error;
        }

        if ($CanUpload) {
            if ($fileName == '') {
                $fileName = $_FILES[$FormName]['name'];
            }
            $doUpload = @copy($_FILES[$FormName]['tmp_name'], $Directroy.$fileName);
            if ($doUpload) {
                $doUpFile = $fileName;
                chmod($Directroy.$fileName, 0777);
                return true;
            } else {
                $Error = 4;
                return $Error;
            }
        }
    }

    // 建立圖片縮圖
    function thumb($dscChar='', $width=150, $height=113)
    {
        global $CanUpload, $Error, $Directroy, $doUpFile, $sm_File;

        if ($CanUpload && $doUpFile != '') {
            $srcFile = $doUpFile;
            if ($dscChar == '') { $dscChar = 'sm_'; }

            $dscFile = $Directroy.$dscChar.$srcFile;
            $data = getimagesize($Directroy.$srcFile);

            switch ($data[2]) {
                case 1: $im = @imagecreatefromgif($Directroy.$srcFile);  break;
                case 2: $im = @imagecreatefromjpeg($Directroy.$srcFile); break;
                case 3: $im = @imagecreatefrompng($Directroy.$srcFile);  break;
            }

            $srcW = imagesx($im);
            $srcH = imagesy($im);
            $ni   = imagecreatetruecolor($width, $height);
            imagecopyresized($ni, $im, 0, 0, 0, 0, $width, $height, $srcW, $srcH);
            $cr = imagejpeg($ni, $dscFile);
            chmod($dscFile, 0777);

            if ($cr) {
                $sm_File = $dscFile;
                return true;
            } else {
                $Error = 5;
                return $Error;
            }
        }
    }

    function Err()      { global $Error;    return $Error; }
    function UpFile()   { global $doUpFile, $Error; return $doUpFile != '' ? $doUpFile : ($Error = 6); }
    function filePath() { global $Directroy, $doUpFile, $Error; return $doUpFile != '' ? $Directroy.$doUpFile : ($Error = 6); }
    function thumbMap() { global $sm_File, $Error; return $sm_File != '' ? $sm_File : ($Error = 6); }
    function IEb_version() { return 'IEB_UPLOAD CLASS Ver 1.1'; }
}

呼叫方式

<?php
include('IEb_upload.inc');
?>
<form action="" method="post" enctype="multipart/form-data" name="form1">
  <input type="file" name="file">
  <input type="submit" name="Submit" value="提交">
  <input name="scan" type="hidden" id="up" value="true">
</form>

<?php
if (isset($_REQUEST['scan'])) {
    // IEb_upload( 欄位名, [目錄, 大小上限] )
    $upfos = new IEb_upload('file', 'upload');

    echo '檔名:' . $upfos->getName()  . '<br/>';
    echo '類型:' . $upfos->getExt()   . '<br/>';
    echo '大小:' . $upfos->getSize()  . '<br/>';
    echo '隨機名:' . $upfos->newName() . '<br/>';

    $upfos->upload($upfos->newName());   // 建議用隨機名避免覆寫
    $upfos->thumb('slt_', 200, 140);      // 縮圖前綴、寬、高

    echo '生成檔:' . $upfos->UpFile()    . '<br/>';
    echo '路徑:'   . $upfos->filePath()  . '<br/>';
    echo '縮圖:'   . $upfos->thumbMap()  . '<br/>';
    echo '版本:'   . $upfos->IEb_version();
}
?>

這份程式碼的風險,一定要知道

這個類別寫於 PHP4 時代,直接搬上現代伺服器會遇到幾個嚴重問題,改用之前務必修正:

  1. 不要用 copy() 處理上傳檔。應改用 move_uploaded_file(),並先檢查 is_uploaded_file(),否則可能把任意本地檔案搬進公開目錄。
  2. 副檔名不可信。explode('.') 取尾段这种做法,遇到 a.php.jpg 或雙寫擴展名時毫無防禦力。請改用白名單比對,並以 finfo 或 getimagesize() 驗證真實型別。
  3. chmod(..., 0777) 是危險寫法。公開目錄下的可寫檔案等於把執行權限交給任何人,通常 0644 就夠,上傳目錄更應關閉腳本執行權。
  4. 缺少大小上限的實際檢查。類別裡存了 $MaxSize 卻從未比對,等於沒有防護。同時應在 php.ini 或 .htaccess 調整 upload_max_filesize 與 post_max_size。
  5. 改用全域變數傳遞狀態並不好。建議改成類別屬性 $this->,並改用 PDO 或 mysqli 搭配後續的資料庫寫入。
  6. 縮圖會失真。imagecopyresized 是強制拉伸,請改用 imagecopyresampled,並依長寬比計算目標尺寸。

把這些觀念補上之後,這個小類別仍然可以當成理解上傳流程的教材;但要上 production,請直接採用成熟框架的檔案上傳元件。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved