Pacote Laravel

Laravel · LGPL-3.0

O pacote Laravel (yeeefang/tcpdf-next-laravel) fornece integração de primeira classe com o Laravel 12:

• ServiceProvider auto-discovered -- Bindings DI, serviços escopados seguros para Octane
• Facade Pdf -- acesso estático conveniente
• PdfResponse -- helpers de resposta HTTP seguras (inline/download)
• GeneratePdfJob -- geração assíncrona de PDF via fila

Instalação

composer require yeeefang/tcpdf-next-laravel

Requisitos: Laravel ^12.0

O ServiceProvider é auto-discovered. Publique a configuração:

php artisan vendor:publish --tag=tcpdf-next-config

Início Rápido

use Yeeefang\TcpdfNext\Laravel\Facades\Pdf;
use Yeeefang\TcpdfNext\Laravel\Http\PdfResponse;

class InvoiceController extends Controller
{
    public function download(Invoice $invoice)
    {
        $pdf = Pdf::create()
            ->setTitle("Invoice #{$invoice->number}")
            ->addPage()
            ->setFont('DejaVuSans', '', 12)
            ->cell(0, 10, "Invoice #{$invoice->number}");

        return PdfResponse::download($pdf, "invoice-{$invoice->number}.pdf");
    }
}

Bindings do Service Provider

Interface	Binding	Escopo
PdfDocumentInterface	Document::create()	Factory (novo por resolução)
FontManagerInterface	FontManager	Escopado (novo por request, seguro para Octane)
SignerInterface	Configurado a partir de config/tcpdf-next.php	Factory

O TcpdfServiceProvider mescla padrões sensatos do arquivo de configuração incluído e registra todos os bindings antes da aplicação inicializar. Em ambientes Laravel Octane, os bindings escopados são automaticamente limpos entre requests para prevenir vazamento de estado.

Estrutura do Pacote

Yeeefang\TcpdfNext\Laravel\
├── TcpdfServiceProvider       # DI bindings, config publishing
├── Facades\
│   └── Pdf                    # Static proxy to Document factory
├── Http\
│   └── PdfResponse            # Inline / download response helpers
└── Jobs\
    └── GeneratePdfJob         # Queueable async PDF generation

Injeção de Dependência

Em vez da Facade, injete o contrato diretamente:

use Yeeefang\TcpdfNext\Contracts\PdfDocumentInterface;

class ReportService
{
    public function __construct(
        private readonly PdfDocumentInterface $pdf,
    ) {}

    public function generate(array $data): string
    {
        return $this->pdf
            ->addPage()
            ->setFont('Helvetica', 'B', 16)
            ->cell(0, 10, 'Monthly Report')
            ->setFont('Helvetica', '', 12)
            ->cell(0, 10, "Generated: " . now()->format('F j, Y'))
            ->output();
    }
}

Próximos Passos

• Facade Pdf -- Acesso estático e helpers de teste
• Respostas HTTP -- Exibição inline e downloads seguros
• Queue Jobs -- Geração assíncrona de PDF com callbacks
• Configuração -- Referência completa de configuração