Ever wanted an all-purpose, easy-to-use method of resizing your images in PHP? Well, that's what PHP classes are for—reusable pieces of functionality that we call to do the dirty work behind the scenes. We're going to learn how to create our own class that will be well constructed and expandable.?

Introduction

To give you a quick glimpse of what we're trying to achieve with our class, the class should be:

• easy to use
• format independent: can open, resize, and save a number of different image formats
• intelligent sizing: no image distortion!

There's a lot to cover—let's begin.

1. Preparation

The first step is easy. In your working directory, create two files: one called index.php and the other resize-class.php

2. Calling the Object

To give you an idea of what we're trying to achieve, we'll begin by coding the calls we'll use to resize the images. Open your index.php file and add the following code.

As you can see, there is a nice logic to what we're doing. We open the image file, and we set the dimensions we want to resize the image to and the type of resizing. Then we save the image, choosing the image format and quality we want. Save and close your index.php file.

// *** Include the class<br>include("resize-class.php");<br><br>// *** 1) Initialize / load image<br>$resizeObj = new resize('sample.jpg');<br><br>// *** 2) Resize image (options: exact, height, width, auto, crop)<br>$resizeObj -> resizeImage(150, 100, 'crop');<br><br>// *** 3) Save image<br>$resizeObj -> saveImage('sample-resized.gif', 100);<br>

From the code above, you can see we're opening a jpg file but saving a gif. Remember, it's all about flexibility.

3. Create the Class Skeleton

It's Object-Oriented Programming (OOP) that makes this sense of ease possible. Think of a class like a pattern; you can encapsulate the data—another jargon term that really just means hiding the data. We can then reuse this class over and over without the need to rewrite any of the resizing code—you only need to call the appropriate methods, just as we did in step 2. Once our pattern has been created, we create instances of this pattern, called objects.

Let's begin creating our resize class. Open your resize-class.php file. Below is a really basic class skeleton structure which I've named $fileName.

We need to open the file passed in with PHP (more specifically the PHP GD Library) so PHP can read the image. We're doing this with the custom method $image as a private variable by typing private, you're limiting the scope of that variable so it can only be accessed by the class. From now on, we can make a call to our opened image, known as a resource, which we will be doing later when we resize.

While we're at it, let's store the height and width of the image. I have a feeling these will be useful later.

You should now have the following.

// *** Include the class<br>include("resize-class.php");<br><br>// *** 1) Initialize / load image<br>$resizeObj = new resize('sample.jpg');<br><br>// *** 2) Resize image (options: exact, height, width, auto, crop)<br>$resizeObj -> resizeImage(150, 100, 'crop');<br><br>// *** 3) Save image<br>$resizeObj -> saveImage('sample-resized.gif', 100);<br>

The imagesy() methods are built-in functions that are part of the GD library. They retrieve the width and height of your image, respectively.

5. Opening the Image

In the previous step, we called the custom method strrchr() function in PHP, which returns part of the main string from the last occurrence of the specified character till its end. For example, the filename papaya.jpg will give us .jpg, and the filename i.like.papaya.jpg will also give us .jpg.

After determining the extension, we use the appropriate exact)

7. Resizing. Let's Do It!

There are two parts to the resize method. The first is getting the optimal width and height for our new image by creating some custom methods—and of course passing in our resize option as described above. The width and height are returned as an array and set to their respective variables. Feel free to pass by reference—but I'm not a huge fan of that.

The second part is what performs the actual resizing. We will be using two built-in PHP functions for our resizing. They are:

• imagecopyresampled

I recommend that you read about them in the documentation.

In short, the imagecopyresampled() function is used to copy and resize part of an image with resampling.

We also save the output of the private $imageResized; with your other class variables.

