萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 使用 ImageMagick 將 PDF 轉換為 JPG 圖片的完整教學

前言

在 Web 開發中,常需要將上傳的 PDF 文件轉換為圖片格式以便預覽或縮圖顯示。ImageMagick 是功能強大的圖像處理工具,配合 PHP 的 exec() 函數即可輕鬆實現 PDF 轉 JPG。本文將詳細說明環境需求、核心代碼實現及常見問題排查。

環境需求

  • 伺服器已安裝 ImageMagick 套件(Linux 下可用 apt-get install imagemagick 或 yum install ImageMagick)
  • PHP 已啟用 exec() 函數(部分共享主機可能禁用)
  • Apache/Nginx 對目標儲存目錄具備寫入權限

核心轉換代碼

<?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,平衡檔案大小與畫質

常見問題與解決

1. 權限不足

確保執行 PHP 的使用者(如 www-data)對 $save_to 目錄有寫入權限:

chown -R www-data:www-data /var/www/html/jpg
chmod 755 /var/www/html/jpg

2. Ghostscript 缺失

ImageMagick 處理 PDF 依賴 Ghostscript,若報錯 FailedToExecuteCommand 'gs',請安裝:

apt-get install ghostscript  # Debian/Ubuntu
yum install ghostscript      # CentOS/RHEL

3. 安全策略限制

ImageMagick 6.9+ 預設禁止處理 PDF,需修改 /etc/ImageMagick-6/policy.xml:

<policy domain="coder" rights="read|write" pattern="PDF" />

修改後重啟 PHP-FPM 或 Apache 生效。

進階應用:批次轉換多頁 PDF

<?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 請求。

copyright © 萬盛學電腦網 all rights reserved