Wybierz właściwą ścieżkę

W skrócie

NextPDF udostępnia kilka punktów wejścia. Właściwy wybór zależy od tego, gdzie działa kod i jakiego wyniku w formacie Portable Document Format (PDF) potrzebuje aplikacja. Skorzystaj z tej strony, aby podjąć trzy decyzje: którą dystrybucję zainstalować, którego renderera Hypertext Markup Language (HTML) użyć oraz kiedy dany przypadek wymaga edycji Pro lub Enterprise.

Przeczytaj sekcję odpowiadającą pytaniu lub przejrzyj podsumowanie decyzji na końcu.

Wybierz dystrybucję

Zacznij od sposobu, w jaki aplikacja wywołuje silnik. Skorzystaj z pierwszego wiersza, który odpowiada danej sytuacji.

Sytuacja	Instalacja	Dlaczego
Standardowy projekt PHP, biblioteka lub narzędzie wiersza poleceń (CLI)	NextPDF core (nextpdf/core)	Sam silnik. Nie zakłada konkretnego frameworka ani nie uruchamia usługi.
Aplikacja Laravel, Symfony lub CodeIgniter	Odpowiednia integracja z frameworkiem	Wraz z core otrzymujesz powiązania kontenera, helpery odpowiedzi oraz zadania kolejki.
Usługa spoza PHP, agent lub inne środowisko uruchomieniowe, które musi wywoływać silnik przez sieć	NextPDF Server (nextpdf/server)	Jedna usługa udostępnia silnik przez Model Context Protocol (MCP), REST i gRPC.
Kod w języku Python, który potrzebuje plików PDF z serwera NextPDF Server	Python Software Development Kit (SDK) (pip install nextpdf)	Typowany klient do uruchomionego serwera. Nie osadza silnika.

Dwie kwestie łatwo przeoczyć:

• Integracja z frameworkiem zawiera core. Nie instalujesz obu oddzielnie. Adapter deklaruje zależność od nextpdf/core i sam ją rozwiązuje.
• Python SDK to klient, a nie silnik. Łączy się z punktem końcowym NextPDF Server. Generowanie PDF odbywa się w PHP na serwerze.

Biblioteka czy usługa?

Jeśli aplikacja PHP może dołączyć bibliotekę, użyj core lub integracji z frameworkiem. Uruchamiasz jeden proces mniej i uzyskujesz najniższe opóźnienie. Użyj serwera, gdy silnika potrzebuje kod spoza PHP lub gdy wielu wywołujących powinno współdzielić jedną usługę renderowania.

Wybierz renderer HTML

NextPDF może renderować HTML do PDF na cztery sposoby. Wbudowany potok obsługuje większość dokumentów bez dodatkowej konfiguracji. Sięgnij po jeden z trzech pakietów rendererów, gdy potrzebujesz układu na poziomie przeglądarki lub musisz połączyć się z istniejącą usługą.

renderer	Pakiet	Gdzie działa	Wybierz, gdy
Wbudowany writeHtml()	nextpdf/core	W procesie, czysty PHP	Chcesz obsługiwanego podzbioru HTML i Cascading Style Sheets (CSS) bez przeglądarki i bez wywołań sieciowych.
Artisan	nextpdf/artisan	Headless Chrome na hoście	Potrzebujesz pełnego układu zgodnego z Chrome — flexbox, grid, złożone selektory, czcionki internetowe — z możliwością zaznaczania tekstu.
Cloudflare	nextpdf/cloudflare	Cloudflare Browser Rendering na brzegu sieci	Renderowanie powinno odbywać się na brzegu sieci lub chcesz trzymać procesy przeglądarki z dala od własnych hostów.
Gotenberg	nextpdf/gotenberg	Usługa Gotenberg, którą obsługujesz	Konwertujesz dokumenty biurowe (DOCX, XLSX) lub HTML za pośrednictwem istniejącego wdrożenia Gotenberg.

Jak czytać tabelę:

