class.upload.php
Homepage : http://www.verot.net/php_class_upload.htm
Demo : http://www.verot.net/php_class_upload_samples.htm
Donations: http://www.verot.net/php_class_upload_donate.htm
Commercial use: http://www.verot.net/php_class_upload_license.htm
What does it do?
This class manages file uploads for you. In short, it manages the uploaded file, and allows you to do whatever you want with the file, especially if it is an image, and as many times as you want.
It is the ideal class to quickly integrate file upload in your site. If the file is an image, you can convert, resize, crop it in many ways. You can also apply filters, add borders, text, watermarks, etc... That's all you need for a gallery script for instance. Supported formats are PNG, JPG, GIF, WEBP and BMP.
You can also use the class to work on local files, which is especially useful to use the image manipulation features. The class also supports Flash uploaders and XMLHttpRequest.
The class works with PHP 5.3+, PHP 7 and PHP 8 (use version 1.x for PHP 4 support), and its error messages can be localized at will.
Install via composer
Edit your composer.json file to include the following:
{
"require": {
"verot/class.upload.php": "*"
}
}
Or install it directly:
composer require verot/class.upload.php
Demo and examples
Check out the test/ directory, which you can load in your browser. You can test the class and its different ways to instantiate it, see some code examples, and run some tests.
How to use it?
Create a simple HTML file, with a form such as:
<form enctype="multipart/form-data" method="post" action="upload.php">
<input type="file" size="32" name="image_field" value="">
<input type="submit" name="Submit" value="upload">
form>
Create a file called upload.php (into which you have first loaded the class):
$handle = new \Verot\Upload\Upload($_FILES['image_field']);
if ($handle->uploaded) {
$handle->file_new_name_body = 'image_resized';
$handle->image_resize = true;
$handle->image_x = 100;
$handle->image_ratio_y = true;
$handle->process('/home/user/files/');
if ($handle->processed) {
echo 'image resized';
$handle->clean();
} else {
echo 'error : ' . $handle->error;
}
}
How does it work?
You instanciate the class with the $_FILES['my_field'] array where my_field is the field name from your upload form. The class will check if the original file has been uploaded to its temporary location (alternatively, you can instanciate the class with a local filename).
You can then set a number of processing variables to act on the file. For instance, you can rename the file, and if it is an image, convert and resize it in many ways. You can also set what will the class do if the file already exists.
Then you call the function process() to actually perform the actions according to the processing parameters you set above. It will create new instances of the original file, so the original file remains the same between each process. The file will be manipulated, and copied to the given location. The processing variables will be reset once it is done.
You can repeat setting up a new set of processing variables, and calling process() again as many times as you want. When you have finished, you can call clean() to delete the original uploaded file.
If you don't set any processing parameters and call process() just after instanciating the class. The uploaded file will be simply copied to the given location without any alteration or checks.
Don't forget to add enctype="multipart/form-data" in your form tag
13 Dec 29, 2022
3 Jan 13, 2022
3 May 30, 2022
11 Apr 23, 2022
2 Sep 9, 2022
2 May 13, 2022
356 Nov 26, 2022
1 Dec 1, 2021
25 Sep 18, 2022
4 Jan 15, 2022
3 Aug 9, 2022
2 Jun 18, 2022
15 Nov 5, 2022
812 Dec 30, 2022
23 Dec 10, 2022
2 Jan 22, 2022
31.1k Dec 30, 2022
9 Jan 1, 2023
2 Sep 6, 2021