В этом уроке мы создадим вспомогательную функцию в приложении Laravel для преобразования содержимого Markdown в HTML с использованием библиотеки League/Commonmark. Мы рассмотрим шаги по созданию вспомогательного файла, включению его в наш проект Laravel и использованию в шаблоне Blade. Этот механизм используется в Laravel 11 для обеспечения глобальной доступности функций.

Необязательно: обработка преобразования Markdown в контроллере

Альтернативой является обработка преобразования 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. Установите лигу/общую марку

Сначала мы устанавливаем библиотеку лиги/commonmark через Composer:

composer require league/commonmark

Шаг 2. Создайте файл helpers.php.

Далее мы создадим файл helpers.php для определения нашей вспомогательной функции. Этот файл можно разместить в каталоге приложения или в любом другом предпочтительном месте.

touch app/helpers.php

Откройте app/helpers.php и добавьте следующий контент:

convertToHtml($markdown);
    }
}

Шаг 3. Включение вспомогательного файла в Composer

Чтобы Laravel автоматически загружал файл helpers.php, нам нужно изменить файл композитора.json, добавив путь к helpers.php в раздел автозагрузки:

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

Шаг 4. Восстановите файлы автозагрузки Composer

После изменения файла Composer.json повторно создайте файлы автозагрузки Composer, выполнив:

composer dump-autoload

Шаг 5. Используйте вспомогательную функцию в шаблонах блейдов

Определив и загрузив вспомогательную функцию, мы теперь можем использовать ее в шаблонах Blade для преобразования Markdown в HTML:

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

Это руководство предназначено для того, чтобы показать, как можно сделать пользовательские функции доступными в шаблонах блейдов.