Handles multiple uploads with a powerful validation for images, videos, audios, and archive files. This package allows you to handle your file after your file was uploaded. You can resize, convert, extract and so many things to do after your files were uploaded. At the end, you can extract details of files into an array.
- Upload multiple files with a configuration variable.
- validate your videos, audios, images, archive files with different rules.
- Manage your files such as converting, resizing, extracting and so many things to do after your files were uploaded.
- Export the details of files into an array and you can easily insert them into a database.
- Compatible with PHP >= 7.1.0.
This version of the package is only compatible with PHP 7.1.0 and later.
Install the package via composer:
composer require aminyazdanpanah/handling-file-uploadsrequire_once 'vendor/autoload.php';
$export = function($filename){
//Add additional validators and handle file after your file was uploaded.
//...
}$config_files = [
[
'name' => 'upload_key_name', //The key name that you send your file to the server
'save_to' => $output_path, //The path you'd like to save your file(auto make new directory)
'validator' => [
'min_size' => 100, //Minimum size is 100KB
'max_size' => 1024 * 2, //Maximum size is 2MB
'allowed_extensions' => ['jpg', 'jpeg', 'png', ...] //Just images are allowed
],
'export' => $export //Get a callback method(whatever you want to do with your file after it was uploaded!)
],
[
//...
],
];
$uploads = uploads($config_files)->all();
var_dump("<pre>", $uploads, "</pre>");$validator = new Validator();
$validator = $validator->setMinSize(100)
->setMaxSize(1024 * 2)
->setType(['jpg', 'png', 'jpeg']);
$upload = new File();
$upload = $upload->file('upload_key_name')
->setValidator($validator)
->setOverride(false)
->setSaveAs('my_dfile')
->save($output_path, $export);
var_dump("<pre>", $upload, "</pre>");Important: Please see examples for more information. In these pages you can see complete examples of usage this package.
It is recommended to browse the source code as it is self-documented.
In the sever side you should create an array of config and pass it to uploads() method:
$config_files = [
[
'name' => 'upload_image',
'save_to' => __DIR__ . "/images/user/" . time(),
'validator' => [
'min_size' => 100,
'max_size' => 2048,
'types' => ['jpg', 'jpeg', 'png']
]
],
[
//...
],
];
$uploads = Upload::files($config_files);For more information about these attributes, please check the below tables:
| attr | default | mean |
|---|---|---|
| name | mandatory: must be specified | The key name you send your file to the server-PHP($_Files). |
| save_to | mandatory: must be specified | The path that you would like to save your file in the server or computer. |
| save_as | Base file name | The name that you want to save. |
| override | false | Override original file with the same filename. |
| validator | no rules | Validate your file before save(see validator table). |
| export | Nothing happens | A callback method that you specify additional rules and manage your file after it was uploaded. |
You can validate your uploaded file before move the uploaded file to the destination. There are some rules that you can apply on your file:
| attr | default | mean |
|---|---|---|
| min_size | 1 | The minimum size of files that are allowed (KiloByte). |
| max_size | 999999 | The maximum size of files that are allowed (KiloByte). |
| types | '*' (everything) | The types that are allowed (must be an array) |
You can set some rules after move the uploaded file to the destination by using a callback method. To validate a file after saving, just check your file in the callback method and throw an AYazdanpanah\SaveUploadedFiles\Exception\Exception. In the end, put it in the array of config and pass it to Upload::files($config). In the callback method, you can manage your file. For example, resize image or video, convert video, extracting an archive file and etc. After that, you are able to return your data.
$export = function ($filename) {
//Add a Validator: if $filename is not ...
if (//condition 1) {
throw new Exception("Exception 1");
}
//Add a Validator: if $filename is not ...
if (//condition 2) {
throw new Exception("Exception 2");
}
//...
//Handles file: resize image or video, convert video, extracting the archive and etc.
//...
//return whatever you want
return $data;
}
$config = [
[
//... ,
'export' => $export
],
];
Upload::files($config);There are some factors that can use to validate a video. I recommended PHP-FFMpeg-video-streaming package that is a wrapper around PHP-FFmpeg. You can validate your video by using its codec, duration, width, height, ratio, and other its attributes. After that, depends on whether your file is valid or not, you can throw an Exception. At the end, as it can be seen below, you can convert your video or whatever you want to do with your file and export your data:
$video_path = __DIR__ . "/videos/$user_id";
$video_name = str_random();
$export_video = function ($filename) use ($video_path, $video_name) {
$video = AYazdanpanah\FFMpegStreaming\FFMpeg::create()
->open($filename);
//Extracting video meta data
$video_metadata = $video->getFirstStream();
//Add a Validator: check if the file is video and video duration is not longer than 1 minute
if (!$video_metadata->isVideo() && null === ($duration = $video_metadata->get('duration')) && $duration >= 60) {
throw new Exception("Your file is not a video or your video duration is longer than 1 minute!");
}
//Add a Validator: check if the video is HD or higher resolution
if ($video_metadata->get('width',1) * $video_metadata->get('height', 1) < 1280 * 720) {
throw new Exception("Sorry, your video must be at least HD or higher resolution");
}
//Add a Validator: check if the video ratio is 16 / 9
if ($video_metadata->getDimensions()->getRatio()->getValue() == 16 / 9) {
throw new Exception("Sorry, the video ratio must be 16 / 9");
}
//Extracting image and resize it
$video->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(intval($duration / 4)))->save("$video_path/screenshots.jpg");
$image = new ImageResize("$video_path/screenshots.jpg");
$image->resizeToWidth(240)->save("$video_path/{$video_name}_screenshots_small.jpg");
//Extracting gif
$video->gif(FFMpeg\Coordinate\TimeCode::fromSeconds(3), new FFMpeg\Coordinate\Dimension(240, 95), 3)
->save("$video_path/{$video_name}_animation.gif");
//Create the dash files(it is better to create a job and dispatch it-do it in the background)
mkdir("$video_path/dash/$video_name", 0777, true);
dash($filename, "$video_path/dash/$video_name/output.mpd", function ($audio, $format, $percentage) {
echo "$percentage % is transcoded\n";
});
//Delete the original file
@unlink($filename);
return $video_metadata->all();
};For more information, please read PHP FFMPEG Video Streaming documentation and php-ffmpeg documentation.
To validate and manage an image, I recommended php-image-resize package. For more information I strongly recommand to read php-image-resize documantation . After that, depends on whether your file is valid or not, you can throw an Exception. At the end, you can export your data:
$image_path = __DIR__ . "/images/user/$user_id";
$export_image = function ($filename) use ($image_path) {
//Add a Validator: check if the file is image
if (!is_type("image", $filename)) {
throw new Exception("Your file is not an image!");
}
$image_metadata = exif_read_data($filename);
//Add a Validator: check whether the image is square or not
if ($image_metadata['COMPUTED']['Width'] / $image_metadata['COMPUTED']['Height'] != 1) {
throw new Exception("Your image must be square!");
}
if (!is_dir($image_path . "/thumbnail")) {
mkdir($image_path . "/thumbnail", 0777, true);
}
// Resize and crop your image
$image = new ImageResize($filename);
$image->resizeToWidth(50)->save($image_path . "/thumbnail/thumb_50.jpg");
$image->resizeToWidth(100)->save($image_path . "/thumbnail/thumb_100.jpg");
$image->resizeToWidth(240)->save($image_path . "/thumbnail/thumb_240.jpg");
$image->resizeToBestFit(500, 300)->save($image_path . "/thumbnail/thumb_500_300.jpg");
$image->crop(200, 200)->save($image_path . "/thumbnail/thumb_crop_200_200.jpg");
return $image_metadata;
};To validate and manage an archive file, I recommended using UnifiedArchive package. For more information I strongly recommand to read UnifiedArchive documantation . After that, depends on whether your file is valid or not, you can throw an Exception. At the end, you can export your data:
$archive_path = __DIR__ . "/archive/$user_id";
$archive_name = str_random();
$archive_export = function ($filename) use ($archive_path, $archive_name) {
mkdir("$archive_path/$archive_name");
$archive = UnifiedArchive::open($filename);
//Add a Validator: check whether the file is able to open or not
if (null === $archive) {
unlink($filename);
throw new Exception("Sorry!we could not open the archive.
Please check whether your extension has been installed or not.
Your file may be corrupted or is encrypted");
}
//Add a Validator: check whether the profile.jpg is in archive or not
if (!$archive->isFileExists('profile.jpg')) {
unlink($filename);
throw new Exception("Sorry!we could not find 'profile.jpg' in the archive");
}
//Extracting files
$archive->extractFiles("$archive_path/$archive_name");
return $archive->getFileNames();
};To validate and manage an archive file, I recommended using php-ffmpeg package. For more information I strongly recommand to read php-ffmpeg . After that, depends on whether your file is valid or not, you can throw an Exception. At the end, you can export your data:
$audio_path = __DIR__ . "/audios/$user_id";
$audio_name = str_random();
$audio_export = function ($filename) use ($audio_path, $audio_name) {
mkdir($audio_path . '/flac');
$audio = AYazdanpanah\FFMpegStreaming\FFMpeg::create()
->open($filename);
$audio_metadata = $audio->getFirstStream();
//Add a Validator: check if the file is audio
if (!$audio_metadata->isAudio() && null === ($duration = $audio_metadata->get('duration')) && $duration <= 60) {
throw new Exception("Sorry, your file is not an audio or your audio duration must be longer than 1 minute!");
}
//Add a Validator: check if the file is mp3
if (!strstr($audio_metadata->get('codec_name'), 'mp3')) {
throw new Exception("Sorry, your audio format must be mp3!");
}
//Convert the file into flac format
$format = new FFMpeg\Format\Audio\Flac();
$format->on('progress', function ($audio, $format, $percentage) {
echo "$percentage % transcoded\n";
});
$format
->setAudioChannels(2)
->setAudioKiloBitrate(256);
$audio->save($format, "$audio_path/flac/$audio_name.flac");
return $audio_metadata->all();
};After uploading, class return an object that is instance of Filter. You can export all details of your upload by using all() method:
print_r($uploads->all());// Returns all uploads and their details.print_r($uploads->get(['upload_video', 'upload_raw']));// Returns specified uploads and their details.
print_r($uploads->except(['upload_raw', 'upload_image']));// Returns all uploads and their details except those ones specified.
print_r($uploads->first());// Returns first upload and it's detail.
print_r($uploads->succeeded());// Returns all succeeded uploads and their details.
print_r($uploads->failed());// Returns all failed uploads and their details.
print_r($uploads->names());// Returns all upload names.
print_r($uploads->count());// Returns the number of uploadsFor see complete example, please go to examples.
I'd love your help in improving, correcting, adding to the specification. Please file an issue or submit a pull request.
Please see Contributing File for more information.
If you discover a security vulnerability within this package, please send an e-mail to Amin Yazdanpanah via: contact [AT] aminyazdanpanah • com.
The MIT License (MIT). Please see License File for more information.