docxmustache

docxmustache لـ Laravel 10.x.

فئة معالجة قالب Docx لـ Laravel 10.x، استنادًا إلى لغة قوالب الشارب. لا يزال هذا الفصل قيد التطوير المكثف ويعمل كدليل على المفهوم في الوقت الحالي. سوف تتغير الأمور بسرعة وقد تنكسر الأشياء.

تساعدك هذه الحزمة على استخدام ملفات docx ذات صيغة الشارب كقوالب لدمج المستندات الغنية بالمعلومات من أي مصدر بيانات. يمكنه استبدال النص والصور ويدعم تصميم HTML الأساسي (غامق ومائل وتسطير).

تثبيت

composer require wrklst/ docxmustache

يرجى التحقق من التبعيات أدناه ومجلد الأمثلة للتكوين والاستخدام.

تحويل HTML

يعد تحويل HTML الحالي أمرًا أساسيًا ويدعم فقط عمليات التشغيل المفردة للنص الغامق والمائل والمسطر ولا يحتوي على مجموعة من هذه النصوص. يتطلب الأمر الهروب من جميع القيم غير html باستخدام htmlspecialchars($value, ENT_COMPAT, 'UTF-8'); وبادئة *[[DONOTESCAPE]]* حتى يعرف الفصل عدم الهروب من html قبل تحويله إلى openXML.

استبدال الصور

يجب أن تكون الصورة عنوان URL يمكن الوصول إليه مع صورة بتنسيق مدعوم. يجب وضع قيمة عنوان url في حقل وصف النص البديل للصورة. سيتم إعادة تشكيل الصور وفقًا لقيود صورة العنصر النائب. يجب تنسيق قيمة الصورة باستخدام علامات زائفة حولها، مثل: [IMG-REPLACE]http://placehold.it/350x150[/IMG-REPLACE]

مثال

يرجى أيضًا الاطلاع على المثال الموجود في مجلد المثال للحصول على فهم أساسي لكيفية استخدام هذا الفصل.

تحويل DOCX إلى PDF

يتطلب التحويل إلى PDF تثبيت libreoffice-common على الخادم (يستخدم للتحويل). استخدم sudo apt install libreoffice-common على خادمك المستند إلى ubuntu/debian. قم أيضًا بتثبيت ttf-mscorefonts إذا كنت بحاجة إلى دعم لخط Arial عند تحويل مستندات docx إلى pdf sudo apt-get install ttf-mscorefonts-installer

تبعيات أخرى

تعتمد الحزمة على عدة وظائف محددة في Laravel. يمكن نقله بسهولة إلى أطر عمل أخرى أو يمكن نقله ليكون إطارًا ملحدًا. بالإضافة إلى تبعية Laravel، تستخدم الصفحة الحزم التالية:

• شارب / شارب
• التدخل/الصورة (يتطلب إضافة موفر واسم مستعار إلى تكوين التطبيق الخاص بك بالإضافة إلى gd أو imagick، يرجى مراجعة صفحة ويب تدخل الصورة للحصول على التفاصيل)

تبعيات Laravel المحددة (ذات صلة فقط إذا تم نقلها إلى بيئة غير Laravel):

• فئة التخزين والملفات، استنادًا إلى Flysystem (للوصول إلى الملفات المحلية، يمكن أيضًا استبدالها بطرق fopen الخاصة بـ phps وما إلى ذلك)
• SymfonyComponentProcessProcess (فقط لتحويل PDF)

المساهمات

إذا كنت ترغب في المساهمة بشيء ما في هذه الحزمة، فلا تتردد في تقديم طلب سحب ومشكلة مقابلة وسنكون سعداء بمراجعتها ومناقشتها.

لماذا حل قالب openXML/docx آخر؟

هناك بعض الفئات التي تساعد في كتابة و/أو تغيير محتوى مستندات Word، بعضها بتراخيص تجارية وبعضها الآخر مجاني. لتحقيق هدفنا الخاص، لم نكن بحاجة إلى معظم الميزات المتوفرة في العديد من المكتبات - كنا بحاجة إلى حل بسيط يسمح باستبدال القيم والصور واجتياز البيانات بطريقة سهلة ومباشرة.

تستخدم العديد من المكتبات الأخرى الاستنساخ لتكرار كتلة باستخدام بعض صيغ القوالب المخصصة بدلاً من استخدام صيغة القالب الموجودة. نستخدم صيغة الشارب المعتادة أيضًا لتحقيق محتوى متكرر في العديد من الأبعاد حسب الحاجة.

فئات PHP الأخرى لمعالجة مستندات Word openXML:

• openTBS – صغير لكن قوي
• PHPWord
• docxtemplater pro (الإصدار الأساسي مفتوح المصدر / الإصدار المجاني / ترخيص MIT متاح حتى وقت الكتابة؛ استبدال الصور هو مكون إضافي تجاري)
• دوك اكسبريسو (تجاري)
• phpdocx (تجاري)