Пакет Symfony

Symfony · LGPL-3.0

Пакет Symfony обеспечивает первоклассную интеграцию TCPDF-Next с Symfony 7 — привязки DI-контейнера, сервис PdfFactory, асинхронная генерация через Messenger и хелперы HTTP-ответов с заголовками безопасности OWASP.

Установка

bash

composer require yeeefang/tcpdf-next-symfony

Требования: Symfony ^7.0, PHP ^8.5

Бандл автоматически настраивается через Symfony Flex. При необходимости зарегистрируйте вручную:

php

// config/bundles.php
return [
    // ...
    Yeeefang\TcpdfNext\Symfony\TcpdfNextBundle::class => ['all' => true],
];

Конфигурация

yaml

# config/packages/tcpdf_next.yaml
tcpdf_next:
    fonts_directory: '%kernel.project_dir%/resources/fonts'
    default_page_size: A4
    default_orientation: portrait
    auto_page_break: true
    margin_bottom: 25.0

Сервис PdfFactory

Инжектируйте фабрику в ваши сервисы или контроллеры:

php

use Yeeefang\TcpdfNext\Symfony\PdfFactory;

class InvoiceController extends AbstractController
{
    public function __construct(
        private readonly PdfFactory $pdfFactory,
    ) {}

    #[Route('/invoice/{id}/pdf')]
    public function download(Invoice $invoice): Response
    {
        $pdf = $this->pdfFactory->create()
            ->setTitle("Invoice #{$invoice->number}")
            ->addPage()
            ->setFont('Helvetica', '', 12)
            ->cell(0, 10, "Invoice #{$invoice->number}");

        return $this->pdfFactory->response($pdf, "invoice-{$invoice->number}.pdf");
    }
}

HTTP-ответы

Класс PdfResponse возвращает PDF с рекомендованными OWASP заголовками безопасности:

php

use Yeeefang\TcpdfNext\Symfony\Http\PdfResponse;

// Inline display (browser preview)
return PdfResponse::inline($pdf, 'report.pdf');

// Force download
return PdfResponse::download($pdf, 'report.pdf');

Интеграция с Messenger

Отправьте генерацию PDF в воркер Messenger:

php

use Yeeefang\TcpdfNext\Symfony\Messenger\GeneratePdfMessage;

$this->bus->dispatch(new GeneratePdfMessage(
    template: 'invoice',
    data: ['invoice_id' => $invoice->id],
    outputPath: "/tmp/invoice-{$invoice->id}.pdf",
));

Безопасность в воркерах (FrankenPHP / RoadRunner)

Бандл настраивает DocumentFactory как синглтон — реестры шрифтов и кеши изображений сохраняются между запросами в персистентных воркерах. Работает с FrankenPHP, RoadRunner и любой реализацией Symfony Runtime.

Содержимое пакета

Класс	Описание
`TcpdfNextBundle`	Регистрация бандла и подключение сервисов
`PdfFactory`	DI-совместимая фабрика для создания PDF-документов
`PdfResponse`	HTTP-ответ с заголовками безопасности
`GeneratePdfMessage`	Сообщение Messenger для асинхронной генерации
`GeneratePdfMessageHandler`	Обработчик асинхронной генерации PDF

Пакет Symfony ​

Установка ​

Конфигурация ​

Сервис PdfFactory ​

HTTP-ответы ​

Интеграция с Messenger ​

Безопасность в воркерах (FrankenPHP / RoadRunner) ​

Содержимое пакета ​