一個(gè)經(jīng)典的PHP文件上傳類(lèi)分享
一、需求分析
要球自定義文件上傳類(lèi)，即在使用非常簡(jiǎn)便的前提下，又可以完成以下幾項(xiàng)功能：
?、僦С謫蝹€(gè)文件上傳。
?、谥С侄鄠€(gè)文件上傳。
③可以自己指定上傳文件的保存位置，可以設(shè)置上傳文件允許的大小和類(lèi)型，可以由系統(tǒng)對(duì)上傳文件重新命名，又可以設(shè)置保留上傳文件的原名。
?。ㄕf(shuō)明：要求單個(gè)文件上傳和多個(gè)文件上傳要采用同樣的操作方式，對(duì)上傳進(jìn)行的一些設(shè)置也要采用相同的方式）。
二、程序設(shè)計(jì)
根據(jù)程序需求的要求，我們可以為文件上傳類(lèi)聲明4個(gè)可見(jiàn)的成員屬性，讓用戶(hù)在使用時(shí)還可以進(jìn)行一些行為的設(shè)置。需要的成員屬性如下表所示：
為避免屬性的值被賦上一些非法值，需要將這些成員屬性封裝起來(lái)，在對(duì)象外面不能訪問(wèn)，再通過(guò)類(lèi)中聲明的set()方法為以上四個(gè)成員屬性賦值。set()方法有兩個(gè)參數(shù)，第一個(gè)參數(shù)就是成員屬性名稱(chēng)（不區(qū)分大小寫(xiě)），第二個(gè)參數(shù)，就是前面參數(shù)中屬性對(duì)應(yīng)的值。set()方法調(diào)用完成以后，返回本對(duì)象($this)，所以除了可以單獨(dú)為每個(gè)屬性賦值以外，還可以進(jìn)行連貫操作一起為多個(gè)屬性賦值。本例中除了set()方法以外，最主要的是實(shí)現(xiàn)上傳文件的功能，所以系統(tǒng)主要提供了以下一些公有方法，實(shí)現(xiàn)文件上傳的操作，如下表所示：
為避免屬性的值被賦上一些非法值，需要將這些成員屬性封裝起來(lái)，在對(duì)象外面不能訪問(wèn)，再通過(guò)類(lèi)中聲明的set()方法為以上四個(gè)成員屬性賦值。set()方法有兩個(gè)參數(shù)，第一個(gè)參數(shù)就是成員屬性名稱(chēng)（不區(qū)分大小寫(xiě)），第二個(gè)參數(shù)，就是前面參數(shù)中屬性對(duì)應(yīng)的值。set()方法調(diào)用完成以后，返回本對(duì)象($this)，所以除了可以單獨(dú)為每個(gè)屬性賦值以外，還可以進(jìn)行連貫操作一起為多個(gè)屬性賦值。本例中除了set()方法以外，最主要的是實(shí)現(xiàn)上傳文件的功能，所以系統(tǒng)主要提供了以下一些公有方法，實(shí)現(xiàn)文件上傳的操作，如下表所示：
<?php
/**
file: fileupload.class.php 文件上傳類(lèi)FileUpload
本類(lèi)的實(shí)例對(duì)象用于處理上傳文件，可以上傳一個(gè)文件，也可同時(shí)處理多個(gè)文件上傳
*/
class FileUpload {
private $path = "./uploads"; //上傳文件保存的路徑
private $allowtype = array('jpg','gif','png'); //設(shè)置限制上傳文件的類(lèi)型
private $maxsize = 1000000; //限制文件上傳大?。ㄗ止?jié)）
private $israndname = true; //設(shè)置是否隨機(jī)重命名文件， false不隨機(jī)
private $originName; //源文件名
private $tmpFileName; //臨時(shí)文件名
private $fileType; //文件類(lèi)型(文件后綴)
private $fileSize; //文件大小
private $newFileName; //新文件名
private $errorNum = 0; //錯(cuò)誤號(hào)
private $errorMess=""; //錯(cuò)誤報(bào)告消息
/**
* 用于設(shè)置成員屬性（$path, $allowtype,$maxsize, $israndname）
* 可以通過(guò)連貫操作一次設(shè)置多個(gè)屬性值
*@param string $key 成員屬性名(不區(qū)分大小寫(xiě))
*@param mixed $val 為成員屬性設(shè)置的值
*@return object 返回自己對(duì)象$this，可以用于連貫操作
*/
function set($key, $val){
$key = strtolower($key);
if( array_key_exists( $key, get_class_vars(get_class($this) ) ) ){
$this->setOption($key, $val);
}
return $this;
}
/**
* 調(diào)用該方法上傳文件
* @param string $fileFile 上傳文件的表單名稱(chēng)
* @return bool 如果上傳成功返回?cái)?shù)true
*/
function upload($fileField) {
$return = true;
/* 檢查文件路徑是滯合法 */
if( !$this->checkFilePath() ) {
$this->errorMess = $this->getError();
return false;
}
/* 將文件上傳的信息取出賦給變量 */
$name = $_FILES[$fileField]['name'];
$tmp_name = $_FILES[$fileField]['tmp_name'];
$size = $_FILES[$fileField]['size'];
$error = $_FILES[$fileField]['error'];
/* 如果是多個(gè)文件上傳則$file["name"]會(huì)是一個(gè)數(shù)組 */
if(is_Array($name)){
$errors=array();
/*多個(gè)文件上傳則循環(huán)處理 ， 這個(gè)循環(huán)只有檢查上傳文件的作用，并沒(méi)有真正上傳 */
for($i = 0; $i < count($name); $i++){
/*設(shè)置文件信息 */
if($this->setFiles($name[$i],$tmp_name[$i],$size[$i],$error[$i] )) {
if(!$this->checkFileSize() || !$this->checkFileType()){
$errors[] = $this->getError();
$return=false;
}
}else{
$errors[] = $this->getError();
$return=false;
}
/* 如果有問(wèn)題，則重新初使化屬性 */
if(!$return)
$this->setFiles();
}
if($return){
/* 存放所有上傳后文件名的變量數(shù)組 */
$fileNames = array();
/* 如果上傳的多個(gè)文件都是合法的，則通過(guò)銷(xiāo)魂循環(huán)向服務(wù)器上傳文件 */
for($i = 0; $i < count($name); $i++){
if($this->setFiles($name[$i], $tmp_name[$i], $size[$i], $error[$i] )) {
$this->setNewFileName();
if(!$this->copyFile()){
$errors[] = $this->getError();
$return = false;
}
$fileNames[] = $this->newFileName;
}
}
$this->newFileName = $fileNames;
}
$this->errorMess = $errors;
return $return;
/*上傳單個(gè)文件處理方法*/
} else {
/* 設(shè)置文件信息 */
if($this->setFiles($name,$tmp_name,$size,$error)) {
/* 上傳之前先檢查一下大小和類(lèi)型 */
if($this->checkFileSize() && $this->checkFileType()){
/* 為上傳文件設(shè)置新文件名 */
$this->setNewFileName();
/* 上傳文件 返回0為成功， 小于0都為錯(cuò)誤 */
if($this->copyFile()){
return true;
}else{
$return=false;
}
}else{
$return=false;
}
} else {
$return=false;
}
//如果$return為false, 則出錯(cuò)，將錯(cuò)誤信息保存在屬性errorMess中
if(!$return)
$this->errorMess=$this->getError();
return $return;
}
}
/**
* 獲取上傳后的文件名稱(chēng)
* @param void 沒(méi)有參數(shù)
* @return string 上傳后，新文件的名稱(chēng)， 如果是多文件上傳返回?cái)?shù)組
*/
public function getFileName(){
return $this->newFileName;
}
/**
* 上傳失敗后，調(diào)用該方法則返回，上傳出錯(cuò)信息
* @param void 沒(méi)有參數(shù)
* @return string 返回上傳文件出錯(cuò)的信息報(bào)告，如果是多文件上傳返回?cái)?shù)組
*/
public function getErrorMsg(){
return $this->errorMess;
}
/* 設(shè)置上傳出錯(cuò)信息 */
private function getError() {
$str = "上傳文件<font color='red'>{$this->originName}</font>時(shí)出錯(cuò) : ";
switch ($this->errorNum) {
case 4: $str .= "沒(méi)有文件被上傳"; break;
case 3: $str .= "文件只有部分被上傳"; break;
case 2: $str .= "上傳文件的大小超過(guò)了HTML表單中MAX_FILE_SIZE選項(xiàng)指定的值"; break;
case 1: $str .= "上傳的文件超過(guò)了php.ini中upload_max_filesize選項(xiàng)限制的值"; break;
case -1: $str .= "未允許類(lèi)型"; break;
case -2: $str .= "文件過(guò)大,上傳的文件不能超過(guò){$this->maxsize}個(gè)字節(jié)"; break;
case -3: $str .= "上傳失敗"; break;
case -4: $str .= "建立存放上傳文件目錄失敗，請(qǐng)重新指定上傳目錄"; break;
case -5: $str .= "必須指定上傳文件的路徑"; break;
default: $str .= "未知錯(cuò)誤";
}
return $str.'<br>';
}
/* 設(shè)置和$_FILES有關(guān)的內(nèi)容 */
private function setFiles($name="", $tmp_name="", $size=0, $error=0) {
$this->setOption('errorNum', $error);
if($error)
return false;
$this->setOption('originName', $name);
$this->setOption('tmpFileName',$tmp_name);
$aryStr = explode(".", $name);
$this->setOption('fileType', strtolower($aryStr[count($aryStr)-1]));
$this->setOption('fileSize', $size);
return true;
}
/* 為單個(gè)成員屬性設(shè)置值 */
private function setOption($key, $val) {
$this->$key = $val;
}
/* 設(shè)置上傳后的文件名稱(chēng) */
private function setNewFileName() {
if ($this->israndname) {
$this->setOption('newFileName', $this->proRandName());
} else{
$this->setOption('newFileName', $this->originName);
}
}
/* 檢查上傳的文件是否是合法的類(lèi)型 */
private function checkFileType() {
if (in_array(strtolower($this->fileType), $this->allowtype)) {
return true;
}else {
$this->setOption('errorNum', -1);
return false;
}
}
/* 檢查上傳的文件是否是允許的大小 */
private function checkFileSize() {
if ($this->fileSize > $this->maxsize) {
$this->setOption('errorNum', -2);
return false;
}else{
return true;
}
}
/* 檢查是否有存放上傳文件的目錄 */
private function checkFilePath() {
if(empty($this->path)){
$this->setOption('errorNum', -5);
return false;
}
if (!file_exists($this->path) || !is_writable($this->path)) {
if (!@mkdir($this->path, 0755)) {
$this->setOption('errorNum', -4);
return false;
}
}
return true;
}
/* 設(shè)置隨機(jī)文件名 */
private function proRandName() {
$fileName = date('YmdHis')."_".rand(100,999);
return $fileName.'.'.$this->fileType;
}
/* 復(fù)制上傳文件到指定的位置 */
private function copyFile() {
if(!$this->errorNum) {
$path = rtrim($this->path, '/').'/';
$path .= $this->newFileName;
if (@move_uploaded_file($this->tmpFileName, $path)) {
return true;
}else{
$this->setOption('errorNum', -3);
return false;
}
} else {
return false;
}
}
}
四、文件上傳類(lèi)的應(yīng)用過(guò)程
本例的文件上傳類(lèi)FileUpload，即支持單文件上傳，也支持多個(gè)文件一起向服務(wù)器上傳，在處理方式上沒(méi)有區(qū)別的，只不過(guò)在編寫(xiě)上傳標(biāo)單時(shí)，多個(gè)文件上傳一定要以數(shù)組方式傳遞給服務(wù)器。單個(gè)文件上傳表單如下所示：
<form action="upload.php" method="post" enctype="multipart/form-data" > name: <input type="text" name="username" value="" /><br> <input type="hidden" name="MAX_FILE_SIZE" value="1000000" /> up pic: <input type="file" name="pic[]" value=""><br> up pic: <input type="file" name="pic[]" value=""><br> up pic: <input type="file" name="pic[]" value=""><br> up pic: <input type="file" name="pic[]" value=""><br> <input type="submit" value="upload" /><br> </form>
上面表單，都將提交的位置指向了同一個(gè)文件upload.php，所以不難看出單個(gè)和多個(gè)文件上傳是一樣的處理方式，upload.php代碼如下所示：
<?php
//包含一個(gè)文件上傳類(lèi)中的上傳類(lèi)
include "fileupload.class.php";
$up = new fileupload;
//設(shè)置屬性(上傳的位置， 大小， 類(lèi)型， 名是是否要隨機(jī)生成)
$up -> set("path", "./images/");
$up -> set("maxsize", 2000000);
$up -> set("allowtype", array("gif", "png", "jpg","jpeg"));
$up -> set("israndname", false);
//使用對(duì)象中的upload方法， 就可以上傳文件， 方法需要傳一個(gè)上傳表單的名子 pic, 如果成功返回true, 失敗返回false
if($up -> upload("pic")) {
echo '<pre>';
//獲取上傳后文件名子
var_dump($up->getFileName());
echo '</pre>';
} else {
echo '<pre>';
//獲取上傳失敗以后的錯(cuò)誤提示
var_dump($up->getErrorMsg());
echo '</pre>';
}
?>
在upload.php文件中，首先必須加載文件上傳FileUpload類(lèi)所在的文件fileupload.class.php。再就是實(shí)例化文件上傳類(lèi)的對(duì)象，然后通過(guò)調(diào)用upload()方法上傳文件，如果上傳成功，可以通過(guò)getFileName()方法獲取上傳后的文件名稱(chēng)，如果上傳失敗，還可以通過(guò)getErrorMsg()方法獲取錯(cuò)誤報(bào)告。如果需要改變上傳的一些行為，可以通過(guò)調(diào)用set()方法來(lái)完成一些屬性的設(shè)置。set()方法可以單獨(dú)使用設(shè)置一個(gè)屬性的值，如果需要改變多個(gè)屬性的值，可以連續(xù)調(diào)用set()方法進(jìn)行設(shè)置，也可以連貫操作同時(shí)設(shè)置多個(gè)屬性。
下載PHP文件上傳類(lèi):
相關(guān)文章
基于CakePHP實(shí)現(xiàn)的簡(jiǎn)單博客系統(tǒng)實(shí)例
這篇文章主要介紹了基于CakePHP實(shí)現(xiàn)的簡(jiǎn)單博客系統(tǒng),以一個(gè)完整實(shí)例分析了使用CakePHP實(shí)現(xiàn)博客系統(tǒng)的完整流程,需要的朋友可以參考下2015-06-06
這篇文章主要為大家詳細(xì)介紹了PHP SFTP實(shí)現(xiàn)上傳下載功能，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2017-07-07
PHP運(yùn)用foreach神奇的轉(zhuǎn)換數(shù)組(實(shí)例講解)
下面小編就為大家分享一篇PHP運(yùn)用foreach神奇的轉(zhuǎn)換數(shù)組(實(shí)例講解)，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2018-02-02
php 搜索框提示(自動(dòng)完成)實(shí)例代碼
輸入要搜索的文字時(shí)在搜索框下方提示相關(guān)的搜索信息實(shí)現(xiàn)方法，就是自動(dòng)完成效果2012-02-02
本篇文章介紹了，php 目錄遍歷、刪除 函數(shù)的使用分析。需要的朋友參考下2013-04-04
隨時(shí)給自己貼的圖片加文字的php代碼...2007-03-03
使用PHP導(dǎo)出Redis數(shù)據(jù)到另一個(gè)Redis中的代碼
這篇文章主要介紹了使用PHP導(dǎo)出Redis數(shù)據(jù)到另一個(gè)Redis中的方法,需要的朋友可以參考下2014-03-03
PHP中使用mpdf 導(dǎo)出PDF文件的實(shí)現(xiàn)方法
這篇文章主要介紹了PHP中使用mpdf 導(dǎo)出PDF文件的實(shí)現(xiàn)方法,非常不錯(cuò)，具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2018-10-10
一個(gè)基于phpQuery的php通用采集類(lèi)分享
這是自己以前寫(xiě)的一個(gè)php的采集類(lèi)，自己一直在用，自我感覺(jué)很簡(jiǎn)單很強(qiáng)大，只要懂一點(diǎn)點(diǎn)選擇器的知識(shí)就可以采集任何頁(yè)面了，也支持https頁(yè)面，做簡(jiǎn)單的采集足夠用了2014-04-04
下面小編就為大家?guī)?lái)一篇php curl常用的5個(gè)經(jīng)典例子。小編覺(jué)得挺不錯(cuò)的，現(xiàn)在就分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-01-01