Çıktı işlem hattı

Bir bakışta

NextPDF Enterprise, NextPDF Pro çıktı-işlem-hattı manifestolarının büyük ölçekli toplu yürütmesini, yapılandırılabilir bir eşzamanlılık sınırı ve tamamlanan çıktılar üzerinde isteğe bağlı bir uyumluluk aktarımıyla koordine eder. Pro çıktı işlem hattının üzerindeki toplu katmandır.

Kullanılabilirlik ve lisanslama

Bu yetenek NextPDF Enterprise (nextpdf/enterprise) ile sunulur ve bir Enterprise katmanı lisans zarfıyla etkinleşir. Bu yetkilendirmeye sahip olmayan bir dağıtım, yeteneğin sınıflarını yüklemez. Sürümleri karşılaştırın ve bir lisans alın.

Enterprise parti yüzeyi, geçit değil bir ön koşul olan Pro çıktı işlem hattının (pro.output.pipeline) üzerine kurulur. Özellik başına ayrı bir yetenek kodu yoktur; parti düzenleyicisi ve uyumluluk aktarımı, lisanslı nextpdf/enterprise paketinin kurulu olduğu her yerde kullanılabilir.

Kurulum

composer require nextpdf/enterprise:^3

Kavramsal genel bakış

BatchPipelineOrchestrator, birçok PipelineManifest örneğini tek bir parti olarak yürütür. Her manifesto Pro PipelineExecutor üzerinden çalıştırılır; düzenleyici, parti koordinasyonu, sınırlı-kaynak koruması (parti başına manifesto sayısı sınırlanmıştır), parti başına zaman aşımı işleme ve isteğe bağlı bir uyumluluk aktarımı ekler.

BatchPipelineConfig üç şeyi denetler: en yüksek eşzamanlı çalışan geri çağrısı sayısı, milisaniye cinsinden isteğe bağlı bir genel parti zaman aşımı ve işlem hattı tamamlandıktan sonra her çıktıda bir uyumluluk denetimi çalışıp çalışmayacağı. Uyumluluk denetimi etkinleştirildiğinde, ComplianceHandoff, türetilmiş her PDF’i Enterprise uyumluluk ağ geçidi üzerinden yeniden doğrulayan bir işlem hattı adımı olarak tümleşir; böylece işlem hattınca değiştirilen bir belge, değiştirilmeden önceki durumundan güvenilmek yerine yeniden denetlenir.

Üretim dağıtımlarında, paralel çalışan sevki ve geri basınç ayrı bir yürütme yardımcı hizmeti tarafından işlenir; burada açıklanan PHP düzenleyicisi parti koordinasyonunu ve uyumluluk-aktarımı mantığını sağlar ve doğrudan istek işleyicileri tarafından değil, iş çalışanı tarafından çağrılır.

Neden bu şekilde çalışır

Yüksek hacimli parti üretimi iki kaygıya ayrılır: hangi manifestoların hangi garantiler altında çalışacağını koordine etmek ve ham paralel iş hacmini yürütmek. NextPDF, koordinasyon ve uyumluluk anlam bilimini bu belirlenimci PHP düzenleyicisinde tutar ve paralel çalışan sevkini ile geri basıncı ayrı bir yürütme yardımcı hizmetine devreder. Bu sınır, iş hacmi katmanının eşzamanlılığı bağımsız olarak ölçeklendirmesine olanak tanırken düzenleyici basit, sınırlı ve denetlenebilir kalır. Parti başına manifestolar üzerindeki sert bir sınır, en yüksek belleği öngörülebilir tutar; böylece büyük bir gönderim çalışan havuzunu bozamaz. Uyumluluk aktarımı, türetilmiş her çıktıyı değiştirilmeden önceki durumuna güvenmek yerine yeniden doğrular ve kapalı biçimde başarısız olur. Tamamlanmış bir manifesto yalnızca ağ geçidi uygunluğu onayladığında geçer, asla varsayılan olarak değil.

Tasarım arka planı: Yüksek hacimli belge üretimi.

API yüzeyi

