مسار الإخراج

لمحة سريعة

يُنسّق ⁨NextPDF Enterprise⁩ التنفيذ الجَملي واسع النطاق لبيانات مسار إخراج ⁨NextPDF Pro⁩ مع حدّ تزامن قابل للتهيئة وتسليم امتثال اختياري على المخرجات المُكتمَلة. وهو طبقة الدُّفعة فوق مسار إخراج ⁨Pro⁩.

التوفّر والترخيص

تُشحَن هذه القدرة في ⁨NextPDF Enterprise⁩ (nextpdf/enterprise) وتُفعَّل بمَظروف ترخيص من فئة ⁨Enterprise⁩. ولا يُحمِّل أي نشر يفتقر إلى ذلك الاستحقاق أصناف هذه القدرة. قارن الإصدارات واحصل على ترخيص.

يبني سطح دُفعة ⁨Enterprise⁩ على مسار إخراج ⁨Pro⁩ (pro.output.pipeline)، وهو شرط مُسبق لا البوابة. ولا يوجد رمز قدرة منفصل لكل ميزة؛ فمُنسِّق الدُّفعة وتسليم الامتثال متوفّران حيثما تكون حزمة nextpdf/enterprise المُرخَّصة مثبَّتة.

التثبيت

composer require nextpdf/enterprise:^3

نظرة مفاهيمية عامة

يُنفِّذ BatchPipelineOrchestrator العديد من نسخ PipelineManifest كدفعة واحدة. ويُشغَّل كل بيان عبر PipelineExecutor في ⁨Pro⁩؛ ويضيف المُنسِّق تنسيق الدُّفعة، وحارس مورد محدود (يُحدّ عدد البيانات لكل دفعة)، ومعالجة مهلة لكل دفعة، وتسليم امتثال اختياري.

يتحكّم BatchPipelineConfig في ثلاثة أشياء: الحد الأقصى لاستدعاءات العامل المتزامنة، ومهلة دفعة عامة اختيارية بالملّي ثانية، وما إذا كان فحص امتثال يجري على كل مخرج بعد اكتمال المسار. وحين يُفعَّل فحص الامتثال، يتكامل ComplianceHandoff كخطوة في المسار تُعيد التحقّق من كل ⁨PDF⁩ مُشتق عبر بوابة امتثال ⁨Enterprise⁩، بحيث يُعاد فحص أي مستند عدّله المسار بدلًا من الوثوق به من حالته قبل التعديل.

في عمليات النشر الإنتاجية، يتولّى مرافِق تنفيذ منفصل توزيع العمّال المتوازي والضغط العكسي؛ ويقدّم مُنسِّق ⁨PHP⁩ الموصوف هنا تنسيق الدُّفعة ومنطق تسليم الامتثال، ويُستدعى من عامل المهام لا مباشرةً من معالجات الطلبات.

لماذا يعمل بهذه الطريقة

ينقسم التوليد الجَملي عالي الحجم إلى شاغلين: تنسيق أي البيانات تُشغَّل وبأي ضمانات، ودفع الإنتاجية المتوازية الخام. يُبقي ⁨NextPDF⁩ دلالات التنسيق والامتثال في مُنسِّق ⁨PHP⁩ الحتمي هذا، ويفوّض توزيع العمّال المتوازي والضغط العكسي إلى مرافِق تنفيذ منفصل. وهذا الحدّ يتيح لطبقة الإنتاجية أن تُوسِّع التزامن باستقلال بينما يبقى المُنسِّق بسيطًا ومحدودًا وقابلًا للتدقيق. ويُبقي سقفٌ صارم على البيانات لكل دفعة ذروةَ الذاكرة قابلةً للتنبّؤ، فلا يستطيع تقديمٌ ضخم واحد أن يُدهور مجمع العمّال. ويُعيد تسليم الامتثال التحقّق من كل مخرج مُشتق بدلًا من الوثوق بحالته قبل التعديل، ويُخفِق مُغلَقًا. ولا يمر بيان مكتمل إلا حين تؤكّد البوابة المطابقة، لا بشكل افتراضي أبدًا.

خلفية التصميم: توليد المستندات عالي الحجم.