Resizing is performed by a PHP module known as the GD Library. Many of the methods we're using are provided by this library.

		Class resize<br>		{<br>			// *** Class variables<br>			private $image;<br>			private $width;<br>			private $height;<br><br>			function __construct($fileName)<br>			{<br>			    // *** Open up the file<br>			    $this->image = $this->openImage($fileName);<br><br>			    // *** Get width and height<br>			    $this->width  = imagesx($this->image);<br>			    $this->height = imagesy($this->image);<br>			}<br>		}<br>

In the above code snippet, we calculate the new image dimensions and create a true color image object accordingly. This image object is then passed to height or auto, we use the original width and height of the image to determine whether the resized image should have a fixed width or height. For images in landscape orientation, we keep the width fixed. For images in portrait orientation, we keep the height fixed. If the original image is a square, we pick the fixed dimension using the new width and height value.

// *** Add to class variables<br>private $imageResized;<br><br>public function resizeImage($newWidth, $newHeight, $option="auto")<br>{<br><br>	// *** Get optimal width and height - based on $option<br>	$optionArray = $this->getDimensions($newWidth, $newHeight, strtolower($option));<br><br>	$optimalWidth  = $optionArray['optimalWidth'];<br>	$optimalHeight = $optionArray['optimalHeight'];<br><br>	// *** Resample - create image canvas of x, y size<br>	$this->imageResized = imagecreatetruecolor($optimalWidth, $optimalHeight);<br>	imagecopyresampled($this->imageResized, $this->image, 0, 0, 0, 0, $optimalWidth, $optimalHeight, $this->width, $this->height);<br><br>	// *** if option is 'crop', then crop too<br>	if ($option == 'crop') {<br>		$this->crop($optimalWidth, $optimalHeight, $newWidth, $newHeight);<br>	}<br>}<br>

The $optimalHeight and $optimalWidth<code>$optimalWidth, which we use for resizing. The reason is that instead of cropping the image directly to the specified width and height, our class crops the images after resizing.

Let's say the dimensions of an image are 1920w and 1080h, and you want to crop it to 1200w and 200h. As you can see, the ratio of the original width to the new width will be lower than the corresponding height ratio. Therefore, the image will first need to be resized in such a way that its width comes down to 1200 and the height changes accordingly.

The actual cropping of the image will be done after the resizing is complete.

10. Crop

If you opted for a crop—that is, you've used the crop option—then you have one more little step. We're going to crop the image from the center. Cropping is a very similar process to resizing but with a couple more sizing parameters passed in.

// *** Include the class<br>include("resize-class.php");<br><br>// *** 1) Initialize / load image<br>$resizeObj = new resize('sample.jpg');<br><br>// *** 2) Resize image (options: exact, height, width, auto, crop)<br>$resizeObj -> resizeImage(150, 100, 'crop');<br><br>// *** 3) Save image<br>$resizeObj -> saveImage('sample-resized.gif', 100);<br>

11. Save the Image

We're getting there; almost done. It's now time to save the image. We pass in the path and specify the image quality we would like ranging from 0-100, 100 being the best. Then we call the appropriate method. A couple of things to note about the image quality: JPG uses a scale of 0-100, 100 being the best. GIF images don't have an image quality setting. PNGs do, but they use the scale 0-9, 0 being the best. This isn't good as we can't expect ourselves to remember this every time we want to save an image. So we can do a bit of magic to standardize everything.

		Class resize<br>		{<br>			// *** Class variables<br>			private $image;<br>			private $width;<br>			private $height;<br><br>			function __construct($fileName)<br>			{<br>			    // *** Open up the file<br>			    $this->image = $this->openImage($fileName);<br><br>			    // *** Get width and height<br>			    $this->width  = imagesx($this->image);<br>			    $this->height = imagesy($this->image);<br>			}<br>		}<br>

Now is also a good time to destroy our image resource to free up some memory. If you were to use this in production, it might also be a good idea to capture and return the result of the saved image.

Conclusion

Well, that's it, folks. Thank you for following this tutorial, and I hope you find it useful.

This post has been updated with contributions from?Monty Shokeen. Monty is a full-stack developer who also loves to write tutorials and to learn about new JavaScript libraries.

The above is the detailed content of Image Resizing Made Easy With?PHP. For more information, please follow other related articles on the PHP Chinese website!