تثبيت NextPDF Connect

لمحة سريعة

ثبّت nextpdf/server باستخدام ⁨Composer.⁩ ثم شغّل إحدى نقاط الدخول الثلاث الخاصة بوسائل النقل. لا يتطلب التثبيت الأساسي سوى ⁨PHP 8.4⁩ ومحرك ⁨NextPDF⁩. ويبقى كل من ⁨Redis⁩ و⁨Premium⁩ اختيارياً.

التثبيت

composer require nextpdf/server

يثبّت هذا الأمر nextpdf/core: ^3.0. وتصرّح الحزمة بـ php: >=8.4 <9.0، لذلك يرفض ⁨Composer⁩ تثبيتها على ⁨PHP 8.3⁩ أو أقدم، أو على ⁨PHP 9.⁩

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

هذه حزمة ⁨Composer⁩ من النوع library. عند تثبيتها، تُضاف أربع نقاط دخول عبر الطرفية إلى vendor/bin/:

• vendor/bin/nextpdf-mcp — خادم ⁨stdio⁩ لبروتوكول ⁨Model Context Protocol⁩ (⁨MCP⁩).
• vendor/bin/nextpdf-server — خادم ⁨Representational State Transfer⁩ (⁨REST⁩) (عامل ⁨HTTP⁩ الخاص بـ ⁨RoadRunner⁩).
• vendor/bin/nextpdf-grpc — خادم ⁨gRPC⁩ (عامل ⁨gRPC⁩ الخاص بـ ⁨RoadRunner⁩).
• vendor/bin/generate-skills — يصدّر فهرس الأدوات بصيغة مهارات للوكلاء.

يتضمّن المستودع برنامجاً نصياً خامساً، هو bin/nextpdf-prune، لمهام الصيانة. شغّله مباشرةً بدلاً من تشغيله عبر vendor/bin/.

لا تحتاج إلى مزوّد خدمة أو حزمة تكامل أو تسجيل داخل إطار عمل. يعمل الخادم بوصفه عملية مستقلة، وليس مكتبة تربطها داخل تطبيق مضيف.

واجهة ⁨API⁩

يثبّت ⁨Composer⁩ أيضاً اعتماديات وقت التشغيل الخاصة بالحزمة. وتشمل الاعتماديات المتعدّية حزمة بروتوكول ⁨Hypertext Transfer Protocol⁩ (⁨HTTP⁩) وحزمة ⁨gRPC⁩:

• league/route وnyholm/psr7 — توجيه ⁨REST⁩ ورسائل ⁨PHP Standard Recommendation⁩ (⁨PSR⁩)-7.
• spiral/roadrunner-http وspiral/roadrunner-grpc — بيئة تشغيل عامل ⁨RoadRunner⁩ لوسيلتَي نقل ⁨REST⁩ و⁨gRPC.⁩
• psr/http-server-middleware وpsr/http-server-handler — عقود طبقة ⁨middleware⁩ الخاصة بـ ⁨PSR-15⁩ التي ينفّذها مسار ⁨REST.⁩
• symfony/yaml — تحليل ملف الإعدادات.
• ramsey/uuid — معرّفات الطلبات والموارد.

لا تثبّت هذه الحزم مباشرةً. يتولّى ⁨Composer⁩ حلّها نيابةً عنك انطلاقاً من nextpdf/server.

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

للتحقق من التثبيت، اعرض فهرس الأدوات من دون بدء تشغيل خادم:

./vendor/bin/generate-skills --dry-run --list-tools

يشغّل هذا الأمر السجلّ، وينفّذ كشف المستوى، ثم يطبع الأدوات التي يكشفها هذا التثبيت. تعكس القائمة الحزم الاختيارية المثبّتة. راجع /⁨connect/tool-catalog/.⁩

مثال برمجي — بيئة الإنتاج

في بيئة الإنتاج، ثبّت الاعتمادية وتخطَّ أدوات التطوير:

composer require nextpdf/server --no-dev
composer install --no-dev --optimize-autoloader --classmap-authoritative

