本文介绍如何利用 php 的 imagick 扩展精确提取含图像页面的 pdf 文件中每一页的实际像素宽高，解决 pdfparser 无法按页获取尺寸的局限。
本文介绍如何利用 php 的 imagick 扩展精确提取含图像页面的 pdf 文件中每一页的实际像素宽高，解决 pdfparser 无法按页获取尺寸的局限。
在处理以图像为内容主体的 PDF（例如扫描件、截图合集或导出的幻灯片）时，常需获知每页渲染后的原始像素尺寸（如 2480×3508），而非 PDF 内置的逻辑尺寸（如 MediaBox 单位为点）。PHP 原生 PDF 扩展（如 pdfParser 或 SPL 类库）通常仅解析结构元数据，不执行光栅化，因此无法返回真实像素值——而 Imagick 正是为此类场景设计的理想工具。
Imagick 是 ImageMagick 的 PHP 绑定，支持将 PDF 页面作为位图加载，并自动根据分辨率（默认 72 DPI）进行光栅化。关键在于利用方括号语法指定页码索引（从 0 开始），并调用 getImageWidth() 和 getImageHeight() 获取像素尺寸：
<?php
$pdfPath = 'document.pdf';
// 初始化 Imagick 实例
$imagick = new Imagick();
// 获取总页数（可选，用于遍历）
$pageCount = $imagick->getNumberImages(); // 注意：此方法需先读取至少一页
// 遍历每一页（推荐逐页读取，避免内存占用过高）
for ($page = 0; $page < 10; $page++) { // 建议加安全上限
try {
$imagick->clear(); // 清空前一页资源
$imagick->readImage($pdfPath . '[' . $page . ']'); // 读取第 $page 页
$width = $imagick->getImageWidth();
$height = $imagick->getImageHeight();
$dpi = $imagick->getImageResolution(); // 可选：查看当前渲染DPI
echo "Page {$page}: {$width} × {$height} px (DPI: {$dpi['x']})\n";
} catch (ImagickException $e) {
echo "Page {$page} not available or invalid.\n";
break;
}
}
?>⚠️ 注意事项：
-
依赖要求：服务器需安装 ImageMagick（≥6.9.0）及 PHP Imagick 扩展（启用
imagick.so）；PDF 解析依赖 Ghostscript，确保其已安装并可被 ImageMagick 调用。 -
DPI 影响精度：默认 72 DPI 可能导致尺寸偏小。如需匹配打印/显示需求，可在读取前设置：
$imagick->setResolution(300, 300);（须在readImage()前调用）。 -
性能与内存：大文件或多页 PDF 易触发内存溢出，务必使用
clear()释放资源，并考虑分批处理或限制页数。 -
纯矢量页不适用：若 PDF 含文字或矢量图形，
Imagick返回的是光栅化结果，非“原始像素”（因无原始像素概念），但对图像型 PDF 完全准确。
综上，Imagick 提供了简洁、可靠且生产就绪的方案——它不解析 PDF 结构，而是真实渲染每页，从而直接暴露像素级尺寸，是解决该问题最直接有效的技术路径。
立即学习“PHP免费学习笔记（深入）”；
