اختر المسار المناسب

نظرة سريعة

يوفِّر لك ⁨NextPDF⁩ عدة نقاط دخول. يعتمد الخيار الصحيح على المكان الذي تعمل فيه التعليمات البرمجية ونوع مخرجات صيغة المستندات المحمولة (⁨PDF⁩) التي تحتاجها. استخدم هذه الصفحة لاتخاذ ثلاثة قرارات: أيُّ توزيعة تثبِّت، وأيُّ مُصيِّر للغة ترميز النص التشعبي (⁨HTML⁩) تستخدم، ومتى يحتاج عبء العمل إلى ⁨Pro⁩ أو ⁨Enterprise.⁩

اقرأ القسم الذي يطابق سؤالك، أو انتقل إلى ملخَّص القرار في النهاية.

اختر توزيعة

ابدأ بالطريقة التي يستدعي بها تطبيقك المحرك. استخدم أول صف يطابق حالتك.

وضعك	التثبيت	لماذا
مشروع ⁨PHP⁩ عادي، أو مكتبة، أو أداة واجهة سطر الأوامر (⁨CLI⁩)	⁨NextPDF core⁩ (nextpdf/core)	المحرك فقط. لا يفترض وجود أي إطار عمل ولا يشغِّل خدمة.
تطبيق ⁨Laravel⁩ أو ⁨Symfony⁩ أو ⁨CodeIgniter⁩	تكامل إطار العمل المطابق	تحصل على ارتباطات الحاوية، ومساعِدات الاستجابة، ومهام قائمة الانتظار فوق ⁨core.⁩
خدمة ليست بلغة ⁨PHP⁩، أو وكيل، أو وقت تشغيل آخر يجب أن يستدعي المحرك عبر الشبكة	⁨NextPDF Server⁩ (nextpdf/server)	خدمة واحدة تتيح المحرك عبر بروتوكول سياق النموذج (⁨MCP⁩)، و⁨REST⁩، و⁨gRPC.⁩
تعليمات برمجية بلغة ⁨Python⁩ تحتاج إلى ملفات ⁨PDF⁩ من ⁨NextPDF Server⁩	مجموعة تطوير البرمجيات (⁨SDK⁩) للغة ⁨Python⁩ (pip install nextpdf)	عميل محدَّد النوع لخادم قيد التشغيل. وهو لا يضمِّن المحرك.

من السهل أن تغيب عنك نقطتان:

• تكامل إطار العمل يتضمَّن ⁨core.⁩ لا تثبِّت كليهما على حدة. يعلن المحوِّل عن nextpdf/core ويحلّه نيابةً عنك.
• مجموعة تطوير البرمجيات (⁨SDK⁩) للغة ⁨Python⁩ هي عميل، وليست محركًا. فهي تتصل بنقطة نهاية ⁨NextPDF Server.⁩ ويتم توليد ملف ⁨PDF⁩ في ⁨PHP⁩ على الخادم.

مكتبة أم خدمة؟

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

اختر مُصيِّر ⁨HTML⁩

يستطيع ⁨NextPDF⁩ تصيير ⁨HTML⁩ إلى ⁨PDF⁩ بأربع طرق. يغطي خط الأنابيب المُضمَّن معظم المستندات دون إعداد إضافي. استخدم حِزَم المُصيِّرات الثلاث عندما تحتاج إلى تخطيط بمستوى المتصفح أو إلى الاتصال بخدمة قائمة.

المُصيِّر	الحزمة	مكان تشغيله	اخترْه عندما
المُضمَّن writeHtml()	nextpdf/core	داخل العملية، ⁨PHP⁩ فقط	تريد مجموعةً فرعية مدعومة من ⁨HTML⁩ وأوراق الأنماط المتتالية (⁨CSS⁩) دون متصفح ودون استدعاء شبكي.
⁨Artisan⁩	nextpdf/artisan	متصفح ⁨Chrome⁩ بلا واجهة على المضيف	تحتاج إلى تخطيط ⁨Chrome⁩ الكامل — ⁨flexbox⁩، و⁨grid⁩، والمحدِّدات المعقدة، وخطوط الويب — مع نص قابل للتحديد.
⁨Cloudflare⁩	nextpdf/cloudflare	تصيير متصفح ⁨Cloudflare⁩ عند الحافة	العرض أنسب للحافة، أو تريد إبقاء عمليات المتصفح خارج مضيفيك.
⁨Gotenberg⁩	nextpdf/gotenberg	خدمة ⁨Gotenberg⁩ تشغِّلها أنت	تحوِّل مستندات مكتبية (⁨DOCX⁩، ⁨XLSX⁩) أو ⁨HTML⁩ عبر نشر ⁨Gotenberg⁩ قائم.

كيفية قراءة الجدول:

• ابدأ بـخط الأنابيب المُضمَّن. فهو أسرع مسار ولا يعتمد على خدمة خارجية. قبل أن تعتمد على خاصية، تحقَّق منها مقابل مصفوفة دعم ⁨CSS⁩.
• استخدم ⁨Artisan⁩ عندما يتجاوز التخطيط المجموعة الفرعية المدعومة، ويجب أن يبقى العرض ضمن بنيتك التحتية. فهو يشغِّل عملية ⁨Chrome⁩، لذا خطِّط لدورة حياتها.
• استخدم ⁨Cloudflare⁩ عندما تريد دقة المتصفح نفسها وتفضِّل العرض عند الحافة بدل عمليات المتصفح المحلية.
• استخدم ⁨Gotenberg⁩ لتحويل المستندات المكتبية، أو عندما تكون تشغِّل ⁨Gotenberg⁩ بالفعل وتريد أن يديره ⁨NextPDF⁩.

المُصيِّرات توسِّع سطح التهديد

افتراضيًا، لا يشغِّل خط الأنابيب المُضمَّن أيَّ نصوص برمجية ولا يجلب أيَّ موارد بعيدة. أما ⁨Artisan⁩ و⁨Cloudflare⁩ و⁨Gotenberg⁩ فيُصيِّر كلٌّ منها عبر متصفح أو خدمة شبكية. تعامَل مع ⁨HTML⁩ على أنه غير موثوق، واقرأ صفحة الأمان والتشغيل لكل حزمة قبل تمرير مدخلات متأثرة بالمستخدم.

متى تحتاج إلى ⁨Pro⁩ أو ⁨Enterprise⁩

يولِّد محرك ⁨core⁩ ملفات ⁨PDF⁩ ويُصيِّرها ويفحصها دون أي تكلفة وبلا أي ترخيص. ⁨NextPDF Pro⁩ و⁨NextPDF Enterprise⁩ هما الطبقتان المرخَّصتان من حزمة nextpdf/premium. يضيف تثبيتها قدرات دون تغيير واجهة برمجة تطبيقات ⁨core.⁩

تحتاج إلى أن	الطبقة	القدرة
توقِّع ملف ⁨PDF⁩ رقميًا على أساس التوقيعات الإلكترونية المتقدمة لملف ⁨PDF⁩ (⁨PAdES⁩)	⁨Pro⁩	تطبيقات التوقيع بمفتاح برمجي.
تنتج مخرجات أرشيفية بصيغة ⁨PDF/A⁩	⁨Pro⁩	مطابقة ⁨PDF/A⁩ وملفات تعريف الأرشفة.
تضمِّن فاتورة إلكترونية (⁨Factur-X⁩ / ⁨ZUGFeRD⁩)	⁨Pro⁩	تطبيقات عقد الفاتورة الإلكترونية.
توقِّع بوحدة أمان مادية (⁨HSM⁩)	⁨Enterprise⁩	عمليات مفاتيح مدعومة بالعتاد.
تُصدِر توقيعات إلكترونية مؤهَّلة	⁨Enterprise⁩	سير عمل التوقيع المؤهَّل وسطح الامتثال الكامل.

قاعدتان تُبقيان القرار واضحًا:

• إذا كانت مخرجاتك ملفات ⁨PDF⁩ غير موقَّعة وغير أرشيفية، فإن ⁨core⁩ كامل. لا تحتاج إلى ترخيص.
• عندما تثبِّت nextpdf/premium، تكتشفه تكاملات أطر العمل والخادم تلقائيًا. وتعرض القدرات الإضافية عبر مفاتيح الحاوية وكتالوج الأدوات نفسيهما. لا يحتاج تطبيقك إلى تغييرات برمجية لاعتمادها.

ملخَّص القرار

التوزيعة

⁨PHP⁩ عادي &⁨rarr⁩; ⁨core⁩. تطبيق إطار عمل &⁨rarr⁩; التكامل المطابق. حدود الشبكة &⁨rarr⁩; الخادم. عميل ⁨Python⁩ &⁨rarr⁩; مجموعة تطوير البرمجيات (⁨SDK⁩) للغة ⁨Python⁩.

مُصيِّر HTML

المجموعة الفرعية المدعومة، بلا اعتمادية &⁨rarr⁩; writeHtml(). دقة المتصفح على مضيفيك &⁨rarr⁩; ⁨Artisan⁩. عند الحافة &⁨rarr⁩; ⁨Cloudflare⁩. تحويل المستندات المكتبية &⁨rarr⁩; ⁨Gotenberg⁩.

الطبقة المرخَّصة

ملفات ⁨PDF⁩ غير موقَّعة &⁨rarr⁩; ⁨core⁩. التوقيع، و⁨PDF/A⁩، والفاتورة الإلكترونية &⁨rarr⁩; ⁨Pro⁩. وحدة الأمان المادية (⁨HSM⁩) أو التوقيعات المؤهَّلة &⁨rarr⁩; ⁨Enterprise⁩.

ما زلت غير متأكد؟

ثبِّت ⁨core⁩، وشغِّل أول ملف ⁨PDF⁩ لك، وأضِف حزمةً فقط عندما تظهر حاجة محددة. يمكنك تغيير أي من ذلك لاحقًا.

انظر أيضًا

تثبيت NextPDF الأمر المناسب لكل توزيعة ومُصيِّر.

أول ملف PDF لك ولِّد ملف PDF من PHP وصيِّر HTML إلى PDF.

التكاملات خريطة الامتدادات الكاملة، ودليل الاختيار، وأدلة الحزم.

الاتصال (الخادم) شغِّل المحرك كخدمة شبكية عبر MCP وREST وgRPC.