Memasang NextPDF
Sekilas
Bagian berjudul “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.
Persyaratan
Bagian berjudul “Persyaratan”NextPDF menargetkan satu runtime modern. Batasan ini diambil langsung dari berkas composer.json milik paket itu sendiri.
| Persyaratan | Batasan | Status | Catatan |
|---|---|---|---|
| PHP | >=8.4 <9.0 | Diperlukan | Composer menolak menginstal pada PHP 8.3 ke bawah, atau pada PHP 9. |
| Composer | 2.x | Diperlukan | Diperlukan untuk resolusi dependensi dan pembuatan autoloader. |
ext-mbstring | — | Diperlukan | Penanganan string multibyte untuk tata letak teks. |
ext-zlib | — | Diperlukan | Kompresi stream untuk objek Portable Document Format (PDF). |
ext-intl | — | Diperlukan | Layanan International Components for Unicode (ICU): teks dwiarah, pemenggalan baris, dan pemformatan yang peka lokal. |
ext-gd | — | Diperlukan | Pendekodean dan pemrosesan gambar raster untuk gambar tertanam. |
ext-curl | — | Diperlukan | Komunikasi bolak-balik jaringan: penandaan waktu RFC 3161 dan pengambilan aset jarak jauh. Pembuatan secara offline tidak menggunakannya, tetapi Composer tetap memerlukannya. |
ext-openssl | — | Diperlukan | Kriptografi untuk tanda tangan digital, struktur CMS, dan enkripsi. |
| Chrome or Chromium | — | Opsional | Hanya untuk perender Artisan (writeHtmlChrome()). |
| Gotenberg service | — | Opsional | Hanya untuk konversi office dan HTML melalui Gotenberg. |
| Python | 3.10+ | Opsional | Hanya untuk software development kit (SDK) Python. |
ext-mbstring dan ext-zlib sudah aktif pada sebagian besar build PHP; ext-intl, ext-gd, ext-curl, dan ext-openssl berbeda-beda menurut distribusi, jadi verifikasi keenamnya dengan php -m sebelum Anda memasang. Integrasi memeriksa ekstensi yang diperlukannya saat boot dan berhenti dengan pesan yang jelas jika ada yang tidak tersedia.
Memasang inti
Bagian berjudul “Memasang inti”Untuk membuat dan memeriksa berkas PDF melalui PHP, Anda hanya memerlukan mesin inti.
composer require nextpdf/coreCommit composer.lock agar setiap worker yang di-deploy memakai versi mesin yang sama. Setelah pemasangan, lanjutkan ke PDF pertama Anda.
Memasang integrasi framework
Bagian berjudul “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.
composer require nextpdf/laravelAuto-discovery mendaftarkan service provider dan facade Pdf. Setelah itu, publikasikan berkas konfigurasinya:
php artisan vendor:publish --tag=nextpdf-configLihat panduan pemasangan Laravel dan quickstart Laravel.
composer require nextpdf/symfonyDi 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.
composer require nextpdf/codeigniterCodeIgniter 4 menemukan kelas Services dan helper pdf() secara otomatis, sehingga Anda tidak perlu mendaftarkannya secara manual. Lihat panduan pemasangan CodeIgniter.
Memasang renderer atau layanan
Bagian berjudul “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.
composer require nextpdf/artisanPaket 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.
composer require nextpdf/cloudflare guzzlehttp/guzzlePerenderan 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.
composer require nextpdf/gotenberg guzzlehttp/guzzlePaket ini mengonversi dokumen office dan HTML melalui layanan Gotenberg. Anda menyediakan klien PSR-18 dan instance Gotenberg yang dapat dijangkau. Lihat panduan pemasangan Gotenberg.
Memasang server
Bagian berjudul “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/serverPaket 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-binaryLihat panduan pemasangan Connect dan quickstart Connect.
Memasang Python SDK
Bagian berjudul “Memasang Python SDK”Python SDK adalah klien bertipe untuk NextPDF Server yang sedang berjalan. Pasang dari Python Package Index (PyPI):
pip install nextpdfSDK ini memerlukan Python 3.10 atau lebih baru dan endpoint NextPDF Server yang dapat dijangkau. Lihat quickstart Python SDK.
Memverifikasi pemasangan
Bagian berjudul “Memverifikasi pemasangan”Pastikan setiap distribusi terpasang dengan benar sebelum Anda mulai menulis kode.
composer show nextpdf/coreBaris versi memastikan mesin sudah terpasang dan tersedia bagi autoloader.
php artisan package:discover --ansiOutput akan menampilkan nextpdf/laravel di antara paket yang ditemukan.
php bin/console debug:container nextpdfContainer akan melaporkan alias nextpdf.document dan layanan PdfFactory.
./vendor/bin/generate-skills --dry-run --list-toolsPerintah ini mem-boot registry dan mencetak alat yang dipaparkan pemasangan ini tanpa menjalankan server.
nextpdf versionString versi memastikan SDK dapat diimpor dengan bersih.