Entegrasyonlar

Genel bakış

NextPDF uzantıları, çekirdek Taşınabilir Belge Biçimi (PDF) motorunu uygulama çerçevelerine, tarayıcı işleyicilerine, edge hizmetlerine, derleme araçlarına ve eski sistem geçişlerine bağlar. Her uzantı bölümü aynı kılavuz yapısını izler: genel bakış, kurulum, hızlı başlangıç, yapılandırma, API, geliştirici kılavuzu, üretimde kullanım, güvenlik ve sorun giderme.

Uzantı haritası

Uzantı	Paket	Ne zaman kullanılır	Ana bölüm
Laravel	nextpdf/laravel	Laravel uygulamaları geliştirirken kapsayıcı bağlamaları, bir facade, yanıtlar ve kuyruk işleri gerektiğinde kullanın.	Laravel
Symfony	nextpdf/symfony	Symfony uygulamaları geliştirirken bir bundle, bağımlılık enjeksiyonu bağlamaları, Messenger işleri ve HTTP yanıtları gerektiğinde kullanın.	Symfony
CodeIgniter	nextpdf/codeigniter	CodeIgniter 4 uygulamaları geliştirirken hizmetler, bir kitaplık sarmalayıcısı, yanıtlar ve kuyruk işleri gerektiğinde kullanın.	CodeIgniter
Artisan	nextpdf/artisan	Chrome DevTools Protocol (CDP) ile HTML işleme, sayfa içe aktarma veya düşük düzeyli PDF inceleme araçları gerektiğinde kullanın.	Artisan
Cloudflare	nextpdf/cloudflare	Cloudflare Browser Rendering üzerinden işleme yaptığınızda, API erişimini güvenceye aldığınızda veya PDF’leri R2’ye arşivlediğinizde kullanın.	Cloudflare
Gotenberg	nextpdf/gotenberg	Bir Gotenberg hizmetiyle ofis belgelerini veya HTML’yi dönüştürdüğünüzde kullanın.	Gotenberg
TCPDF uyumluluğu	nextpdf/compat-legacy	TCPDF biçimindeki uygulama kodunu baştan yazmadan NextPDF’e geçirirken kullanın.	TCPDF uyumluluğu
Backport Builder	nextpdf/backport-builder	Daha eski PHP çalışma zamanları için sürüm yapıtlarını sürdürdüğünüzde kullanın.	Backport Builder

Seçim kılavuzu

İhtiyaç	Buradan başlayın	İşletim notu
Çerçeve yanıt yardımcıları	Laravel, Symfony veya CodeIgniter	Kapsayıcı ve yanıt entegrasyonu çerçeve paketine; belge oluşturma ise çekirdeğe aittir.
Piksel odaklı HTML işleme	Artisan veya Cloudflare	Ana makinede yerel Chrome CDP kullanacaksanız Artisan’ı seçin. İşlemenin edge’de yapılması gerektiğinde Cloudflare’i seçin.
Ofis dönüştürme	Gotenberg	Gotenberg’i zaman aşımı, boyut ve sunucu tarafı istek sahteciliği (SSRF) denetimleri bulunan harici bir hizmet sınırı olarak ele alın.
Eski TCPDF geçişi	TCPDF uyumluluğu	Eski bir çağrının desteklenip desteklenmediğini varsaymadan önce yöntem kapsamı tablosunu denetleyin.
Daha eski PHP dağıtımı	Backport Builder	Yalnızca derleme aracıdır; bir uygulama çalışma zamanı bağımlılığı olarak kurmayın.

Kılavuz yapısı

Her uzantı bölümü şu sayfa türlerini içerir:

Sayfa	Amaç
overview	Ürün sınırı, hedef kitle, desteklenen iş akışları ve sınırlamalar.
install	Kurulum komutları ve gerekli çalışma zamanı bağımlılıkları.
quickstart	Kopyalanabilir bir ilk çıktı veren en basit çalışan akış.
configuration	Desteklenen yapılandırma anahtarları, ortam değişkenleri, varsayılanlar ve etkileri.
api	Herkese açık sınıflar, yöntemler, parametreler, varsayılanlar, dönüş değerleri ve özel durumlar.
developer-guide	Uzantı mimarisi, yaşam döngüsü, uzantı noktaları ve kod düzeni.
production-usage	Dağıtım, güvenilirlik, performans, worker güvenliği ve gözlemlenebilirlik.
security-and-operations	Güven sınırları, güvenli varsayılanlar, gizli anahtarlar, dosya erişimi ve işletim denetimleri.
troubleshooting	Belirtiler, tanılama, olası nedenler ve düzeltici işlemler.

API tablosu kuralı

API tabloları kılavuz boyunca aynı sütunları kullanır; böylece paketleri karşılaştırmak için yeni bir düzen öğrenmeniz gerekmez.

Sütun	Anlamı
Simge	Tam nitelikli sınıf, yöntem, uç nokta, CLI komutu veya yapılandırma nesnesi.
Parametreler	Ad, tür, zorunluluk durumu, varsayılan ve kabul edilen değerler.
Varsayılan davranış	İsteğe bağlı girdiyi atladığınızda ne olur.
Döndürür	Dönüş türü veya çıktı yapıtı.
Şununla hata verir veya başarısız olur	Özel durum türü, HTTP durumu, doğrulama hatası veya işletim hatası modu.
Notlar	Güvenlik, worker güvenliği, uyumluluk veya performans ayrıntıları.

Çeviriye hazırlık

İngilizce kaynak, sonraki yerelleştirme süreçleri düşünülerek yazılmıştır: kısa bölümler, kararlı başlıklar, açık adlar, deyimsiz anlatım ve yinelenen yapılar için tablolar. Çeviri araçlarının bu özellikleri koruyabilmesi için yeni API sayfalarında yöntem adlarını, yapılandırma anahtarlarını, CLI bayraklarını ve özel durum adlarını kod biçiminde tutun.