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

1

php -m |grepimagick

1

2

3

if(!extension_loaded('imagick')) {

die('Imagick 扩展未安装，请先安装并启用');

}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

<?php

namespaceApp\Services;

useIlluminate\Support\Facades\Log;

useException;

classPdfToImageConverterService

{

/**

* 将 PDF 文件转换为图片

* @param string $pdfPath PDF 文件路径

* @param string $outputDir 图片输出目录

* @param string $format 图片格式，如 'png', 'jpeg' 等

* @param int $dpi 图片清晰度，默认 300

* @return array 生成的图片路径数组

*/

publicfunctionpdfToImages($pdfPath,$outputDir,$format='jpeg',$dpi= 300) {

// 检查 PDF 文件是否存在

if(!file_exists($pdfPath)) {

thrownewException("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($imagickas$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) {

thrownewException("PDF 转换失败: ".$e->getMessage());

}

return$images;

}

}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

// 实例化转换器

$converter=newPdfToImageConverterService();

// 使用示例

try{

$pdfPath= public_path('documents/sample.pdf');// 输入的 PDF 文件路径

$outputDir= public_path('output/images');// 图片输出目录

// 执行转换

$result=$converter->pdfToImages($pdfPath,$outputDir,'jpeg', 300);

echo"转换成功，生成的图片：\n";

foreach($resultas$imagePath) {

echo"- {$imagePath}\n";

}

}catch(\Exception$e) {

echo"错误：".$e->getMessage() ."\n";

}

1

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

1

2

3

4

// 关键改进：添加白色背景并去除透明通道

$image->setImageBackgroundColor('white');

$image->setImageAlphaChannel(\Imagick::ALPHACHANNEL_REMOVE);

$image->mergeImageLayers(\Imagick::LAYERMETHOD_FLATTEN);

1

$image->setImageCompressionQuality(90);