How to Use Verot.net Upload Class

How to Use Verot.net Upload Class#

I want to share with you a wonderful upload class I came across while looking for multi-upload classes to use in my project.
This class, which is quite simple to install and use, provides great convenience, especially in image upload operations.

Installation#

First, we download the ZIP file from the Verot.net class.upload.php address.
Enter the SRC folder inside the ZIP and:

• copy the class.upload.php file
• copy the lang folder

to the directory where your project is located.

Then we include the class in our PHP file:

require_once 'class.upload.php';

Creating the Form Area#

We prepare our HTML form as follows:

<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>

The name part is important here. Since we will be uploading an image, we can name it image_field or image. The form will be sent to the upload.php page using the POST method.

File Upload Process on the PHP Side#

Write the following codes in the upload.php file:

$handle = new upload($_FILES['image_field']); // We wrote the name from the input field here
if ($handle->uploaded) {
  $handle->file_new_name_body   = 'image_resized';
  $handle->image_resize         = true; // We confirm that we want to resize the image
  $handle->image_x              = 100;  // It will shrink to 100 on the X axis
  $handle->image_ratio_y        = true; // Aspect ratio protection
  $handle->process('/home/user/files/'); // The folder where the file will be uploaded
  if ($handle->processed) {  // If successful
    echo 'image resized';
    $handle->clean();
  } else { // If failed
    echo 'error : ' . $handle->error;
  }
}

Removing Thumb (Small Image) Creation#

If you don't want a thumb, simply remove the following lines:

$handle->file_new_name_body   = 'image_resized';
$handle->image_resize         = true;
$handle->image_x              = 100;
$handle->image_ratio_y        = true;

Including Language File#

If you want error messages and system outputs in a specific language, you can include the language file as follows:

$handle = new upload($_FILES['image_field'], 'tr_TR');

If you don't write this, the default language will be English.

Useful Settings and Methods#

Below are some frequently used features and their descriptions:

$handle->file_overwrite = true;

Allows files to be overwritten. For example, if there is a file with the same name (john.jpg), it overwrites it instead of giving an error.

$handle->file_new_name_body = 'new_name';

Determines the name of the uploaded file. For example, if you write “abuzer,” all images will be uploaded with this name.

$handle->file_auto_rename = true;

If a file with the same name exists, it automatically gives it a different name. (Default: false)

$handle->file_max_size = '1024';

Limits the size of the file to be uploaded (example: 1 KB).

$handle->allowed = array('application/pdf','application/msword','image/*');

Specifies the file types allowed to be uploaded.

$handle->image_convert = 'jpg';

Converts uploaded images to the desired format. (Supported formats: png, jpeg, gif, bmp)

$handle->jpeg_quality = 50;

Determines the image quality. As the value decreases, the file size decreases, and the quality drops.

$handle->image_max_width = 200;
$handle->image_max_height = 100;
$handle->image_min_width = 100;
$handle->image_min_height = 500;

Controls the minimum and maximum sizes of images.

For more information, you can examine the official documentation: 👉 https://github.com/verot/class.upload.php/blob/master/README.md