PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    getimagesize

    (PHP 4, PHP 5, PHP 7, PHP 8)

    getimagesize — 画像の大きさを取得する

    説明

    getimagesize(string $filename, array &$image_info = null): array|false

    getimagesize() 関数は、サポートする任意の形式の画像ファイルの大きさを決定し、 ファイルの型と高さ/幅を表す文字列を返します。これらは HTML の IMG タグや HTTP の content type として使用できます。

    警告

    この関数は、filename が適切な画像ファイルであることを想定しています。 画像以外のファイルを渡してもそれを画像だと判断してしまい、関数の処理は成功するでしょう。 しかし、配列には意味のない値が含まれる場合があります。

    getimagesize() を使って、そのファイルが画像であるかどうかを確かめることはできません。 そのようなことをしたい場合は、そのために用意されたソリューション (Fileinfo 拡張モジュールなど) を使いましょう。

    getimagesize() は、 image_info パラメータで追加情報を返します。

    注意: JPC と JP2 は異なるビット深度のコンポーネントを含むことが可能なことに 注意してください。この場合 "bits" に対する値は、 最も大きい深度になります。また、JP2 ファイルは 複数の JPEG 2000 コードストリームを含む場合があります。この場合、 getimagesize() はファイルのルートから 最初に遭遇するコードストリームに対する値を返します。

    注意: アイコンに関する情報は、ビットレートが最大のアイコンから取得します。

    注意: GIF 画像はひとつ以上のフレームからなります。 個々のフレームは画像の一部のみを占めます。 getimagesize() が報告する画像のサイズは、 (logical screen descriptor から読み込まれた) 全部のサイズです。

    パラメータ

    filename

    このパラメータは、情報を取得したいファイルの名前を指定します。 ローカルファイルへの参照、あるいは (設定で許可されているなら) ストリームを用いたリモートファイルへの参照を指定できます。

    image_info

    オプションのパラメータで、 画像ファイルから何らかの拡張情報を引き出すことが可能です。 現在、この変数にはJPGファイルについて 異なった複数のAPPマーカーが連想配列として返されます。いくつかのプログラムは、 これらのAPPマーカーを画像の中の埋込テキストの情報として使用します。 最も一般的な例は、マーカーAPPl3に埋込IPTC » http://www.iptc.org/情報が返されることです。 バイナリ形式のマーカーAPP13を読むことができるよう処理するために iptcparse() 関数を使用することができます。

    注意:

    image_info は、 JFIF ファイルのみをサポートします。

    戻り値

    最大 7 つの要素からなる配列を返します。画像の形式によっては、 channels や bits は含まれないことがあります。

    0 番目および 1 番目の要素は、それぞれ画像の幅と高さを表します。

    注意:

    形式によっては、画像を含まないものや複数の画像を含むものがあります。 これらの場合、getimagesize() は画像のサイズを適切に決定することができません。このような場合、 getimagesize() が返す幅と高さはいずれもゼロとなります。

    2 番目の要素は IMAGETYPE_* 定数のひとつで、 画像の形式を表します。

    3 番目の要素は IMG タグで直接利用できる文字列 height="yyy" width="xxx" です。

    mimeは画像のMIMEタイプに一致します。この情報は 画像とともに正しい HTTP Content-type ヘッダを転送するために使用できます。

    例1 getimagesize() および MIME 型

    <?php
    $size     = getimagesize($filename);
    $fp = fopen($filename, "rb");
    if (    $size && $fp) {
    header("Content-type: {$size['mime']}");
    fpassthru($fp);
    exit;
    } else {
    // エラー
    }
    ?>

    channels は RGB 画像の場合に 3、CMYK 画像の場合に 4 です。

    bits は個々の色のビット数です。

    画像の形式によっては、channels や bits の値の存在は混乱の元です。 たとえば、GIF は常に 1 ピクセルあたり 3 チャンネルを使用しますが、グローバルカラーテーブルを使ったアニメーション GIF のピクセルあたりのビット数を計算することはできません。

    失敗した場合には false を返します。

    エラー / 例外

    もし filename のイメージにアクセスできない場合、 getimagesize() は false を返し、E_WARNING レベルのエラーを発生させます。 読み込み時にエラーが発生した場合は、 getimagesize() は E_NOTICE レベルのエラーを発生させます。

    変更履歴

    バージョン 説明
    8.2.0 AVIF 画像の ビット数、チャンネル情報、幅と高さの情報(dimensions) を返すようになりました。 これより前のバージョンでは、幅と高さの情報は 0x0 として報告され、ビット数とチャンネル情報は全く報告されていませんでした。
    7.1.0 WebP に対応しました。

    例

    例2 getimagesize() の例

    <?php
    list($width, $height, $type, $attr) = getimagesize("img/flag.jpg");
    echo     "<img src=\"img/flag.jpg\" $attr alt=\"getimagesize() example\" />";
    ?>

    例3 getimagesize (URL)

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

    // ファイル名にスペースが含まれる場合は適切にエンコードしてください
    $size = getimagesize("http://www.example.com/gifs/lo%20go.gif");

    ?>

    例4 IPTC を返す getimagesize()

    <?php
    $size     = getimagesize("testimg.jpg", $info);
    if (isset(    $info["APP13"])) {
    $iptc = iptcparse($info["APP13"]);
    var_dump($iptc);
    }
    ?>

    注意

    注意:

    この関数は、GD 画像ライブラリは必要ありません。

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 24 notes

    up
    89
    james dot relyea at zifiniti dot com
    15 years ago
    As noted below, getimagesize will download the entire image before it checks for the requested information. This is extremely slow on large images that are accessed remotely. Since the width/height is in the first few bytes of the file, there is no need to download the entire file. I wrote a function to get the size of a JPEG by streaming bytes until the proper data is found to report the width and height:

    <?php
    // Retrieve JPEG width and height without downloading/reading entire image.
    function getjpegsize($img_loc) {
    $handle = fopen($img_loc, "rb") or die("Invalid file stream.");
    $new_block = NULL;
    if(!    feof($handle)) {
    $new_block = fread($handle, 32);
    $i = 0;
    if(    $new_block[$i]=="\xFF" && $new_block[$i+1]=="\xD8" && $new_block[$i+2]=="\xFF" && $new_block[$i+3]=="\xE0") {
    $i += 4;
    if(    $new_block[$i+2]=="\x4A" && $new_block[$i+3]=="\x46" && $new_block[$i+4]=="\x49" && $new_block[$i+5]=="\x46" && $new_block[$i+6]=="\x00") {
    // Read block size and skip ahead to begin cycling through blocks in search of SOF marker
    $block_size = unpack("H*", $new_block[$i] . $new_block[$i+1]);
    $block_size = hexdec($block_size[1]);
    while(!    feof($handle)) {
    $i += $block_size;
    $new_block .= fread($handle, $block_size);
    if(    $new_block[$i]=="\xFF") {
    // New block detected, check for SOF marker
    $sof_marker = array("\xC0", "\xC1", "\xC2", "\xC3", "\xC5", "\xC6", "\xC7", "\xC8", "\xC9", "\xCA", "\xCB", "\xCD", "\xCE", "\xCF");
    if(    in_array($new_block[$i+1], $sof_marker)) {
    // SOF marker detected. Width and height information is contained in bytes 4-7 after this byte.
    $size_data = $new_block[$i+2] . $new_block[$i+3] . $new_block[$i+4] . $new_block[$i+5] . $new_block[$i+6] . $new_block[$i+7] . $new_block[$i+8];
    $unpacked = unpack("H*", $size_data);
    $unpacked = $unpacked[1];
    $height = hexdec($unpacked[6] . $unpacked[7] . $unpacked[8] . $unpacked[9]);
    $width = hexdec($unpacked[10] . $unpacked[11] . $unpacked[12] . $unpacked[13]);
    return array(    $width, $height);
    } else {
    // Skip block marker and read block size
    $i += 2;
    $block_size = unpack("H*", $new_block[$i] . $new_block[$i+1]);
    $block_size = hexdec($block_size[1]);
    }
    } else {
    return     FALSE;
    }
    }
    }
    }
    }
    return     FALSE;
    }
    ?>
    up
    16
    nikolam3244 at gmail dot com
    7 years ago
    There's a code snippet for getting JPEG image dimensions by getting only first few bytes of the file, but it doesn't work for PNG files, so I wrote one. It will download only the first 24 bytes instead of the whole image, and thus being much faster than getimagesize() and it will save bandwidth at the same time:

    <?php
    // Retrieve PNG width and height without downloading/reading entire image.
    function getpngsize( $img_loc ) {
    $handle = fopen( $img_loc, "rb" ) or die( "Invalid file stream." );

    if ( !     feof( $handle ) ) {
    $new_block = fread( $handle, 24 );
    if (     $new_block[0] == "\x89" &&
    $new_block[1] == "\x50" &&
    $new_block[2] == "\x4E" &&
    $new_block[3] == "\x47" &&
    $new_block[4] == "\x0D" &&
    $new_block[5] == "\x0A" &&
    $new_block[6] == "\x1A" &&
    $new_block[7] == "\x0A" ) {
    if (     $new_block[12] . $new_block[13] . $new_block[14] . $new_block[15] === "\x49\x48\x44\x52" ) {
    $width = unpack( 'H*', $new_block[16] . $new_block[17] . $new_block[18] . $new_block[19] );
    $width = hexdec( $width[1] );
    $height = unpack( 'H*', $new_block[20] . $new_block[21] . $new_block[22] . $new_block[23] );
    $height = hexdec( $height[1] );

    return array(     $width, $height );
    }
    }
    }

    return     false;
    }
    ?>
    up
    16
    tomasz at trejderowski dot pl
    11 years ago
    If you want to "convert" value returned by "getimagesize()" as index "2" into something more human-readable, you may consider using a function like this one:

    $imageTypeArray = array
    (
    0=>'UNKNOWN',
    1=>'GIF',
    2=>'JPEG',
    3=>'PNG',
    4=>'SWF',
    5=>'PSD',
    6=>'BMP',
    7=>'TIFF_II',
    8=>'TIFF_MM',
    9=>'JPC',
    10=>'JP2',
    11=>'JPX',
    12=>'JB2',
    13=>'SWC',
    14=>'IFF',
    15=>'WBMP',
    16=>'XBM',
    17=>'ICO',
    18=>'COUNT'
    );

    $size = getimagesize($filename);

    $size[2] = $imageTypeArray[$size[2]];

    Or something similar.
    up
    19
    php dot net at dannysauer dot com
    19 years ago
    Note that, if you're going to be a good programmer and use named constatnts (IMAGETYPE_JPEG) rather than their values (2), you want to use the IMAGETYPE variants - IMAGETYPE_JPEG, IMAGETYPE GIF, IMAGETYPE_PNG, etc. For some reason, somebody made a horrible decision, and IMG_PNG is actually 4 in my version of PHP, while IMAGETYPE_PNG is 3. It took me a while to figure out why comparing the type against IMG_PNG was failing...
    up
    5
    simon dot waters at surevine dot com
    9 years ago
    Note: getimage size doesn't attempt to validate image file formats

    It is possible for malformed GIF images to contain PHP and still have valid dimensions.

    Programmers need to ensure such images are validated by other tools, or never treated as PHP or other executable types (enforcing appropriate extensions, avoiding user controlled renaming, restricting uploaded images to areas of the website where PHP is not enabled).

    http://ha.ckers.org/blog/20070604/passing-malicious-php-through-getimagesize/
    up
    4
    redcore at gmail dot com
    17 years ago
    It's always good to check out an image's dimensions while attempting to upload to your server or database...especially if it's going to be displayed on a page that doesn't accomodate images beyond a particular size.

    <?php

    $tmpName     = $_FILES['userfile']['tmp_name'];

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

    if(    $width>275 || $height>275)
    {
    die(    "exceeded image dimension limits.");
    }

    ?>
    up
    3
    utilmind
    13 years ago
    Here is the function which determines whether the PNG image contains alpha or not:

    <?php
    function is_alpha_png($fn){
    return (    ord(@file_get_contents($fn, NULL, NULL, 25, 1)) == 6);
    }
    ?>

    The color type of PNG image is stored at byte offset 25. Possible values of that 25'th byte is:
    * 0 - greyscale
    * 2 - RGB
    * 3 - RGB with palette
    * 4 - greyscale + alpha
    * 6 - RGB + alpha
    up
    5
    info at alex-lawrence dot com
    16 years ago
    Could be useful (didn´t know where to post it):

    function getImageErrors( $filename, $type = "", $minWidth = 0, $minHeight = 0, $maxWidth = 0, $maxHeight = 0, $maxFileSize = 0 )
    {
    $errors = array();
    if ( file_exists( $filename ) )
    {
    $ending = substr( $filename, strpos( $filename, "." ) );
    if ( is_array( $type ) )
    {
    $isTypeOf = false;
    foreach( $type as $eachtype )
    {
    if ( $ending == $eachtype )
    {
    $isTypeOf = true;
    }
    }
    if ( ! $isTypeOf )
    {
    $errors[ 'type' ] = $ending;
    }
    }
    elseif ( $type != "" )
    {
    if ( $ending != $type )
    {
    $errors[ 'type' ] = $ending;
    }
    }
    $size = getimagesize( $filename );
    if ( $size[ 0 ] < $minWidth )
    {
    $errors[ 'minWidth' ] = $size[ 0 ];
    }
    if ( $size[ 1 ] < $minHeight )
    {
    $errors[ 'minHeight' ] = $size[ 1 ];
    }
    if ( ( $maxWidth > $minWidth ) && ( $size[ 0 ] > $maxWidth ) )
    {
    $errors[ 'maxWidth' ] = $size[ 0 ];
    }
    if ( ( $maxHeight > $minHeight ) && ( $size[ 1 ] > $maxHeight ) )
    {
    $errors[ 'maxHeight' ] = $size[ 1 ];
    }
    if ( ( $maxFileSize > 0 ) && ( filesize( $filename ) > $maxFileSize ) )
    {
    $errors[ 'maxFileSize' ] = filesize( $filename );
    }
    }
    else
    {
    $errors[ 'filename' ] = "not existing";
    }
    return ( count( $errors ) > 0 ? $errors : null );
    }
    up
    3
    Steve
    13 years ago
    The list of defined IMAGETYPE_ constants is on the manual page for exif_imagetype:

    http://www.php.net/manual/en/function.exif-imagetype.php
    up
    2
    shmohel at gmail dot com
    16 years ago
    Rather than making a lengthy function that essentially runs twice (once as width, once as height) I came up with a helpful function that uses variable variables to set a maximum height/width. Hope someone finds this helpful.

    function scaleimage($location, $maxw=NULL, $maxh=NULL){
    $img = @getimagesize($location);
    if($img){
    $w = $img[0];
    $h = $img[1];

    $dim = array('w','h');
    foreach($dim AS $val){
    $max = "max{$val}";
    if(${$val} > ${$max} && ${$max}){
    $alt = ($val == 'w') ? 'h' : 'w';
    $ratio = ${$alt} / ${$val};
    ${$val} = ${$max};
    ${$alt} = ${$val} * $ratio;
    }
    }

    return("<img src='{$location}' alt='image' width='{$w}' height='{$h}' />");
    }
    }