كتاب وصفات PHP

كتاب وصفات ⁨PHP⁩

يسرد هذا الفهرس وصفات ⁨NextPDF⁩ الأصيلة في ⁨PHP⁩: صفحات قابلة للتشغيل ومركَّزة على المهام، مكتوبة مباشرةً مقابل واجهة ⁨PHP⁩ الأساسية. توجد كل وصفة في المستودع الأساسي nextpdf وتُتحقَّق ضمن docs/public/cookbook/php/. لكل وصفة سكربت examples/*.php واختبار مِهاد ضمن tests/Cookbook/Php/. يسحب المُجمِّع بعد ذلك كل صفحة إلى هذا الموقع ويحفظ منشأها المصدري.

بما أن هذه الصفحة فهرس، فهي لا تقدّم أي ادعاءات سلوكية عن أي وصفة. يسجّل كل صف غرض الوصفة، والوحدة الأساسية التي تستخدمها، وملف قابلية إعادة الإنتاج المعلَن لها. ويعود الملف وأي ادعاء بالمطابقة إلى صفحة الوصفة نفسها؛ فكلاهما يأتي من بيانات تلك الصفحة الأمامية ومن اختبارها داخل المستودع، لا من هذا الفهرس. للاطلاع على كتاب وصفات التكامل (إطار العمل / المُصيِّر / الخدمة)، راجع كتاب وصفات التكامل. للاطلاع على العقد الذي تتبعه كل وصفة قابلة للتشغيل، راجع اصطلاحات الوصفات.

كيف تُنظَّم مُعرِّفات الوصفات

تُؤلَّف كل وصفة في المستودع الأساسي ضمن docs/public/cookbook/php/، ويَنشرها المُجمِّع في هذا الموقع. يتبع كل مُعرِّف اصطلاحًا واحدًا: مقطعًا واحدًا.

/cookbook/php/<recipe>/

يسمّي <recipe> غرض الوصفة بصيغة ⁨kebab-case⁩ (على سبيل المثال render-html-to-pdf، لا اسم الوحدة html). ويكون بأحرف صغيرة، ومفصولًا بشرطات، وخاليًا من أرقام الإصدارات، وينتهي بشَرطة مائلة لاحقة واحدة.

ملف قابلية إعادة الإنتاج، في سطر واحد

تعلن كل وصفة عن أصرم ملف يمكنها استيفاؤه بدقة:

• ⁨bitwise⁩ — متطابق على مستوى البايت عبر عمليات التشغيل (محتوى حتمي بسيط مع تثبيت كل مصادر العشوائية).
• ⁨structural⁩ — متطابق بعد تسوية الذرّات المتقلّبة (وسم /ID في المُذيَّل، وتواريخ ⁨creation/modification⁩، وبادئات تجزئة الخطوط — وعمليًا يشمل ذلك كل ملف ⁨PDF⁩ متعدد الكائنات).
• ⁨semantic⁩ — تكافؤ شجرة البنية المجرّدة (⁨structural-AST⁩) مع تكافؤ البيانات الوصفية فقط (مُخرَج موقَّع أو مختوم بطابع زمني، أو مُخرَج تكافؤه غير ثابت على مستوى البايت بطبيعته).

تُثبت صفحة الوصفة الملفَّ عبر اختبار مِهادها. ولا يتجاوز دور هذا الفهرس الإبلاغ عن القيمة التي تعلنها تلك الصفحة.

الأساسيات

بناء مستند وتقسيمه إلى صفحات وتنسيقه.

الوصفة	ما تؤديه	الوحدة	الملف
render-html-to-pdf	تصيير مستند ⁨HTML⁩ إلى ⁨PDF⁩	⁨Html⁩	⁨structural⁩
style-with-css	تطبيق ⁨CSS⁩ على تصيير ⁨HTML⁩	⁨Html⁩	⁨structural⁩
html-table-layout	تخطيط جدول ⁨HTML⁩	⁨Html⁩	⁨structural⁩
paginate-long-html	تقسيم مستند ⁨HTML⁩ طويل إلى صفحات	⁨Html⁩	⁨structural⁩
paginate-large-html-tables	تقسيم جدول ⁨HTML⁩ كبير عبر عدة صفحات	⁨Html⁩	⁨structural⁩
render-rtl-arabic-html	تصيير ⁨HTML⁩ عربي من اليمين إلى اليسار	⁨Html⁩	⁨structural⁩
compose-text-and-fonts	تأليف النص مع التحكّم الطباعي	الطباعة	⁨structural⁩
embed-and-subset-fonts	تضمين الخطوط وتجزئتها	الخط	⁨structural⁩
cjk-vertical-writing	ضبط نص ⁨CJK⁩ في وضع الكتابة العمودية	الطباعة	⁨structural⁩
multi-page-document	بناء مستند متعدد الصفحات	المستند	⁨structural⁩
headers-and-footers	إضافة ترويسات وتذييلات جارية	التخطيط	⁨structural⁩

الرسوميات والمحتوى

العمل مع المتجهات والصور والطبقات وفضاء الإحداثيات.

الوصفة	ما تؤديه	الوحدة	الملف
draw-vector-graphics	رسم رسوميات متجهة	الرسوميات	⁨structural⁩
gradients-and-transparency	تطبيق التدرّجات والشفافية	الرسوميات	⁨structural⁩
embed-images	تضمين الصور النقطية	المحتوى	⁨structural⁩
add-watermarks-and-backgrounds	إضافة علامات مائية نصية وصورية أو خلفيات إلى الصفحات	المحتوى	⁨structural⁩
cmyk-spot-color-and-icc-profiles	إنتاج ⁨CMYK⁩ ولون موضعي جاهزَين للطباعة	اللون	⁨structural⁩
embed-file-attachments	تضمين الملفات وإنشاء حافظات ⁨PDF⁩	المحتوى	⁨structural⁩
optional-content-layers	استخدام المحتوى الاختياري (الطبقات)	الرسوميات	⁨structural⁩
transform-coordinate-space	تحويل فضاء الإحداثيات	الرسوميات	⁨structural⁩

التنقّل والنماذج

إضافة إشارات مرجعية وروابط وتعليقات توضيحية وحقول ⁨AcroForm.⁩

الوصفة	ما تؤديه	الوحدة	الملف
bookmarks-and-toc	بناء الإشارات المرجعية وجدول المحتويات	التنقّل	⁨structural⁩
generate-dynamic-table-of-contents	توليد جدول محتويات ديناميكي	التنقّل	⁨structural⁩
links-and-annotations	إضافة الروابط والتعليقات التوضيحية	التنقّل	⁨structural⁩
generate-barcodes	توليد الباركود	الباركود	⁨bitwise⁩
gs1-composite-barcodes	توليد باركود ⁨GS1 Composite⁩ (حامل ⁨CC-C⁩)	الباركود	⁨structural⁩
fill-pdf-form	تعبئة نموذج ⁨AcroForm⁩	النموذج	⁨structural⁩
flatten-form-fields	تسطيح حقول النموذج	النموذج	⁨structural⁩
form-field-validation-and-flatten-with-state	التحقّق من حقول النموذج وتسطيحها مع الحالة	النموذج	⁨structural⁩

معلومات المستند

ضبط البيانات الوصفية وسلوك العارض.

الوصفة	ما تؤديه	الوحدة	الملف
set-document-metadata	ضبط البيانات الوصفية للمستند	البيانات الوصفية	⁨structural⁩
set-viewer-preferences	ضبط تفضيلات العارض	المستند	⁨structural⁩

عمليات المستند

تجميع المستندات الموجودة وتقسيمها وتحسينها.

الوصفة	ما تؤديه	الوحدة	الملف
merge-external-pdfs	دمج ملفات ⁨PDF⁩ خارجية أو إلحاق صفحات	المستند	⁨structural⁩
split-and-extract-pages	تقسيم ملف ⁨PDF⁩ واستخراج نطاقات الصفحات	المستند	⁨structural⁩
optimize-pdf-file-size	تقليل حجم ملف ⁨PDF⁩ عبر الضغط والتجزئة	المستند	⁨structural⁩

الأمان والتوقيع والمطابقة

استخدام التشفير والتوقيع وإمكانية الوصول وإخراج الملفات. تترك هذه الوصفات حدّي الدعم≠المطابقة والوجود≠الصلاحية لصفحة الوصفة.

الوصفة	ما تؤديه	الوحدة	الملف
encrypt-aes256	التشفير باستخدام ⁨AES-256⁩ وضبط أعلام الأذونات	الأمان	⁨structural⁩
encrypt-with-permissions	التشفير مع أعلام الأذونات	الأمان	⁨structural⁩
sign-pades-b-b	تطبيق توقيع ⁨PAdES⁩ (⁨B-B⁩ و⁨B-T⁩)	الأمان	⁨semantic⁩
inspect-existing-signature	فحص توقيع قائم	الفحص	⁨semantic⁩
tagged-pdf-ua2	إصدار البنية الموسومة لـ ⁨PDF/UA-2⁩	إمكانية الوصول	⁨semantic⁩
accessible-pdfua2-from-html	إصدار البنية الموسومة لتأليف ⁨PDF/UA-2⁩ متاح الوصول من ⁨HTML⁩	إمكانية الوصول	⁨semantic⁩
pdf-a-4-output	إنتاج مُخرَج ⁨PDF/A-4⁩	المطابقة	⁨semantic⁩
pdfa4-conformance-gate	إنتاج مُخرَج ⁨PDF/A-4⁩ والاحتكام إلى مُحقِّق خارجي	المطابقة	⁨semantic⁩
validate-conformance	التحقّق مقابل ملف مطابقة	الامتثال	⁨semantic⁩

الفحص والاستخراج

قراءة المحتوى والبنية مرة أخرى من ملف ⁨PDF.⁩

الوصفة	ما تؤديه	الوحدة	الملف
extract-text-content	استخراج المحتوى النصي	النص	⁨semantic⁩
multilingual-copy-paste-extraction	جعل النسخ واللصق صحيحًا في ملفات ⁨PDF⁩ بلغة ⁨CJK⁩ والعربية	النص	⁨structural⁩
parse-and-inspect-pdf	تحليل ملف ⁨PDF⁩ وفحصه	الفحص	⁨semantic⁩
inspect-layout-boxes	فحص صناديق التخطيط	الفحص	⁨semantic⁩

وصفات شاملة لعدة مجالات

استخدام أنماط تمتد عبر عدة وحدات.

الوصفة	ما تؤديه	النطاقات	الملف
worker-safe-batch-rendering	التصيير بأمان داخل عامل طويل التشغيل (سجلّات مشتركة، ذاكرة محدودة)	⁨Core⁩ · ⁨Performance⁩ · ⁨Support⁩	⁨semantic⁩
streaming-and-memory	تحليل أداء البثّ واستخدام الذاكرة	⁨Performance⁩	⁨bitwise⁩
exception-aware-error-handling	معالجة الأخطاء عبر تسلسل استثناءات ⁨NextPDF⁩	⁨Exception⁩ · ⁨Contracts⁩	⁨structural⁩
custom-error-recovery-patterns	تنفيذ استراتيجيات مخصّصة لاستعادة الأخطاء وإعادة المحاولة	⁨Exception⁩	⁨semantic⁩
observe-with-opentelemetry	مراقبة التصيير عبر ⁨OpenTelemetry⁩	⁨Observability⁩ · ⁨Telemetry⁩ · ⁨Event⁩	⁨semantic⁩

تُنشَر كل وصفة أعلاه مع سكربت examples/*.php داعم واختبار مِهاد tests/Cookbook/Php/ في المستودع الأساسي. وعندما تُؤلَّف وصفة جديدة في المنبع، تظهر هنا فور وصول مثالها واختبارها.

انظر أيضًا

• كتاب وصفات التكامل — فهرس تكامل إطار العمل والمُصيِّر والخدمة.
• اصطلاحات الوصفات — العقد الذي تتبعه كل وصفة قابلة للتشغيل في كتاب الوصفات هذا.