لماذا خادم منفصل؟
ثبّت NextPDF Server عندما تحتاج خدمة ليست مكتوبة بـ PHP أو وكيل أو بيئة تشغيل أخرى إلى استدعاء المحرك عبر بروتوكول شبكي بدلًا من الربط بالمكتبة. يُعد Python SDK هو العميل المُحدَّد الأنواع لذلك الخادم.
ابدأ باستخدام NextPDF
لمحة سريعة
قسم بعنوان «لمحة سريعة»NextPDF هو محرك PHP 8.4 يُنشئ مستندات Portable Document Format (PDF) 2.0 ويفحصها، وهي بتنسيق الملف المُعرَّف في ISO 32000-2. تُنشئ المستند عبر واجهة برمجة تطبيقات (API) سلسة ومُحدَّدة الأنواع. ويعرض لغة ترميز النص التشعبي (HTML) وصفحات الأنماط المتتالية (CSS) في صفحات، ويوقّع الناتج ويؤرشفه، ثم يقرأ المحتوى المُنظَّم منه مجددًا. يحدث كل ذلك في PHP، ولا تحتاج مسارات الاستخدام الأساسية إلى أي ملف ثنائي خارجي.
يتوفر المشروع في أربعة توزيعات، تشمل البرمجيات مفتوحة المصدر (OSS) والفئات المُرخَّصة. وتشترك جميعها في المحرك الأساسي نفسه، لذا ثبّت التوزيع الذي يناسب أسلوب عملك.
| التوزيع | الحزمة | ثبّته عندما |
|---|---|---|
| نواة NextPDF (OSS) | nextpdf/core | تكتب بلغة PHP وتريد الوصول المباشر إلى المحرك، سواء مع إطار عمل أو بمفرده. |
| NextPDF Server (OSS) | nextpdf/server | تحتاج إلى خدمة مستقلة تُتيح المحرك عبر بروتوكول سياق النموذج (MCP) ونقل الحالة التمثيلية (REST) وgRPC. |
| NextPDF Pro | nextpdf/premium (فئة Pro) | تحتاج إلى التوقيع الرقمي أو الأرشفة بصيغة PDF/A أو إخراج الفواتير الإلكترونية. |
| NextPDF Enterprise | nextpdf/premium (فئة Enterprise) | تحتاج إلى توقيع مدعوم بالعتاد، وتوقيعات مؤهَّلة، وتغطية امتثال كاملة. |
NextPDF Pro وNextPDF Enterprise فئتان مُرخَّصتان ضمن حزمة nextpdf/premium نفسها. يعمل المحرك الأساسي بالطريقة نفسها سواء كانت تلك الحزمة مُثبَّتة أم لا.
التثبيت بسطر واحد
قسم بعنوان «التثبيت بسطر واحد»ضمن مشروع PHP عادي، ثبّت المحرك الأساسي عبر Composer.
composer require nextpdf/coreتُنشئ هذه الحزمة وحدها ملفات PDF وتفحصها دون أي إعداد إضافي. وتضيف تكاملات أطر العمل، وعارضات HTML، والخادم، وعدة تطوير برمجيات Python (SDK) حزمةً واحدة فوقها لكلٍّ منها. يعرض دليل التثبيت كل أمر.
اختر مسارك
قسم بعنوان «اختر مسارك»يتلاءم NextPDF مع الكود الموجود لديك بالفعل. اختر نقطة الدخول التي تناسب حزمتك التقنية، ثم افتح بطاقتها.
التثبيت مصفوفة التثبيت الكاملة: النواة وتكاملات أطر العمل وعارضات HTML والخادم وعدة Python SDK.
أول ملف PDF لك درس تعليمي قصير يُنشئ ملف PDF من PHP، ثم يعرض HTML إلى PDF.
اختر مسارك دليل قرار يوازن بين النواة وإطار العمل والخادم، وأي عارض HTML تستخدم.
التكاملات محوّلات أطر العمل وعارضات المتصفح وخدمات الحافة وحزم الترحيل.
إلى أين تتجه بعد ذلك
قسم بعنوان «إلى أين تتجه بعد ذلك»بعد إنشاء أول مستند لك، ارجع إلى هذه المجالات الرئيسية الثلاثة في الوثائق.
الأدلة والتكاملات شغّل الحزمة التي تناسب إطار عملك أو عارضك أو بيئة التشغيل أو هدف الترحيل — Laravel وSymfony وCodeIgniter وArtisan وCloudflare وGotenberg.
مرجع API سطح المحرك المُتحقَّق منه: الفئات والوسائل ومفاتيح التهيئة ومصفوفة دعم CSS.
كتاب الوصفات وصفات مُركَّزة على المهام — عرض HTML إلى PDF، والتنسيق عبر CSS، وتخطيط الجداول، وترقيم صفحات المحتوى الطويل.