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.

Wymagania

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

Wymaganie	Ograniczenie	Uwagi
PHP	`>=8.4 <9.0`	Composer odmawia instalacji w środowisku PHP 8.3 lub starszym oraz w PHP 9.
Composer	2.7 lub nowszy	Wymagany do rozwiązywania zależności i generowania autoloadera.
`ext-mbstring`	Wymagane	Obsługa ciągów wielobajtowych na potrzeby układu tekstu.
`ext-zlib`	Wymagane	Kompresja strumieni dla obiektów formatu Portable Document Format (PDF).
Chrome lub Chromium	Opcjonalnie	Tylko dla mechanizmu renderowania Artisan (`writeHtmlChrome()`).
Usługa Gotenberg	Opcjonalnie	Tylko do konwersji dokumentów biurowych i HTML za pośrednictwem Gotenberg.
Python	3.10 lub nowszy	Tylko dla zestawu Python SDK.

ext-mbstring oraz ext-zlib są domyślnie włączone w każdej obsługiwanej kompilacji PHP. Integracje sprawdzają ich obecność podczas uruchamiania i zatrzymują się z czytelnym komunikatem, jeśli brakuje któregokolwiek z nich.

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.

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.

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.

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.

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.

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.

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.

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.

composer show nextpdf/core

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

php artisan package:discover --ansi

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

php bin/console debug:container nextpdf

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

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

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

nextpdf version

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

Zobacz również

Twój pierwszy plik PDF Wygeneruj 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.

Integracje Pełna mapa rozszerzeń i przewodnik wyboru.

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