Print Image With Fixed Aspect Ratio In PHP

20th September 2010 - 4 minutes read time

When displaying images added by users it is quite often necessary to resize them in order that they fit into a specific area of the page. Not doing this can cause problems with the images breaking the page layout. The trouble is that if you resize the image absolutely you tend to squash and distort it.

The following function can be used to calculate the width and height of an image to the correct aspect ratio, which will preserve the contents when printed out. This function makes use of the getimagesize() function, which is available as part of the GD library in PHP.

/**
 * Calculates the aspect ratio of an image returns a formatted string
 * containing the width and height of the image to a fixed width.
 *
 * @param string  The name of the file
 * @param integer The width of the image (optional)
 *
 * @return string The image dimentions.
 */
function img_aspect_ratio($file, $width = 200){
    if (!file_exists($file)){
        // File doesn't exist, return false.
        return '';
    }

    // Get the image dimensions
    $image_size = getimagesize($file);

    if ($image_size === false) {
        // Failed to get dimensions for image, return width
        return ' width="' . $width . '"';
    }

    // Divide height by width to get the apect ratio.
    $aspect_ratio = $image_size[1] / $image_size[0];
     
    // Change the height according to the aspect ratio
    $height = (int)($aspect_ratio * $width) . "px";
     
    // Return formatted string of width and height
    return ' height="' . $height . '" width="' . $width . '"';    
}

You can use the function like this:

$image_file = 'example_image.png';

echo '<img' . img_aspect_ratio($image_file, 150) . ' src="' . $image_file . '" />';

I should note that this solution is far from perfect and shouldn't be used in all circumstances. It is best suited to resize images that only need a little tweak. For example, to resize the thumbnails in a gallery without having to regenerate all of the thumbnail images again.

This function shouldn't be used to resize large images down to small dimensions as your users will still need to download the full size images before they are resized in the browser. In this situation you should regenerate a smaller version of the image and then use this as the source of the image in the browser.

PHP

Add new comment

The content of this field is kept private and will not be shown publicly.
CAPTCHA
15 + 3 =
Solve this simple math problem and enter the result. E.g. for 1+3, enter 4.
This question is for testing whether or not you are a human visitor and to prevent automated spam submissions.

Related Content

Recreating Spotify Wrapped In PHP

17th March 2024

I quite like the end of the year report from Spotify that they call "Wrapped". This is a little application in which they tell you what your favorite artist was and what sort of genres you listened to the most during the year.

Read more

Should A Constructor Throw An Exception?

18th February 2024

Let's say you had a class that you wanted to use, but there was some sort of error in creating the object. This might be that the wrong parameters were passed, or the third party service (eg. a database) wasn't available at the time of creation.

Read more

PHP Question: Variable Reference

10th December 2023

Question

What does the following code print out?

function arrayPrint($array)
{
   echo implode(' ', $array);
}

$arrayA = [1, 2, 3];
$arrayB = $arrayA;
$arrayB[1] = 0;
arrayPrint($arrayA);

Read more

Creating An Authentication System With PHP and MariaDB

15th October 2023

Using frameworks to handle the authentication of your PHP application is perfectly fine to do, and normally encouraged. They abstract away all of the complexity of managing users and sessions that need to work in order to allow your application to function.

Read more

Creating Sparklines In PHP

17th September 2023

A sparkline is a very small line graph that is intended to convey some simple information, usually in terms of a numeric value over time. They tend to lack axes or other labels and are added to information readouts in order to expand on numbers in order to give them more context.

Read more