Sınıf	Sorumluluk
BatchPipelineOrchestrator	Birçok manifestoyu sınırlı eşzamanlılıkla bir parti olarak yürütür.
BatchPipelineConfig	En yüksek eşzamanlılık, parti zaman aşımı, tamamlanınca-uyumluluk anahtarı.
BatchPipelineResult	Toplam: manifesto başına sonuçlar, tamamlanan ve başarısız sayıları, zamanlama.
ComplianceHandoff	İsteğe bağlı işlem-hattı-sonu uyumluluk yeniden-doğrulama adımı.

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

use NextPDF\Enterprise\OutputPipeline\BatchPipelineOrchestrator;

$result = (new BatchPipelineOrchestrator($executor))->executeBatch($manifests);

Kod örneği — üretim

use NextPDF\Enterprise\OutputPipeline\BatchPipelineOrchestrator;
use NextPDF\Enterprise\OutputPipeline\BatchPipelineConfig;

$config = new BatchPipelineConfig(
    maxConcurrency: 4,
    timeoutMs: 600_000,
    complianceCheckOnComplete: true,
);

$result = (new BatchPipelineOrchestrator($executor, $config))
    ->executeBatch($manifests, $variablesMap);

$logger->info('pipeline.batch', [
    'completed' => $result->completedCount,
    'failed'    => $result->failedCount,
]);

Uç durumlar ve tuzaklar

• Parti, manifesto sayısı üzerinde bir üst sınır uygular; bunun aşılması sessizce bozulmak yerine bir kaynak-koruması hatası yükseltir.
• Sıfır olan bir genel zaman aşımı, parti zaman aşımı yok demektir; üretimde sonlu bir değer ayarlayın; böylece takılı bir manifesto partiyi süresiz engelleyemez.
• Uyumluluk aktarımı, yukarı akış adımı çıktısında tanınabilir bir PDF gerektirir; hiçbiri bulunmazsa adım, sessizce geçmek yerine o manifesto için bir başarısızlık raporlar.
• Bu modül, Pro çıktı işlem hattına bağımlıdır; yeni bir adım modeli değil, parti koordinasyonu ekler.

Performans

İş hacmi, yapılandırılmış eşzamanlılık ve manifesto başına maliyetle ölçeklenir. Eşzamanlılık, geri çağrılar onu doyurmasın diye çalışan havuzuna göre tutucu biçimde ayarlanmalıdır. Parti başına manifesto sınırı, en yüksek belleği sınırlar.

Güvenlik notları

Parti düzenleyicisi, çağıranın sağladığı manifestoları ve değişkenleri işler; işlem hattı girdilerini herhangi bir güvenilmeyen PDF iş yüküyle aynı şekilde ele alın. Uyumluluk aktarımı bir yetkilendirme denetimi değil, bir yeniden-doğrulama yardımıdır.

Veri yerleşimi ve PII azaltmaları

Parti çıktıları kişisel veri içerebilir. İşleme süreç içi ve yereldir; bu düzenleyici tarafından hiçbir giden ağ çağrısı yapılmaz. Parti çıktılarına kendi saklama denetimlerinizi uygulayın.

Güvenli telemetri ve günlük temizleme

Parti sonuçları, belge içeriğini değil, sayıları ve zamanlamayı raporlar. Kiracı veya dava verisini kodluyorlarsa manifesto tanımlayıcılarını günlüklerden temizleyin.

Uygunluk

Bu modül için hiçbir standart uygunluğu iddia edilmez; bu bir düzenleme katmanıdır. İsteğe bağlı uyumluluk aktarımı, kendi referanslarını taşıyan Enterprise uyumluluk ağ geçidine erteler.

FIPS modu davranışı

Bu modül hiçbir kriptografik işlem yapmaz.

Tehdit modeli

Birincil girdiler, çağıranın sağladığı manifestolar ve değişkenlerdir. Azaltmalar: parti başına manifesto üzerinde sert bir sınır, sınırlı eşzamanlılık, türetilmiş çıktıların isteğe bağlı yeniden doğrulanması ve düzenleyicinin kendisinde ağ G/Ç’sinin olmaması.

