Instalacja NextPDF

W skrócie

Zainstaluj wybraną dystrybucję NextPDF jednym poleceniem menedżera pakietów. Dystrybucje PHP korzystają z Composera, a zestaw software development kit (SDK) dla Pythona używa pip. Wybierz kartę odpowiednią do tego, co tworzysz. Uruchom polecenie, a następnie zweryfikuj wynik na dole tej strony.

Jeden silnik, kilka punktów wejścia

Pakietem silnika podstawowego jest nextpdf/core. Integracje z frameworkami, mechanizmy renderowania języka Hypertext Markup Language (HTML), serwer oraz klient Python — każda z tych opcji dodaje jeden pakiet do silnika podstawowego. Nie zastępują go — instalują go automatycznie.

Wymagania

NextPDF jest przeznaczony dla jednego nowoczesnego środowiska uruchomieniowego. Te ograniczenia pochodzą bezpośrednio z plików composer.json poszczególnych pakietów.

Wymagania środowiska uruchomieniowego NextPDF odczytane z własnych plików composer.json pakietów

Wymaganie	Ograniczenie	Stan	Uwagi
PHP	>=8.4 <9.0	Wymagane	Composer odmawia instalacji w PHP 8.3 lub starszym oraz w PHP 9.
Composer	2.x	Wymagane	Wymagany do rozwiązywania zależności i generowania autoloadera.
ext-mbstring	—	Wymagane	Obsługa wielobajtowych ciągów znaków na potrzeby układu tekstu.
ext-zlib	—	Wymagane	Kompresja strumieniowa obiektów formatu Portable Document Format (PDF).
ext-intl	—	Wymagane	Usługi International Components for Unicode (ICU): tekst dwukierunkowy, dzielenie wierszy i formatowanie uwzględniające ustawienia regionalne.
ext-gd	—	Wymagane	Dekodowanie i przetwarzanie obrazów rastrowych na potrzeby obrazów osadzonych.
ext-curl	—	Wymagane	Komunikacja sieciowa: znakowanie czasem RFC 3161 oraz pobieranie zdalnych zasobów. Generowanie w trybie offline tego nie wykorzystuje, ale Composer nadal tego wymaga.
ext-openssl	—	Wymagane	Kryptografia na potrzeby podpisów cyfrowych, struktur CMS i szyfrowania.
Chrome or Chromium	—	Opcjonalne	Tylko dla mechanizmu renderującego Artisan (writeHtmlChrome()).
Gotenberg service	—	Opcjonalne	Tylko do konwersji dokumentów biurowych i HTML za pomocą narzędzia Gotenberg.
Python	3.10+	Opcjonalne	Tylko dla Python software development kit (SDK).

ext-mbstring oraz ext-zlib są domyślnie włączone w większości kompilacji PHP; ext-intl, ext-gd, ext-curl oraz ext-openssl różnią się w zależności od dystrybucji, dlatego przed instalacją zweryfikuj wszystkie sześć rozszerzeń poleceniem php -m. Integracje podczas uruchamiania sprawdzają obecność wymaganych przez siebie rozszerzeń i zatrzymują się z czytelnym komunikatem, jeśli któregokolwiek brakuje.

Instalacja silnika podstawowego

Aby generować i analizować pliki PDF z poziomu PHP, wystarczy silnik podstawowy.

composer require nextpdf/core

Zatwierdź plik composer.lock, aby każdy wdrożony proces roboczy korzystał z tej samej wersji silnika. Po instalacji przejdź do strony Twój pierwszy plik PDF.

Instalacja integracji z frameworkiem

Zainstaluj jeden adapter dla frameworka, aby uzyskać powiązania kontenera, funkcje pomocnicze dla odpowiedzi oraz zadania kolejkowe. Każdy adapter deklaruje nextpdf/core i rozwiązuje tę zależność za Ciebie.

Laravel

composer require nextpdf/laravel

Automatyczne wykrywanie rejestruje dostawcę usług oraz fasadę Pdf. Następnie opublikuj plik konfiguracyjny:

php artisan vendor:publish --tag=nextpdf-config

Zobacz przewodnik instalacji dla Laravela oraz szybki start dla Laravela.

Symfony

composer require nextpdf/symfony

W aplikacji z Symfony Flex pakiet rejestruje się automatycznie. W aplikacji bez Flex dodaj NextPDF\Symfony\NextPdfBundle do config/bundles.php ręcznie. Zobacz przewodnik instalacji dla Symfony.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 wykrywa klasę Services oraz funkcję pomocniczą pdf() automatycznie, więc ręczna rejestracja nie jest potrzebna. Zobacz przewodnik instalacji dla CodeIgnitera.

