تثبيت NextPDF

لمحة سريعة

ثبّت أي توزيعة من ⁨NextPDF⁩ بأمر واحد عبر مدير الحزم. تستخدم توزيعات ⁨PHP⁩ أداة ⁨Composer⁩، بينما تستخدم مجموعة تطوير البرامج (⁨SDK⁩) الخاصة بلغة ⁨Python⁩ أداة ⁨pip.⁩ اختر علامة التبويب المناسبة لما تبنيه. نفّذ الأمر، ثم تحقّق من النتيجة في أسفل هذه الصفحة.

محرّك واحد، عدة واجهات للدخول

المحرّك الأساسي هو nextpdf/core. وتضيف تكاملات أطر العمل، ومُصيّرات لغة ترميز النص التشعّبي (⁨HTML⁩)، والخادم، وعميل ⁨Python⁩، كلٌّ منها حزمة إضافية واحدة. وهي لا تحلّ محلّ المحرّك الأساسي؛ بل تثبّته نيابةً عنك.

المتطلّبات

يستهدف ⁨NextPDF⁩ بيئة تشغيل حديثة واحدة. وتأتي هذه القيود مباشرةً من ملفات composer.json الخاصة بالحزم نفسها.

المتطلّب	القيد	ملاحظات
PHP	>=8.4 <9.0	يرفض Composer التثبيت على PHP 8.3 أو أقدم، أو على PHP 9.
⁨Composer⁩	2.7 أو أحدث	مطلوب لحلّ الاعتماديات وتوليد مُحمّل التحميل التلقائي.
ext-mbstring	مطلوب	معالجة السلاسل النصية متعدّدة البايتات من أجل تخطيط النص.
ext-zlib	مطلوب	ضغط الدفق لكائنات تنسيق المستندات المحمولة (⁨PDF⁩).
⁨Chrome⁩ أو ⁨Chromium⁩	اختياري	لمُصيّر ⁨Artisan⁩ فقط (writeHtmlChrome()).
خدمة ⁨Gotenberg⁩	اختياري	لتحويل مستندات المكتب و⁨HTML⁩ عبر ⁨Gotenberg⁩ فقط.
⁨Python⁩	3.10 أو أحدث	لمجموعة تطوير البرامج (⁨SDK⁩) الخاصة بلغة ⁨Python⁩ فقط.

يأتي ext-mbstring وext-zlib مُفعَّلَيْن في كل بنية ⁨PHP⁩ مدعومة. تتحقّق التكاملات منهما أثناء الإقلاع، وتتوقّف برسالة واضحة إذا كان أيٌّ منهما مفقودًا.

تثبيت المحرّك الأساسي

لإنشاء ملفات ⁨PDF⁩ وفحصها من ⁨PHP⁩، لا تحتاج إلا إلى المحرّك الأساسي.

composer require nextpdf/core

أودِع composer.lock حتى يستخدم كل عامل نشر إصدار المحرّك نفسه. بعد التثبيت، تابِع إلى ملف ⁨PDF⁩ الأول لك.

تثبيت تكامل إطار عمل

ثبّت محوّل إطار عمل واحدًا للحصول على ارتباطات الحاوية، ومساعدات الاستجابة، ومهامّ الطابور. يعلن كل محوّل عن nextpdf/core ويحلّه نيابةً عنك.

Laravel

composer require nextpdf/laravel

يسجّل الاكتشاف التلقائي مزوّد الخدمة وواجهة Pdf. ثم انشُر ملف الإعدادات:

php artisan vendor:publish --tag=nextpdf-config

راجِع دليل تثبيت ⁨Laravel⁩ ودليل البدء السريع لـ ⁨Laravel⁩.

Symfony

composer require nextpdf/symfony

في تطبيق ⁨Symfony Flex⁩، تسجّل الحزمة نفسها تلقائيًا. وفي تطبيق غير ⁨Flex⁩، أضِف NextPDF\Symfony\NextPdfBundle إلى config/bundles.php بنفسك. راجِع دليل تثبيت ⁨Symfony⁩.

CodeIgniter

composer require nextpdf/codeigniter

يكتشف ⁨CodeIgniter 4⁩ صنف Services ومساعد pdf() تلقائيًا، لذا لا تحتاج إلى تسجيل يدوي. راجِع دليل تثبيت ⁨CodeIgniter⁩.

تثبيت مُصيّر أو خدمة

يُصيّر ⁨NextPDF⁩ صفحات ⁨HTML⁩ إلى ⁨PDF⁩ بثلاث طرق. ثبّت الخيار المناسب للموضع الذي تريد أن يحدث فيه التصيير. ولا يحلّ أيٌّ منها محلّ writeHtml()، وهو خطّ أنابيب ⁨HTML⁩ المدمج والخالص بلغة ⁨PHP⁩ في المحرّك الأساسي.

