في هذا البرنامج التعليمي، سنقوم بإنشاء وظيفة مساعدة في تطبيق Laravel لتحويل محتوى Markdown إلى HTML باستخدام مكتبة الدوري/العلامات المشتركة. سنغطي خطوات إنشاء ملف مساعد، وإدراجه في مشروع Laravel الخاص بنا، واستخدامه في قالب Blade. تُستخدم هذه الآلية في Laravel 11 لإتاحة الوظائف عالميًا.

اختياري: التعامل مع تحويل تخفيض السعر في وحدة التحكم

البديل هو معالجة تحويل Markdown في وحدة التحكم قبل تمرير البيانات إلى العرض، لذلك لم نعد بحاجة إلى إنشاء ملف مساعد:

use League\CommonMark\CommonMarkConverter;

public function show($id)
{
    $course = Course::find($id);
    $converter = new CommonMarkConverter();

    $post->description = $converter->convertToHtml($post->description);

    return view('post.show', compact('post'));
}

إنشاء ملف مساعد لإتاحة وظيفة التحويل في قالب الشفرة

الخطوة 1: تثبيت الدوري/العلامة المشتركة

أولاً، نقوم بتثبيت مكتبة الدوري/العلامة المشتركة عبر Composer:

composer require league/commonmark

الخطوة 2: إنشاء ملف helpers.php

بعد ذلك، سنقوم بإنشاء ملف helpers.php لتحديد وظيفة المساعد لدينا. يمكن وضع هذا الملف في دليل التطبيق أو في أي مكان مفضل آخر.

touch app/helpers.php

افتح app/helpers.php وأضف المحتوى التالي:

convertToHtml($markdown);
    }
}

الخطوة 3: تضمين ملف المساعد في Composer

لضمان قيام Laravel تلقائيًا بتحميل ملف helpers.php، نحتاج إلى تعديل ملف Composer.json لإضافة المسار إلى helpers.php ضمن قسم التحميل التلقائي:

"autoload": {
    "files": [
        "app/helpers.php"
    ]
}

الخطوة 4: إعادة إنشاء ملفات التحميل التلقائي للملحن

بعد تعديل Composer.json، قم بإعادة إنشاء ملفات التحميل التلقائي للملحن عن طريق تشغيل:

composer dump-autoload

الخطوة 5: استخدم وظيفة المساعد في قوالب النصل

مع تحديد وظيفة المساعد وتحميلها، يمكننا الآن استخدامها في قوالب Blade لتحويل Markdown إلى HTML:

    {!! markdownToHtml($post->description) !!}

تم توفير هذا البرنامج التعليمي لإظهار كيف يمكننا توفير وظائف مخصصة في قوالب النصل.