renderpdf-io/renderpdf-laravel

使用 RenderPDF.io 服务将 HTML 转换为 PDF,是 Laravel 的库

1.0.0 2024-08-03 14:19 UTC

This package is auto-updated.

Last update: 2024-09-03 14:32:26 UTC


README

Unit Test codecov

RenderPDF.io Cover

RenderPDF.io 提供了出色的 & 开发者友好的 API,用于将 HTML 转换为 PDF。

这是一个 Laravel 包,提供了一个与 RenderPDF.io 简单集成的解决方案

要求

  • PHP 8.1 及以上
  • Laravel 10 及以上

安装

composer install renderpdf-io/renderpdf-laravel

注意:对于 Laravel 10 用户,您还需要安装 GuzzleHTTP

services.renderpdf-io.key 配置添加到您的 config/services.php 文件中(必需)

// config/services.php

return [
    'renderpdf-io' => [
        'key' => env('RENDER_PDF_IO_API_KEY'),
    ],
];

用法

外观风格

只需使用 RenderPdfIo 外观即可

use RenderPdfIo\RenderPdfIo;
use RenderPdfIo\Services\RenderPdfOptions;

public function renderPdf()
{
    $fileUrl = RenderPdfIo::render(new RenderPdfOptions(
        htmlContent: '<p>This is a new PDF</p>',
    ));
}

依赖注入风格

如果您想使用 DI 风格,我们也有相应的解决方案

use RenderPdfIo\Services\RenderPdfIoService;
use RenderPdfIo\Services\RenderPdfOptions;

class InvoiceController
{
    public function download(RenderPdfIoService $renderPdfService)
    {
        $fileUrl = $renderPdfService->render(new RenderPdfOptions(
            htmlContent: '<p>This is a new PDF using DI</p>',
        ));
    }
}

在此处查看所有可用选项: RenderPdfOptions.php

贡献

感谢您考虑为 RenderPDF.io 的 Laravel 库做出贡献,请随时

  • 为错误报告打开一个问题。
  • 提交一个 PR 以进行改进/增强。

许可

此库免费使用,根据 MIT 许可证