الأدلة

نظرة سريعة

تشرح هذه الأدلة كيفية ربط ⁨NextPDF⁩ بالبيئة التي تعمل فيها شفرتك. يبدأ هذا التبويب بـ قائمة التحقق من عمليات الإنتاج، ثم يغطي خمسة مجالات مرتبة وفق مسار التبنّي: تكاملات أطر العمل وأدوات العرض، وخادم ⁨NextPDF Connect⁩، وحزمة ⁨Python SDK⁩، وإنشاء امتدادات للمحرك، واستكشاف الأخطاء وإصلاحها. يبدأ كل قسم أدناه بصفحته المركزية، ثم يسرد الصفحات التي ستحتاج إليها غالبًا.

للحصول على وصفة قابلة للنسخ وموجَّهة إلى مهمة محددة، استخدم كتاب الوصفات. وللاطلاع على سطح واجهة برمجة التطبيقات (⁨API⁩) المُتحقَّق منه ومصفوفات الدعم، استخدم المرجع.

عمليات التكامل

تربط حزم المحرك الأساسي الثماني بأطر العمل، ومُصيّرات المتصفح، وخدمات الحافة، وأدوات البناء، ومسارات ترحيل الأنظمة القديمة. ويتّبع كل قسم خاص بحزمة ما بنية الدليل نفسها: نظرة عامة، والتثبيت، والبدء السريع، والتهيئة، و⁨API⁩، ودليل المطوّر، والاستخدام في الإنتاج، والأمان، واستكشاف الأخطاء وإصلاحها. وبعد أن تتعرّف على وثائق حزمة واحدة، ستبدو بنية بقية الوثائق مألوفة لك.

الصفحة	الغرض منها
عمليات التكامل	خريطة الامتدادات ودليل الاختيار. اقرأها أولًا حتى تختار الحزمة المناسبة.
فهرس ⁨API⁩ لعمليات الدمج	صفحة واجهات الامتداد التي تغطي كل إطار عمل، ومُصيِّر، وآلية نقل، وواجهة أداة بناء.
تكامل ⁨Laravel⁩	مهايئ إطار عمل ⁨Laravel⁩.
التكامل مع ⁨Symfony⁩	مهايئ إطار عمل ⁨Symfony⁩.
تكامل ⁨CodeIgniter⁩	مهايئ إطار عمل ⁨CodeIgniter⁩.
تكامل ⁨Artisan⁩	جسر مُصيِّر ⁨Chrome⁩ لعرض ⁨HTML⁩ بجودة المتصفح.
تكامل ⁨Cloudflare⁩	مسار النشر على الحافة في ⁨Cloudflare⁩.
تكامل ⁨Gotenberg⁩	جسر مُصيِّر ⁨Gotenberg⁩.
توافق ⁨TCPDF⁩	طبقة التوافق لقواعد الشفرة المرحّلة من ⁨TCPDF⁩.
NextPDF Backport Builder	أداة البناء التي تستهدف بيئات تشغيل ⁨PHP⁩ الأقدم.

NextPDF Connect

تشغّل حزمة nextpdf/server المحرك كخدمة طويلة العمر: سجلّ أدوات حتمي واحد يُقدَّم عبر بروتوكول سياق النموذج (⁨MCP⁩)، وبروتوكول نقل الحالة التمثيلي (⁨REST⁩)، و⁨gRPC⁩، خلف بوابة تأكيد تتطلب مراجعة بشرية للأدوات عالية المخاطر.

الصفحة	الغرض منها
⁨NextPDF Connect⁩	مركز القسم: مفاهيم الخادم وتهيئته وتشغيله.
نظرة عامة على خادم ⁨NextPDF Connect⁩	حدود الحزمة ووسائل النقل الثلاث.
بدء سريع مع ⁨NextPDF Connect⁩	أول مصافحة ⁨MCP⁩ قابلة للتشغيل، وطلب التصيير المقابل عبر ⁨REST⁩.
تهيئة ⁨NextPDF Connect⁩	ملف ⁨MCP YAML⁩ ومتغيرات البيئة `NEXTPDF_*`.
مرجع ⁨API⁩ في ⁨NextPDF Connect⁩	كل أداة مسجَّلة، وكل رمز ⁨gRPC⁩، وكل مدخل في نموذج الأخطاء، وحدّ المعدّل.
نشر ⁨NextPDF Connect⁩	ملفات تعريف عمّال ⁨RoadRunner⁩، و⁨Docker⁩، والمخازن المدعومة من ⁨Redis⁩.
الأمان والعمليات في ⁨NextPDF Connect⁩	المصادقة، وأمان النقل، ونموذج التهديد.

لكل وسيلة نقل صفحتها المرجعية الخاصة.

