如果需要使用多個文件上傳,只需要修改表單,把
改為
或者
兩種方式的多附件上傳系統的文件上傳類都可以自動識別。
ThinkPHP文件上傳操作使用Think\Upload
類,假設前面的表單提交到當前控制器的upload方法,我們來看下upload方法的實現代碼:
publicfunction upload(){
$upload =new \Think\Upload();// 實例化上傳類
$upload->maxSize =3145728;// 設置附件上傳大小
$upload->exts = array('jpg','gif','png','jpeg');// 設置附件上傳類型
$upload->rootPath ='./Uploads/';// 設置附件上傳根目錄
$upload->savePath ='';// 設置附件上傳(子)目錄
// 上傳文件
$info = $upload->upload();
if(!$info){// 上傳錯誤提示錯誤信息
$this->error($upload->getError());
}else{// 上傳成功
$this->success('上傳成功!');
}
}
上傳類對圖片文件的上傳安全做了支持,如果企圖上傳非法的圖像文件,系統會提示 非法圖像文件
。 為了更好的使用上傳功能,建議你的服務器開啟finfo
模塊支持
在上傳操作之前,我們可以對上傳的屬性進行一些設置,Upload類支持的屬性設置包括:
屬性 | 描述 |
---|---|
maxSize | 文件上傳的最大文件大小(以字節為單位),0為不限大小 |
rootPath | 文件上傳保存的根路徑 |
savePath | 文件上傳的保存路徑(相對于根路徑) |
saveName | 上傳文件的保存規則,支持數組和字符串方式定義 |
saveExt | 上傳文件的保存后綴,不設置的話使用原文件后綴 |
replace | 存在同名文件是否是覆蓋,默認為false |
exts | 允許上傳的文件后綴(留空為不限制),使用數組或者逗號分隔的字符串設置,默認為空 |
mimes | 允許上傳的文件類型(留空為不限制),使用數組或者逗號分隔的字符串設置,默認為空 |
autoSub | 自動使用子目錄保存上傳文件 默認為true |
subName | 子目錄創建方式,采用數組或者字符串方式定義 |
hash | 是否生成文件的hash編碼 默認為true |
callback | 檢測文件是否存在回調,如果存在返回文件信息數組 |
上面的屬性可以通過兩種方式傳入:
我們可以在實例化的時候直接傳入參數數組,例如:
$config = array(
'maxSize'=>3145728,
'rootPath'=>'./Uploads/',
'savePath'=>'',
'saveName'=> array('uniqid',''),
'exts'=> array('jpg','gif','png','jpeg'),
'autoSub'=>true,
'subName'=> array('date','Ymd'),
);
$upload =new \Think\Upload($config);// 實例化上傳類
關于saveName和subName的使用后面我們會有詳細的描述。
支持在實例化后動態賦值上傳參數,例如:
$upload =new \Think\Upload();// 實例化上傳類
$upload->maxSize =3145728;
$upload->rootPath ='./Uploads/';
$upload->savePath ='';
$upload->saveName = array('uniqid','');
$upload->exts = array('jpg','gif','png','jpeg');
$upload->autoSub =true;
$upload->subName = array('date','Ymd');
上面的設置和實例化傳入的效果是一致的。
設置好上傳的參數后,就可以調用Think\Upload
類的upload方法進行附件上傳,如果失敗,返回false,并且用getError方法獲取錯誤提示信息;如果上傳成功,就返回成功上傳的文件信息數組。
$upload =new \Think\Upload();// 實例化上傳類
$upload->maxSize =3145728;// 設置附件上傳大小
$upload->exts = array('jpg','gif','png','jpeg');// 設置附件上傳類型
$upload->rootPath ='./Uploads/';// 設置附件上傳根目錄
$upload->savePath ='';// 設置附件上傳(子)目錄
// 上傳文件
$info = $upload->upload();
if(!$info){// 上傳錯誤提示錯誤信息
$this->error($upload->getError());
}else{// 上傳成功 獲取上傳文件信息
foreach($info as $file){
echo $file['savepath'].$file['savename'];
}
}
每個文件信息又是一個記錄了下面信息的數組,包括:
屬性 | 描述 |
---|---|
key | 附件上傳的表單名稱 |
savepath | 上傳文件的保存路徑 |
name | 上傳文件的原始名稱 |
savename | 上傳文件的保存名稱 |
size | 上傳文件的大小 |
type | 上傳文件的MIME類型 |
ext | 上傳文件的后綴類型 |
md5 | 上傳文件的md5哈希驗證字符串 僅當hash設置開啟后有效 |
sha1 | 上傳文件的sha1哈希驗證字符串 僅當hash設置開啟后有效 |
文件上傳成功后,就可以使用這些文件信息來進行其他的數據操作,例如保存到當前數據表或者單獨的附件數據表。
例如,下面表示把上傳信息保存到數據表的字段:
$model = M('Photo');
// 取得成功上傳的文件信息
$info = $upload->upload();
// 保存當前數據對象
$data['photo']= $info[0]['savename'];
$data['create_time']= NOW_TIME;
$model->add($data);
upload方法支持多文件上傳,有時候,我們只需要上傳一個文件,就可以使用Upload類提供的uploadOne方法上傳單個文件,例如:
publicfunction upload(){
$upload =new \Think\Upload();// 實例化上傳類
$upload->maxSize =3145728;// 設置附件上傳大小
$upload->exts = array('jpg','gif','png','jpeg');// 設置附件上傳類型
$upload->rootPath ='./Uploads/';// 設置附件上傳根目錄
// 上傳單個文件
$info = $upload->uploadOne($_FILES['photo1']);
if(!$info){// 上傳錯誤提示錯誤信息
$this->error($upload->getError());
}else{// 上傳成功 獲取上傳文件信息
echo $info['savepath'].$info['savename'];
}
}
uploadOne方法上傳成功后返回的文件信息和upload方法的區別是只有單個文件信息的一維數組。
上傳文件的命名規則(saveName)用于確保文件不會產生沖突或者覆蓋的情況。命名規則的定義可以根據你的業務邏輯來調整,不是固定的。例如, 如果你采用時間戳的方式來定義命名規范,那么在同時上傳多個文件的時候可能產生沖突(因為同一秒內可以上傳多個文件),因此你需要根據你的業務需求來設置 合適的上傳命名規則。這里順便來說下saveName參數的具體用法。
如果傳入的字符串是一個函數名,那么表示采用函數動態生成上傳文件名(不包括文件后綴),例如:
// 采用時間戳命名
$upload->saveName ='time';
// 采用GUID序列命名
$upload->saveName ='com_create_guid';
也可以采用用戶自定義函數
// 采用自定義函數命名
$upload->saveName ='myfun';
默認的命名規則設置是采用uniqid函數生成一個唯一的字符串序列。
saveName的值支持數組和字符串兩種方式,如果是只有一個參數或者沒有參數的函數,直接使用字符串設置即可,如果需要傳入額外的參數,可以使用數組方式,例如:
// 采用date函數生成命名規則 傳入Y-m-d參數
$upload->saveName = array('date','Y-m-d');
// 如果有多個參數需要傳入的話 可以使用數組
$upload->saveName = array('myFun',array('__FILE__','val1','val2'));
如果需要使用上傳的原始文件名,可以采用__FILE__傳入,所以上面的定義規則,最終的結果是 myFun('上傳文件名','val1','val2')
執行的結果。
如果傳入的參數不是一個函數名,那么就會直接當做是上傳文件名,例如:
$upload->saveName = time().'_'.mt_rand();
表示上傳的文件命名采用時間戳加一個隨機數的組合字符串方式。
當然,如果覺得有必要,你還可以固定設置一個上傳文件的命名規則,用于固定保存某個上傳文件。
$upload->saveName ='ThinkPHP';
如果你想保持上傳的文件名不變,那么只需要設置命名規范為空即可,例如:
$upload->saveName ='';
一般來說不建議保持不變,因為會導致相同的文件名上傳后被覆蓋的情況。
saveName只是用于設置文件的保存規則,不涉及到目錄,如果希望對上傳的文件分子目錄保存,可以設置autoSub
和subName
參數來完成,例如:
// 開啟子目錄保存 并以日期(格式為Ymd)為子目錄
$upload->autoSub =true;
$upload->subName = array('date','Ymd');
可以使用自定義函數來保存,例如:
// 開啟子目錄保存 并調用自定義函數get_user_id生成子目錄
$upload->autoSub =true;
$upload->subName ='get_user_id';
和saveName參數一樣,subName的定義可以采用數組和字符串的方式。
注意:如果get_user_id函數未定義的話,會直接以get_user_id字符串作為子目錄的名稱保存。
子目錄保存和文件命名規則可以結合使用。
上傳類可以支持不同的環境,通過相應的上傳驅動來解決,默認情況下使用本地(Local)上傳驅動,當然,你還可以設置當前默認的上傳驅動類型,例如:
'FILE_UPLOAD_TYPE'=>'Ftp',
'UPLOAD_TYPE_CONFIG'=> array(
'host'=>'192.168.1.200',//服務器
'port'=>21,//端口
'timeout'=>90,//超時時間
'username'=>'ftp_user',//用戶名
'password'=>'ftp_pwd',//密碼 ),
表示當前使用Ftp作為上傳類的驅動,上傳的文件會通過FTP傳到指定的遠程服務器。
也可以在實例化上傳類的時候指定,例如:
$config = array(
'maxSize'=3145728,
'rootPath'='./Uploads/',
'savePath'='',
'saveName'= array('uniqid',''),
'exts'= array('jpg','gif','png','jpeg'),
'autoSub'=true,
'subName'= array('date','Ymd'),
);
$ftpConfig = array(
'host'=>'192.168.1.200',//服務器
'port'=>21,//端口
'timeout'=>90,//超時時間
'username'=>'ftp_user',//用戶名
'password'=>'ftp_pwd',//密碼 );
$upload =new \Think\Upload($config,'Ftp',$ftpConfig);// 實例化上傳類
聲明:本網頁內容旨在傳播知識,若有侵權等問題請及時與本網聯系,我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com