PHP: getimagesize

Description

array getimagesize ( string filename [, array &imageinfo] )

The getimagesize() function will determine the size of any GIF, JPG, PNG, SWF, SWC, PSD, TIFF, BMP, IFF, JP2, JPX, JB2, JPC, XBM, or WBMP image file and return the dimensions along with the file type and a height/width text string to be used inside a normal HTML IMG tag.

If accessing the filename image is impossible, or if it isn't a valid picture, getimagesize() will return FALSE and generate an error of level E_WARNING.

Notatka: Support for JPC, JP2, JPX, JB2, XBM, and WBMP became available in PHP 4.3.2. Support for SWC exists as of PHP 4.3.0 and TIFF support was added in PHP 4.2.0

Notatka: JPEG 2000 support was added in PHP 4.3.2. Note that JPC and JP2 are capable of having components with different bit depths. In this case, the value for "bits" is the highest bit depth encountered. Also, JP2 files may contain multiple JPEG 2000 codestreams. In this case, getimagesize() returns the values for the first codestream it encounters in the root of the file.

Notatka: The getimagesize() function does not require the GD image library.

Returns an array with 4 elements. Index 0 contains the width of the image in pixels. Index 1 contains the height. Index 2 is a flag indicating the type of the image: 1 = GIF, 2 = JPG, 3 = PNG, 4 = SWF, 5 = PSD, 6 = BMP, 7 = TIFF(intel byte order), 8 = TIFF(motorola byte order), 9 = JPC, 10 = JP2, 11 = JPX, 12 = JB2, 13 = SWC, 14 = IFF, 15 = WBMP, 16 = XBM. These values correspond to the IMAGETYPE constants that were added in PHP 4.3.0. Index 3 is a text string with the correct height="yyy" width="xxx" string that can be used directly in an IMG tag.

Przykład 1. getimagesize (file)


<?php

list($width, $height, $type, $attr) = getimagesize("img/flag.jpg");

echo "<img src=\"img/flag.jpg\" $attr alt=\"getimagesize() example\" />";

?>

URL support was added in PHP 4.0.5

Przykład 2. getimagesize (URL)


<?php 

$size = getimagesize("http://www.example.com/gifs/logo.gif");



// if the file name has space in it, encode it properly

$size = getimagesize("http://www.example.com/gifs/lo%20go.gif");



?>

With JPG images, two extra indexes are returned: channels and bits. channels will be 3 for RGB pictures and 4 for CMYK pictures. bits is the number of bits for each color.

Beginning with PHP 4.3.0, bits and channels are present for other image types, too. However, the presence of these values can be a bit confusing. As an example, GIF always uses 3 channels per pixel, but the number of bits per pixel cannot be calculated for an animated GIF with a global color table.

Some formats may contain no image or may contain multiple images. In these cases, getimagesize() might not be able to properly determine the image size. getimagesize() will return zero for width and height in these cases.

Beginning with PHP 4.3.0, getimagesize() also returns an additional parameter, mime, that corresponds with the MIME type of the image. This information can be used to deliver images with correct HTTP Content-type headers:

Przykład 3. getimagesize() and MIME types


<?php

$size = getimagesize($filename);

$fp=fopen($filename, "rb");

if ($size && $fp) {

  header("Content-type: {$size['mime']}");

  fpassthru($fp);

  exit;

} else {

  // error

}

?>

The optional imageinfo parameter allows you to extract some extended information from the image file. Currently, this will return the different JPG APP markers as an associative array. Some programs use these APP markers to embed text information in images. A very common one is to embed IPTC http://www.iptc.org/ information in the APP13 marker. You can use the iptcparse() function to parse the binary APP13 marker into something readable.

Przykład 4. getimagesize() returning IPTC


<?php

$size = getimagesize("testimg.jpg", $info);

if (isset($info["APP13"])) {

    $iptc = iptcparse($info["APP13"]);

    var_dump($iptc);

}

?>

User Contributed Notes


This is a useful function to display a thumbnail of a whatever image.

