(PHP 4, PHP 5, PHP 7, PHP 8)
getimagesize
— 取得图像大小
说明
getimagesize(string $filename, array &$image_info = null): array|false
getimagesize()
函数将确定任何支持的指定图像文件的大小,并返回尺寸以及文件类型和 height/width 文本字符串,以在标准 HTML IMG 标签和对应的 HTTP 内容类型中使用。
getimagesize()
还可以在 image_info
参数中返回更多信息。
此函数要求 filename 是有效的图像文件。如果提供的是非图像,可能会错误的识别为图像且函数会成功返回,但数组可能包含无意义的值。
不要使用 getimagesize() 识别指定的文件是否是有效的图像。请使用专业解决方案,比如 Fileinfo 扩展。
注意: 注意 JPC 和 JP2 是具有不同位深度的组件。此外,JP2 文件可能包含有多个 JPEG 2000 代码流,此情况下,getimagesize() 返回此文件顶层中碰到的第一个代码流的值。
注意: 从具有最高比特率的 icon 中检索有关 icon 的信息。
注意: GIF 图像由一个或多个帧组成,其中每个帧可能只占据图像的一部分。getimagesize() 报告的图像大小是整体大小(从逻辑屏幕描述符中读取)。
参数
filename
此参数指定希望检索其信息的文件。可以指向本地文件或(配置允许)使用某个支持的流的远程文件。
image_info
可选参数允许从图像文件中提取一些扩展信息。目前会将不同的 JPG APP 标记作为关联数组返回。一些程序使用这些 APP 标记在图像中嵌入文本信息。
注意:
image_info
仅支持 JFIF 文件。
返回值
返回信息最多包含 7 个元素。并非所有图像类型都包含 channels 和 bits 元素。
索引 0 和 1 分别包含图像的宽度和高度。
一些格式可能没有图像或者包含多个图像。在这种情况下,getimagesize() 可能无法正确确定图像大小。getimagesize() 此时会返回的宽高为 0。
索引 2 是表示图像类型的某个 IMAGETYPE_XXX 常量。
mime 是图像对应的 MIME 类型。此信息可用于传递具有正确 HTTP Content-type 报头的图像
例子
#1
2023-08-08 更新