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.

Kitaplık mı, hizmet mi?

PHP uygulamanız kitaplığı doğrudan kullanabiliyorsa, core’u veya bir çerçeve entegrasyonunu kullanın. Böylece bir süreç daha az çalışır ve en düşük gecikmeyi elde edersiniz. PHP dışı kod motora ihtiyaç duyduğunda veya birçok çağıranın tek bir işleme hizmetini paylaşması gerektiğinde sunucuyu kullanın.

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.

İşleyiciler tehdit yüzeyini genişletir

Varsayılan olarak, yerleşik işlem hattı hiçbir komut dosyası çalıştırmaz ve hiçbir uzak kaynağı getirmez. Artisan, Cloudflare ve Gotenberg’in her biri bir tarayıcı veya bir ağ hizmeti aracılığıyla işleme yapar. HTML’yi güvenilmez olarak değerlendirin ve kullanıcının etkileyebildiği girdiyi iletmeden önce her paketin güvenlik ve operasyonlar sayfasını okuyun.

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, ücretli ürün hattı olan NextPDF Premium’un iki lisanslı sürümüdür. Bu paketi kurmak, core API’sini değiştirmeden yetenekler ekler.

Core, PDF Advanced Electronic Signatures (PAdES) B-B ve B-T temel seviyelerinde yazılım anahtarlarıyla zaten imzalar. Kademeler, bu seviyelerin bittiği yerde başlar.

İhtiyacınız	Kademe	Yetenek
Gelişmiş imzalama iş akışlarını çalıştırma: uzaktan, cloud-KMS veya sıralı imzalama	Pro	Core B-B / B-T temel seviyesinin üzerine kurulan imzalama iş akışı uygulamaları.
Arşivlik PDF/A çıktısı üretme	Enterprise	PDF/A uyumluluğu ve arşiv profilleri.
Bir elektronik fatura (Factur-X / ZUGFeRD) gömme	Pro	E-fatura sözleşme uygulamaları.
İmzaları PAdES B-LT / B-LTA ile uzun vadede geçerli tutma	Enterprise	Arşiv geçerliliği için Document Security Store ve belge zaman damgaları.
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.

Pro veya Enterprise satın alma

Lisanslı bir kademeye gerçekten ihtiyaç duyduğunuzda, ticari lisanslar Merchant of Record’umuz aracılığıyla satılır — siparişinizin satıcısı (seller of record) konumundaki yetkili bir bayi — ve lisansınız, Son Kullanıcı Lisans Sözleşmesi (EULA) kapsamında PATEON tarafından verilir. Lisans portalından başlarsınız ve sizi, fiyatın, varsa verginin ve faturanızın işlendiği Merchant of Record’umuzun ödeme akışı üzerinden yönlendiririz.

Tam yol, iki sözleşmeli model (satın alma ile lisans) ve faturalandırma ile ürün yardımı için kiminle iletişime geçeceğiniz için bkz. Satın alma ve lisanslama.

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, e-fatura → Pro. PDF/A, 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 kurunHer dağıtım ve işleyici için tam komut.

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

EntegrasyonlarTam 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.