Przepisy

W skrócie

Ten zbiór przepisów jest zorientowany na zadania. Każdy przepis rozwiązuje jeden problem za pomocą przykładu gotowego do skopiowania i opartego na kodzie źródłowym. Przepisy są podzielone na trzy rodziny zależnie od miejsca wykonywania pracy. Wybierz rodzinę odpowiednią dla sposobu wywoływania NextPDF, a następnie otwórz właściwy przepis.

Jeśli chcesz zrozumieć, dlaczego silnik zachowuje się w określony sposób, sięgnij zamiast tego do Przewodników. Aby poznać zweryfikowany interfejs programowania aplikacji (API), zajrzyj do Dokumentacji referencyjnej.

Jeden przykład, jedno środowisko uruchomieniowe

Każdy przepis jest przeznaczony dla jednego środowiska uruchomieniowego. Przepisy PHP wywołują silnik podstawowy w ramach procesu. Przepisy Connect wywołują narzędzia przez transport. Przepisy integracyjne łączą NextPDF z frameworkiem lub zapleczem renderującym. Przed dostosowaniem przykładu przeczytaj odpowiednią stronę konwencji.

Przepisy PHP

Przepisy PHP uruchamiają silnik podstawowy bezpośrednio w ramach procesu. Każdy przepis zaczyna się od composer require nextpdf/core, a następnie używa publicznego API do tworzenia, podpisywania, inspekcji lub konwersji dokumentów, w tym Document::createStandalone() i writeHtml().

Przepisy PHP Mapa każdego natywnego przepisu PHP: renderowanie HTML do PDF, układanie tabel, osadzanie i tworzenie podzbiorów czcionek, szyfrowanie za pomocą AES-256, podpisywanie za pomocą PAdES, generowanie PDF/A-4 i znakowanego PDF/UA-2, wyodrębnianie tekstu oraz inspekcja istniejących plików.

Przepisy Connect

Przepisy Connect wywołują NextPDF za pośrednictwem rejestru narzędzi serwera, korzystając z Model Context Protocol (MCP), Representational State Transfer (REST) lub gRPC. To samo wywołanie narzędzia działa we wszystkich trzech transportach i pozostaje chronione bramką potwierdzenia z udziałem człowieka.

Przepisy Connect Niezależne od transportu przepisy dla serwera NextPDF Connect: hello world, tabele HTML, osadzanie obrazów, podpisy cyfrowe, kontrole dostępności i zgodności, redakcja, analiza śledcza oraz obserwowalność za pomocą OpenTelemetry.

Przepisy integracyjne

Przepisy integracyjne pokazują, jak połączyć NextPDF z frameworkiem aplikacji lub delegować renderowanie do zewnętrznego zaplecza. Obejmują adaptery frameworków, mostki do mechanizmów renderujących oraz ścieżkę migracji ze starszej biblioteki.

Przepisy integracyjne Przepisy dla pakietów ekosystemu: wybór integracji, zwracanie PDF z kontrolera frameworka, kolejkowanie generowania w zadaniu w tle, renderowanie HTML za pomocą Artisan, konwersja plików Office za pomocą Gotenberg, renderowanie na brzegu sieci za pomocą Cloudflare oraz podążanie ścieżką migracji TCPDF.

Konwencje przepisów

Każdy przepis jest zgodny z udokumentowanym kontraktem: przykłady oparte na kodzie źródłowym, metadane profilu odtwarzalności w front-matter, uczciwa granica zgodności oraz bramka publikacji. Przed dostosowaniem przykładu przeczytaj stronę konwencji dla danej rodziny przepisów.

Konwencje przepisów integracyjnych Kontrakt, którego przestrzega każdy uruchamialny przepis integracyjny: przykłady oparte na kodzie źródłowym, metadane front-matter profilu odtwarzalności oraz bramka publikacji.

Konwencje przepisów Connect Kontrakt, którego przestrzega każdy przepis Connect: niezależne od transportu wywołania narzędzi, narzędzia warunkowe zależne od poziomu, model ryzyka i bramka potwierdzenia oraz uczciwa granica zgodności.

Zobacz też

• Przewodniki — dokumentacja koncepcyjna i instruktażowa.
• Dokumentacja referencyjna — zweryfikowane API i macierz obsługi Cascading Style Sheets (CSS).
• Wybór integracji — macierz decyzyjna mapująca przypadki użycia na integracje.