سطح الـ ⁨API⁩

الصنف	المسؤولية
BatchPipelineOrchestrator	تنفيذ العديد من البيانات كدفعة بتزامن محدود.
BatchPipelineConfig	الحد الأقصى للتزامن، ومهلة الدُّفعة، ومفتاح الامتثال عند الاكتمال.
BatchPipelineResult	تجميع: نتائج لكل بيان، وأعداد المُكتمِل والمُخفِق، والتوقيت.
ComplianceHandoff	خطوة إعادة تحقّق امتثال اختيارية عند نهاية المسار.

مثال شيفرة — بداية سريعة

use NextPDF\Enterprise\OutputPipeline\BatchPipelineOrchestrator;

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

مثال شيفرة — إنتاج

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,
]);

الحالات الحدّية والمزالق

• تفرض الدُّفعة حدًا أعلى على عدد البيانات؛ وتجاوزه يثير خطأ حارس مورد بدلًا من التدهور بصمت.
• مهلة عامة بقيمة صفر تعني انعدام مهلة دفعة؛ اضبط قيمة منتهية في الإنتاج حتى لا يستطيع بيان عالق أن يحجب الدُّفعة إلى أجل غير مسمى.
• يتطلّب تسليم الامتثال ⁨PDF⁩ قابلًا للتمييز في ناتج الخطوة السابقة؛ وإن لم يُعثَر عليه تُبلِّغ الخطوة بإخفاق ذلك البيان بدلًا من التمرير بصمت.
• تعتمد هذه الوحدة على مسار إخراج ⁨Pro⁩؛ وهي تضيف تنسيق الدُّفعة، لا نموذج خطوة جديدًا.

الأداء

تتدرّج الإنتاجية مع التزامن المُهيّأ وتكلفة كل بيان. وينبغي ضبط التزامن بتحفّظ نسبةً إلى مجمع العمّال حتى لا تُشبِع الاستدعاءاتُ المجمعَ. ويحدّ سقف بيانات كل دفعة ذروة الذاكرة.

ملاحظات أمنية

يعالج مُنسِّق الدُّفعة أي بيانات ومتغيرات يزوّدها المستدعي؛ عامِل مُدخَلات المسار كما تعامل أي حمولة ⁨PDF⁩ غير موثوقة أخرى. وتسليم الامتثال مساعد إعادة تحقّق، لا ضابط تخويل.

إقامة البيانات وتخفيفات المعلومات الشخصية

قد تحتوي مخرجات الدُّفعة بيانات شخصية. والمعالجة داخل العملية ومحلية؛ ولا يُجري هذا المُنسِّق أي اتصال شبكي صادر. طبّق ضوابط الاحتفاظ الخاصة بك على مخرجات الدُّفعة.

القياس الآمن وتنقية السجلات

تُبلِّغ نتائج الدُّفعة عن الأعداد والتوقيت، لا عن محتوى المستند. نقِّ مُعرِّفات البيانات من السجلات إذا كانت تُرمِّز بيانات مستأجر أو قضية.

المطابقة

لا يُدَّعى أي مطابقة معايير لهذه الوحدة؛ فهي طبقة تنسيق. ويُحيل تسليم الامتثال الاختياري إلى بوابة امتثال ⁨Enterprise⁩، التي تحمل مراجعها الخاصة.

سلوك وضع ⁨FIPS⁩

لا تُجري هذه الوحدة أي عمليات تشفيرية.

نموذج التهديد

المُدخَلات الأساسية هي بيانات ومتغيرات يزوّدها المستدعي. التخفيفات: سقف صارم على البيانات لكل دفعة، وتزامن محدود، وإعادة تحقّق اختيارية من المخرجات المُشتقّة، وانعدام الإدخال/الإخراج الشبكي في المُنسِّق نفسه.

عقد السلوك

