Kılavuzlar

Bir bakışta

Kılavuzlar, NextPDF’i kodunuzun çalıştığı ortama bağlamanıza yardımcı olur. Bu sekme, üretim operasyonları kontrol listesiyle başlar, ardından kullanıma alma sırasını izleyerek beş alanı kapsar: çerçeve ve işleyici entegrasyonları, NextPDF Connect sunucusu, Python SDK, motor uzantısı yazımı ve sorun giderme. Aşağıdaki her bölüm, kendi merkez sayfasıyla başlar ve en sık kullanacağınız sayfaları listeler.

Kopyalanabilir, göreve yönelik bir tarif gerektiğinde Tarif defteri bölümünü kullanın. Doğrulanmış Application Programming Interface (API) yüzeyi ve destek matrisleri için Başvuru bölümünü kullanın.

Bir başlangıç noktası seçin

Bir PHP çerçevesi üzerinde geliştirme yapıyorsanız Entegrasyonlar ile başlayın. Çağrıyı yapan bileşenleriniz uzaktaysa, başka bir dilde yazılmışsa veya yapay zeka (AI) aracılarıysa NextPDF Connect ya da Python SDK ile başlayın. Motorun kendisini genişletiyorsanız Motoru genişletin ile başlayın.

Entegrasyonlar

Sekiz paket, çekirdek motoru çerçevelere, tarayıcı işleyicilerine, kenar hizmetlerine, derleme araçlarına ve eski sistemlerden geçiş yollarına bağlar. Her paket bölümü aynı el kitabı 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 — böylece birini öğrendiğinizde diğerlerinde de aynı düzenle ilerleyebilirsiniz.

Sayfa	Ne için kullanılır
Entegrasyonlar	Uzantı haritası ve seçim kılavuzu. Paket seçmeden önce bu sayfayı okuyun.
Entegrasyon API başvuruları dizini	Her çerçeve, işleyici, taşıma katmanı ve derleme aracı yüzeyinin hangi uzantı API sayfasında açıklandığını gösterir.
Laravel için NextPDF	Laravel için çerçeve bağdaştırıcısı.
Symfony için NextPDF	Symfony için çerçeve bağdaştırıcısı.
CodeIgniter için NextPDF	CodeIgniter için çerçeve bağdaştırıcısı.
NextPDF Artisan	Tarayıcı düzeyinde HTML işleme için Chrome işleyici köprüsü.
NextPDF Cloudflare	Cloudflare üzerinde kenar dağıtım yolu.
NextPDF Gotenberg	Gotenberg işleyici köprüsü.
TCPDF uyumluluğu	TCPDF’den geçiş yapan kod tabanları için uyumluluk katmanı.
NextPDF Backport Builder	Eski PHP çalışma zamanlarını hedefleyen derleme aracı.

NextPDF Connect

nextpdf/server paketi, motoru uzun ömürlü bir hizmet olarak çalıştırır: Model Context Protocol (MCP), Representational State Transfer (REST) ve gRPC üzerinden sunulan tek ve deterministik araç kayıt defteri; yüksek riskli araçlar için insan denetimli bir onay geçidinin arkasında çalışır.

Sayfa	Ne için kullanılır
NextPDF Connect	Bölüm merkezi: sunucu kavramları, yapılandırma ve operasyonlar.
Connect’e genel bakış	Paketin sınırları ve üç taşıma katmanı.
Connect hızlı başlangıcı	İlk çalıştırılabilir MCP el sıkışması ve buna karşılık gelen REST işleme isteği.
NextPDF Connect’i yapılandırma	MCP YAML dosyası ve NEXTPDF_* ortam değişkenleri.
NextPDF Connect API başvurusu	Kayıtlı her araç, gRPC sembolü, hata modeli girdisi ve hız sınırı için başvuru.
NextPDF Connect dağıtımı	RoadRunner işçi profilleri, Docker ve Redis destekli depolar.
Connect için güvenlik ve operasyonlar	Kimlik doğrulama, taşıma güvenliği ve tehdit modeli.

