README

Introduction

This minimal PHP library is my attempt to upload images safely by an object oriented approach.

It's 79 lines.

Aims

1- to provide safe uploading.

2- to be fully in an object oriented approach.

3- to have ability to define image name and image extension (to saved with),

also maxSize, imageTypes, errorMassage.

How to use it

Parameters

This is the main method of Image:

save($name, $directory, $file)

$name

Is the name that html form assigns to the uploaded image.

$directory

Is the destination directory that the image will be saved in.
This should be an already existing directory on server.

$file

Is the name and extention that you choose for the new uploaded file like personel.png .
This third parameter can be omitted from the save() method.
If no $file value is provided, the client's uploaded name and extension will be used.

Return value

class returns TRUE on success.
class returns FALSE on failure.

Image type and size configurations (by State Design Pattern)

After instantiating the Image class and before using the save() method you can

allocate values of $maxSize :int (IN BYTES) and $alowedTypes :array (of extensions only),

not feeding them means accepting all sizes and all image types.

errorMessage3

Get and directly show the error message any where with using the errorMessage() method of the same object.
It returns NULL on a successful image saving.

A Complete Example:

$obj = new Image  //-> or any other way like dependency injection

$obj -> maxSize = 4900000;

$obj -> allowedTypes = ['png', 'jpg', 'jpeg']; 

$obj -> save('image','pics/lastfolder','personel.png');

echo ($obj -> errorMessage());

Credit

Developed by Ehsan Yousefi mailbox5517@gmail.com [https://fsdeveloper.ir]

Updates

"20/4/2019 first release version 0.0.0"

program-2 / image

Maintainers

Details