abstractrs/laravel-pdf-merger

Laravel 的一个打包程序,可以将多个 PDF 文件合并为一个。

1.0.3 2021-12-14 10:58 UTC

This package is auto-updated.

Last update: 2024-09-10 23:20:14 UTC


README

受另一个打包程序启发的 Laravel PDF 合并器,为个人使用而创建。在 Laravel 5.6 上进行了测试。

优点

  • 也支持 1.4 以上的 PDF 版本
  • 支持 PHP 7

安装

 $ composer require grofgraf/laravel-pdf-merger

配置

在位于 config/app.php 的主配置文件中做出以下更改

'providers' => [
   ...
   GrofGraf\LaravelPDFMerger\Providers\PDFMergerServiceProvider::class
],

'aliases' => [
   ...
   'PDFMerger' => GrofGraf\LaravelPDFMerger\Facades\PDFMergerFacade::class
]

在合并 1.4 以上的 PDF 版本或 PDF 字符串时,会在过程中创建一个临时 PDF,并将其存储在 storage/tmp 目录中,因此您可能需要事先创建它。此外,请注意,此打包程序需要服务器上安装 Ghostscript 才能正确处理 1.5+ 版本的 PDF。请参阅 安装指南

用法

您可以通过指定 PDF 文件的路径使用 addPathToPDF 方法添加要合并的 PDF,或者使用 addPDFString 方法添加 PDF 文件作为字符串。两种方法中的第二个参数是所选页面数组('all' 为所有页面),第三个参数是 PDF 的方向(纵向或横向)。

$merger->addPathToPDF('/path/to/pdf', 'all', 'P');
$merger->addPDFString(file_get_contents('path/to/pdf'), ['1', '2'], 'L')

您可以使用 setFileName 方法设置合并后的 PDF 名称。

$merger->setFileName('merger.pdf');

最后,使用 mergeduplexMerge 方法完成过程,并使用合并 PDF 的输出选项之一。两种方法的区别在于,如果合并的 PDF 页数是奇数,则 duplexMerge 方法会在每个合并的 PDF 后添加空白页。

可用的输出选项有

  • inline()
  • download()
  • string()
  • save('path/to/merged.pdf')
$merger->merge();
$merger->inline();

示例用法

$merger = \PDFMerger::init();
$merger->addPathToPDF(base_path('/vendor/grofgraf/laravel-pdf-merger/examples/one.pdf'), [2], 'P');
$merger->addPDFString(file_get_contents(base_path('/vendor/grofgraf/laravel-pdf-merger/examples/two.pdf')), 'all', 'L');
$merger->merge();
$merger->save(base_path('/public/pdfs/merged.pdf'));

作者

致谢

许可证

MIT 许可证 (MIT)

版权 (c) 2017 GrofGraf

以下是对任何获得本软件及其相关文档副本(“软件”)的个人免费授予的许可,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利,并允许获得本软件的个人执行上述操作,前提是必须遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供,没有任何形式的保证,明示或暗示,包括但不限于适销性、适用于特定目的和无侵犯性的保证。在任何情况下,作者或版权所有者都不应对任何索赔、损害或其他责任负责,无论此类索赔、损害或其他责任是基于合同、侵权或其他方式,源于、因涉及或与软件或其使用或其它方式相关。