• Zacznij od wbudowanego potoku. To najszybsza ścieżka, bez zewnętrznych zależności. Zanim oprzesz się na danej właściwości, sprawdź ją w macierzy obsługi CSS.
• Użyj Artisan, gdy układ wykracza poza obsługiwany podzbiór, a renderowanie powinno pozostać we własnej infrastrukturze. Uruchamia proces Chrome, więc uwzględnij jego cykl życia w planach.
• Użyj Cloudflare, gdy chcesz takiej samej wierności renderowania w przeglądarce i wolisz renderowanie na brzegu sieci zamiast lokalnych procesów przeglądarki.
• Użyj Gotenberg do konwersji dokumentów biurowych lub gdy już uruchamiasz Gotenberg i chcesz, żeby sterował nim NextPDF.

renderery poszerzają powierzchnię zagrożeń

Domyślnie wbudowany potok nie uruchamia żadnych skryptów ani nie pobiera żadnych zdalnych zasobów. Każdy z pakietów Artisan, Cloudflare i Gotenberg renderuje za pośrednictwem przeglądarki lub usługi sieciowej. Traktuj HTML jako niezaufany i zapoznaj się ze stroną bezpieczeństwa oraz eksploatacji każdego pakietu, zanim przekażesz dane wejściowe zależne od użytkownika.

Kiedy potrzebujesz edycji Pro lub Enterprise

Silnik core generuje, renderuje i analizuje pliki PDF bezpłatnie i bez licencji. NextPDF Pro i NextPDF Enterprise to dwie licencjonowane edycje pakietu nextpdf/premium. Instalacja tego pakietu dodaje możliwości bez zmiany API core.

Potrzebujesz	Edycja	Możliwość
Cyfrowo podpisać plik PDF z profilem bazowym PDF Advanced Electronic Signatures (PAdES)	Pro	Implementacje podpisywania z użyciem klucza programowego.
Tworzyć archiwalne pliki w formacie PDF/A	Pro	Zgodność z PDF/A oraz profile archiwalne.
Osadzić fakturę elektroniczną (Factur-X / ZUGFeRD)	Pro	Implementacje kontraktu e-faktury.
Podpisywać za pomocą sprzętowego modułu bezpieczeństwa (HSM)	Enterprise	Sprzętowo wspierane operacje na kluczach.
Składać kwalifikowane podpisy elektroniczne	Enterprise	Przepływ pracy dla podpisu kwalifikowanego oraz pełny zakres zgodności.

Dwie zasady ułatwiają podjęcie decyzji:

• Jeśli wynikiem mają być niepodpisane, niearchiwalne pliki PDF, core jest kompletny. Nie potrzebujesz licencji.
• Po zainstalowaniu nextpdf/premium integracje z frameworkami oraz serwer wykrywają go automatycznie. Udostępniają dodatkowe możliwości przez te same klucze kontenera i katalog narzędzi. Aplikacja nie wymaga zmian w kodzie, aby z nich skorzystać.

Podsumowanie decyzji

Dystrybucja

Standardowy PHP → core. Aplikacja frameworkowa → odpowiednia integracja. Granica sieciowa → serwer. Klient Python → Python SDK.

renderer HTML

Obsługiwany podzbiór, bez zależności → writeHtml(). Wierność przeglądarki na własnych hostach → Artisan. Na brzegu sieci → Cloudflare. Konwersja dokumentów biurowych → Gotenberg.

Licencjonowana edycja

Niepodpisane pliki PDF → core. Podpisywanie, PDF/A, e-faktura → Pro. HSM lub podpisy kwalifikowane → Enterprise.

Nadal masz wątpliwości?

Zainstaluj core, uruchom Twój pierwszy PDF i dodaj pakiet dopiero wtedy, gdy pojawi się konkretna potrzeba. Wszystko możesz później zmienić.

Zobacz też

Zainstaluj NextPDF Dokładne polecenie dla każdej dystrybucji i renderera.

Twój pierwszy PDF Wygeneruj PDF z PHP i wyrenderuj HTML do PDF.

Integracje Pełna mapa rozszerzeń, przewodnik wyboru oraz instrukcje dla poszczególnych pakietów.

Połącz (serwer) Uruchom silnik jako usługę sieciową przez MCP, REST i gRPC.