لوسيلتَي نقل ⁨REST⁩ و⁨gRPC⁩، ثبّت أيضاً ملف ⁨RoadRunner⁩ الثنائي. يعمل ⁨RoadRunner⁩ مشرفاً للعمليات ويمتلك مجموعة العمّال. توفّر حزمة ⁨PHP⁩ العامل، لا المشرف:

./vendor/bin/rr get-binary

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

• ⁨Redis⁩ اختياري. إضافة ext-redis مصنّفة suggest، وليست require. من دونها، يستخدم خادم ⁨REST⁩ مخازن داخل الذاكرة لتحديد المعدّل والتكرارية ومخازن المستندات. تعمل هذه المخازن داخل الذاكرة على نحو صحيح مع عامل واحد، لكنها لا تُشارَك عبر مجموعة متعددة العمّال. في عمليات النشر المتعددة العمّال، ثبّت ext-redis واضبط متغيّرات بيئة ⁨Redis.⁩ راجع /⁨connect/configuration/.⁩

• ⁨Premium⁩ اختياري. nextpdf/premium هي suggest. عند تثبيتها إلى جانب الخادم، تعثر مجسّات كشف المستوى الخاصة بالسجلّ على فئات المزوّد الخاصة بها، وتسجّل أدوات ⁨Pro⁩ و⁨Enterprise⁩ الإضافية. من دونها، يُقدَّم الفهرس الأساسي فقط. هذا قرار تحزيم يُتّخذ في وقت composer require، وليس مفتاح تبديل في وقت التشغيل.

• خادم ⁨MCP⁩ لا يحتاج إلى ⁨RoadRunner.⁩ nextpdf-mcp هي عملية ⁨PHP⁩ بسيطة تتخاطب ببروتوكول ⁨JavaScript Object Notation Remote Procedure Call⁩ (⁨JSON-RPC⁩) عبر الإدخال والإخراج القياسيين (⁨stdio⁩). يُشترَط ⁨RoadRunner⁩ لوسيلتَي نقل ⁨REST⁩ و⁨gRPC⁩ فقط.

الأداء

يمثّل حلّ الاعتماديات عبر ⁨Composer⁩ معظم تكلفة زمن التثبيت. في صور بيئة الإنتاج، استخدم --prefer-dist وخريطة فئات موثوقة للإبقاء على زمن التحميل التلقائي عند الإقلاع البارد منخفضاً. تتمثّل تكلفة إقلاع الخادم نفسه في فحص السجلّ وكشف المستوى. يضع performance_budget المذكور في هذه الصفحة حداً لتكلفة الإقلاع تلك.

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

ثبّت فقط من حزمة ⁨Packagist⁩ الرسمية nextpdf/server. ثبّت الإصدار في composer.json وأدرج composer.lock في المستودع ليكون فهرس الأدوات المنشور قابلاً لإعادة الإنتاج. تتطلب وسائل النقل الشبكية مفتاح واجهة برمجة التطبيقات ⁨application programming interface⁩ (⁨API⁩) قبل خدمة أي نقطة نهاية غير خاصة بفحص الصحة؛ راجع /⁨connect/security-and-operations/.⁩

المطابقة

تصف هذه الصفحة آليات التثبيت فقط. استشهادات مطابقة البروتوكول والأمن موثّقة في /⁨transports/mcp/⁩ و/⁨transports/rest/⁩ و/⁨transports/grpc/⁩ و/⁨connect/security-and-operations/.⁩

السياق التجاري

التثبيت الأساسي كامل الوظائف. يتولّى إنشاء المستندات وفحصها وتشخيصها عبر وسائل النقل الثلاث جميعها. تؤدي إضافة nextpdf/premium إلى توسيع الفهرس دون تغيير نموذج النقل أو المصادقة.

انظر أيضاً

• /⁨connect/overview/⁩ — ما توفّره الحزمة
• /⁨connect/quickstart/⁩ — أول تبادل قابل للتشغيل
• /⁨connect/configuration/⁩ — متغيّرات البيئة وملف الإعدادات
• /⁨connect/deployment/⁩ — ⁨RoadRunner⁩ و⁨Docker⁩ والنشر المدمج متعدّد وسائل النقل
• /⁨connect/tool-catalog/⁩ — الأدوات التي يكشفها هذا التثبيت