使用PHP Imagick扩展将PDF转换为图片功能的完整方案

php -m | grep imagick

if (!extension_loaded('imagick')) {
    die('Imagick 扩展未安装，请先安装并启用');
}

<?php

namespace App\Services;

use Illuminate\Support\Facades\Log;
use Exception;

class PdfToImageConverterService
{
    /**
     * 将 PDF 文件转换为图片
     * @param string $pdfPath PDF 文件路径
     * @param string $outputDir 图片输出目录
     * @param string $format 图片格式，如 'png', 'jpeg' 等
     * @param int $dpi 图片清晰度，默认 300
     * @return array 生成的图片路径数组
     */
    public function pdfToImages($pdfPath, $outputDir, $format = 'jpeg', $dpi = 300) {
        // 检查 PDF 文件是否存在
        if (!file_exists($pdfPath)) {
            throw new Exception("PDF 文件不存在: {$pdfPath}");
        }

        // 创建输出目录（如果不存在）
        if (!is_dir($outputDir)) {
            mkdir($outputDir, 0755, true);
        }

        $images = [];

        try {
            // 创建 Imagick 对象
            $imagick = new \Imagick();

            // 设置分辨率
            $imagick->setResolution($dpi, $dpi);

            // 读取 PDF 文件
            $imagick->readImage("{$pdfPath}[0]");

            // 设置图片格式
            $imagick->setImageFormat($format);

            // 处理每一页
            $pageNumber = 1;
            foreach ($imagick as $image) {
                // 关键改进：添加白色背景并去除透明通道
                $image->setImageBackgroundColor('white');
                $image->setImageAlphaChannel(\Imagick::ALPHACHANNEL_REMOVE);
                $image->mergeImageLayers(\Imagick::LAYERMETHOD_FLATTEN);

                // 优化图片
                $image->setImageCompressionQuality(90);

                // 生成输出文件名
                $filename = pathinfo($pdfPath, PATHINFO_FILENAME) . "_page_{$pageNumber}.{$format}";
                $outputPath = $outputDir . '/' . $filename;

                // 写入图片文件
                $image->writeImage($outputPath);
                $images[] = $outputPath;

                $pageNumber++;
            }

            // 清理资源
            $imagick->destroy();
        } catch (\Exception $e) {
            throw new Exception("PDF 转换失败: " . $e->getMessage());
        }

        return $images;
    }
}

// 实例化转换器
$converter = new PdfToImageConverterService();

// 使用示例
try {
    $pdfPath = public_path('documents/sample.pdf'); // 输入的 PDF 文件路径
    $outputDir = public_path('output/images'); // 图片输出目录
    
    // 执行转换
    $result = $converter->pdfToImages($pdfPath, $outputDir, 'jpeg', 300);

    echo "转换成功，生成的图片：\n";
    foreach ($result as $imagePath) {
        echo "- {$imagePath}\n";
    }
} catch (\Exception $e) {
    echo "错误：" . $e->getMessage() . "\n";
}

$imagick->setResolution($dpi, $dpi);

// 关键改进：添加白色背景并去除透明通道
$image->setImageBackgroundColor('white');
$image->setImageAlphaChannel(\Imagick::ALPHACHANNEL_REMOVE);
$image->mergeImageLayers(\Imagick::LAYERMETHOD_FLATTEN);

$image->setImageCompressionQuality(90);