Receptariusz PHP

Ten indeks zawiera receptury NextPDF natywne dla PHP: zorientowane na zadania, uruchamialne strony napisane bezpośrednio z użyciem podstawowego API PHP. Repozytorium core nextpdf przechowuje i weryfikuje każdą recepturę w katalogu docs/public/cookbook/php/. Każda receptura ma skrypt examples/*.php oraz test uruchomieniowy tests/Cookbook/Php/. Następnie agregator pobiera każdą stronę do tej witryny i zachowuje informacje o jej pochodzeniu źródłowym.

Jako indeks ta strona nie zawiera żadnych deklaracji dotyczących zachowania poszczególnych receptur. Każdy wiersz wskazuje cel receptury, podstawowy moduł, z którego korzysta, oraz jej zadeklarowany profil odtwarzalności. Profil i wszelkie deklaracje zgodności należą do samej strony receptury. Pochodzą z nagłówka front-matter tej strony oraz z jej testu w repozytorium, a nie z tego indeksu. Receptariusz integracji (framework / renderer / usługa) znajdziesz w Receptariuszu integracji. Kontrakt, którego przestrzega każda uruchamialna receptura, opisują Konwencje receptur.

Jak są zorganizowane slugi receptur

Każda receptura jest tworzona w repozytorium core w katalogu docs/public/cookbook/php/ i publikowana w tej witrynie przez agregator. Każdy slug stosuje jedną konwencję: ma pojedynczy segment.

/cookbook/php/<recipe>/

<recipe> określa cel receptury w formacie kebab-case (na przykład render-html-to-pdf, a nie nazwę modułu html). Jest zapisany małymi literami i rozdzielony łącznikami, nie zawiera numerów wersji i kończy się jednym ukośnikiem.

Profil odtwarzalności w jednej linii

Każda receptura deklaruje najściślejszy profil, który może rzetelnie spełnić:

bitwise — identyczny bajt po bajcie między uruchomieniami (zwykła, deterministyczna treść z całkowicie ustaloną entropią).
structural — identyczny po znormalizowaniu zmiennych atomów (/ID z trailera, daty creation/modification, prefiksy podzbioru czcionki — w praktyce każdy wieloobiektowy PDF).
semantic — wyłącznie równoważność strukturalnego AST i metadanych (wynik podpisany lub ze znacznikiem czasu albo wynik, którego równoważność z natury nie jest stabilna na poziomie bajtów).

Strona receptury potwierdza profil za pomocą swojego testu uruchomieniowego. Ten indeks podaje jedynie wartość deklarowaną przez tę stronę.

Podstawy

Buduj, paginuj i stylizuj dokument.

Receptura	Co robi	Moduł	Profil
`render-html-to-pdf`	Renderuj dokument HTML do PDF	Html	structural
`style-with-css`	Zastosuj CSS do renderowania HTML	Html	structural
`html-table-layout`	Rozmieść tabelę HTML	Html	structural
`paginate-long-html`	Paginuj długi dokument HTML	Html	structural
`paginate-large-html-tables`	Paginuj dużą tabelę HTML na wielu stronach	Html	structural
`render-rtl-arabic-html`	Renderuj arabski HTML pisany od prawej do lewej	Html	structural
`compose-text-and-fonts`	Składaj tekst z kontrolą typografii	Typography	structural
`embed-and-subset-fonts`	Osadzaj i twórz podzbiory czcionek	Font	structural
`cjk-vertical-writing`	Składaj tekst CJK w pionowym trybie pisma	Typography	structural
`multi-page-document`	Zbuduj dokument wielostronicowy	Document	structural
`headers-and-footers`	Dodaj żywe paginy: nagłówki i stopki	Layout	structural

Grafika i treść

Pracuj z grafiką wektorową, obrazami, warstwami i przestrzenią współrzędnych.

Receptura	Co robi	Moduł	Profil
`draw-vector-graphics`	Rysuj grafikę wektorową	Graphics	structural
`gradients-and-transparency`	Zastosuj gradienty i przezroczystość	Graphics	structural
`embed-images`	Osadzaj obrazy rastrowe	Content	structural
`add-watermarks-and-backgrounds`	Dodaj tekstowe i graficzne znaki wodne lub tła do stron	Content	structural
`cmyk-spot-color-and-icc-profiles`	Wygeneruj gotowy do druku kolor CMYK i kolor dodatkowy	Color	structural
`embed-file-attachments`	Osadzaj pliki i twórz portfolia PDF	Content	structural
`optional-content-layers`	Użyj treści opcjonalnej (warstw)	Graphics	structural
`transform-coordinate-space`	Przekształć przestrzeń współrzędnych	Graphics	structural

Nawigacja i formularze

Dodaj zakładki, odnośniki, adnotacje i pola AcroForm.

Receptura	Co robi	Moduł	Profil
`bookmarks-and-toc`	Zbuduj zakładki i spis treści	Navigation	structural
`generate-dynamic-table-of-contents`	Generuj dynamiczny spis treści	Navigation	structural
`links-and-annotations`	Dodaj odnośniki i adnotacje	Navigation	structural
`generate-barcodes`	Generuj kody kreskowe	Barcode	bitwise
`gs1-composite-barcodes`	Generuj kody kreskowe GS1 Composite (nośnik CC-C)	Barcode	structural
`fill-pdf-form`	Wypełnij formularz AcroForm	Form	structural
`flatten-form-fields`	Spłaszcz pola formularza	Form	structural
`form-field-validation-and-flatten-with-state`	Waliduj pola formularza i spłaszcz je ze stanem	Form	structural

Informacje o dokumencie

Ustaw metadane i zachowanie przeglądarki.

Receptura	Co robi	Moduł	Profil
`set-document-metadata`	Ustaw metadane dokumentu	Metadata	structural
`set-viewer-preferences`	Ustaw preferencje przeglądarki	Document	structural

Operacje na dokumentach

Składaj, dziel i optymalizuj istniejące dokumenty.

Receptura	Co robi	Moduł	Profil
`merge-external-pdfs`	Scalaj zewnętrzne pliki PDF lub dołączaj strony	Document	structural
`split-and-extract-pages`	Podziel plik PDF i wyodrębnij zakresy stron	Document	structural
`optimize-pdf-file-size`	Zmniejsz rozmiar pliku PDF dzięki kompresji i tworzeniu podzbiorów	Document	structural

Bezpieczeństwo, podpis i zgodność

Korzystaj z szyfrowania, podpisywania, dostępności i generowania wyników profilowanych. Na swoich stronach te receptury zachowują granice obsługa≠zgodność oraz obecność≠ważność.

Receptura	Co robi	Moduł	Profil
`encrypt-aes256`	Zaszyfruj algorytmem AES-256 i ustaw flagi uprawnień	Security	structural
`encrypt-with-permissions`	Zaszyfruj z flagami uprawnień	Security	structural
`sign-pades-b-b`	Zastosuj podpis PAdES (B-B i B-T)	Security	semantic
`inspect-existing-signature`	Sprawdź istniejący podpis	Inspect	semantic
`tagged-pdf-ua2`	Wyemituj otagowaną strukturę dla PDF/UA-2	Accessibility	semantic
`accessible-pdfua2-from-html`	Wyemituj otagowaną strukturę na potrzeby dostępnego tworzenia PDF/UA-2 z HTML	Accessibility	semantic
`pdf-a-4-output`	Wygeneruj wynik PDF/A-4	Conformance	semantic
`pdfa4-conformance-gate`	Wygeneruj wynik PDF/A-4 i uzależnij go od zewnętrznego walidatora	Conformance	semantic
`validate-conformance`	Zwaliduj względem profilu zgodności	Compliance	semantic

Inspekcja i ekstrakcja

Odczytuj treść i strukturę z pliku PDF.

Receptura	Co robi	Moduł	Profil
`extract-text-content`	Wyodrębnij treść tekstową	Text	semantic
`multilingual-copy-paste-extraction`	Spraw, aby pliki PDF w językach CJK i arabskim poprawnie się kopiowały i wklejały	Text	structural
`parse-and-inspect-pdf`	Parsuj i analizuj plik PDF	Inspect	semantic
`inspect-layout-boxes`	Badaj ramki układu	Inspect	semantic

Przekrojowe

Stosuj wzorce obejmujące kilka modułów.

Receptura	Co robi	Obejmuje	Profil
`worker-safe-batch-rendering`	Renderuj bezpiecznie w długotrwałym procesie roboczym (współdzielone rejestry, ograniczona pamięć)	Core · Performance · Support	semantic
`streaming-and-memory`	Profiluj strumieniowanie i zużycie pamięci	Performance	bitwise
`exception-aware-error-handling`	Obsługuj błędy z wykorzystaniem hierarchii wyjątków NextPDF	Exception · Contracts	structural
`custom-error-recovery-patterns`	Zaimplementuj niestandardowe strategie odzyskiwania po błędach i ponawiania	Exception	semantic
`observe-with-opentelemetry`	Obserwuj renderowanie za pomocą OpenTelemetry	Observability · Telemetry · Event	semantic

Każda receptura powyżej jest publikowana z powiązanym skryptem examples/*.php oraz testem uruchomieniowym tests/Cookbook/Php/ w repozytorium core. Gdy nowa receptura zostanie utworzona w repozytorium źródłowym, pojawia się tutaj, gdy tylko powstaną jej przykład i test.

Zobacz także

Receptariusz integracji — indeks integracji z frameworkami, rendererami i usługami.
Konwencje receptur — kontrakt, którego przestrzega każda uruchamialna receptura w tym receptariuszu.