在 Web 開發中,常需要將上傳的 PDF 文件轉換為圖片格式以便預覽或縮圖顯示。ImageMagick 是功能強大的圖像處理工具,配合 PHP 的 exec() 函數即可輕鬆實現 PDF 轉 JPG。本文將詳細說明環境需求、核心代碼實現及常見問題排查。
apt-get install imagemagick 或 yum install ImageMagick)exec() 函數(部分共享主機可能禁用)<?php
$pdf_file = './pdf/demo.pdf'; // 來源 PDF 路徑
$save_to = './jpg/demo.jpg'; // 輸出 JPG 路徑
// 執行 ImageMagick convert 指令
// -colorspace RGB 確保色彩空間正確
// -resize 800 將寬度縮放至 800px,高度自動等比例縮放
exec('convert "'.$pdf_file.'" -colorspace RGB -resize 800 "'.$save_to.'"', $output, $return_var);
if ($return_var === 0) {
echo 'Conversion OK'; // 轉換成功
} else {
echo 'Conversion failed. ' . implode("\n", $output); // 輸出錯誤詳情
}
?>
| 參數 | 作用 |
|---|---|
-colorspace RGB | 指定輸出色彩空間為 RGB,避免 CMYK 導致顏色異常 |
-resize 800 | 將圖片寬度限制在 800px,高度自動按比例縮放 |
-density 150 | (可選)設定解析度 DPI,預設 72,較大值可提升清晰度 |
-quality 85 | (可選)JPG 壓縮品質 1-100,平衡檔案大小與畫質 |
確保執行 PHP 的使用者(如 www-data)對 $save_to 目錄有寫入權限:
chown -R www-data:www-data /var/www/html/jpg
chmod 755 /var/www/html/jpg
ImageMagick 處理 PDF 依賴 Ghostscript,若報錯 FailedToExecuteCommand 'gs',請安裝:
apt-get install ghostscript # Debian/Ubuntu
yum install ghostscript # CentOS/RHEL
ImageMagick 6.9+ 預設禁止處理 PDF,需修改 /etc/ImageMagick-6/policy.xml:
<policy domain="coder" rights="read|write" pattern="PDF" />
修改後重啟 PHP-FPM 或 Apache 生效。
<?php
$pdf_file = './pdf/multi.pdf';
$output_dir = './jpg/';
$basename = basename($pdf_file, '.pdf');
exec("convert -density 150 -quality 85 \"{$pdf_file}\" \"{$output_dir}{$basename}_%03d.jpg\"", $out, $ret);
if ($ret === 0) {
echo "生成圖片:{$output_dir}{$basename}_001.jpg, {$basename}_002.jpg ...";
} else {
echo "失敗:" . implode("\n", $out);
}
?>
此命令會將每一頁 PDF 輸出為獨立 JPG,檔名自動編號(_001.jpg, _002.jpg…)。
透過 ImageMagick 的 convert 指令,PHP 可高效完成 PDF 轉 JPG。關鍵在於確保伺服器環境完整、權限正確、並根據業務需求調整解析度與壓縮品質。生產環境建議加入異常捕獲、日誌記錄與非同步佇列處理大檔案,避免阻塞 Web 請求。