Przewodniki
W skrócie
Dział zatytułowany „W skrócie”Przewodniki pokazują, jak połączyć NextPDF ze środowiskiem uruchomieniowym kodu. Karta zaczyna się od listy kontrolnej eksploatacji produkcyjnej, a następnie obejmuje pięć obszarów w kolejności typowej dla wdrożenia: integracje z frameworkami i rendererami, serwer NextPDF Connect, zestaw SDK dla języka Python, tworzenie rozszerzeń silnika oraz rozwiązywanie problemów. Każda z poniższych sekcji zaczyna się od własnego węzła, a następnie wskazuje najczęściej używane strony.
Gdy potrzebny jest gotowy do skopiowania przepis dotyczący konkretnego zadania, skorzystaj z sekcji Receptariusz. Zweryfikowany opis Application Programming Interface (API) oraz macierze wsparcia znajdziesz w sekcji Dokumentacja referencyjna.
Integracje
Dział zatytułowany „Integracje”Osiem pakietów łączy silnik bazowy z frameworkami, rendererami przeglądarkowymi, usługami brzegowymi, narzędziami kompilacji oraz ścieżkami migracji ze starszych rozwiązań. Każda sekcja pakietu ma tę samą strukturę podręcznika: przegląd, instalację, szybki start, konfigurację, API, przewodnik dla programistów, użycie produkcyjne, bezpieczeństwo oraz rozwiązywanie problemów. Dzięki temu poznanie jednej sekcji ułatwia pracę z pozostałymi.
| Strona | Zastosowanie |
|---|---|
| Integracje | Mapa rozszerzeń i przewodnik wyboru. Zacznij tutaj, aby dobrać pakiet. |
| Indeks API integracji | Wskazuje stronę API rozszerzenia opisującą dany framework, renderer, transport albo obszar narzędzi kompilacji. |
| NextPDF dla Laravela | Adapter dla frameworka Laravel. |
| NextPDF dla Symfony | Adapter dla frameworka Symfony. |
| NextPDF dla CodeIgniter | Adapter dla frameworka CodeIgniter. |
| NextPDF Artisan | Mostek do renderera Chrome zapewniający renderowanie HTML w jakości przeglądarki. |
| NextPDF Cloudflare | Ścieżka wdrożenia brzegowego w Cloudflare. |
| NextPDF Gotenberg | Mostek do renderera Gotenberg. |
| Zgodność z TCPDF | Warstwa zgodności dla baz kodu odchodzących od TCPDF. |
| NextPDF Backport Builder | Narzędzie kompilacji dla starszych środowisk uruchomieniowych PHP. |
NextPDF Connect
Dział zatytułowany „NextPDF Connect”Pakiet nextpdf/server uruchamia silnik jako usługę działającą stale: jeden deterministyczny rejestr narzędzi udostępniany przez Model Context Protocol (MCP), Representational State Transfer (REST) oraz gRPC, z bramką wymagającą zatwierdzenia przez człowieka dla narzędzi wysokiego ryzyka.
| Strona | Zastosowanie |
|---|---|
| NextPDF Connect | Węzeł sekcji z koncepcjami, konfiguracją oraz eksploatacją serwera. |
| Przegląd Connect | Zakres pakietu oraz trzy transporty. |
| Szybki start Connect | Pierwszy działający handshake MCP i odpowiadające mu żądanie renderowania REST. |
| Konfiguracja Connect | Plik YAML dla MCP oraz zmienne środowiskowe NEXTPDF_*. |
| Dokumentacja API Connect | Opis każdego zarejestrowanego narzędzia, symbolu gRPC, wpisu modelu błędów i limitu częstotliwości. |
| Wdrażanie Connect | Profile procesów roboczych RoadRunner, Docker i magazyny oparte na Redis. |
| Bezpieczeństwo i eksploatacja Connect | Uwierzytelnianie, zabezpieczenie transportu oraz model zagrożeń. |
Każdy transport ma własną stronę dokumentacji.
| Strona | Zastosowanie |
|---|---|
| Transport MCP | Ramkowanie JSON-RPC 2.0 przez standardowe wejście i wyjście. |
| Transport REST | Kontrakt OpenAPI 3.1, uwierzytelnianie typu bearer oraz trasy ograniczane według poziomu. |
| Transport gRPC | Usługa nextpdf.connect.v1, strumieniowanie serwerowe i uwierzytelnianie za pomocą metadanych. |
Zestaw SDK dla języka Python
Dział zatytułowany „Zestaw SDK dla języka Python”Gotowa do cytowania ekstrakcja z plików PDF dla aplikacji w języku Python, agentów oraz wiersza poleceń, oparta na punkcie końcowym NextPDF Connect.
| Strona | Zastosowanie |
|---|---|
| Zestaw SDK dla języka Python | Węzeł sekcji dla pakietu nextpdf w języku Python. |
| Przegląd SDK dla języka Python | Co robi zestaw SDK i jak łączy się z NextPDF Connect. |
| Szybki start z SDK dla Pythona | Zainstaluj za pomocą pip install nextpdf i wskaż klientowi serwer. |
| Dokumentacja API pakietu Python SDK | Klasy klienta, metody oraz typowane wyniki. |
| Interfejs wiersza poleceń (CLI) w Pythonie | Interfejs wiersza poleceń dla procesów ekstrakcji. |
| Serwer MCP dla języka Python | Udostępnianie zestawu SDK agentom komunikującym się przez MCP. |
Rozszerzanie silnika
Dział zatytułowany „Rozszerzanie silnika”Publiczny interfejs SPI (Service Provider Interface) pozwala dodawać funkcje bez tworzenia forka: obejmuje kontrakty dla czcionek, silników układu, nasłuchiwaczy zdarzeń oraz zapleczy podpisywania, a każdy kontrakt ma jasno określoną obietnicę stabilności.
| Strona | Zastosowanie |
|---|---|
| Tworzenie rozszerzeń | Co można rozszerzyć i jaka obietnica stabilności się z tym wiąże. |
| Zasady stabilności SPI | Kontrakt zgodności wstecznej, na którym może polegać rozszerzenie. |
| Czcionki niestandardowe: kontrakt FontRegistry | Rejestrowanie i dostarczanie własnych czcionek. |
| Niestandardowe silniki układu i przechwytywanie tekstu | Zastępowanie lub przechwytywanie zachowania układu. |
| Wyzwalacze akcji i nasłuchiwacze zdarzeń | Obserwowanie cyklu życia dokumentu i reagowanie na niego. |
| Kontrakt dostawcy KMS | Dostarczanie kluczy z własnej usługi Key Management Service (KMS). |
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”Wpisy prowadzą od objawu do rozwiązania i opierają się na wewnętrznej taksonomii wyjątków silnika. Zacznij od tego, co obserwujesz, a nie od nazwy klasy.
| Strona | Zastosowanie |
|---|---|
| Rozwiązywanie problemów | Węzeł bazy wiedzy: struktura wpisów i punkt startowy. |
| Rozwiązywanie problemów z czcionkami i tagowaniem | Problemy z osadzaniem czcionek i tagowaniem struktury. |
| Rozwiązywanie problemów z szyfrowaniem i uprawnieniami | Problemy z szyfrowaniem, hasłami oraz uprawnieniami. |
| Rozwiązywanie problemów z pamięcią i wydajnością | Limity pamięci oraz problemy z przepustowością. |
| Rozwiązywanie problemów z walidacją PDF/A i PDF/UA | Błędy walidacji pod kątem archiwizacji i dostępności. |
| Rozwiązywanie problemów z podpisami i znacznikami czasu | Problemy z walidacją podpisu i znacznika czasu. |
Zobacz także
Dział zatytułowany „Zobacz także”- Receptariusz — przepisy zadaniowe dotyczące PHP, Connect oraz integracji.
- Dokumentacja referencyjna — zweryfikowany opis API, macierze wsparcia oraz dokumentacja błędów.
- Migracja do NextPDF — przejście z innej biblioteki PDF w karcie „Pierwsze kroki”.
- NextPDF od środka — eseje Insider_ o tym, dlaczego silnik działa właśnie tak.