Cloudflare · Integration
تكامل Cloudflare
نظرة سريعة
قسم بعنوان «نظرة سريعة»استخدم nextpdf/cloudflare لعرض ملفات PDF عند الحافة، أو تخزين ملفات PDF المُنشأة في R2، أو التحقق من طلبات واجهة برمجة التطبيقات (API) على مستوى الحزمة قبل أن تصل إلى نقطة نهاية الـ worker.
خريطة الأقسام
قسم بعنوان «خريطة الأقسام»| الصفحة | يُستخدَم في |
|---|---|
| نظرة عامة | نطاق الحزمة وسير العمل المدعوم. |
| التثبيت | التثبيت عبر Composer ومتطلبات Cloudflare الأساسية. |
| البدء السريع | سير عملك الأول لعرض PDF عند الحافة. |
| الإعداد | مفاتيح إعداد الـ worker، وحماية الـ API، وR2. |
| API | واجهات برمجة تطبيقات العارض والحمولة ومحلِّل الاستجابة، وحماية الـ API، وأرشيف R2، والنقل المُثبَّت. |
| دليل المطوِّر | دورة الحياة عند الحافة، وحدود الطلبات، والرجوع إلى البديل المحلي، ونقاط التوسعة. |
| الاستخدام في بيئة الإنتاج | أنماط النشر والتشغيل. |
| الأمان والتشغيل | التحقق من محدِّد موقع الموارد الموحَّد (URL) للـ worker، وحدود الحجم، والتثبيتات، وضوابط R2. |
| استكشاف الأخطاء وإصلاحها | حالات الفشل الشائعة في العرض عند الحافة والأرشفة. |
واجهات برمجة التطبيقات الأساسية
قسم بعنوان «واجهات برمجة التطبيقات الأساسية»| الرمز | الدور |
|---|---|
NextPDF\Cloudflare\CloudflareHtmlRenderer | يرسل طلبات عرض لغة ترميز النص التشعبي (HTML) إلى worker تابع لـ Cloudflare. |
NextPDF\Cloudflare\CloudflareRendererConfig | كائن إعداد غير قابل للتغيير لعارض الـ worker. |
NextPDF\Cloudflare\ApiProtection | بوابة تتحقق من حجم الطلب والعميل ومفتاح الـ API. |
NextPDF\Cloudflare\R2ArchiveManager | يرفع بايتات ملفات PDF المُنشأة وينشئ عناوين URL موقَّعة. |
NextPDF\Cloudflare\Transport\PinnedCurlTransport | طبقة نقل متوافقة مع توصية PHP المعيارية (PSR)-18، مع دعم تثبيت المفتاح العام. |