الصفحة	الغرض منها
⁨NextPDF Connect⁩ — نقل ⁨MCP⁩	تأطير ⁨JSON-RPC 2.0⁩ عبر الإدخال والإخراج القياسيَّين.
⁨NextPDF Connect⁩ — وسيلة نقل ⁨REST⁩	عقد ⁨OpenAPI 3.1⁩، ومصادقة الحامل، والمسارات المقيَّدة بحسب الطبقة.
⁨NextPDF Connect⁩ — ناقل ⁨gRPC⁩	خدمة `nextpdf.connect.v1`، والبث من الخادم، والمصادقة عبر البيانات الوصفية.

Python SDK

استخراج ⁨PDF⁩ جاهز للاستشهاد في تطبيقات ⁨Python⁩ والوكلاء وسطر الأوامر، بدعم من نقطة نهاية ⁨NextPDF Connect⁩.

الصفحة	الغرض منها
حزمة تطوير برمجيات ⁨Python⁩	مركز القسم لحزمة ⁨Python⁩ المسماة `nextpdf`.
نظرة عامة على حزمة تطوير برامج ⁨Python⁩	ما تفعله حزمة ⁨SDK⁩ وكيف ترتبط بـ ⁨Connect⁩.
البدء السريع مع ⁨Python SDK⁩	التثبيت عبر `pip install nextpdf` وتوجيه العميل إلى خادمك.
مرجع واجهة برمجة التطبيقات بلغة ⁨Python⁩	فئات العميل ودوالّه والنتائج المُنمَّطة.
واجهة سطر الأوامر في ⁨Python⁩	واجهة سطر الأوامر لتدفقات عمل الاستخراج.
خادم ⁨MCP⁩ للغة ⁨Python⁩	إتاحة حزمة ⁨SDK⁩ للوكلاء المتوافقين مع ⁨MCP⁩.

توسيع المحرك

تتيح لك واجهة موفّر الخدمة العامة (⁨SPI⁩) إضافة إمكانات من دون تفريع الشفرة: عقود للخطوط، ومحركات التخطيط، ومستمعي الأحداث، وخلفيات التوقيع، مع وعد استقرار صريح لكل منها.

الصفحة	الغرض منها
إنشاء الامتدادات: نظرة عامة على واجهة ⁨SPI⁩ العامة	ما يمكنك توسيعه ووعد الاستقرار المصاحب له.
قواعد استقرار ⁨SPI⁩	عقد التوافق العكسي الذي يمكن لامتدادك الاعتماد عليه.
الخطوط المخصصة: عقد امتداد ⁨FontRegistry⁩	تسجيل خطوطك الخاصة وتوزيعها.
محركات التخطيط المخصّصة واعتراض النص	استبدال سلوك التخطيط أو اعتراضه.
مشغّلات الإجراءات ومستمعو الأحداث	مراقبة دورة حياة المستند والتفاعل معها.
عقد مزود ⁨KMS⁩	توفير المفاتيح من خدمة إدارة المفاتيح (⁨KMS⁩) الخاصة بك.

استكشاف الأخطاء وإصلاحها

مداخل ترشدك من العَرَض إلى الحل، استنادًا إلى تصنيف الاستثناءات في المحرك نفسه. ابدأ بما تلاحظه، لا باسم الفئة.

الصفحة	الغرض منها
استكشاف الأخطاء وإصلاحها	مركز قاعدة المعرفة: كيف تُبنى المداخل ومن أين تبدأ.
استكشاف أخطاء الخطوط والوسم وإصلاحها	إخفاقات تضمين الخطوط ووسم البنية.
استكشاف أخطاء التشفير والأذونات وإصلاحها	إخفاقات التشفير وكلمات المرور والأذونات.
استكشاف أخطاء الذاكرة والأداء وإصلاحها	حدود الذاكرة القصوى ومشكلات الإنتاجية.
استكشاف أخطاء التحقق من ⁨PDF/A⁩ و⁨PDF/UA⁩ وإصلاحها	إخفاقات التحقق من الأرشفة وإمكانية الوصول.
استكشاف أخطاء التوقيع والطابع الزمني وإصلاحها	إخفاقات التحقق من التوقيع والطابع الزمني.

انظر أيضًا

كتاب الوصفات — وصفات موجَّهة بحسب المهمة لـ ⁨PHP⁩ و⁨Connect⁩ وعمليات التكامل.
المرجع — سطح ⁨API⁩ المُتحقَّق منه، ومصفوفات الدعم، ومرجع الأخطاء.
الترحيل إلى ⁨NextPDF⁩ — الانتقال من مكتبة ⁨PDF⁩ أخرى، ضمن تبويب البدء.
من داخل ⁨NextPDF⁩ — مقالات ⁨Insider_⁩ عن سبب سلوك المحرك على هذا النحو.