كتاب الوصفات

لمحة سريعة

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

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

وصفات ⁨PHP⁩

تشغِّل وصفات ⁨PHP⁩ المحرك الأساسي مباشرةً ضمن العملية نفسها. تبدأ كل وصفة بـ composer require nextpdf/core، ثم تستخدم واجهة برمجة التطبيقات العامة لإنشاء المستندات أو توقيعها أو فحصها أو تحويلها، بما في ذلك Document::createStandalone() وwriteHtml().

وصفات PHP خريطة كل وصفة أصيلة في PHP: تصيير HTML إلى PDF، وتخطيط الجداول، وتضمين الخطوط وتجزئتها، والتشفير بـ AES-256، والتوقيع بـ PAdES، وإصدار PDF/A-4 وPDF/UA-2 الموسوم، واستخراج النص، وفحص الملفات الموجودة.

وصفات ⁨Connect⁩

تستدعي وصفات ⁨Connect⁩ خدمة ⁨NextPDF⁩ عبر سجل أدوات الخادم باستخدام بروتوكول سياق النموذج (⁨MCP⁩)، أو نقل الحالة التمثيلية (⁨REST⁩)، أو ⁨gRPC.⁩ ينطبق استدعاء الأداة نفسه على وسائل النقل الثلاث كلها، ويبقى خلف بوابة تأكيد بتدخل بشري.

وصفات Connect وصفات مستقلة عن وسيلة النقل لخادم NextPDF Connect: مرحباً بالعالم، وجداول HTML، وتضمين الصور، والتوقيعات الرقمية، وفحوصات إمكانية الوصول والامتثال، والتنقيح، والتحليل الجنائي، وقابلية المراقبة باستخدام OpenTelemetry.

وصفات التكامل

توضح وصفات التكامل كيفية ربط ⁨NextPDF⁩ بإطار عمل للتطبيقات، أو تفويض التصيير إلى خلفية خارجية. وتغطي محولات أطر العمل، وجسور المُصيِّرات، ومسار الترحيل من مكتبة قديمة.

وصفات التكامل وصفات لحزم النظام البيئي: اختيار تكامل، وإرجاع PDF من متحكم في إطار عمل، وإدراج التوليد في طابور مهمة في الخلفية، وتصيير HTML باستخدام Artisan، وتحويل ملفات Office باستخدام Gotenberg، والتصيير على الحافة باستخدام Cloudflare، واتباع مسار الترحيل من TCPDF.

أعراف الوصفات

تلتزم كل وصفة بعقد موثَّق: نماذج مدعومة بالمصدر، ومقدمة بيانات لملف قابلية إعادة الإنتاج، وحد امتثال صادق، وبوابة النشر. اقرأ صفحة الأعراف الخاصة بعائلة وصفتك قبل تكييف أي نموذج.

أعراف وصفات التكامل العقد الذي تتبعه كل وصفة تكامل قابلة للتشغيل: نماذج مدعومة بالمصدر، ومقدمة بيانات لملف قابلية إعادة الإنتاج، وبوابة النشر.

أعراف وصفات Connect العقد الذي تتبعه كل وصفة Connect: استدعاءات أدوات مستقلة عن وسيلة النقل، وأدوات مشروطة بالطبقة، ونموذج المخاطر وبوابة التأكيد، وحد الامتثال الصادق.

انظر أيضاً

الأدلة — توثيق مفاهيمي وإرشادي.
المرجع — واجهة برمجة التطبيقات (⁨API⁩) المتحقَّق منها ومصفوفة دعم صفحات الأنماط المتتالية (⁨CSS⁩).
اختيار تكامل — مصفوفة قرارات تربط حالات الاستخدام بعمليات التكامل.