NextPDF Connect kurulumu

Bir bakışta

Composer ile nextpdf/server paketini kurun. Ardından üç taşıma katmanı giriş noktasından birini çalıştırın. Çekirdek kurulum için yalnızca PHP 8.4 ve NextPDF motoru gerekir. Redis ve Premium isteğe bağlıdır.

Kurulum

composer require nextpdf/server

Bu komut nextpdf/core: ^3.0 paketini kurar. Paket php: >=8.4 <9.0 bildirir; bu nedenle Composer, paketi PHP 8.3 ve altında ya da PHP 9 üzerinde kurmayı reddeder.

Kavramsal genel bakış

Paket, library türünde bir Composer paketidir. Kurulduğunda vendor/bin/ dizinine dört konsol giriş noktası ekler:

• vendor/bin/nextpdf-mcp — Model Context Protocol (MCP) stdio sunucusu.
• vendor/bin/nextpdf-server — Representational State Transfer (REST) sunucusu (RoadRunner HTTP işçisi).
• vendor/bin/nextpdf-grpc — gRPC sunucusu (RoadRunner gRPC işçisi).
• vendor/bin/generate-skills — araç kataloğunu aracı becerileri biçiminde dışa aktarır.

Beşinci betik olan bin/nextpdf-prune, bakım görevleri için depoda yer alır. Bu betiği vendor/bin/ üzerinden değil, doğrudan çalıştırın.

Bir hizmet sağlayıcıya, paket kaydına veya çerçeve kaydına ihtiyacınız yoktur. Sunucu, bağımsız bir süreç olarak çalışır. Ana uygulamaya bağladığınız bir kütüphane değildir.

API yüzeyi

Composer, paketin çalışma zamanı bağımlılıklarını da kurar. Bu geçişli bağımlılıklar, Hypertext Transfer Protocol (HTTP) ve gRPC yığınlarını içerir:

• league/route ve nyholm/psr7 — REST yönlendirmesi ve PHP Standard Recommendation (PSR)-7 mesajları.
• spiral/roadrunner-http ve spiral/roadrunner-grpc — REST ve gRPC taşıma katmanları için RoadRunner işçi çalışma zamanları.
• psr/http-server-middleware ve psr/http-server-handler — REST işlem hattının uyguladığı PSR-15 ara katman sözleşmeleri.
• symfony/yaml — yapılandırma dosyası ayrıştırması.
• ramsey/uuid — istek ve kaynak tanımlayıcıları.

Bu paketleri doğrudan kurmayın. Composer bunları sizin için nextpdf/server paketinden çözümler.

Kod örneği — hızlı başlangıç

Kurulumu denetlemek için bir sunucu başlatmadan araç kataloğunu listeleyin:

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

Bu komut kayıt defterini başlatır, katman algılamasını çalıştırır ve bu kurulumun sunduğu araçları yazdırır. Liste, kurulu olan isteğe bağlı paketleri yansıtır. Bkz. /connect/tool-catalog/.

Kod örneği — üretim

Üretim kurulumu bağımlılığı sabitler ve geliştirme araçlarını dışarıda bırakır:

composer require nextpdf/server --no-dev
composer install --no-dev --optimize-autoloader --classmap-authoritative

REST ve gRPC taşıma katmanları için RoadRunner ikili dosyasını da kurun. RoadRunner, işçi havuzunu yöneten süreç denetleyicisidir. PHP paketi, denetleyiciyi değil, işçiyi sağlar:

./vendor/bin/rr get-binary

Uç durumlar ve dikkat edilecek noktalar

• İsteğe bağlı Redis. ext-redis uzantısı bir suggest öğesidir; require değildir. Bu uzantı olmadan REST sunucusu bellek içi hız sınırı, eşzamanlılık ve belge depolarını kullanır. Bu bellek içi depolar tek bir işçi için doğru sonuç verir, ancak çok işçili bir havuz genelinde paylaşılmaz. Çok işçili dağıtımlar için ext-redis uzantısını kurun ve Redis ortam değişkenlerini ayarlayın. Bkz. /connect/configuration/.

• İsteğe bağlı Premium. nextpdf/premium bir suggest öğesidir. Bu paketi sunucuyla birlikte kurduğunuzda kayıt defterinin katman algılama yoklamaları sağlayıcı sınıflarını bulur ve ek Pro ve Enterprise araçlarını kaydeder. Bu paket olmadan yalnızca çekirdek katalog sunulur. Bu, bir çalışma zamanı anahtarı değildir; composer require sırasında alınan bir paketleme kararıdır.

• MCP sunucusu RoadRunner gerektirmez. nextpdf-mcp, standart girdi ve çıktı (stdio) üzerinden JavaScript Object Notation Remote Procedure Call (JSON-RPC) konuşan yalın bir PHP sürecidir. RoadRunner yalnızca REST ve gRPC taşıma katmanları için gereklidir.

Performans

Composer bağımlılık çözümlemesi, kurulum süresi maliyetinin çoğunu oluşturur. Üretim imajlarında, soğuk başlatmada otomatik yükleme süresini düşük tutmak için --prefer-dist ve yetkili bir sınıf eşlemesi kullanın. Sunucunun kendi başlatma maliyeti, kayıt defteri taraması ve katman algılamasından oluşur. Bu sayfadaki performance_budget değeri, söz konusu başlatma maliyetini sınırlar.

Güvenlik notları

Yalnızca resmî Packagist paketi nextpdf/server üzerinden kurun. Dağıtılan araç kataloğunun yeniden üretilebilir olması için sürümü composer.json içinde sabitleyin ve composer.lock dosyasını commit edin. Ağ üzerinden çalışan taşıma katmanları, sağlık denetimi dışındaki herhangi bir uç noktayı sunmadan önce bir application programming interface (API) anahtarı gerektirir; bkz. /connect/security-and-operations/.

Uyumluluk

Bu sayfa yalnızca kurulum mekaniğini açıklar. Protokol ve güvenlik uyumluluğuna ilişkin kaynaklar /transports/mcp/, /transports/rest/, /transports/grpc/ ve /connect/security-and-operations/ sayfalarında sabitlenmiştir.

Ticari bağlam

Çekirdek kurulum tam olarak işlevseldir. Belge oluşturma, inceleme ve tanılamayı üç taşıma katmanının tamamı üzerinden yürütür. nextpdf/premium eklemek, taşıma veya kimlik doğrulama modelini değiştirmeden kataloğu genişletir.

Ayrıca bkz.

• /connect/overview/ — paketin neler sağladığı
• /connect/quickstart/ — ilk çalıştırılabilir etkileşim
• /connect/configuration/ — ortam değişkenleri ve yapılandırma dosyası
• /connect/deployment/ — RoadRunner, Docker ve birleşik taşıma dağıtımı
• /connect/tool-catalog/ — bu kurulumun hangi araçları sunduğu