Upload helper class for working with uploaded files and Validation.
$array= Validation::factory($_FILES);
Remember to define your form with "enctype=multipart/form-data" or file uploading will not work!
The following configuration properties can be set:
Class declared in SYSPATH/classes/Upload.php on line 3.
string $default_directorylink to thisdefault upload directory
string(6) "upload"boolean $remove_spaceslink to thisremove spaces in uploaded files
bool TRUE
Validation rule to test if an upload is an image and, optionally, is the correct size.
// The "image" file must be an image$array->rule('image','Upload::image')// The "photo" file has a maximum size of 640x480 pixels$array->rule('photo','Upload::image', [':value', 640, 480]);// The "image" file must be exactly 100x100 pixels$array->rule('image','Upload::image', [':value', 100, 100, true]);
array
$file
required - $_FILES item integer
$max_width
= NULL - Maximum width of image integer
$max_height
= NULL - Maximum height of image boolean
$exact
= bool FALSE - Match width and height exactly? boolean
publicstaticfunctionimage(array$file,$max_width= null,$max_height= null,$exact= false){if(Upload::not_empty($file)) {try{// Get the width and height from the uploaded imagelist($width,$height) =getimagesize($file['tmp_name']);}catch(ErrorException$e) {// Ignore read errors}if(empty($width) ORempty($height)) {// Cannot get image size, cannot validatereturnfalse;}if(!$max_width) {// No limit, use the image width$max_width=$width;}if(!$max_height) {// No limit, use the image height$max_height=$height;}if($exact) {// Check if dimensions match exactlyreturn($width===$max_widthAND$height===$max_height);}else{// Check if size is within maximum dimensionsreturn($width<=$max_widthAND$height<=$max_height);}}returnfalse;}
Tests if a successful upload has been made.
$array->rule('file','Upload::not_empty');
array
$file
required - $_FILES item bool
publicstaticfunctionnot_empty(array$file){return(isset($file['error'])AND isset($file['tmp_name'])AND$file['error'] === UPLOAD_ERR_OKANDis_uploaded_file($file['tmp_name']));}
Save an uploaded file to a new location. If no filename is provided, the original filename will be used, with a unique prefix added.
This method should be used after validating the $_FILES array:
if($array->check()){// Upload is valid, save itUpload::save($array['file']);}
array
$file
required - Uploaded file data string
$filename
= NULL - New filename string
$directory
= NULL - New directory integer
$chmod
= integer 420 - Chmod mask string - On success, full path to new filefalse - On failure
publicstaticfunctionsave(array$file,$filename= null,$directory= null,$chmod= 0644){if(!isset($file['tmp_name']) OR !is_uploaded_file($file['tmp_name'])) {// Ignore corrupted uploadsreturnfalse;}if($filename=== null) {// Use the default filename, with a timestamp pre-pended$filename= uniqid() .$file['name'];}if(Upload::$remove_spaces=== true) {// Remove spaces from the filename$filename= preg_replace('/\s+/u','_',$filename);}if($directory=== null) {// Use the pre-configured upload directory$directory= Upload::$default_directory;}if(!is_dir($directory) OR !is_writable(realpath($directory))) {thrownewKohana_Exception('Directory :dir must be writable', [':dir'=> Debug::path($directory)]);}// Make the filename into a complete path$filename=realpath($directory) . DIRECTORY_SEPARATOR .$filename;if(move_uploaded_file($file['tmp_name'],$filename)) {if($chmod!== false) {// Set permissions on filenamechmod($filename,$chmod);}// Return new file pathreturn$filename;}returnfalse;}
Validation rule to test if an uploaded file is allowed by file size. File sizes are defined as: SB, where S is the size (1, 8.5, 300, etc.) and B is the byte unit (K, MiB, GB, etc.). All valid byte units are defined in Num::$byte_units
$array->rule('file','Upload::size', [':value','1M'])$array->rule('file','Upload::size', [':value','2.5KiB'])
array
$file
required - $_FILES item string
$size
required - Maximum file size allowed bool
publicstaticfunctionsize(array$file,$size){if($file['error'] === UPLOAD_ERR_INI_SIZE) {// Upload is larger than PHP allowed size (upload_max_filesize)returnfalse;}if($file['error'] !== UPLOAD_ERR_OK) {// The upload failed, no size to checkreturntrue;}// Convert the provided size to bytes for comparison$size= Num::bytes($size);// Test that the file is under or equal to the max sizereturn($file['size'] <=$size);}
Test if an uploaded file is an allowed file type, by extension.
$array->rule('file','Upload::type', [':value', ['jpg','png','gif']]);
array
$file
required - $_FILES item array
$allowed
required - Allowed file extensions bool
publicstaticfunctiontype(array$file,array$allowed){if($file['error'] !== UPLOAD_ERR_OK)returntrue;$ext=strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));returnin_array($ext,$allowed);}
Tests if upload data is valid, even if no file was uploaded. If you do require a file to be uploaded, add the Upload::not_empty rule before this rule.
$array->rule('file','Upload::valid')
array
$file
required - $_FILES item bool
publicstaticfunctionvalid($file){return(isset($file['error'])AND isset($file['name'])AND isset($file['type'])AND isset($file['tmp_name'])AND isset($file['size']));}