Instalacja mechanizmu renderowania lub usługi

NextPDF renderuje HTML do PDF na trzy sposoby. Zainstaluj opcję odpowiednią dla miejsca, w którym ma odbywać się renderowanie. Żadna z nich nie zastępuje writeHtml(), wbudowanego potoku HTML w silniku podstawowym, w pełni opartego na PHP.

Artisan (Chrome)

composer require nextpdf/artisan

Ten pakiet dodaje renderowanie w trybie headless Chrome za pośrednictwem protokołu Chrome DevTools Protocol (CDP). Host musi mieć również dostęp do pliku wykonywalnego Chrome lub Chromium. Po instalacji wywołaj writeHtmlChrome() na dokumencie. Zobacz szybki start dla Artisana.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

Renderowanie odbywa się przez Cloudflare Browser Rendering na brzegu sieci. Pomost zależy wyłącznie od kontraktów PHP Standards Recommendation (PSR) PSR-18 i PSR-17, więc dostarczasz własnego klienta protokołu Hypertext Transfer Protocol (HTTP) (tu jako przykład pokazano Guzzle). Zobacz przewodnik instalacji dla Cloudflare.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Ten pakiet konwertuje dokumenty biurowe i HTML za pośrednictwem usługi Gotenberg. Zapewniasz klienta PSR-18 oraz dostępną instancję Gotenberg. Zobacz przewodnik instalacji dla Gotenberg.

Mechanizmy renderowania sięgają poza PHP

Artisan uruchamia proces przeglądarki, a Cloudflare i Gotenberg wywołują usługę sieciową. Traktuj HTML jako niezaufany. Przed wyrenderowaniem danych pochodzących od użytkownika zapoznaj się ze stroną każdego pakietu dotyczącą bezpieczeństwa i działania.

Instalacja serwera

NextPDF Server (nazywany również Connect) to samodzielna usługa. Udostępnia silnik za pośrednictwem Model Context Protocol (MCP), Representational State Transfer (REST) oraz gRPC.

composer require nextpdf/server

Pakiet dodaje konsolowe punkty wejścia do vendor/bin/, w tym vendor/bin/nextpdf-mcp (serwer stdio MCP) oraz vendor/bin/nextpdf-server (serwer REST). Transporty REST i gRPC wymagają również pliku wykonywalnego RoadRunner:

./vendor/bin/rr get-binary

Zobacz przewodnik instalacji dla Connect oraz szybki start dla Connect.

Instalacja zestawu Python SDK

Zestaw Python SDK jest typowanym klientem dla działającego NextPDF Server. Zainstaluj go z Python Package Index (PyPI):

pip install nextpdf

Zestaw SDK wymaga Pythona 3.10 lub nowszego oraz dostępnego punktu końcowego NextPDF Server. Zobacz szybki start dla Python SDK.

Weryfikacja instalacji

Potwierdź, że każda dystrybucja została poprawnie zainstalowana, zanim zaczniesz pisać kod.

Silnik podstawowy / PHP

composer show nextpdf/core

Wiersz z wersją potwierdza, że silnik jest zainstalowany i dostępny dla autoloadera.

Laravel

php artisan package:discover --ansi

Dane wyjściowe wymieniają nextpdf/laravel wśród wykrytych pakietów.

Symfony

php bin/console debug:container nextpdf

Kontener zgłasza alias nextpdf.document oraz usługę PdfFactory.

Serwer

./vendor/bin/generate-skills --dry-run --list-tools

To polecenie uruchamia rejestr i wypisuje narzędzia udostępniane przez tę instalację bez uruchamiania serwera.

Python

nextpdf version

Ciąg wersji potwierdza, że zestaw SDK można zaimportować bez błędów.

Zobacz również

Twój pierwszy plik PDFWygeneruj plik PDF z poziomu PHP i wyrenderuj HTML do PDF.

Wybierz swoją ścieżkęZdecyduj, która dystrybucja i który mechanizm renderowania HTML pasują do Twojej aplikacji.

Zakup i licencjonowanieKup licencję Pro lub Enterprise za pośrednictwem naszego Merchant of Record, a następnie zainstaluj i aktywuj.

IntegracjePełna mapa rozszerzeń i przewodnik wyboru.

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