NextPDF'i kurun

Genel bakış

Herhangi bir NextPDF dağıtımını tek bir paket yöneticisi komutuyla kurun. PHP dağıtımları Composer’ı, Python yazılım geliştirme kiti (SDK) ise pip’i kullanır. Geliştirdiğiniz bileşene uygun sekmeyi seçin. Komutu çalıştırdıktan sonra bu sayfanın altından sonucu doğrulayın.

Tek motor, birçok giriş kapısı

Çekirdek motor nextpdf/core paketidir. Çerçeve entegrasyonları, Köprü Metni İşaretleme Dili (HTML) işleyicileri, sunucu ve Python istemcisi; her biri çekirdeğin üzerine ilgili paketi ekler. Bunlar çekirdek motorun yerini almaz; onu sizin yerinize kurar.

Gereksinimler

NextPDF, tek bir modern çalışma zamanını hedefler. Bu kısıtlamalar doğrudan paketlerin kendi composer.json dosyalarında tanımlıdır.

Paketlerin kendi composer.json dosyalarından okunan NextPDF çalışma zamanı gereksinimleri

Gereksinim	Kısıtlama	Durum	Notlar
PHP	>=8.4 <9.0	Gerekli	Composer, PHP 8.3 ve altında veya PHP 9 üzerinde yüklemeyi reddeder.
Composer	2.x	Gerekli	Bağımlılık çözümlemesi ve autoloader oluşturma için gereklidir.
ext-mbstring	—	Gerekli	Metin düzeni için çok baytlı dize işleme.
ext-zlib	—	Gerekli	Portable Document Format (PDF) nesneleri için akış sıkıştırma.
ext-intl	—	Gerekli	International Components for Unicode (ICU) hizmetleri: iki yönlü metin, satır kesme ve yerel ayara duyarlı biçimlendirme.
ext-gd	—	Gerekli	Gömülü görüntüler için raster görüntü kod çözme ve işleme.
ext-curl	—	Gerekli	Ağ gidiş dönüşleri: RFC 3161 zaman damgası ve uzak varlık getirme işlemleri. Çevrimdışı oluşturma bunu kullanmaz, ancak Composer yine de bunu gerektirir.
ext-openssl	—	Gerekli	Dijital imzalar, CMS yapıları ve şifreleme için kriptografi.
Chrome or Chromium	—	İsteğe bağlı	Yalnızca Artisan işleyicisi (writeHtmlChrome()) için.
Gotenberg service	—	İsteğe bağlı	Yalnızca Gotenberg aracılığıyla ofis ve HTML dönüştürme için.
Python	3.10+	İsteğe bağlı	Yalnızca Python software development kit (SDK) için.

ext-mbstring ve ext-zlib, çoğu PHP derlemesinde etkin halde gelir; ext-intl, ext-gd, ext-curl ve ext-openssl ise dağıtıma göre değişir, bu nedenle kurulumdan önce altı eklentinin tümünü php -m ile doğrulayın. Entegrasyonlar, ihtiyaç duydukları eklentileri başlatma sırasında denetler ve herhangi biri eksikse açık bir mesajla durur.

Çekirdeği kurun

PHP üzerinden PDF dosyaları oluşturmak ve incelemek için yalnızca çekirdek motora ihtiyacınız vardır.

composer require nextpdf/core

Dağıtımdaki her işçinin aynı motor sürümünü kullanması için composer.lock dosyasını sürüm denetimine ekleyin. Kurulumdan sonra İlk PDF’iniz sayfasına geçin.

Bir çerçeve entegrasyonu kurun

Konteyner bağlamalarını, yanıt yardımcılarını ve kuyruk işlerini kullanmak için tek bir çerçeve bağdaştırıcısı kurun. Her bağdaştırıcı nextpdf/core paketini bağımlılık olarak bildirir ve sizin yerinize çözer.

Laravel

composer require nextpdf/laravel

Otomatik keşif hizmet sağlayıcıyı ve Pdf cephesini kaydeder. Ardından yapılandırma dosyasını yayımlayın:

php artisan vendor:publish --tag=nextpdf-config

Şu kaynaklara bakın: Laravel kurulum kılavuzu ve Laravel hızlı başlangıç kılavuzu.

Symfony

composer require nextpdf/symfony

Paket, Symfony Flex uygulamasında kendini kaydeder. Flex kullanmayan bir uygulamada NextPDF\Symfony\NextPdfBundle öğesini config/bundles.php dosyasına kendiniz ekleyin. Symfony kurulum kılavuzuna bakın.

CodeIgniter

composer require nextpdf/codeigniter