This piece of code has been lightly modified from an example found on <b>NYPHP.ORG</B>.

This function can build a thumbnail of any size you want and display it on your browser!

Hope it can be useful for you guys!



<?php



function makeThumbnail($o_file, $t_ht = 100) {

    $image_info = getImageSize($o_file) ; // see EXIF for faster way

    

    switch ($image_info['mime']) {

        case 'image/gif':

            if (imagetypes() & IMG_GIF)  { // not the same as IMAGETYPE

                $o_im = imageCreateFromGIF($o_file) ;

            } else {

                $ermsg = 'GIF images are not supported<br />';

            }

            break;

        case 'image/jpeg':

            if (imagetypes() & IMG_JPG)  {

                $o_im = imageCreateFromJPEG($o_file) ;

            } else {

                $ermsg = 'JPEG images are not supported<br />';

            }

            break;

        case 'image/png':

            if (imagetypes() & IMG_PNG)  {

                $o_im = imageCreateFromPNG($o_file) ;

            } else {

                $ermsg = 'PNG images are not supported<br />';

            }

            break;

        case 'image/wbmp':

            if (imagetypes() & IMG_WBMP)  {

                $o_im = imageCreateFromWBMP($o_file) ;

            } else {

                $ermsg = 'WBMP images are not supported<br />';

            }

            break;

        default:

            $ermsg = $image_info['mime'].' images are not supported<br />';

            break;

    }

    

    if (!isset($ermsg)) {

        $o_wd = imagesx($o_im) ;

        $o_ht = imagesy($o_im) ;

        // thumbnail width = target * original width / original height

        $t_wd = round($o_wd * $t_ht / $o_ht) ; 



        $t_im = imageCreateTrueColor($t_wd,$t_ht);

        

        imageCopyResampled($t_im, $o_im, 0, 0, 0, 0, $t_wd, $t_ht, $o_wd, $o_ht);

        

        imageJPEG($t_im);

        

        imageDestroy($o_im);

        imageDestroy($t_im);

    }

    return isset($ermsg)?$ermsg:NULL;

}

?>



Here the code to call the function:



<?



header("Content-type: image/jpeg");

makeThumbnail("http://it2.php.net/images/php.gif", 300);



?>


I've wrote this piece of useful code.

May be it will be useful for you.

But i got a problem - if source image is in the area with need of authorization then the functions that read some files from that place (i.e. getimagesize, imagejpeg) does not work!

How to solve it?



<?php

//i't a stand-alone file named resize.php

//the feature is caching

// /image/thumbcache folder is used with file name forming by md5($img.$calc_width.$calc_height);

//it gets such parameters:

//img - image address (URL)

//w - optional width

//h - optional height

//if you set either w or h, then the image is resized proportionaly, according to the source

//if you set neither w nor h then the script just output file