• يُشغِّل executeBatch() كل بيان عبر مُنفِّذ مسار ⁨Pro⁩ ويُعيد نتائج لكل بيان مع أعداد المُكتمِل والمُخفِق والتوقيت.
• يحدّ سقف صارم عدد البيانات لكل دفعة؛ وتجاوزه يثير خطأ حارس مورد بدلًا من التدهور بصمت.
• مهلة عامة بقيمة صفر تعني انعدام مهلة دفعة؛ والقيمة المنتهية تحدّ بيانًا عالقًا.
• عند التفعيل، يُعيد تسليم الامتثال التحقّق من كل ⁨PDF⁩ مُشتق ويُبلِّغ بإخفاق خطوة حين لا يُعثَر على ⁨PDF⁩ قابل للتمييز في الخطوة السابقة بدلًا من التمرير بصمت.

حدود النشر

توثّق هذه الصفحة السلوك القابل للملاحظة خارجيًا وسطح الـ ⁨API⁩ العام المدعوم فقط. أما مسارات فضاء الأسماء الداخلية، وأصناف المساعدة، وجداول الآليات، وأسماء ملفات أدلة التشغيل، وبادئات التذاكر فخارج النطاق.

بديل ⁨Core⁩

لا يملك ⁨NextPDF Core⁩ أي نموذج مسار إخراج. ويؤلّف نشرٌ يقتصر على ⁨Core⁩ خطواته بنفسه مباشرةً مقابل ⁨API⁩ في ⁨Core⁩؛ فلا بيان، ولا تنسيق دفعة، ولا تسليم امتثال.

بديل ⁨Pro⁩

في نشر يقتصر على ⁨Pro⁩، يكون السطح المدعوم هو مسار إخراج ⁨Pro⁩ أحادي البيان (pro.output.pipeline): يُشغِّل PipelineExecutor في ⁨Pro⁩ بيانًا واحدًا في كل مرة. ‏⁨Pro⁩ لا يوفّر مُنسِّق الدُّفعة، ولا حارس الدُّفعة محدود التزامن، ولا مهلة كل دفعة، ولا تسليم امتثال ⁨Enterprise⁩؛ وتهيئة تطلب تنسيق الدُّفعة أو تسليم الامتثال في نشر يقتصر على ⁨Pro⁩ لا تملك مكوّن ⁨Enterprise⁩ يُلبّيها. انظر نظرة عامة على ⁨Pro⁩ لسطح مسار ⁨Pro⁩.

ملاحظة حدود ⁨Enterprise⁩

يُوصَف تنسيق الدُّفعة، وحدود حارس المورد، وربط تسليم الامتثال على مستوى السلوك فقط. وبروتوكول توزيع المرافِق الداخلي، ودلالات الضغط العكسي الداخلية، وربط بوابة الامتثال الداخلي خارج نطاق السطح العام ولا تُعرض هنا.

حدود النشر الإنتاجي

في الإنتاج، يتولّى مرافِق تنفيذ منفصل توزيع العمّال المتوازي والضغط العكسي؛ ويقدّم مُنسِّق ⁨PHP⁩ الموصوف هنا تنسيق الدُّفعة ومنطق تسليم الامتثال ويُستدعى من عامل المهام، لا مباشرةً من معالجات الطلبات. وحجم مجمع العمّال، وتزويد المرافِق، وحدود التزامن نسبةً إلى مجمع عمّال ⁨PHP⁩ مسؤولية المُشغِّل. وتسليم الامتثال مساعد إعادة تحقّق، لا ضابط تخويل.

حدود الامتثال القانوني

يُعيد تسليم الامتثال الاختياري تشغيل تمريرة تحقّق على المستندات المُشتقّة. وهو يُبلِّغ عن النتائج؛ ولا يُصادق على مستند، ولا يضمن الكفاية التنظيمية، ولا يشكّل مشورة قانونية. والحكم على ما إذا كان مخرج ما يستوفي التزاماتك مسؤوليتك.

انظر أيضًا

• مسار الإخراج (مرجع ⁨Enterprise⁩) — مرجع ⁨API⁩ مُنسِّق الدُّفعة.
• نظرة عامة على ⁨Pro⁩ — مسار الإخراج الأساسي.
• نظرة عامة على ⁨Enterprise⁩
• مصفوفة ميزات ⁨Core⁩ مقابل ⁨Pro⁩ مقابل ⁨Enterprise⁩