Pilih jalur Anda

Sekilas pandang

NextPDF menyediakan beberapa titik masuk. Pilihan yang tepat bergantung pada lingkungan tempat kode Anda berjalan dan jenis keluaran Portable Document Format (PDF) yang Anda butuhkan. Gunakan halaman ini untuk menetapkan tiga pilihan: distribusi mana yang akan dipasang, renderer Hypertext Markup Language (HTML) mana yang akan digunakan, dan kapan beban kerja membutuhkan Pro atau Enterprise.

Baca bagian yang sesuai dengan pertanyaan Anda, atau lihat sekilas ringkasan keputusan di bagian akhir.

Pilih distribusi

Mulailah dari cara aplikasi Anda memanggil mesin NextPDF. Gunakan baris pertama yang sesuai dengan situasi Anda.

Situasi Anda	Pasang	Mengapa
Proyek PHP biasa, pustaka, atau alat command-line interface (CLI)	NextPDF core (nextpdf/core)	Hanya mesinnya saja. Paket ini tidak membuat asumsi apa pun tentang framework dan tidak menjalankan layanan.
Aplikasi Laravel, Symfony, atau CodeIgniter	Integrasi framework yang sesuai	Anda mendapatkan container binding, response helper, dan queue job di atas core.
Layanan non-PHP, agen, atau runtime lain yang harus memanggil mesin melalui jaringan	NextPDF Server (nextpdf/server)	Satu layanan mengekspos mesin melalui Model Context Protocol (MCP), REST, dan gRPC.
Kode Python yang membutuhkan berkas PDF dari sebuah NextPDF Server	Python Software Development Kit (SDK) (pip install nextpdf)	Klien bertipe untuk server yang sedang berjalan. SDK ini tidak menyertakan mesin di dalamnya.

Dua hal yang mudah terlewat:

• Integrasi framework sudah mencakup core. Anda tidak perlu memasang keduanya secara terpisah. Adapter mendeklarasikan dan menyelesaikan nextpdf/core untuk Anda.
• Python SDK adalah sebuah klien, bukan mesin. SDK ini terhubung ke endpoint NextPDF Server. Pembuatan PDF terjadi di PHP pada server.

Pustaka atau layanan?

Jika aplikasi PHP Anda dapat menautkan ke pustaka, gunakan core atau integrasi framework. Dengan begitu, Anda menjalankan satu proses lebih sedikit dan memperoleh latensi terendah. Gunakan server ketika kode non-PHP membutuhkan mesin, atau ketika banyak pemanggil perlu berbagi satu layanan rendering.

Pilih renderer HTML

NextPDF dapat merender HTML menjadi PDF dengan empat cara. Pipeline bawaan menangani sebagian besar dokumen tanpa penyiapan tambahan. Gunakan ketiga paket renderer ketika Anda membutuhkan tata letak setara peramban atau perlu terhubung ke layanan yang sudah ada.

Perender	Paket	Tempat berjalannya	Pilih ketika
writeHtml() bawaan	nextpdf/core	Dalam proses, PHP murni	Anda menginginkan subset HTML dan Cascading Style Sheets (CSS) yang didukung tanpa peramban dan tanpa panggilan jaringan.
Artisan	nextpdf/artisan	Chrome headless di host	Anda membutuhkan tata letak Chrome penuh — flexbox, grid, selektor kompleks, web font — dengan teks yang dapat dipilih.
Cloudflare	nextpdf/cloudflare	Cloudflare Browser Rendering di edge	Proses rendering sebaiknya berada di edge, atau Anda ingin menjauhkan proses peramban dari host Anda sendiri.
Gotenberg	nextpdf/gotenberg	Layanan Gotenberg yang Anda operasikan	Anda mengonversi dokumen office (DOCX, XLSX) atau HTML melalui deployment Gotenberg yang sudah ada.

Cara membaca tabel:

