Memasang NextPDF

Sekilas

Pasang distribusi NextPDF apa pun dengan satu perintah pengelola paket. Distribusi PHP menggunakan Composer; Python software development kit (SDK) menggunakan pip. Pilih tab yang sesuai dengan apa yang sedang Anda bangun. Jalankan perintahnya, lalu verifikasi hasilnya di bagian bawah halaman ini.

Satu mesin, beberapa pintu masuk

Mesin inti adalah nextpdf/core. Integrasi framework, renderer Hypertext Markup Language (HTML), server, dan klien Python masing-masing menambahkan satu paket di atasnya. Paket-paket itu tidak menggantikan mesin inti; masing-masing memasangnya untuk Anda.

Persyaratan

NextPDF menargetkan satu runtime modern. Batasan ini diambil langsung dari berkas composer.json milik paket itu sendiri.

Persyaratan	Batasan	Catatan
PHP	>=8.4 <9.0	Composer menolak pemasangan pada PHP 8.3 atau di bawahnya, maupun pada PHP 9.
Composer	2.7 atau lebih baru	Diperlukan untuk resolusi dependensi dan pembuatan autoloader.
ext-mbstring	Diperlukan	Penanganan string multi-byte untuk tata letak teks.
ext-zlib	Diperlukan	Kompresi aliran untuk objek Portable Document Format (PDF).
Chrome atau Chromium	Opsional	Hanya untuk renderer Artisan (writeHtmlChrome()).
Layanan Gotenberg	Opsional	Hanya untuk konversi office dan HTML melalui Gotenberg.
Python	3.10 atau lebih baru	Hanya untuk Python SDK.

ext-mbstring dan ext-zlib sudah aktif pada setiap build PHP yang didukung. Integrasi memeriksa keberadaan keduanya saat boot dan berhenti dengan pesan yang jelas jika salah satunya tidak tersedia.

Memasang inti

Untuk membuat dan memeriksa berkas PDF melalui PHP, Anda hanya memerlukan mesin inti.

composer require nextpdf/core

Commit composer.lock agar setiap worker yang di-deploy memakai versi mesin yang sama. Setelah pemasangan, lanjutkan ke PDF pertama Anda.

Memasang integrasi framework

Pasang satu adaptor framework untuk mendapatkan binding container, helper respons, dan job antrean. Setiap adaptor mendeklarasikan nextpdf/core dan mengurus resolusinya untuk Anda.

Laravel

composer require nextpdf/laravel

Auto-discovery mendaftarkan service provider dan facade Pdf. Setelah itu, publikasikan berkas konfigurasinya:

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

Lihat panduan pemasangan Laravel dan quickstart Laravel.

Symfony

composer require nextpdf/symfony

Di aplikasi Symfony Flex, bundle mendaftarkan dirinya sendiri. Di aplikasi non-Flex, tambahkan NextPDF\Symfony\NextPdfBundle ke config/bundles.php secara manual. Lihat panduan pemasangan Symfony.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4 menemukan kelas Services dan helper pdf() secara otomatis, sehingga Anda tidak perlu mendaftarkannya secara manual. Lihat panduan pemasangan CodeIgniter.

Memasang renderer atau layanan

NextPDF merender HTML ke PDF dengan tiga cara. Pasang opsi sesuai tempat Anda ingin perenderan berlangsung. Tidak ada yang menggantikan writeHtml(), pipeline HTML pure-PHP bawaan di mesin inti.

Artisan (Chrome)

composer require nextpdf/artisan

Paket ini menambahkan perenderan headless-Chrome melalui Chrome DevTools Protocol (CDP). Anda juga memerlukan biner Chrome atau Chromium yang dapat dijangkau oleh host. Setelah pemasangan, panggil writeHtmlChrome() pada sebuah dokumen. Lihat quickstart Artisan.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

Perenderan berjalan melalui Cloudflare Browser Rendering di edge. Bridge ini hanya bergantung pada kontrak PHP Standards Recommendation (PSR) PSR-18 dan PSR-17, sehingga Anda perlu menyediakan sendiri klien Hypertext Transfer Protocol (HTTP) (contoh di sini menggunakan Guzzle). Lihat panduan pemasangan Cloudflare.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Paket ini mengonversi dokumen office dan HTML melalui layanan Gotenberg. Anda menyediakan klien PSR-18 dan instance Gotenberg yang dapat dijangkau. Lihat panduan pemasangan Gotenberg.

Perender menjangkau di luar PHP

Artisan meluncurkan proses peramban, sedangkan Cloudflare dan Gotenberg memanggil layanan jaringan. Perlakukan HTML sebagai tidak tepercaya. Baca halaman security-and-operations untuk setiap paket sebelum Anda merender input yang dipengaruhi pengguna.

Memasang server

NextPDF Server (disebut juga Connect) adalah layanan mandiri. Server ini mengekspos mesin melalui Model Context Protocol (MCP), Representational State Transfer (REST), dan gRPC.

composer require nextpdf/server

Paket ini menambahkan titik masuk konsol di vendor/bin/, termasuk vendor/bin/nextpdf-mcp (server stdio MCP) dan vendor/bin/nextpdf-server (server REST). Transport REST dan gRPC juga memerlukan biner RoadRunner:

./vendor/bin/rr get-binary

Lihat panduan pemasangan Connect dan quickstart Connect.

Memasang Python SDK

Python SDK adalah klien bertipe untuk NextPDF Server yang sedang berjalan. Pasang dari Python Package Index (PyPI):

pip install nextpdf

SDK ini memerlukan Python 3.10 atau lebih baru dan endpoint NextPDF Server yang dapat dijangkau. Lihat quickstart Python SDK.

Memverifikasi pemasangan

Pastikan setiap distribusi terpasang dengan benar sebelum Anda mulai menulis kode.

Core / PHP

composer show nextpdf/core

Baris versi memastikan mesin sudah terpasang dan tersedia bagi autoloader.

Laravel

php artisan package:discover --ansi

Output akan menampilkan nextpdf/laravel di antara paket yang ditemukan.

Symfony

php bin/console debug:container nextpdf

Container akan melaporkan alias nextpdf.document dan layanan PdfFactory.

Server

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

Perintah ini mem-boot registry dan mencetak alat yang dipaparkan pemasangan ini tanpa menjalankan server.

Python

nextpdf version

String versi memastikan SDK dapat diimpor dengan bersih.

Lihat juga

PDF pertama Anda Buat PDF dari PHP dan render HTML ke PDF.

Pilih jalur Anda Tentukan distribusi dan renderer HTML mana yang cocok untuk aplikasi Anda.

Integrasi Peta ekstensi lengkap dan panduan pemilihan.

Connect (server) Jalankan mesin sebagai layanan jaringan melalui MCP, REST, dan gRPC.