getimagesize 函數 取得圖像大小 (PHP 4, PHP 5)
array getimagesize ( string filename [, array &imageinfo] ) //注意 ¥imageinfo在使用的時候不在需要前面的&。
說明
getimagesize() 函數將測定任何 GIF,JPG,PNG,SWF,SWC,PSD,TIFF,BMP,IFF,JP2,JPX,JB2,JPC,XBM 或 WBMP 圖像文件的大小並返回圖像的尺寸以及文件類型和一個可以用於普通 HTML 文件中 IMG 標記中的 height/width 文本字符串。
如果不能訪問 filename 指定的圖像或者其不是有效的圖像,getimagesize() 將返回 FALSE 並產生一條 E_WARNING 級的錯誤。
注意:
對 JPC,JP2,JPX,JB2,XBM 和 WBMP 的支持自 PHP 4.3.2 起可用。對 SWC 的支持自 PHP 4.3.0 起可用。對 TIFF 的支持是 PHP 4.2.0 添加的,PHP 5.3 加入了ICON的支持
注意:
JPEG 2000 支持是 PHP 4.3.2 添加的。注意 JPC 和 JP2 可以有不同的色彩深度的成分。此情況下,“bits”的值是碰到的最高的位深度。此外,JP2 文件可能包含有多個 JPEG 2000 代碼流,此情況下,getimagesize() 返回此文件頂層中碰到的第一個代碼流的值。
注意:
本函數不需要 GD 圖像庫。
返回一個具有四個單元的數組。索引 0 包含圖像寬度的像素值,索引 1 包含圖像高度的像素值。索引 2 是圖像類型的標記: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,17 = ICO,18 = COUNT。這些標記與 PHP 4.3.0 新加的 IMAGETYPE 常量對應。索引 3 是文本字符串,內容為“height="yyy" width="xxx"”,可直接用於 IMG 標記。
例 getimagesize(文件)
<?php
list($width, $height, $type, $attr) = getimagesize("img/flag.jpg");
echo "width={$width}, height={$height}, type={$type}, attr={$attr}";
?>
URL 支持是 PHP 4.0.5 添加的。
例 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/logo.gif");
?>
對於 JPG 圖像,還會多返回兩個索引:channels 和 bits。channels 對於 RGB 圖像其值為 3,對於 CMYK 圖像其值為 4。bits 是每種顏色的位數。
自 PHP 4.3.0 起,bits 和 channels 對於其它圖像類型也存在。但是這些值可能會把人搞糊塗。例如,GIF 總是對每個像素使用 3 個 channel,但是對於動畫 GIF 來說每個像素的位數無法通過全局顏色表計算出來。
某些格式可能不包含圖像或者包含多個圖像。此種情況下,getimagesize() 可能不能用來准確測定圖像的大小。此時 getimagesize() 將返回零作為寬度和高度。
自 PHP 4.3.0 起,getimagesize() 還會返回額外的參數 mime,符合該圖像的 MIME 類型。此信息可以用來在 HTTP Content-type 頭信息中發送正確的信息:
例 getimagesize() 和 MIME 類型
<?php
$size = getimagesize($filename);
$fp=fopen($filename, "rb");
if ($size && $fp) {
header("Content-type: {$size['mime']}");
fpassthru($fp);
exit;
} else {
// error
}
?>
可選的 imageinfo 參數允許從圖像文件中提取一些擴展信息。目前,這將以一個關聯數組返回不同的 JPG APP 標識。某些程序用這些 APP 標識來在圖像中嵌入文本信息。一個非常常見的是 APP13 標識中嵌入的 IPTC » http://www.iptc.org/ 信息。可以用 iptcparse() 函數來將二進制的 APP13 標識解析為可讀的信息。
例 getimagesize() 返回 IPTC
<?php
$size = getimagesize("testimg.jpg", $info);
if (isset($info["APP13"])) {
$iptc = iptcparse($info["APP13"]);
var_dump($iptc);
}
?>