CodeIgniter 4, Services sınıfını ve pdf() yardımcısını otomatik olarak keşfeder; bu nedenle elle kayıt yapmanız gerekmez. CodeIgniter kurulum kılavuzuna bakın.

Bir işleyici veya hizmet kurun

NextPDF, HTML’i üç farklı yolla PDF’e işler. İşlemenin nerede gerçekleşmesini istediğinize göre uygun seçeneği kurun. Bu seçeneklerin hiçbiri, çekirdek motordaki yerleşik saf PHP HTML işlem hattı olan writeHtml() işlevinin yerini almaz.

Artisan (Chrome)

composer require nextpdf/artisan

Bu paket, Chrome DevTools Protocol (CDP) aracılığıyla headless Chrome üzerinden işlemeyi ekler. Ayrıca ana makinenin erişebileceği bir Chrome veya Chromium ikili dosyasına ihtiyacınız vardır. Kurulumdan sonra bir belge üzerinde writeHtmlChrome() işlevini çağırın. Artisan hızlı başlangıç kılavuzuna bakın.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

İşleme, uçta Cloudflare Browser Rendering üzerinden çalışır. Köprü yalnızca PHP Standards Recommendation (PSR) kapsamındaki PSR-18 ve PSR-17 sözleşmelerine bağlıdır; bu nedenle kendi Köprü Metni Aktarım Protokolü (HTTP) istemcinizi siz sağlarsınız (burada Guzzle gösterilmiştir). Cloudflare kurulum kılavuzuna bakın.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

Bu paket, bir Gotenberg hizmeti aracılığıyla ofis belgelerini ve HTML’i dönüştürür. Bir PSR-18 istemcisini ve erişilebilir bir Gotenberg örneğini siz sağlarsınız. Gotenberg kurulum kılavuzuna bakın.

İşleyiciler PHP dışına uzanır

Artisan bir tarayıcı işlemi başlatır; Cloudflare ve Gotenberg ise bir ağ hizmeti çağırır. HTML’i güvenilmeyen kabul edin. Kullanıcı tarafından etkilenebilen girdiyi işlemeden önce her paketin güvenlik ve operasyon sayfasını okuyun.

Sunucuyu kurun

NextPDF Server (Connect olarak da adlandırılır) bağımsız bir hizmettir. Motoru Model Context Protocol (MCP), Representational State Transfer (REST) ve gRPC üzerinden sunar.

composer require nextpdf/server

Paket, vendor/bin/ dizinine konsol giriş noktaları ekler; bunlar arasında vendor/bin/nextpdf-mcp (MCP stdio sunucusu) ve vendor/bin/nextpdf-server (REST sunucusu) yer alır. REST ve gRPC aktarımları için ayrıca RoadRunner ikili dosyası gerekir:

./vendor/bin/rr get-binary

Şu kaynaklara bakın: Connect kurulum kılavuzu ve Connect hızlı başlangıç kılavuzu.

Python SDK’yı kurun

Python SDK, çalışan bir NextPDF Server için türleri tanımlı bir istemcidir. Python Package Index (PyPI) üzerinden kurun:

pip install nextpdf

SDK, Python 3.10 veya daha yenisini ve erişilebilir bir NextPDF Server uç noktasını gerektirir. Python SDK hızlı başlangıç kılavuzuna bakın.

Kurulumu doğrulayın

Kod yazmaya başlamadan önce her dağıtımın doğru kurulduğunu onaylayın.

Core / PHP

composer show nextpdf/core

Bir sürüm satırı, motorun kurulduğunu ve otomatik yükleyici tarafından kullanılabildiğini doğrular.

Laravel

php artisan package:discover --ansi

Çıktıda, keşfedilen paketler arasında nextpdf/laravel paketi listelenir.

Symfony

php bin/console debug:container nextpdf

Konteyner, nextpdf.document takma adını ve PdfFactory hizmetini bildirir.

Server

./vendor/bin/generate-skills --dry-run --list-tools

Bu komut, kayıt defterini başlatır ve sunucuyu başlatmadan bu kurulumun sunduğu araçları yazdırır.

Python

nextpdf version

Bir sürüm dizgisi, SDK’nın sorunsuz biçimde içe aktarıldığını doğrular.

Ayrıca bakın

İlk PDF'inizPHP üzerinden bir PDF oluşturun ve HTML'i PDF'e işleyin.

Yolunuzu seçinUygulamanıza hangi dağıtımın ve HTML işleyicisinin uygun olduğuna karar verin.

Satın alma ve lisanslamaMerchant of Record'umuz aracılığıyla bir Pro veya Enterprise lisansı satın alın, ardından kurun ve etkinleştirin.

EntegrasyonlarTam uzantı haritası ve seçim kılavuzu.

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