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.

Gereksinim	Kısıtlama	Notlar
PHP	>=8.4 <9.0	Composer, PHP 8.3 ve altı sürümlerde ya da PHP 9 üzerinde kuruluma izin vermez.
Composer	2.7 veya daha yenisi	Bağımlılık çözümü ve otomatik yükleyici oluşturma için gereklidir.
ext-mbstring	Gerekli	Metin yerleşimi için çok baytlı dizgi işleme.
ext-zlib	Gerekli	Taşınabilir Belge Biçimi (PDF) nesnelerinde akış sıkıştırması.
Chrome veya Chromium	İsteğe bağlı	Yalnızca Artisan işleyicisi için (writeHtmlChrome()).
Gotenberg hizmeti	İsteğe bağlı	Yalnızca Gotenberg aracılığıyla ofis belgelerini ve HTML’i dönüştürmek için.
Python	3.10 veya daha yenisi	Yalnızca Python SDK’sı için.

ext-mbstring ve ext-zlib, desteklenen her PHP derlemesinde etkin halde gelir. Entegrasyonlar bunları başlatma sırasında denetler ve eksik olan varsa 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'iniz PHP üzerinden bir PDF oluşturun ve HTML'i PDF'e işleyin.

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

Entegrasyonlar Tam uzantı haritası ve seçim kılavuzu.

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