اختيار التكامل الملائم
اختيار التكامل الملائم
قسم بعنوان «اختيار التكامل الملائم»استخدم هذه الصفحة لمطابقة حالة الاستخدام لديك مع التكامل الذي يتولّاها. تستند كل توصية فقط إلى وصف composer.json الخاص بالحزمة وغرضها المعلَن، وكلاهما مقروء مباشرةً من المستودع المصدري. عند تداخل تكاملين، توضّح هذه الصفحة العامل الفاصل بينهما لتختار بثقة.
ابحث عن الصف الذي يطابق وضعك، ثم ابدأ من هناك.
ابدأ من هنا: ماذا لديك؟
قسم بعنوان «ابدأ من هنا: ماذا لديك؟»| ماذا لديك … | استخدم | لماذا (الغرض الموثَّق) |
|---|---|---|
| تطبيق Laravel 12 | nextpdf/laravel | تكامل مع إطار عمل Laravel: مزوِّد خدمة، وواجهة facade، ومساعدات لاستجابات PDF. |
| تطبيق Symfony 7 | nextpdf/symfony | حزمة Symfony: خدمات حقن التبعيات (DI) ومساعدات لاستجابات PDF. |
| تطبيق CodeIgniter 4 | nextpdf/codeigniter | خدمات CodeIgniter 4، وغلاف مكتبة، ومساعدات لاستجابات PDF. |
| تطبيق PHP بدون إطار عمل | nextpdf/core مباشرةً | لا تحتاج إلى تكامل مع إطار عمل؛ فالمحرك مكتبة عادية. |
| محتوى HTML يحتاج إلى محرك CSS الخاص بالمتصفح، مع قدرتك على تشغيل Chrome | nextpdf/artisan | عارض عبر بروتوكول أدوات مطوري Chrome (CDP) لمحتوى HTML الذي يحتاج إلى تخطيط CSS بمستوى المتصفح. |
| مستند Office تريد تحويله، مثل DOCX أو XLSX أو ODT | nextpdf/gotenberg | تحويل من Office إلى PDF عبر خدمة Gotenberg المصغَّرة. |
| حاجة إلى العرض دون تشغيل أي عملية متصفح | nextpdf/cloudflare | عرض بلا خوادم عبر واجهة Cloudflare Browser Rendering API على الحافة. |
| شِفرة تعتمد على مكتبة PDF قديمة | nextpdf/compat-legacy | طبقة توافق مع مكتبة PDF القديمة؛ استدعِ NextPDF دون إعادة كتابة مواضع الاستدعاء. |
| بيئة تشغيل متوقفة عند PHP 8.1 / 7.4 | nextpdf/backport-builder | خط تخفيض إصدار باستخدام Rector يبني هدف 8.1 / 7.4 من المحرك. |
| مستدعون عن بُعد، أو لغة أخرى، أو نظام ذكاء اصطناعي (AI) | nextpdf/server | NextPDF Connect: واجهة REST وgRPC وبروتوكول Model Context Protocol للتنفيذ عن بُعد. |
عندما يصلح تكاملان معًا
قسم بعنوان «عندما يصلح تكاملان معًا»عرض HTML إلى PDF: Artisan مقابل Gotenberg مقابل Cloudflare مقابل النواة
قسم بعنوان «عرض HTML إلى PDF: Artisan مقابل Gotenberg مقابل Cloudflare مقابل النواة»جسور العرض الثلاثة كلّها تحوّل الترميز إلى PDF. يختلف كل جسر في طريقة عمله، لا في الجودة. استخدم هذا الاختلاف التشغيلي بوصفه العامل الحاسم.
- يقود
nextpdf/artisanمتصفح Chrome بلا واجهة عبر بروتوكول Chrome DevTools. يحتاج إلى عملية Chrome يمكن للتطبيق الوصول إليها. اختره عندما تتمكن من تشغيل تلك العملية ويحتاج المستند إلى محرك CSS الخاص بالمتصفح. - يستدعي
nextpdf/gotenbergخدمة Gotenberg مصغَّرة خارج العملية عبر HTTP. اختره عندما يجب عزل العرض في خدمة مستقلة، أو عندما يكون المُدخل مستند Office. Gotenberg هو الوحيد من بين الثلاثة الذي يتضمن غرضه المعلَن التحويل من Office إلى PDF. - يستدعي
nextpdf/cloudflareواجهة Cloudflare Browser Rendering API. اختره عندما تريد عرض edge/serverless دون عملية متصفح تحتاج إلى تشغيل أو ترقيع. - خط معالجة HTML داخل العملية في نواة NextPDF لا يحتاج إلى أيٍّ مما سبق. استخدم جسر عرض فقط عندما يعجز خط المعالجة داخل العملية عن توفير دقة التخطيط أو عزل العملية الذي يحتاجه المستند. يفوّض الجسر هذه الخطوة عمدًا؛ وهو ليس المسار الافتراضي.
يحتاج جسرا HTTP (nextpdf/gotenberg، nextpdf/cloudflare) إلى عميل HTTP متوافق مع PSR-18 يوفّره المضيف. تتعامل وصفات هذين التكاملين مع فشل النقل وحالة HTTP غير الناجحة بوصفهما نتيجتين منفصلتين.
تحويل مستند Office
قسم بعنوان «تحويل مستند Office»nextpdf/gotenberg هو التكامل الذي يذكر وصف composer.json الموثَّق الخاص به التحويل من Office إلى PDF. تصف جسور العرض الأخرى عرض HTML، لا مُدخلات Office. إذا كان المصدر DOCX/XLSX/ODT، فاستخدم هذا التكامل.
الترحيل عن مكتبة PDF قديمة
قسم بعنوان «الترحيل عن مكتبة PDF قديمة»بحسب غرضه المعلَن، يُعدّ nextpdf/compat-legacy طبقة توافق لقواعد الشِفرة التي تعتمد على مكتبة PDF قديمة. يتيح لمواضع الاستدعاء القائمة الوصول إلى NextPDF قبل أن تعيد كتابتها. تعامل معه بوصفه أداة مساعدة مؤقتة للترحيل ومخطَّطًا لإزالتها، لا بوصفه تبعية تشغيل دائمة. ينبغي أن تستدعي الشِفرة الجديدة nextpdf/core (أو تكامل إطار العمل المناسب) مباشرةً.
التشغيل على PHP 8.1 أو 7.4
قسم بعنوان «التشغيل على PHP 8.1 أو 7.4»تعلن كل حزمة في المنظومة عن PHP >=8.4 <9.0. يوجد nextpdf/backport-builder لهذا القيد تحديدًا: غرضه المعلَن هو خط تخفيض إصدار باستخدام Rector يبني صنعة PHP 8.1+ (وهدف 7.4). إنه أداة بناء، وليس تبعية تشغيل لتطبيقك. شغّل أداة البناء لإنتاج المحرك المنقول إلى إصدار أقدم، ثم انشر ذلك المحرك.
مستدعٍ غير PHP أو وكيل ذكاء اصطناعي
قسم بعنوان «مستدعٍ غير PHP أو وكيل ذكاء اصطناعي»يُتيح nextpdf/server (NextPDF Connect) المحرك عبر واجهة REST API، وخدمة gRPC، وبروتوكول Model Context Protocol. اختره عندما يكون المستدعي بعيدًا، أو مكتوبًا بلغة أخرى، أو نظام ذكاء اصطناعي يستهلك نقطة نهاية أداة بدلًا من مكتبة PHP. ينبغي لتطبيق PHP يعمل داخل العملية نفسها أن يستخدم nextpdf/core أو تكامل إطار عمل بدلًا من إضافة قفزة شبكية.
استخدام أكثر من تكامل معًا
قسم بعنوان «استخدام أكثر من تكامل معًا»يعمل تكامل إطار العمل وجسر العرض في طبقتين مختلفتين، لذا يمكنك تثبيت كليهما. يتولّى تكامل إطار العمل ربط الحاوية واستجابة HTTP؛ ويتولّى جسر العرض الواجهة الخلفية للعرض. عند حلّ مجموعة تبعيات مدمجة، تحقّق من إصدارات nextpdf/core التي تقبلها كل حزمة. مرجع قيود النواة في فهرس دليل التكاملات هو مصدر الحقيقة. توجد وصفات كل تركيبة في المستودعات المعنية، وترتبط من ذلك الفهرس.
انظر أيضًا
قسم بعنوان «انظر أيضًا»- دليل التكاملات — مرجع الحزم وقيود النواة، إلى جانب فهرس روابط الوصفات.
- اصطلاحات الوصفات — العقد الذي تتبعه كل وصفة قابلة للتشغيل.