getimagesize
(PHP 4, PHP 5, PHP 7, PHP 8)
getimagesize — 取得图像大小
说明
getimagesize(string $filename
, array &$imageinfo
= ?): array
如果不能访问 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 添加的。
注意:
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。这些标记与 PHP 4.3.0
新加的 IMAGETYPE 常量对应。索引 3 是文本字符串,内容为“height="yyy"
width="xxx"”,可直接用于 IMG 标记。
示例 #1 getimagesize(文件)
<?php
list($width, $height, $type, $attr) = getimagesize("img/flag.jpg");
echo "<img src=\"img/flag.jpg\" $attr>";
?>
URL 支持是 PHP 4.0.5 添加的。
示例 #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");
?>
对于 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 头信息中发送正确的信息:
示例 #3 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 标识解析为可读的信息。
示例 #4 getimagesize() 返回 IPTC
<?php
$size = getimagesize("testimg.jpg", &$info);
if (isset($info["APP13"])) {
$iptc = iptcparse($info["APP13"]);
var_dump($iptc);
}
?>
参见 image_type_to_mime_type(),exif_imagetype(),exif_read_data()
和 exif_thumbnail()。
参数
-
filename
-
This parameter specifies the file you wish to retrieve information
about. It can reference a local file or (configuration permitting) a
remote file using one of the supported streams.
-
imageinfo
-
This optional 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 information in the APP13 marker.
You can use the iptcparse() function to parse the
binary APP13 marker into something readable.
返回值
Returns an array with 7 elements.
Index 0 and 1 contains respectively the width and the height of the image.
注意:
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.
Index 2 is one of the IMAGETYPE_XXX
constants indicating
the type of the image.
Index 3 is a text string with the correct
height="yyy" width="xxx"
string that can be used
directly in an IMG tag.
mime
is the correspondant MIME type of the image.
This information can be used to deliver images with the correct HTTP
Content-type
header:
示例 #5 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
}
?>
channels
will be 3 for RGB pictures and 4 for CMYK
pictures.
bits
is the number of bits for each color.
For some image types, the presence of channels
and
bits
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.
On failure, false
is returned.
错误/异常
If accessing the filename
image is impossible, or
if it isn't a valid picture, getimagesize() will
generate an error of level E_WARNING
. On read error,
getimagesize() will generate an error of level
E_NOTICE
.
范例
示例 #6 getimagesize() example
<?php
list($width, $height, $type, $attr) = getimagesize("img/flag.jpg");
echo "<img src=\"img/flag.jpg\" $attr alt=\"getimagesize() example\" />";
?>
示例 #7 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");
?>
示例 #8 getimagesize() returning IPTC
<?php
$size = getimagesize("testimg.jpg", $info);
if (isset($info["APP13"])) {
$iptc = iptcparse($info["APP13"]);
var_dump($iptc);
}
?>