//if you set both w or h then the image will be resized exactly how you want



    $server_root = 'http://'.$_SERVER['SERVER_NAME'].'/';



    if (isset($_GET['img']) && ((isset($_GET['w']) || isset($_GET['h'])))

    {

        $img = substr($_GET['img'],0,100);

        if (isset($_GET['w'])) $w = substr($_GET['w'],0,10);

        if (isset($_GET['h'])) $h = substr($_GET['h'],0,10);



        error_reporting(0);



        //check cache

        $hash = md5($img.$w.$h);

        $pos = strrpos($img,".");

        $ext = substr($img,$pos+1,strlen($img)-$pos);

        $fname = $hash.'.'.$ext;

        $cachedim = @imagecreatefromjpeg($serverroot.'images/thumbcache/'.$fname);

        if ($cachedim) //just show cached thumbnail

        {

            header("Content-type: image/jpeg");

            imagejpeg($cachedim,'',100);

        }

        else //create and cache thumbnail and show it 'cause it's not in cache

        {

            list($width, $height, $type, $attr) = getimagesize($img);

            if ($type==2) //jpeg

            {

                $im = @imagecreatefromjpeg($img); /* Attempt to open */

                if (!$im) { /* See if it failed */

            $im  = imagecreate(150, 30); /* Create a blank image */

                    $bgc = imagecolorallocate($im, 255, 255, 255);

                    $tc  = imagecolorallocate($im, 0, 0, 0);

                    imagefilledrectangle($im, 0, 0, 150, 30, $bgc);

                    imagestring($im, 1, 5, 5, "Error loading image!", $tc);

                }

                else

                {

                    //constrain proportions if needed

                    if (isset($w)){ if ($w==0) $w = $width; }

                    else $w = $width*$h/$height;



                    if (isset($h)){ if ($h==0) $h = $height; }

                    else $h = $height*$w/$width;



                    $dstw=isset($w)?$w:$width;

                    $dsth=isset($h)?$h:$height;

                    $tim = imagecreatetruecolor($dstw,$dsth);

            

            imagecopyresampled($tim,$im,0,0,0,0,$dstw,$dsth,$width,$height);

                    

                    header("Content-type: image/jpeg");

                    imagejpeg($tim,'./images/thumbcache/'.$fname,100);

                    imagejpeg($tim,'',100);

                }

            }

        }

        error_reporting(E_ALL);

    }



?>


A simple piece of code i wrote to proportionally resize an image to a max height and width then display it



<?php

// Max height and width

$max_width = 100;

$max_height = 100;



// Path to your jpeg



$upfile '/path/to/file.jpg';

    Header("Content-type: image/jpeg");

    

    $size = GetImageSize($upfile); // Read the size

          $width = $size[0];

          $height = $size[1];

          

          // Proportionally resize the image to the

          // max sizes specified above

          

          $x_ratio = $max_width / $width;

          $y_ratio = $max_height / $height;



          if( ($width <= $max_width) && ($height <= $max_height) )

          {

               $tn_width = $width;

               $tn_height = $height;

          }

          elseif (($x_ratio * $height) < $max_height)

          {

               $tn_height = ceil($x_ratio * $height);

               $tn_width = $max_width;

          }

          else

          {

               $tn_width = ceil($y_ratio * $width);

               $tn_height = $max_height;

          }

     // Increase memory limit to support larger files

     

     ini_set('memory_limit', '32M');

     

     // Create the new image!

     $src = ImageCreateFromJpeg($upfile);

     $dst = ImageCreateTrueColor($tn_width, $tn_height);

     ImageCopyResized($dst, $src, 0, 0, 0, 0, $tn_width, $tn_height, $width, $height);

     ImageJpeg($dst);

// Destroy the images

ImageDestroy($src);

ImageDestroy($dst);

?>


This is just to add to the comment by robertks at hotmail dot com on 

05-Mar-2003 12:12 regarding trying to derive the dimensions of a video file. The package referenced (http://www.getid3.org/) had been updated, and below is a script I use to get the size. You can get many other attributes of media files as well.



<?php

// include getID3() library (can be in a different directory if full path is specified)

 include_once('getid3.php');

 

// Initialize getID3 engine

$getID3 = new getID3;



 // File to get info from

 $file_location = './your/path/to/file.mov';



// Get information from the file

 $fileinfo = $getID3->analyze($file_location);

 getid3_lib::CopyTagsToComments($fileinfo);

 

 // Output results

if (!empty($fileinfo['video']['resolution_x'])) { echo '<p> video width: '.$fileinfo['video']['resolution_x'].'</p>'; }

if (!empty($fileinfo['video']['resolution_y'])) { echo '<p> video height: '.$fileinfo['video']['resolution_y'].'</p>'; }

?>



Hope that helps others looking for a function similar to getimagesize() for a video or media file.


--- Editor's Note:


It's easier to call on urlencode() or rawurlencode() to "fix" urls containing spaces and other characters that normally not well-liked.


--- 





You may have noticed that images with spaces WONT work with getimagesize - some of us have massive amounts of pictures, or don't feel like rewriting file names on users uploaded pictures- so here is a super fast fix that will replace the spaces once the image is called and will work with getimagesize flawlessly-





$image_new = "/pictures/$pic[picture]";  //PICTURE URL


$image_new = str_replace(' ','%20',$image_new); //REPLACE THE SPACES





Now you just call $image_new using getimagesize and you wont' have anymore problems.





On my site I take uploaded pictures from users - then resize them if they are over a certain width, here is the script i use if anyone would like to do this-





$image_new = "/pictures/$pic[picture]"; //url of picture


$image_new = str_replace(' ','%20',$image_new); //take url and replace spaces


$max_width= "480";  //maximum width allowed for pictures


$resize_width= "480";  //same as max width


$size = getimagesize("$image_new");    //get the actual size of the picture


$width= $size[0];           // get width of picture


$height= $size[1];   // get height of picture


if ($width>$max_width){


            $new_width=$resize_width;  // Resize Image If over max width


}else {


            $new_width=$width;       // Keep original size from array because smaller than max





}





echo "<IMG src=\"$image_new\" border=1  width=$new_width>"   //print image with new width





Hope this helps anyone who wants some simple uses for getimagesize- check out my website to see it in action- vitalmodels.com


I'm sorry for they other scripts, but I made one mistake about the image resizing... here is a working script !

<?

    // Some configuration variables !

    $maxWidth = 90;

    $maxHeight = 90;

    $maxCols = 8;

    $webDir = "https://localhost/images/";

    $localDir = $_SERVER['DOCUMENT_ROOT']."/images/";



    $AutorisedImageType = array ("jpg", "jpeg", "gif", "png");

?>



<center>

<table border='1' cellspacing='5' cellpadding='5' style="border-collapse:collapse; border-style: dotted">

<tr>

   <?

   // Open localDir

   $dh = opendir($localDir);

   while (false !== ($filename = readdir($dh))) {

       $filesArray[] = $filename;

   }



   // Display and resize

   foreach ($filesArray as $images) {

   

       $ext = substr($images, strpos($images, ".")+1, strlen($images));

       

       if( in_array($ext, $AutorisedImageType) ) {



           list($width, $height, $type, $attr) = @getimagesize( $localDir.$images );



            $xRatio = $maxWidth / $width; 

            $yRatio = $maxHeight / $height; 

            

            if ( ($width <= $maxWidth) && ($height <= $maxHeight) ) { 

              $newWidth = $width; 

              $newHeight = $height; 

            } 

            else if (($xRatio * $height) < $maxHeight) { 

              $newHeight = ceil($xRatio * $height); 

              $newWidth = $maxWidth; 

            } 

            else { 

              $newWidth = ceil($yRatio * $width); 

              $newHeight = $maxHeight; 

            } 

           

           if($i == $maxCols) {

               echo "</tr><tr>";

               $i = 0;

           }

           echo "<td align='center' valign='middle' width='$maxWidth' height='$maxHeight'><img src='".$webDir.$images."' width='$newWidth' height='$newHeight'></td>";

           $i++;

       }

   }

?>

</tr>

</table>

</center>


A cool resize / cropping script for creating thumbnails using mogrify



IMAGETEST.PHP



<?php 



include 'mogrify.php';



// variables from flash (my website uses flash and php)

$picture="sample.jpg";

$fixedwidth=300;

$fixedheight=240;

//



cropimage($picture,$fixedwidth,$fixedheight,$mogrify);



 ?>



MOGRIFY.PHP



<?php 

// walking the path

$mogrify="C:/apache/Imagik/mogrify.exe";



// ---------------------------------------- crop function



function cropimage($picture,$fixedwidth,$fixedheight,$mogrify) {



    // GET IMG

    $img = imagecreatefromjpeg($picture);

    $width= imagesx($img);

    $height= imagesy($img);

    // CROP WIDTH 

    if($width!=$fixedwidth){

        $ratio =$fixedwidth/$width;

        $NewHeight=round($height*$ratio);

        $NewWidth=round($width*$ratio);

        exec( $mogrify." -resize ".$NewWidth."x".$NewHeight."! $picture");

        exec( $mogrify." -crop ".$fixedwidth."x".$fixedheight."+0+0 $picture");

        // REFRESH

        $img = imagecreatefromjpeg($picture);

        $width= imagesx($img);

        $height= imagesy($img);

    }

    // CROP HEIGHT

    if($height!=$fixedheight){

        $ratio =$fixedheight/$height;

        $NewHeight=round($height*$ratio);

        $NewWidth=round($width*$ratio);

        exec( $mogrify." -resize ".$NewWidth."x".$NewHeight."! $picture");

        exec( $mogrify." -crop ".$fixedwidth."x".$fixedheight."+0+0 $picture");

    }

    //

    ImageDestroy($img);

}



?>



yeah!


If you want to show thumbnails keeping the original proportions, with defined maximum width and height, you can use this function. This is useful when showing tables of user-uploaded images, that not necessarily are same-sized. However, for big images (like wallpapers), a better option is to create separated thumbnails with a image-editing software.



If the image is smaller or equal than the defined maximums, then it's showed without resizing. If not, creates a link to a pop-up that shows the full-size image.



<?php

function show_thumbnail($file)

{

    $max = 200 // Max. thumbnail width and height



    $size = getimagesize($file);



    if ( $size[0] <= $max && $size[1] <= $max )

    {

        $ret = '<img src="'.$file.'" '.$size[3].' border="0">';

    }

    else

    {

        $k = ( $size[0] >= $size[1] ) ? $size[0] / $max : $size[1] / $max;

        $ret = '<a href="javascript:;" onClick="window.open(\'image.php?img=';

        $ret .= $file.'\',\'\',\'width='.$size[0];

        $ret .= ',height='.$size[1].'\')">';

        $ret .= '<img src="'.$file.'" width="'.floor($size[0]/$k).'" height="'.floor($size[1]/$k).'" border="0" alt="View full-size image"></a>';

    }



    return $ret;

}

?>



Here is the code of 'image.php':



<html>

<head>

<title>Image</title>

</head>

<body leftmargin="0" topmargin="0">

<?php echo ( is_file($_GET['img']) ) ? '<a href="#" onClick="window.close();"><img src="'.$_GET['img'].'" border="0" alt="Close window"></a>' : 'Invalid image filename, or no filename entered. <a href="#" onClick="window.close();">Close window</a>.' ?>

</body>

</html>


An additional note to "tightcode_nosp@m_hotmail":



If that doesn't work try this instead:



<?

      $img = imagecreatefromjpeg ($filename);

      $x = imagesx ($img);

      $y = imagesy ($img);

      imagedestroy ($img);

?>



Though keep in mind that this consumes lots of CPU. So if you're doing something like creating a page of thumbnails this is considerably slower.



So what you can do is use getimagesize() and check if

- the width and height are empty strings ("")

- and those two values aren't too high



Both indicate that getimagesize() didn't work properly. The latter may happen if getimagesize() thought that it recognized the format and therefore the size properly. I mean if you're looking at pictures that you know are max. 1024x768 and getimagesize() returns a width of e.g. 20234 then it's obvious that something went wrong. In that case use the code mentioned above. Of course if getimagesize() returned small values that are wrong you still get the wrong size. So check your pictures and priorities first.



So all of this could look like as follows:



<?

    $picinfo = @getimagesize ($filename);

    if ($picinfo !== false) {

      $x = $picinfo [0];

      $y = $picinfo [1];

    }



    // change this according the picture resolutions you're expecting

    if ($x > 2000 || $y > 2000) $x = $y = "";



    if ($x == "") {

      $img = imagecreatefromjpeg ($filename);

      $x = imagesx ($img);

      $y = imagesy ($img);

      imagedestroy ($img);

    }

?>



Note: fix syntax stuff if there's an error as I compiled this example from a few places.



If you don't care about the huge load on your CPU or you have to rely on the proper size use the snippet noted at the beginning only.