Bir entegrasyon seçin

Kullanım senaryonuzu, onu karşılayan entegrasyonla eşleştirmek için bu sayfayı kullanın. Her öneri yalnızca paketin composer.json açıklamasına ve belirtilen amacına dayanır; ikisi de doğrudan kaynak deposundan okunur. İki entegrasyonun kapsamı örtüştüğünde, bu sayfa onları birbirinden ayıran etkeni belirtir; böylece güvenle seçim yapabilirsiniz.

Durumunuza uyan satırı bulun ve oradan başlayın.

Buradan başlayın: elinizde ne var?

Elinizde …	Kullanın	Neden (doğrulanmış amaç)
Bir Laravel 12 uygulaması	`nextpdf/laravel`	Laravel çerçeve entegrasyonu: service provider, facade ve PDF yanıt yardımcıları.
Bir Symfony 7 uygulaması	`nextpdf/symfony`	Symfony bundle: bağımlılık enjeksiyonu (DI) hizmetleri ve PDF yanıt yardımcıları.
Bir CodeIgniter 4 uygulaması	`nextpdf/codeigniter`	CodeIgniter 4 hizmetleri, kitaplık sarmalayıcısı ve PDF yanıt yardımcıları.
Çerçeve içermeyen bir PHP uygulaması	`nextpdf/core` doğrudan	Çerçeve entegrasyonu gerekmez; motor yalın bir kitaplıktır.
Tarayıcı tabanlı bir CSS motoru gerektiren ve Chrome çalıştırabildiğiniz HTML	`nextpdf/artisan`	Tarayıcı düzeyinde CSS yerleşimi gerektiren HTML için Chrome DevTools Protocol (CDP) işleyicisi.
DOCX, XLSX veya ODT gibi dönüştürülecek bir Office belgesi	`nextpdf/gotenberg`	Bir Gotenberg mikrohizmeti aracılığıyla Office’ten PDF’ye dönüştürme.
Çalıştırılacak bir tarayıcı süreci olmadan işleme gereksinimi	`nextpdf/cloudflare`	Edge’de Cloudflare Browser Rendering API aracılığıyla sunucusuz işleme.
Eski bir PDF kitaplığına göre yazılmış kod	`nextpdf/compat-legacy`	Eski PDF kitaplığı uyumluluk katmanı; çağrı noktalarını yeniden yazmadan NextPDF çağrısı yapın.
PHP 8.1 / 7.4 ile sınırlı kalmış bir çalışma zamanı	`nextpdf/backport-builder`	Motorun 8.1 / 7.4 hedefini oluşturan Rector sürüm düşürme iş hattı.
Uzak çağrı yapanlar, başka bir dil veya bir AI sistemi	`nextpdf/server`	NextPDF Connect: uzaktan yürütme için Representational State Transfer (REST), gRPC ve Model Context Protocol arayüzü.

İki entegrasyonun da uyabileceği durumlar

HTML’i PDF’ye işleme: Artisan, Gotenberg, Cloudflare ve core karşılaştırması

Bu üç işleyici köprüsünün tamamı işaretlemeyi PDF’ye dönüştürür. Farkları kalitede değil, çalışma biçimlerindedir. Seçiminizde belirleyici etken olarak bu işleyiş farkını kullanın.

nextpdf/artisan, headless Chrome’u Chrome DevTools Protocol üzerinden çalıştırır. Uygulamanın erişebileceği bir Chrome sürecine ihtiyaç duyar. Bu süreci çalıştırabildiğinizde ve belge tarayıcı CSS motoru gerektirdiğinde bunu seçin.
nextpdf/gotenberg, süreç dışında çalışan bir Gotenberg mikrohizmetini HTTP üzerinden çağırır. İşlemenin kendi hizmetinde yalıtılması gerektiğinde veya girdi bir Office belgesi olduğunda bunu seçin. Üçü arasında, belirtilen amacı Office’ten PDF’ye dönüştürmeyi içeren tek seçenek Gotenberg’dir.
nextpdf/cloudflare, Cloudflare Browser Rendering API’yi çağırır. Çalıştırılacak veya yamalanacak bir tarayıcı süreci olmadan edge/serverless işleme istediğinizde bunu seçin.
Süreç içi NextPDF core HTML iş hattı, yukarıdakilerin hiçbirine ihtiyaç duymaz. Bir işleyici köprüsünü yalnızca süreç içi iş hattı, belgenin gereksinim duyduğu yerleşim sadakatini veya süreç yalıtımını sağlayamadığında kullanın. Köprü kullanımı, bu adımın bilinçli olarak devredildiği anlamına gelir; varsayılan yol değildir.