Her taşıma katmanının kendi başvuru sayfası vardır.

Sayfa	Ne için kullanılır
MCP taşıması	Standart giriş ve çıkış üzerinden JSON-RPC 2.0 çerçevelemesi.
REST taşıması	OpenAPI 3.1 sözleşmesi, taşıyıcı kimlik doğrulaması ve katman düzeyinde kısıtlanmış rotalar.
gRPC taşıması	nextpdf.connect.v1 hizmeti, sunucu akışı ve meta veriye dayalı kimlik doğrulaması.

Python SDK

Python uygulamaları, aracılar ve komut satırı için bir NextPDF Connect uç noktasıyla desteklenen, alıntıya hazır PDF çıkarma.

Sayfa	Ne için kullanılır
Python SDK	nextpdf Python paketi için bölüm merkezi.
Python SDK’sına genel bakış	SDK’nın ne yaptığı ve Connect ile nasıl ilişkilendiği.
Python SDK hızlı başlangıcı	pip install nextpdf ile kurun ve istemcinizi sunucunuza yönlendirin.
Python SDK API başvurusu	İstemci sınıfları, yöntemler ve türlendirilmiş sonuçlar.
Python CLI	Çıkarma iş akışları için komut satırı arayüzü.
Python MCP sunucusu	MCP kullanan aracılara SDK’yı sunma.

Motoru genişletin

Herkese açık Service Provider Interface (SPI), çatallama yapmadan yetenek eklemenizi sağlar: yazı tipleri, yerleşim motorları, olay dinleyicileri ve imzalama arka uçları için sözleşmeler sunar; bunların her biri açık bir kararlılık vaadiyle desteklenir.

Sayfa	Ne için kullanılır
Uzantı yazımı	Neleri genişletebileceğiniz ve bunları destekleyen kararlılık vaadi.
SPI kararlılığı kuralları	Uzantınızın güvenebileceği geriye dönük uyumluluk sözleşmesi.
Özel yazı tipleri: FontRegistry sözleşmesi	Kendi yazı tiplerinizi kaydetme ve dağıtma.
Özel yerleşim motorları ve metin yakalama	Yerleşim davranışını değiştirme veya yakalama.
Eylem tetikleyicileri ve olay dinleyicileri	Belge yaşam döngüsünü gözlemleme ve buna tepki verme.
KMS sağlayıcısı sözleşmesi	Anahtarları kendi Key Management Service (KMS) hizmetinizden sağlama.

Sorun giderme

Motorun kendi istisna sınıflandırmasına dayanan ve belirtiden çözüme götüren kayıtlar. Bir sınıf adıyla değil, gözlemlediğiniz belirtiyle başlayın.

Sayfa	Ne için kullanılır
Sorun giderme	Bilgi tabanı merkezi: kayıtların nasıl yapılandırıldığı ve nereden başlanacağı.
Sorun giderme: yazı tipleri ve etiketleme	Yazı tipi gömme ve yapı etiketleme hataları.
Sorun giderme: şifreleme ve izinler	Şifreleme, parola ve izin hataları.
Sorun giderme: bellek ve başarım	Bellek tavanları ve başarım sorunları.
Sorun giderme: PDF/A ve PDF/UA doğrulama	Arşivleme ve erişilebilirlik doğrulama hataları.
Sorun giderme: imzalar ve zaman damgaları	İmza ve zaman damgası doğrulama hataları.

Ayrıca bakınız

• Tarif defteri — PHP, Connect ve entegrasyonlar için göreve yönelik tarifler.
• Referans — doğrulanmış API yüzeyi, destek matrisleri ve hata başvurusu.
• NextPDF’e geçiş — başka bir PDF kitaplığından geçiş; Başlarken sekmesinde yer alır.
• NextPDF’in içinde — motorun neden bu şekilde davrandığını açıklayan Insider_ makaleleri.