使用 imagecropauto() 裁剪图像时，原始设置的 300dpi 分辨率会被重置为默认的 96dpi；需在裁剪后显式调用 imageresolution() 恢复目标 DPI，否则输出图像将不满足印刷级精度要求。
使用 `imagecropauto()` 裁剪图像时，原始设置的 300dpi 分辨率会被重置为默认的 96dpi；需在裁剪后显式调用 `imageresolution()` 恢复目标 dpi，否则输出图像将不满足印刷级精度要求。
在 PHP 的 GD 图像处理中，imageresolution() 是控制 PNG 输出物理分辨率（DPI）的关键函数，但其作用范围仅限于当前图像资源对象，且不会自动继承或传播到新创建的图像资源。imagecropauto() 内部会创建一个全新的图像资源（即 $cropped），该资源初始化时采用 GD 库的默认分辨率——根据 PHP 官方文档 imageresolution() 手册页 明确说明：“If not set, the default resolution is 96 dpi.” 这正是问题根源：无论原图设置为 72、150 还是 300 dpi，imagecropauto() 返回的新图像始终以 96 dpi 为初始值。
因此，正确的处理流程必须包含裁剪后显式重设分辨率这一步。以下是修复后的完整实践代码（已优化可读性与健壮性）：
<?php
$string = "URBANWARFARE";
// 设置响应头：PNG 下载
header('Content-Type: image/png');
header('Cache-Control: no-store, no-cache');
header('Content-Disposition: attachment; filename="name.png"');
// 创建高分辨率画布（300dpi × 尺寸需按物理尺寸换算）
$width_px = 4200; // 对应 14 英寸 × 300dpi
$height_px = 420; // 对应 1.4 英寸 × 300dpi
$img = imagecreate($width_px, $height_px);
imageresolution($img, 300, 300); // ✅ 关键：立即设置原图 DPI
// 启用 Alpha 通道支持
imagealphablending($img, false);
imagesavealpha($img, true);
// 填充透明背景
$transparent = imagecolorallocatealpha($img, 255, 255, 255, 127);
imagefill($img, 0, 0, $transparent);
// 渲染白色文字
$textColor = imagecolorallocate($img, 255, 255, 255);
$font = "./Bloomsbury-Sans.ttf";
imagettftext($img, 380, 0, 0, 410, $textColor, $font, $string);
// 执行自动裁剪（生成新图像资源）
$cropped = imagecropauto($img, IMG_CROP_DEFAULT);
if ($cropped === false) {
die("Cropping failed: no suitable background color detected.");
}
// ✅ 关键修复：为裁剪后的新图像重新设置 DPI
imageresolution($cropped, 300, 300);
// 输出最终图像（此时为真正的 300dpi PNG）
imagepng($cropped);
// 清理资源
imagedestroy($img);
imagedestroy($cropped);
?>⚠️ 重要注意事项：
- imageresolution() 必须在 imagepng() 调用前执行，且作用对象必须是最终输出的图像资源（如本例中的 $cropped）；
- DPI 设置不影响像素尺寸，仅影响嵌入 PNG 文件的 pHYs chunk（用于打印/排版软件识别物理尺寸），因此务必确保画布像素尺寸本身已按目标 DPI 和物理尺寸精确计算（例如：14″×1.4″ @ 300dpi → 4200×420px）；
- 其他 GD 函数如 imagecopyresampled()、imagecreatefrompng() 等同样不会继承源图 DPI，凡生成新图像资源的操作，均需独立调用 imageresolution() 配置；
- 若需验证输出 DPI，可用命令行工具检查：identify -verbose name.png | grep -i "resolution"（ImageMagick）或查看 PNG 文件 pHYs chunk 的原始字节。
总结而言，GD 库中“分辨率”并非图像固有属性，而是每个资源对象的独立元数据。开发者需建立明确意识：任何创建新图像资源的操作（裁剪、缩放、复制、加载）都会重置 DPI 为 96，必须手动恢复。 这一设计虽易引发疏漏，但通过标准化的后置 imageresolution() 调用，即可稳定保障印刷输出质量。
立即学习“PHP免费学习笔记（深入）”；