İki HTTP köprüsü (nextpdf/gotenberg, nextpdf/cloudflare), ana uygulama tarafından sağlanan bir PSR-18 HTTP istemcisine ihtiyaç duyar. Tarifleri, bir aktarım hatasını ve başarısız bir HTTP durumunu ayrı sonuçlar olarak ele alır.

Bir Office belgesini dönüştürme

nextpdf/gotenberg, doğrulanmış composer.json açıklamasında Office’ten PDF’ye dönüştürme amacı belirtilen entegrasyondur. Diğer işleyici köprüleri, Office girdisini değil HTML işlemeyi tanımlar. Kaynak DOCX/XLSX/ODT ise bu entegrasyonu kullanın.

Eski bir PDF kitaplığından geçiş yapma

Belirtilen amacına göre nextpdf/compat-legacy, eski bir PDF kitaplığına göre yazılmış kod tabanları için bir uyumluluk katmanıdır. Mevcut çağrı noktalarının, siz onları yeniden yazmadan önce NextPDF’ye erişmesini sağlar. Bunu kalıcı bir çalışma zamanı bağımlılığı olarak değil, kaldırılması planlanan bir geçiş yardımcısı olarak ele alın. Yeni kod, doğrudan nextpdf/core (veya ilgili çerçeve entegrasyonu) çağrısı yapmalıdır.

PHP 8.1 veya 7.4 üzerinde çalıştırma

Her ekosistem paketi PHP >=8.4 <9.0 bildirir. nextpdf/backport-builder tam olarak bu kısıt için vardır: belirtilen amacı, PHP 8.1+ (ve 7.4 hedefi) yapıtı oluşturan bir Rector sürüm düşürme iş hattıdır. Uygulamanız için bir çalışma zamanı bağımlılığı değil, bir derleme aracıdır. Geriye taşınmış motoru üretmek için derleyiciyi çalıştırın, ardından o motoru dağıtın.

PHP olmayan çağrı yapan veya bir AI aracısı

nextpdf/server (NextPDF Connect), motoru bir REST API, bir gRPC hizmeti ve Model Context Protocol üzerinden sunar. Çağıran taraf uzakta olduğunda, başka bir dilde olduğunda veya bir PHP kitaplığı yerine bir araç uç noktasını tüketen bir AI sistemi olduğunda bunu seçin. Aynı süreçteki bir PHP uygulaması, bir ağ atlaması eklemek yerine nextpdf/core veya bir çerçeve entegrasyonu kullanmalıdır.

Birden fazla entegrasyonu birlikte kullanma

Bir çerçeve entegrasyonu ve bir işleyici köprüsü farklı katmanlarda çalışır; bu nedenle her ikisini de kurabilirsiniz. Çerçeve entegrasyonu, konteyner bağlantısını ve HTTP yanıtını yönetir; işleyici köprüsü ise işleme arka ucunu üstlenir. Birleştirilmiş bir bağımlılık kümesini çözerken, her paketin hangi nextpdf/core sürümlerini kabul ettiğini denetleyin. entegrasyon Cookbook dizini içindeki core kısıtı başvurusu temel doğru kaynaktır. Her kombinasyona özgü tarifler ilgili depolarda bulunur ve bu tariflere o dizinden bağlantı verilir.

Ayrıca bakınız

Entegrasyon Cookbook — paket ve core kısıtı başvurusu ile tarif bağlantı dizini.
Tarif kuralları — çalıştırılabilir her tarifin uyduğu sözleşmeler.