Yolunuzu seçin

Bir bakışta

NextPDF size birden fazla başlangıç noktası sunar. Doğru seçim, kodunuzun nerede çalıştığına ve hangi tür Portable Document Format (PDF) çıktısına ihtiyaç duyduğunuza bağlıdır. Bu sayfayı üç karar için kullanın: hangi dağıtımı kuracağınız, hangi Hypertext Markup Language (HTML) işleyicisini kullanacağınız ve bir iş yükü için ne zaman Pro veya Enterprise gerektiği.

Sorunuzla eşleşen bölümü okuyun veya sondaki karar özetini gözden geçirin.

Bir dağıtım seçin

Uygulamanızın motoru nasıl çağırdığından başlayın. Durumunuza uyan ilk satırı kullanın.

Durumunuz	Kurulum	Neden
Yalın bir PHP projesi, bir kitaplık veya bir command-line interface (CLI) aracı	NextPDF core (`nextpdf/core`)	Yalnızca motor. Hiçbir çerçeve varsayımında bulunmaz ve bir hizmet çalıştırmaz.
Bir Laravel, Symfony veya CodeIgniter uygulaması	Eşleşen çerçeve entegrasyonu	Core’a ek olarak konteyner bağlamaları, yanıt yardımcıları ve kuyruk işleri elde edersiniz.
Motoru ağ üzerinden çağırması gereken PHP dışı bir hizmet, aracı veya başka bir çalışma zamanı	NextPDF Server (`nextpdf/server`)	Tek bir hizmet, motoru Model Context Protocol (MCP), REST ve gRPC üzerinden sunar.
Bir NextPDF Server’dan PDF dosyalarına ihtiyaç duyan Python kodu	Python Software Development Kit (SDK) (`pip install nextpdf`)	Çalışan bir sunucuya yönelik tip tanımlı bir istemci. Motoru gömmez.

Kolayca gözden kaçabilecek iki nokta var:

Bir çerçeve entegrasyonu core’u içerir. İkisini ayrı ayrı kurmazsınız. Adaptör, nextpdf/core bağımlılığını sizin için bildirir ve çözer.
Python SDK bir motor değil, bir istemcidir. Bir NextPDF Server uç noktasına bağlanır. PDF oluşturma, sunucuda PHP içinde gerçekleşir.

Bir HTML işleyicisi seçin

NextPDF, HTML’yi dört yolla PDF’ye işleyebilir. Yerleşik işlem hattı, çoğu belgeyi ek kurulum gerektirmeden işler. Tarayıcı kalitesinde bir yerleşime ihtiyaç duyduğunuzda veya mevcut bir hizmete bağlanmanız gerektiğinde üç işleyici paketini kullanın.

İşleyici	Paket	Nerede çalışır	Ne zaman seçmeli
Yerleşik `writeHtml()`	`nextpdf/core`	Süreç içinde, saf PHP	Tarayıcı veya ağ çağrısı kullanmadan, desteklenen bir HTML ve Cascading Style Sheets (CSS) alt kümesi istiyorsunuz.
Artisan	`nextpdf/artisan`	Ana makinede headless Chrome	Seçilebilir metinle birlikte tam Chrome yerleşimine — flexbox, grid, karmaşık seçiciler, web yazı tipleri — ihtiyacınız var.
Cloudflare	`nextpdf/cloudflare`	Uçta Cloudflare Browser Rendering	İşleme uçta yapılmalı veya tarayıcı süreçlerini kendi ana makinelerinizden uzak tutmak istiyorsunuz.
Gotenberg	`nextpdf/gotenberg`	İşlettiğiniz bir Gotenberg hizmeti	Ofis belgelerini (DOCX, XLSX) veya HTML’yi mevcut bir Gotenberg dağıtımı aracılığıyla dönüştürüyorsunuz.

Tabloyu şöyle okuyun:

Önce yerleşik işlem hattıyla başlayın. En hızlı yoldur ve dış bağımlılık gerektirmez. Bir özelliğe güvenmeden önce, bunu CSS destek matrisine göre kontrol edin.
Bir yerleşim, desteklenen alt kümenin ötesine geçtiğinde ve işlemenin kendi altyapınızda kalması gerektiğinde Artisan’ı kullanın. Bir Chrome süreci başlatır, bu nedenle o yaşam döngüsünü planlayın.
Aynı tarayıcı doğruluğunu istediğinizde ve uçta işlemeyi yerel tarayıcı süreçlerine tercih ettiğinizde Cloudflare’ı kullanın.
Ofis belgelerini dönüştürmek için veya zaten Gotenberg çalıştırıyorsanız ve onu NextPDF’in yönetmesini istiyorsanız Gotenberg’i kullanın.

Ne zaman Pro veya Enterprise gerekir

Core motoru, PDF’leri ücretsiz olarak ve lisans gerektirmeden oluşturur, işler ve inceler. NextPDF Pro ve NextPDF Enterprise, nextpdf/premium paketinin iki lisanslı kademesidir. Bu paketi kurmak, core API’sini değiştirmeden yetenekler ekler.

İhtiyacınız	Kademe	Yetenek
Bir PDF’yi PDF Advanced Electronic Signatures (PAdES) temel seviyesiyle dijital olarak imzalama	Pro	Yazılım anahtarıyla imzalama uygulamaları.
Arşivlik PDF/A çıktısı üretme	Pro	PDF/A uyumluluğu ve arşiv profilleri.
Bir elektronik fatura (Factur-X / ZUGFeRD) gömme	Pro	E-fatura sözleşme uygulamaları.
Bir donanım güvenlik modülü (HSM) ile imzalama	Enterprise	Donanım destekli anahtar işlemleri.
Nitelikli elektronik imzalar verme	Enterprise	Nitelikli imza iş akışı ve uyumluluk yüzeyi (byte-identical değil).

İki kural kararı net tutar:

Çıktınız imzasız ve arşiv amaçlı olmayan PDF’lerse, core eksiksizdir. Bir lisansa ihtiyacınız yok.
Bir kez nextpdf/premium paketini kurduğunuzda, çerçeve entegrasyonları ve sunucu onu otomatik olarak algılar. Ek yetenekleri aynı konteyner anahtarları ve araç kataloğu aracılığıyla sunarlar. Bunu benimsemek için uygulamanızda kod değişikliği yapmanız gerekmez.

Karar özeti

dağıtım

Yalın PHP → core. Çerçeve uygulaması → eşleşen entegrasyon. Ağ sınırı → sunucu. Python istemcisi → Python SDK.

HTML işleyicisi

Desteklenen alt küme, bağımlılık yok → writeHtml(). Kendi ana makinelerinizde tarayıcı doğruluğu → Artisan. Uçta → Cloudflare. Ofis dönüştürme → Gotenberg.

Lisanslı kademe

İmzasız PDF’ler → core. İmzalama, PDF/A, e-fatura → Pro. HSM veya nitelikli imzalar → Enterprise.

Hâlâ emin değil misiniz?

Önce core’u kurun, İlk PDF’inizi çalıştırın ve yalnızca somut bir gereksinim ortaya çıktığında bir paket ekleyin. Bunların hepsini daha sonra değiştirebilirsiniz.

Ayrıca bakınız

NextPDF'i kurun Her dağıtım ve işleyici için tam komut.

İlk PDF'iniz PHP'den bir PDF oluşturun ve HTML'yi PDF'ye işleyin.

Entegrasyonlar Tam uzantı haritası, seçim kılavuzu ve paket başına kılavuzlar.

Bağlanın (sunucu) Motoru MCP, REST ve gRPC üzerinden bir ağ hizmeti olarak çalıştırın.