• Mulailah dengan pipeline bawaan. Ini adalah jalur tercepat dan tidak memiliki dependensi eksternal. Sebelum Anda mengandalkan suatu properti, cocokkan dengan matriks dukungan CSS.
• Gunakan Artisan ketika tata letak melampaui subset yang didukung dan proses rendering sebaiknya tetap berada di infrastruktur Anda. Artisan meluncurkan proses Chrome, jadi rencanakan siklus hidupnya.
• Gunakan Cloudflare ketika Anda menginginkan ketepatan render peramban yang sama dan lebih memilih proses rendering di edge daripada proses peramban lokal.
• Gunakan Gotenberg untuk konversi dokumen office, atau ketika Anda sudah menjalankan Gotenberg dan ingin NextPDF mengendalikannya.

Perender memperluas permukaan ancaman

Secara baku, pipeline bawaan tidak menjalankan skrip apa pun dan tidak mengambil sumber daya jarak jauh. Artisan, Cloudflare, dan Gotenberg masing-masing merender melalui peramban atau layanan jaringan. Perlakukan HTML sebagai tidak tepercaya, dan baca halaman keamanan dan operasi setiap paket sebelum Anda meneruskan input yang dipengaruhi pengguna.

Kapan Anda membutuhkan Pro atau Enterprise

Mesin core menghasilkan, merender, dan memeriksa PDF tanpa biaya dan tanpa lisensi. NextPDF Pro dan NextPDF Enterprise adalah dua tingkat lisensi dari paket nextpdf/premium. Memasangnya menambahkan kemampuan tanpa mengubah API core.

Anda perlu	Tingkat	Kemampuan
Menandatangani PDF secara digital dengan baseline PDF Advanced Electronic Signatures (PAdES)	Pro	Implementasi penandatanganan dengan kunci perangkat lunak.
Menghasilkan keluaran PDF/A untuk arsip	Pro	Konformansi PDF/A dan profil pengarsipan.
Menyematkan faktur elektronik (Factur-X / ZUGFeRD)	Pro	Implementasi kontrak faktur elektronik.
Menandatangani dengan hardware security module (HSM)	Enterprise	Operasi kunci yang didukung perangkat keras.
Menerbitkan tanda tangan elektronik tersertifikasi	Enterprise	Alur kerja tanda tangan tersertifikasi dan cakupan kepatuhan penuh.

Dua aturan ini menjaga keputusan tetap realistis:

• Jika keluaran Anda berupa PDF tanpa tanda tangan dan bukan untuk arsip, core sudah lengkap. Anda tidak memerlukan lisensi.
• Ketika Anda memasang nextpdf/premium, integrasi framework dan server mendeteksinya secara otomatis. Keduanya mengekspos kemampuan tambahan melalui kunci container dan katalog alat yang sama. Aplikasi Anda tidak memerlukan perubahan kode untuk mengadopsinya.

Ringkasan keputusan

Distribusi

PHP biasa → core. Aplikasi framework → integrasi yang sesuai. Batas jaringan → server. Klien Python → Python SDK.

Perender HTML

Subset yang didukung, tanpa dependensi → writeHtml(). Kesetiaan peramban di host Anda → Artisan. Di edge → Cloudflare. Konversi office → Gotenberg.

Tingkat berlisensi

PDF tanpa tanda tangan → core. Penandatanganan, PDF/A, faktur elektronik → Pro. HSM atau tanda tangan tersertifikasi → Enterprise.

Masih ragu?

Pasang core, jalankan PDF pertama Anda, dan tambahkan paket hanya ketika ada kebutuhan konkret yang muncul. Anda dapat mengubah semua ini di kemudian hari.

Lihat juga

Pasang NextPDF Perintah tepat untuk setiap distribusi dan renderer.

PDF pertama Anda Hasilkan PDF dari PHP dan render HTML menjadi PDF.

Integrasi Peta ekstensi lengkap, panduan pemilihan, dan manual per paket.

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