Davranış sözleşmesi

• executeBatch(), her manifestoyu Pro işlem hattı yürütücüsü üzerinden çalıştırır ve tamamlanan ve başarısız sayıları ve zamanlamayla birlikte manifesto başına sonuçları döndürür.
• Sert bir sınır, parti başına manifesto sayısını sınırlar; bunun aşılması sessizce bozulmak yerine bir kaynak-koruması hatası yükseltir.
• Sıfır bir genel zaman aşımı, parti zaman aşımı yok demektir; sonlu bir değer takılı bir manifestoyu sınırlar.
• Etkinleştirildiğinde, uyumluluk aktarımı türetilmiş her PDF’i yeniden doğrular ve yukarı akışta tanınabilir bir PDF bulunmadığında sessizce geçmek yerine bir adım başarısızlığı raporlar.

Yayımlama sınırı

Bu sayfa yalnızca dışarıdan gözlemlenebilir davranışı ve desteklenen herkese açık API yüzeyini belgeler. Dahilî ad alanı yolları, yardımcı sınıflar, mekanizma tabloları, runbook dosya adları ve bilet önekleri kapsam dışıdır.

Core yedeği

NextPDF Core’un hiçbir çıktı-işlem-hattı modeli yoktur. Yalnızca Core’lu bir dağıtım, kendi adımlarını doğrudan Core API’sine karşı oluşturur; manifesto, parti koordinasyonu ve uyumluluk aktarımı yoktur.

Pro yedeği

Yalnızca Pro’lu bir dağıtımda desteklenen yüzey, tek-manifestolu Pro çıktı işlem hattıdır (pro.output.pipeline): Pro PipelineExecutor, her seferinde bir manifesto çalıştırır. Pro, parti düzenleyicisini, sınırlı-eşzamanlılık parti korumasını, parti başına zaman aşımını veya Enterprise uyumluluk aktarımını sağlamaz; yalnızca Pro’lu bir dağıtımda parti düzenlemesi veya uyumluluk aktarımı isteyen bir yapılandırmanın bunu karşılayacak hiçbir Enterprise bileşeni yoktur. Pro işlem hattı yüzeyi için Pro genel bakışı sayfasına bakın.

Enterprise sınır notu

Parti koordinasyonu, kaynak-koruması sınırları ve uyumluluk-aktarımı kablajı yalnızca davranış düzeyinde açıklanmıştır. Dahilî yardımcı hizmet sevk protokolü, dahilî geri-basınç anlam bilimi ve dahilî uyumluluk-ağ-geçidi kablajı, herkese açık yüzeyin kapsamı dışındadır ve burada yeniden üretilmez.

Dağıtım sınırı

Üretimde, paralel çalışan sevki ve geri basınç ayrı bir yürütme yardımcı hizmeti tarafından işlenir; burada açıklanan PHP düzenleyicisi parti koordinasyonunu ve uyumluluk-aktarımı mantığını sağlar ve doğrudan istek işleyicileri tarafından değil, iş çalışanı tarafından çağrılır. Çalışan-havuzu boyutlandırması, yardımcı hizmet sağlama ve PHP çalışan havuzuna göre eşzamanlılık sınırları operatörün sorumluluğundadır. Uyumluluk aktarımı bir yetkilendirme denetimi değil, bir yeniden-doğrulama yardımıdır.

Hukuki uygunluk sınırı

İsteğe bağlı uyumluluk aktarımı, türetilmiş belgeler üzerinde bir doğrulama geçişini yeniden çalıştırır. Bulguları raporlar; bir belgeyi sertifikalandırmaz, düzenleyici yeterliliği garanti etmez veya hukuki tavsiye oluşturmaz. Bir çıktının yükümlülüklerinizi karşılayıp karşılamadığını değerlendirmek sizin sorumluluğunuzdadır.

Ayrıca bakınız

• Çıktı işlem hattı (Enterprise referansı) — parti düzenleyicisi API referansı.
• Pro genel bakışı — temeldeki çıktı işlem hattı.
• Enterprise genel bakışı
• Core, Pro ve Enterprise özellik matrisi