Cookbook

Auf einen Blick

Das Cookbook ist aufgabenorientiert. Jedes Recipe löst genau ein Problem anhand eines kopierbaren, quellengestützten Beispiels. Die Recipes gliedern sich in drei Familien, je nachdem, wo die Arbeit ausgeführt wird. Wählen Sie die Familie, die dazu passt, wie Sie NextPDF aufrufen, und wählen Sie dort das passende Recipe aus.

Wenn Sie verstehen möchten, warum sich die Engine auf eine bestimmte Weise verhält, lesen Sie stattdessen die Guides. Wenn Sie die geprüfte API-Oberfläche benötigen, lesen Sie die Reference.

Ein Beispiel, eine Laufzeitumgebung

Jedes Recipe ist auf genau eine Laufzeitumgebung ausgelegt. PHP-Recipes rufen die Core-Engine im selben Prozess auf. Connect-Recipes rufen Tools über einen Transport auf. Integrations-Recipes binden NextPDF in ein Framework oder ein Renderer-Backend ein. Lesen Sie die passende Konventionen-Seite, bevor Sie ein Beispiel anpassen.

PHP-Recipes

PHP-Recipes nutzen die Core-Engine direkt im selben Prozess. Jedes Recipe beginnt mit einer Installation über composer require nextpdf/core und baut, signiert, inspiziert oder konvertiert anschließend Dokumente mit der öffentlichen API, zum Beispiel Document::createStandalone() und writeHtml().

PHP-Recipes Die Übersicht über jedes PHP-native Recipe: HTML zu PDF rendern, Tabellen layouten, Schriften einbetten und subsetten, mit AES-256 verschlüsseln, mit PAdES signieren, PDF/A-4 und getaggtes PDF/UA-2 ausgeben, Text extrahieren und vorhandene Dateien inspizieren.

Connect-Recipes

Connect-Recipes rufen NextPDF über die Tool-Registry des Servers per Model Context Protocol (MCP), Representational State Transfer (REST) oder gRPC auf. Derselbe Tool-Aufruf funktioniert über alle drei Transportwege hinweg und läuft hinter dem Human-in-the-Loop-Bestätigungs-Gate.

Connect-Recipes Transportunabhängige Recipes für den NextPDF-Connect-Server: Hello World, HTML-Tabellen, Bildeinbettung, digitale Signaturen, Barrierefreiheits- und Compliance-Prüfungen, Schwärzung, forensische Analyse und Observability mit OpenTelemetry.

Integrations-Recipes

Integrations-Recipes binden NextPDF in ein Anwendungs-Framework ein oder delegieren das Rendering an ein externes Backend. Sie decken die Framework-Adapter und die Renderer-Brücken sowie den Migrationspfad von einer Altbibliothek weg ab.

Integrations-Recipes Recipes für die Ökosystem-Pakete: eine Integration auswählen, ein PDF aus einem Framework-Controller zurückgeben, die Generierung in einem Hintergrund-Job einreihen, HTML mit Artisan rendern, Office-Dateien mit Gotenberg konvertieren, am Edge mit Cloudflare rendern und dem TCPDF-Migrationspfad folgen.

Recipe-Konventionen

Jedes Recipe folgt einem dokumentierten Vertrag: quellengestützte Beispiele, Front-Matter für das Reproduzierbarkeits-Profil, eine ehrliche Konformitätsgrenze und das Publish-Gate. Lesen Sie die Konventionen-Seite für die Familie, in der Sie arbeiten, bevor Sie ein Beispiel anpassen.

Konventionen für Integrations-Recipes Der Vertrag, dem jedes lauffähige Integrations-Recipe folgt: quellengestützte Beispiele, Front-Matter für das Reproduzierbarkeits-Profil und das Publish-Gate.

Konventionen für Connect-Recipes Der Vertrag, dem jedes Connect-Recipe folgt: transportunabhängige Tool-Aufrufe, stufenabhängige Tools, das Risikomodell und das Bestätigungs-Gate sowie die ehrliche Konformitätsgrenze.

Siehe auch

• Guides — die Übersicht über die konzeptionelle und How-to-Dokumentation.
• Reference — die geprüfte API-Oberfläche und die CSS-Support-Matrix.
• Eine Integration auswählen — eine Entscheidungsmatrix vom Anwendungsfall zur Integration.