php getimagesize

php getimagesize 核心功能解析

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 文本块等)。

返回值为关联数组,包含以下键:

当文件无法读取或非图像格式时,函数返回 false 并抛出 E_WARNING 级别错误,因此实际开发中必须结合 file_exists()、is_readable() 与错误抑制符 @ 使用,或启用异常处理机制。

参数详解与安全实践

php getimagesize 的第一个参数 $filename 支持多种输入形式:

⚠️ 安全风险:当直接使用用户输入的文件路径时,可能引发路径遍历攻击(如 ../../../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"  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 的典型错误包括:

1. 文件不存在或不可读

当路径错误或权限不足时,函数返回 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;
}

2. URL 读取失败

当使用远程 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);

3. 大文件内存溢出

对于超大图像(如 10000×10000 PNG),php getimagesize 可能消耗大量内存。解决方案:

4. WebP 格式兼容性问题

PHP 7.1+ 才原生支持 WebP。旧版本需手动检测文件头:

function is_webp($file) {
    $header = file_get_contents($file, false, null, 0, 12);
    return substr($header, 8, 4) === 'WEBP';
}

实战示例与场景应用

上传验证
响应式图片
EXIF 修正
批量处理

场景:用户头像上传校验

结合 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" >

配合 CSS 的 aspect-ratio 属性,可实现更稳定的布局:

<img src="img.jpg" style="aspect-ratio: ">

场景:自动旋转图像

通过 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 坐标、闪光灯状态等)。

性能优化技巧

1. 避免重复调用

在循环中缓存结果:

$cache = [];
foreach($files as $file) {
    if(!isset($cache[$file])) {
        $cache[$file] = getimagesize($file);
    }
    $info = $cache[$file];
    // ...处理逻辑
}

2. 限制读取范围

仅读取文件头部(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);

3. 预检文件大小

对大文件直接跳过:

if($_FILES['img']['size'] > 5*1024*1024) {
    die('文件过大');
}
$info = getimagesize($_FILES['img']['tmp_name']);

4. 异步处理

对非关键图像(如背景图)使用队列异步检测:

exec('php process_image.php ' . escapeshellarg($file) . ' > /dev/null &');

常见问题汇总

Q:php getimagesize 支持哪些图像格式?

A:支持格式取决于 PHP 编译时的 GD 库配置,常见包括:

  • JPEG(.jpg/.jpeg)
  • PNG(.png)
  • GIF(.gif)
  • BMP(.bmp)
  • WebP(.webp,PHP ≥7.0)
  • TIFF(.tif,需 GD 支持)
  • PCX(.pcx)
  • GD2(.gd2)
  • WBMP(.wbmp)

可通过 imagetypes() 函数获取当前支持的格式位掩码:

if(imagetypes() & IMG_JPG) echo '支持 JPEG';
Q:php getimagesize 返回的尺寸单位是什么?

A:返回的 0 与 1 键为像素值(pixels),是图像的物理尺寸。例如返回 [1920, 1080] 表示 1920×1080 像素。该值与显示尺寸无关,需结合 CSS 或 device-pixel-ratio 计算物理尺寸。

Q:php getimagesize 可以用于视频文件吗?

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]);
Q:如何获取远程图像尺寸而不下载文件?

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]} 字节";
}

但尺寸信息需完整下载文件,无免费方案。建议用代理服务缓存结果。

扩展阅读