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

نظرة سريعة

يوفِّر لك ⁨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.⁩

يوقِّع ⁨core⁩ بالفعل عند مستويَي الأساس ⁨B-B⁩ و⁨B-T⁩ من التوقيعات الإلكترونية المتقدمة لملف ⁨PDF⁩ (⁨PAdES⁩) باستخدام مفاتيح برمجية. تبدأ الطبقات من حيث تنتهي تلك المستويات.

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

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

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

شراء ⁨Pro⁩ أو ⁨Enterprise⁩

عندما تحتاج فعلًا إلى طبقة مرخَّصة، تُباع التراخيص التجارية عبر التاجر المسجَّل لدينا — وهو موزِّع معتمَد يكون البائع المسجَّل لطلبك — ويُمنح ترخيصك من ⁨PATEON⁩ بموجب اتفاقية الترخيص للمستخدم النهائي (⁨EULA⁩). تبدأ من بوّابة التراخيص، ونهيّئ لك التثبيت عبر صفحة الدفع لدى التاجر المسجَّل لدينا، حيث يُعالَج السعر وأي ضريبة وفاتورتك.

راجِع الشراء والترخيص للاطلاع على المسار الكامل، ونموذج العقدين (الشراء مقابل الترخيص)، ومن تتواصل معه لشؤون الفوترة مقابل دعم المنتج.

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

التوزيعة

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

مُصيِّر HTML

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

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

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

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

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

انظر أيضًا

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

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

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

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