PHP 的 imagecropauto() 函数会创建新图像资源，但默认不继承原图的 DPI 设置，导致输出 PNG 降为 96dpi；需在裁剪后显式调用 imageresolution() 恢复目标分辨率。
php 的 `imagecropauto()` 函数会创建新图像资源，但默认不继承原图的 dpi 设置，导致输出 png 降为 96dpi；需在裁剪后显式调用 `imageresolution()` 恢复目标分辨率。
在使用 PHP GD 库生成高精度印刷图像（如 300dpi）时，imagecropauto() 是一个常用工具，用于智能裁除图像边缘透明/空白区域。然而，开发者常遇到一个隐性陷阱：裁剪后的图像虽视觉内容无损，但元数据中的分辨率（DPI）被重置为系统默认值 96dpi——这将直接影响打印输出的清晰度与物理尺寸，尤其对专业排版场景构成严重风险。
根本原因在于：imagecropauto() 内部通过 imagecreatetruecolor() 创建全新图像资源，而该函数不复制源图的分辨率信息。即使原始图像已通过 imageresolution($img, 300, 300) 显式设置 DPI，裁剪后的新资源 $cropped 仍以 GD 默认分辨率（96 DPI）初始化。这一点在 PHP 官方文档 imageresolution() 页面 中有明确说明：“The resolution is only used when writing image files (e.g., PNG, JPEG) and does not affect rendering or scaling in memory.” —— 但关键在于，新图像资源需独立设置分辨率。
✅ 正确做法：裁剪后立即重设 DPI
只需在 imagecropauto() 调用之后、imagepng() 输出之前，为裁剪结果显式指定所需 DPI：
$cropped = imagecropauto($img, IMG_CROP_DEFAULT); imageresolution($cropped, 300, 300); // ← 关键修复：重置为 300dpi imagepng($cropped);
⚠️ 注意：imageresolution() 必须作用于最终输出的图像资源（即 $cropped），而非原始 $img；且必须在 imagepng() 之前调用，否则无效。
立即学习“PHP免费学习笔记（深入）”；
完整修复示例（含最佳实践）
<?php
$string = "URBANWARFARE";
header('Content-Type: image/png');
header('Cache-Control: no-store, no-cache');
header('Content-Disposition: attachment; filename="name.png"');
// 创建高分辨率画布（4200×420 px @ 300dpi ≈ 14×1.4 英寸）
$img = imagecreatetruecolor(4200, 420);
imageresolution($img, 300, 300); // 设置逻辑 DPI（影响输出元数据）
// 启用 Alpha 通道支持
imagealphablending($img, false);
imagesavealpha($img, true);
// 填充透明背景
$transparent = imagecolorallocatealpha($img, 255, 255, 255, 127);
imagefill($img, 0, 0, $transparent);
// 渲染文字（注意坐标需适配高 DPI 画布）
$textColor = imagecolorallocate($img, 255, 255, 255);
$font = "./Bloomsbury-Sans.ttf";
imagettftext($img, 380, 0, 210, 320, $textColor, $font, $string); // 居中微调
// 自动裁剪 + 关键：恢复 DPI
$cropped = imagecropauto($img, IMG_CROP_DEFAULT);
imageresolution($cropped, 300, 300); // ← 不可省略！
// 输出并清理
imagepng($cropped);
imagedestroy($img);
imagedestroy($cropped);
?>? 其他可能重置 DPI 的 GD 函数（需警惕）
除 imagecropauto() 外，以下函数在创建新图像资源时同样不会继承源图 DPI，建议统一遵循“创建 → 设置分辨率 → 使用”流程：
- imagecopyresampled() / imagecopyresized()（缩放后新图需重设）
- imagecreatefrompng() 等加载函数（仅读取像素，不读取 DPI 元数据；需手动 imageresolution()）
- imagecrop()（同 imagecropauto，返回新资源）
? 提示：可通过 var_dump(imageresolution($img)) 在调试时验证当前图像的 DPI 设置（返回 [x => int, y => int] 数组）。
总结
imagecropauto() 导致 DPI 丢失并非 Bug，而是 GD 库资源管理的设计特性。解决逻辑极其简洁：任何通过 GD 创建的新图像资源，若需特定输出 DPI，都必须显式调用 imageresolution()。这一原则适用于所有高保真图像生成场景——从印刷品到高清数字海报，确保像素密度与物理尺寸严格匹配，是专业 PHP 图像处理的必备意识。
