檔案上傳是網站最基礎也最容易出錯的功能之一。本文以一個自製的 IEb_upload 類別為例,說明如何把表單接收、大小檢查、副檔名判斷、隨機命名、本體寫入與縮圖產生這幾件事,收攏到一個可重複使用的元件裡。
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 時代,直接搬上現代伺服器會遇到幾個嚴重問題,改用之前務必修正:
copy() 處理上傳檔。應改用 move_uploaded_file(),並先檢查 is_uploaded_file(),否則可能把任意本地檔案搬進公開目錄。explode('.') 取尾段这种做法,遇到 a.php.jpg 或雙寫擴展名時毫無防禦力。請改用白名單比對,並以 finfo 或 getimagesize() 驗證真實型別。chmod(..., 0777) 是危險寫法。公開目錄下的可寫檔案等於把執行權限交給任何人,通常 0644 就夠,上傳目錄更應關閉腳本執行權。$MaxSize 卻從未比對,等於沒有防護。同時應在 php.ini 或 .htaccess 調整 upload_max_filesize 與 post_max_size。$this->,並改用 PDO 或 mysqli 搭配後續的資料庫寫入。imagecopyresized 是強制拉伸,請改用 imagecopyresampled,並依長寬比計算目標尺寸。把這些觀念補上之後,這個小類別仍然可以當成理解上傳流程的教材;但要上 production,請直接採用成熟框架的檔案上傳元件。