Artisan (Chrome)

composer require nextpdf/artisan

تضيف هذه الحزمة تصييرًا عبر ⁨Chrome⁩ بلا واجهة من خلال بروتوكول أدوات مطوّري ⁨Chrome⁩ (⁨CDP⁩). وتحتاج أيضًا إلى نسخة تنفيذية من ⁨Chrome⁩ أو ⁨Chromium⁩ يمكن للمضيف الوصول إليها. بعد التثبيت، استدعِ writeHtmlChrome() على مستند. راجِع دليل البدء السريع لـ ⁨Artisan⁩.

Cloudflare

composer require nextpdf/cloudflare guzzlehttp/guzzle

يجري التصيير عبر ⁨Cloudflare Browser Rendering⁩ عند الحافة. يعتمد الجسر فقط على عقود توصية معايير ⁨PHP⁩ (⁨PSR⁩)، وهي ⁨PSR-18⁩ و⁨PSR-17⁩، لذلك وفّر عميل بروتوكول نقل النص التشعّبي (⁨HTTP⁩) الخاص بك (وهنا معروض ⁨Guzzle⁩). راجِع دليل تثبيت ⁨Cloudflare⁩.

Gotenberg

composer require nextpdf/gotenberg guzzlehttp/guzzle

تحوّل هذه الحزمة مستندات المكتب و⁨HTML⁩ عبر خدمة ⁨Gotenberg.⁩ وفّر عميل ⁨PSR-18⁩ ونسخة ⁨Gotenberg⁩ يمكن الوصول إليها. راجِع دليل تثبيت ⁨Gotenberg⁩.

المُصيّرات تتجاوز نطاق PHP

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

تثبيت الخادم

⁨NextPDF Server⁩ (المعروف أيضًا باسم ⁨Connect⁩) خدمة مستقلة. وهو يكشف المحرّك عبر بروتوكول سياق النموذج (⁨MCP⁩)، ونقل الحالة التمثيلي (⁨REST⁩)، و⁨gRPC.⁩

composer require nextpdf/server

تضيف الحزمة نقاط دخول للطرفية إلى vendor/bin/، منها vendor/bin/nextpdf-mcp (خادم ⁨MCP⁩ عبر ⁨stdio⁩) وvendor/bin/nextpdf-server (خادم ⁨REST⁩). ويحتاج نقلا ⁨REST⁩ و⁨gRPC⁩ أيضًا إلى نسخة ⁨RoadRunner⁩ التنفيذية:

./vendor/bin/rr get-binary

راجِع دليل تثبيت ⁨Connect⁩ ودليل البدء السريع لـ ⁨Connect⁩.

تثبيت مجموعة تطوير البرامج (⁨SDK⁩) الخاصة بلغة ⁨Python⁩

مجموعة تطوير البرامج (⁨SDK⁩) الخاصة بلغة ⁨Python⁩ هي العميل المُحدَّد الأنواع لخادم ⁨NextPDF Server⁩ قيد التشغيل. ثبّتها من فهرس حزم ⁨Python⁩ (⁨PyPI⁩):

pip install nextpdf

تحتاج مجموعة تطوير البرامج (⁨SDK⁩) إلى ⁨Python 3.10⁩ أو أحدث ونقطة وصول لخادم ⁨NextPDF Server⁩ يمكن الوصول إليها. راجِع دليل البدء السريع لمجموعة تطوير البرامج (⁨SDK⁩) الخاصة بلغة ⁨Python⁩.

التحقّق من التثبيت

تأكّد من تثبيت كل توزيعة بشكل صحيح قبل أن تبدأ كتابة التعليمات البرمجية.

Core / PHP

composer show nextpdf/core

يؤكّد سطر الإصدار أن المحرّك مثبّت ومتاح لمُحمّل التحميل التلقائي.

Laravel

php artisan package:discover --ansi

تُدرِج المُخرجات nextpdf/laravel ضمن الحزم المُكتشَفة.

Symfony

php bin/console debug:container nextpdf

تُبلغ الحاوية عن الاسم البديل nextpdf.document وخدمة PdfFactory.

Server

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

يُقلع هذا الأمر السجلّ ويطبع الأدوات التي يكشفها هذا التثبيت دون بدء خادم.

Python

nextpdf version

تؤكّد سلسلة الإصدار أن مجموعة تطوير البرامج (⁨SDK⁩) تُستورَد بشكل سليم.

انظر أيضًا

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

اختر مسارك قرّر أيُّ توزيعة وأيُّ مُصيّر HTML يناسبان تطبيقك.

التكاملات خريطة الامتدادات الكاملة ودليل الاختيار.

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