nautilus

---

A one file/class to upload/crop/resize/watermark images in PHP securely!!.

enable the php_exif extension in your php.ini before using this class.

Install

{
    "require": {
        "image/nautilus": ">=1.0.0"
    }
}

Setup

// just require the class and create the object
require_once  "src\nautilus.php";
$image = new Image\nautilus;

1 - upload with default settings

The below code will:

• Only upload images with (jpg, gif, png, jpeg) extension,
• Only sizes ranging from 0.1kb to 30kb max
• Creates [if it doesn't exist] "uploads/" folder for storing the image

if($_FILES){
    $result = $image->upload($_FILES['picture']);
}

Also, the variable $result will contain the upload directory/image name. Which can be useful, for storage in database or render the uploaded image using <img src=' <?= $result ?> '/>

2 - customized size, dimension and location.

$image->fileTypes(["png", "jpeg"])  //only accept png/jpeg image types
    ->uploadDir("pics")  //create folder 'pics' if it does not exist.
    ->limitSize(["min"=>1000, "max"=>55000])  //limit image size (in bytes)
    ->limitDimension(["height"=>100, "width"=>120]);  //limit image dimensions
    ->upload($_FILES['picture']);  // upload to folder 'pics'

3 - shrink and upload

shrink() method shrinks/resizes the image according to the given dimensions (in pixels)

$image->fileTypes(["jpg", "gif", "png", "jpeg"])
    ->uploadDir("small_pics")
    ->shrink(["height"=>100, "width"=>200]) // shrink to 100*200 pixels
    ->upload($_FILES["pictures"]); // upload to small_pics folder

4 - watermark and upload.

watermark() create a watermark at the top of the main image, accepts 2 args: 1# - The image to use as watermark. (best to use a PNG). 2# - The Location where to put the watermark on the image. Location can be a string 'center', 'bottom-right', 'bottom-left', 'top-left'...

$image->fileTypes(array("png"))
    ->uploadDir("watermarked")
    ->watermark('me.png', 'bottom-right')) // put 'me.png' on center 
    ->upload($_FILES['logo']);

5 - crop and upload.

crop() method simply crops the images, by the given cordination

$image->fileTypes(array("png"))
   ->crop(array("height"=>40, "width"=>50)) // crop/trim to 40*50 pixels
   ->upload($_FILES['logo']);

Please check the examples/ folder for list of boilerplate codes

Renaming images

upload() accepts 2 arguments; image path & image name [optional] If you want to set a costume name, then pass a second argument, otherwise it will have auto-generated name.

// Image will be renamed 'cheeez' plus the extension 
->upload($_FILES['fileName'], 'cheeez');

// Image will be given random name like: 1531e4b0e3bc82_QPIJLMPKQNJGF plus ext. 
->upload($_FILES['fileName']);

Manipulating uploaded images:

The change() method is different from upload() and should not be mixed. as the first will simply allow you to change images in your server, that do no need uploading.

// The change method is like accessing any file physically and making change to it. 
//CROP IMAGES
$change = $image
 	->crop(array("height"=>10, "width"=>10))
 	->change("crop", "my_pictures/awesome.gif");

// WATERMARK IMAGES
$change = $image
 	->watermark("logo.png", "center")
 	->change("watermark", "my_pictures/passport.gif");

// SHRINK IMAGES
$change = $image
 	->shrink(array("height"=>30, "width"=>50))
 	->change("shrink", "my_pictures/paris.jpg");

What makes this secure ?

• It checks any errors thrown from the $_FILES[]['error'] array.
• Uses exif_imagetype() method to get the real mime/image type,
• Checks if image type exists in the expected types ie. array('jpg', 'png', 'gif', 'jpeg')
• Checks getimagesize(); to see if the image has a valid width/height measurable in pixels.

Todo

• Allow Image Resizing Done.
• Allow Image Watermarking Done.
• Allow Image Cropping Done.
• Handle Errors with Exceptions Done.
• Backward compatability for PHP 5.3 Done.
• Single Responsibility Principle don't count on it yet.

License

Luke 3:11 ( Free; No license! )