Comparison & Deployment Guide

Not sure which packages you need? Use the interactive wizard below, or browse the deployment scenarios and decision matrix to find your ideal setup.

Finden Sie Ihr perfektes Setup

Generate Your Setup

Setup-Generator

Wählen Sie Pakete und Optionen, um sofort einsatzbereite Konfigurationsdateien zu generieren.

Pakete

CoreArtisanProLaravelSymfonyCodeIgniterAdaptation

Core ist immer enthalten

Docker-Optionen

Basis-Image

CJK-SchriftenInstalliert Noto Sans CJK für Chinesisch-, Japanisch- und Koreanisch-UnterstützungRoadRunnerFügt RoadRunner für persistente Worker-basierte HTTP-Bereitstellung hinzu

Generierter Code

composer require yeeefang/tcpdf-next

Deployment Scenarios

Different hosting environments have different capabilities. Here's what works best for each:

🏠

Shared Hosting

Leistung

Empfohlene Pakete

Core

Eingeschränkter PHP-Zugriff, keine Shell. Nur Core mit Basis-Schriften. Kein Chrome/RoadRunner.

🖥

VPS (PHP-FPM)

Leistung

Empfohlene Pakete

Core Artisan Laravel

Volle Server-Kontrolle. Chrome für HTML→PDF installieren. Für die meisten Anwendungen geeignet.

🖥

VPS + RoadRunner

RoadRunner

Leistung

Empfohlene Pakete

Core Artisan Laravel

Persistente Worker eliminieren Cold Starts. 3-7x Throughput-Steigerung.

⚙

Dedicated Server

Leistung

Empfohlene Pakete

Core Artisan Pro Laravel

Volle Ressourcen. Ideal für Pro-Features (PAdES, PDF/A-4, HSM).

⚙

Dedicated + RoadRunner

RoadRunner

Leistung

Empfohlene Pakete

Core Artisan Pro Laravel

Maximaler Throughput. 9.000+ docs/s mit 4 Workers.

☸

Kubernetes / Docker

RoadRunner

Leistung

Empfohlene Pakete

Core Artisan Pro Symfony

Horizontale Skalierung. RoadRunner als Worker-Prozess. Production-Grade.

Performance: Standard PHP-FPM vs RoadRunner

RoadRunner keeps your PHP application in memory as a persistent worker, eliminating cold starts and dramatically increasing throughput.

Standard PHP-FPM vs RoadRunner

▲ Höher ist besser

PHP-FPM RoadRunner

Einfaches Dokument

390 docs/s

2,605 docs/s

6.7x schneller

Rechnung

294 docs/s

1,960 docs/s

6.7x schneller

100-Seiten-Bericht

14 docs/s

98 docs/s

7.0x schneller

4 Workers

1,500 docs/s

9,221 docs/s

6.1x schneller

PHP 8.5.3 + OPcache + JIT · Docker 4 CPUs / 16 GB · i9-13900K · Median von 20 Durchläufen

When to use RoadRunner

RoadRunner is recommended when you need high throughput (hundreds of PDFs per minute) or low latency (sub-millisecond response times). For typical web applications generating a few PDFs per request, standard PHP-FPM is perfectly fine.

Use Case Decision Matrix

Which packages should you install for your specific use case?

\u{2705} Empfohlen\u{26AA} Optional— N/A

Anwendungsfall	Core	Artisan	Pro	Laravel	Symfony	CI4	Adaptation
Rechnungs- & Berichtserstellung	✅	⚪	⚪	⚪	⚪	⚪	—
E-Commerce (HTML→PDF)	✅	✅	⚪	⚪	⚪	⚪	—
Barrierefreie Dokumente (PDF/UA)	✅	—	✅	⚪	⚪	⚪	—
Digitale Signaturen (PAdES)	✅	—	✅	⚪	⚪	⚪	—
Legacy TCPDF Migration	✅	⚪	—	⚪	⚪	⚪	✅
High-Throughput API	✅	⚪	⚪	✅	✅	⚪	—
Archivierungskonformität (PDF/A-4)	✅	—	✅	⚪	⚪	⚪	—
Barcode-intensive Dokumente	✅	—	⚪	⚪	⚪	⚪	—

Paket Kompatibilität

Most packages work together seamlessly, with one exception:

Combination	Compatible	Notes
Core + Any package	Yes	Core is always required
Artisan + Any framework	Yes	Chrome CDP works with all frameworks
Pro + Laravel/Symfony/CI	Yes	Full enterprise features in any framework
Pro + Adaptation	No	Adaptation wraps the legacy TCPDF API; Pro extends the modern TCPDF-Next API. Choose one approach.
Adaptation + Framework	Yes	Use Adaptation to migrate legacy code within your framework

CJK & Font Considerations

The built-in Basic 14 fonts (Helvetica, Times, Courier, etc.) only support Latin characters. If your documents need Chinese, Japanese, or Korean text, you must:

1. Embed TrueType fonts — Use setFont() with a TTF font that supports your character set
2. Configure font paths — Set the TCPDF_FONTS_DIR environment variable or use the configuration API
3. Consider file size — CJK fonts are typically 5-15 MB each; use font subsetting to reduce PDF size

// Example: Using a CJK font
$pdf = Document::createStandalone()
    ->addPage()
    ->setFont('/path/to/NotoSansCJK-Regular.ttf', '', 12)
    ->cell(0, 10, '你好世界 こんにちは 안녕하세요');

Recommended CJK Fonts

• Noto Sans CJK — Google's open-source CJK font family (free)
• Source Han Sans — Adobe's equivalent (free)
• Both support Simplified Chinese, Traditional Chinese, Japanese, and Korean in a single font file.

Shared Hosting Limitations

On shared hosting, you typically cannot:

• Installation Chrome/Chromium (no Artisan package)
• Run long-lived processes (no RoadRunner)
• Installation PHP extensions (limited to what's provided)

Recommended setup for shared hosting:

composer require yeeefang/tcpdf-next

Use Core only with the built-in HTML parser for basic HTML-to-PDF needs. For pixel-perfect HTML rendering, consider upgrading to a VPS.

Nächste Schritte

• Erste Schritte — Installation and create your first PDF
• Installationation Guide — Detailed installation for all packages
• Benchmarks — Full performance comparison data
• Migration from TCPDF — Step-by-step migration guide