php getimagesize 是 PHP 内置的图像处理函数,用于获取图像文件的尺寸、MIME 类型及额外信息。该函数无需额外扩展即可使用,是图像上传验证、缩略图生成、响应式图片适配等场景的底层支撑工具。
从底层机制看,php getimagesize 通过解析图像文件头部的二进制数据(如 JPEG 的 SOI 标记、PNG 的 IHDR 块)提取关键元数据,不依赖 GD 或 Imagick 扩展,因此执行效率高、资源占用低,特别适合高并发场景下的轻量级图像检测。
该函数支持的图像格式包括 JPEG、PNG、GIF、BMP、WebP、TIFF、ICO、PSD 等主流格式,其返回值包含宽度、高度、MIME 类型、属性字符串(可直接用于 HTML img 标签的 width/height 属性)等四项核心信息,为后续图像处理流程提供可靠依据。
值得注意的是,php getimagesize 并非仅用于“获取尺寸”,其返回的 MIME 类型可配合 Content-Type 响应头实现动态图片服务,而属性字符串则常用于构建无闪烁加载的响应式图片容器,避免页面重排,提升用户体验。
php getimagesize 的函数声明如下:
array getimagesize ( string $filename , array &$imageinfo = ? ) : array|false
该函数接受两个参数:第一个为图像文件路径(支持本地文件、URL、stream wrapper),第二个为可选的引用参数,用于返回图像的额外信息数组(如 EXIF 数据、JPEG 注释、PNG 文本块等)。
返回值为关联数组,包含以下键:
0:图像宽度(像素)1:图像高度(像素)2:图像格式常量(如 IMAGETYPE_JPEG、IMAGETYPE_PNG)3:HTML 属性字符串(如 width="800" height="600")channels:颜色通道数(RGB 为 3,CMYK 为 4)bits:每通道位深(常见为 8)mime:MIME 类型字符串(如 image/jpeg)app0、app1 等:JPEG 的 APP 段数据(若存在)comment:JPEG 注释(若存在)当文件无法读取或非图像格式时,函数返回 false 并抛出 E_WARNING 级别错误,因此实际开发中必须结合 file_exists()、is_readable() 与错误抑制符 @ 使用,或启用异常处理机制。
php getimagesize 的第一个参数 $filename 支持多种输入形式:
'./uploads/avatar.jpg''https://example.com/image.png'(需开启 allow_url_fopen)'data://text/plain;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==''php://memory'(常用于测试)⚠️ 安全风险:当直接使用用户输入的文件路径时,可能引发路径遍历攻击(如 ../../../etc/passwd)。建议使用 basename() 提取文件名,并结合白名单校验扩展名:
$allowed = ['jpg','jpeg','png','gif','webp'];
$ext = strtolower(pathinfo($filename,PATHINFO_EXTENSION));
if(!in_array($ext,$allowed)) exit('非法文件类型');
第二个参数 $imageinfo 可捕获更详细的元数据,例如:
$info = [];
getimagesize('example.jpg', $info);
print_r($info);
常见输出示例:
Array
(
[0] => 1920
[1] => 1080
[2] => 2
[3] => width="1920" height="1080"
[bits] => 8
[mime] => image/jpeg
[app0] => JFIF
[app1] => {Exif...}
[Comment] => Created with GIMP
)
特别地,当图像包含 EXIF 数据时,$imageinfo['APP1'] 会返回二进制内容,需配合 exif_read_data() 进一步解析,用于获取拍摄时间、设备型号等信息。
php getimagesize 返回的数组中,0 与 1 键对应图像的物理尺寸,是图像处理流程的起点。例如:
$img = getimagesize('photo.jpg');
$width = $img[0];
$height = $img[1];
在响应式图片生成中,常根据尺寸比例决定是否裁剪:
if($width / $height > 1.5) {
// 横幅类图片,需裁剪左右
$crop = ['x' => ($width - $height * 1.5)/2, 'y' => 0];
}
3 键的 HTML 属性字符串是性能优化的关键——它可直接插入 <img> 标签,避免浏览器因尺寸未知而重排页面:
<img src="image.jpg" = $img[3] ?> alt="示例图">
mime 键用于动态设置响应头:
header('Content-Type: ' . $img['mime']);
readfile($filename);
而 bits 与 channels 用于判断图像质量,例如:
此外,2 键返回的格式常量可配合 image_type_to_extension() 生成文件扩展名:
$ext = image_type_to_extension($img[2], false); // 返回 'jpg'
php getimagesize 的典型错误包括:
当路径错误或权限不足时,函数返回 false。建议封装校验函数:
function safe_getimagesize($file) {
if(!file_exists($file) || !is_readable($file)) {
throw new Exception("文件不存在或无法读取");
}
$info = @getimagesize($file);
if($info === false) {
throw new Exception("非图像文件或格式损坏");
}
return $info;
}
当使用远程 URL 且 allow_url_fopen 关闭时,会触发警告。可改用 cURL 预加载文件:
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = curl_exec($ch);
curl_close($ch);
$stream = 'data://text/plain;base64,' . base64_encode($data);
$info = getimagesize($stream);
对于超大图像(如 10000×10000 PNG),php getimagesize 可能消耗大量内存。解决方案:
$_FILES['file']['size']gd.jpeg_ignore_warning 选项PHP 7.1+ 才原生支持 WebP。旧版本需手动检测文件头:
function is_webp($file) {
$header = file_get_contents($file, false, null, 0, 12);
return substr($header, 8, 4) === 'WEBP';
}
结合 php getimagesize 实现多层验证:
if($_FILES['avatar']['error'] === UPLOAD_ERR_OK) {
$info = getimagesize($_FILES['avatar']['tmp_name']);
if($info === false) {
die('非图像文件');
}
if($info[0] < 200 || $info[1] < 200) {
die('尺寸过小,建议 ≥200×200px');
}
if(!in_array($info[2], [IMAGETYPE_JPEG, IMAGETYPE_PNG])) {
die('仅支持 JPG/PNG 格式');
}
move_uploaded_file($_FILES['avatar']['tmp_name'], 'avatars/' . uniqid() . '.' . image_type_to_extension($info[2], false));
}
利用 $info[3] 避免布局偏移:
<style>
.responsive-img { max-width: 100%; height: auto; }
</style>
<img src="banner.jpg" class="responsive-img" = getimagesize('banner.jpg')[3] ?>>
配合 CSS 的 aspect-ratio 属性,可实现更稳定的布局:
<img src="img.jpg" style="aspect-ratio: = $info[0]/$info[1] ?>">
通过 EXIF 方向值修正拍摄角度:
$info = [];
$img = getimagesize('photo.jpg', $info);
if(isset($info['APP1'])) {
$exif = exif_read_data('photo.jpg');
if($exif && isset($exif['Orientation'])) {
$degrees = [0,0,180,0,0,90,0,270][$exif['Orientation']];
$source = imagecreatefromjpeg('photo.jpg');
$rotated = imagerotate($source, $degrees, 0);
imagejpeg($rotated, 'fixed_photo.jpg');
}
}
扫描目录并生成报告:
$files = glob('images/*.{jpg,png,gif}', GLOB_BRACE);
$total = 0;
$large = 0;
foreach($files as $file) {
$info = @getimagesize($file);
if($info) {
$total++;
if($info[0] > 1920 || $info[1] > 1080) $large++;
}
}
echo "共检测 {$total} 张图像,超高清图像 {$large} 张";
当 php getimagesize 不满足需求时,可考虑以下替代方案:
| 方案 | 适用场景 | 优势 | 劣势 |
|---|---|---|---|
| php getimagesize | 快速尺寸检测 | 无需扩展、轻量高效 | 功能单一 |
| GD 扩展 | 图像处理 | 支持缩放、裁剪、水印 | 内存占用高 |
| Imagick 扩展 | 复杂图像操作 | 支持矢量、动画、格式转换 | 需安装库、学习成本高 |
| getimagesizefromstring() | 内存流图像 | 无需临时文件 | 仅 PHP ≥5.4 |
| exif_read_data() | EXIF 元数据 | 获取拍摄信息 | 仅 JPEG/TIFF |
特别说明:当需要同时获取尺寸与 EXIF 信息时,可组合使用 php getimagesize 与 exif_read_data(),但需注意:getimagesize() 的第二参数仅返回部分元数据,而 exif_read_data() 提供更完整的字段(如 GPS 坐标、闪光灯状态等)。
在循环中缓存结果:
$cache = [];
foreach($files as $file) {
if(!isset($cache[$file])) {
$cache[$file] = getimagesize($file);
}
$info = $cache[$file];
// ...处理逻辑
}
仅读取文件头部(JPEG/PNG 的尺寸信息位于前 2KB):
$fp = fopen($file, 'rb');
$header = fread($fp, 2048);
fclose($fp);
$stream = 'data://application/octet-stream;base64,' . base64_encode($header);
$info = getimagesize($stream);
对大文件直接跳过:
if($_FILES['img']['size'] > 5*1024*1024) {
die('文件过大');
}
$info = getimagesize($_FILES['img']['tmp_name']);
对非关键图像(如背景图)使用队列异步检测:
exec('php process_image.php ' . escapeshellarg($file) . ' > /dev/null &');
A:支持格式取决于 PHP 编译时的 GD 库配置,常见包括:
可通过 imagetypes() 函数获取当前支持的格式位掩码:
if(imagetypes() & IMG_JPG) echo '支持 JPEG';
A:返回的 0 与 1 键为像素值(pixels),是图像的物理尺寸。例如返回 [1920, 1080] 表示 1920×1080 像素。该值与显示尺寸无关,需结合 CSS 或 device-pixel-ratio 计算物理尺寸。
A:❌ 不可以。但部分视频首帧(如 MP4)可被识别为图像,此时返回的尺寸是首帧尺寸。严格来说,应使用 FFmpeg 扩展获取视频元数据:
exec('ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0 video.mp4', $output);
list($width, $height) = explode(',', $output[0]);
A:使用 cURL 的 CURLOPT_HEADERFUNCTION 仅读取头部(部分服务器返回 Content-Length):
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_NOBODY, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
$data = curl_exec($ch);
curl_close($ch);
if(preg_match('/Content-Length:\s*(\d+)/', $data, $m)) {
echo "文件大小:{$m[1]} 字节";
}
但尺寸信息需完整下载文件,无免费方案。建议用代理服务缓存结果。