Dans ce didacticiel, nous allons créer une fonction d'assistance dans une application Laravel pour convertir le contenu Markdown en HTML à l'aide de la bibliothèque league/commonmark. Nous aborderons les étapes pour créer un fichier d'aide, l'inclure dans notre projet Laravel et l'utiliser dans un modèle Blade. Ce mécanisme est utilisé dans Laravel 11 pour rendre les fonctions disponibles globalement.

Facultatif : gestion de la conversion Markdown dans le contrôleur

L'alternative est de gérer la conversion Markdown dans le contrôleur avant de transmettre les données à la vue, nous n'avons donc plus besoin de créer un fichier d'assistance :

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'));
}

Création d'un fichier d'assistance pour rendre la fonction de conversion disponible dans le modèle de lame

Étape 1 : Installer la ligue/commonmark

Tout d'abord, nous installons la bibliothèque league/commonmark via Composer :

composer require league/commonmark

Étape 2 : Créez le fichier helpers.php

Ensuite, nous allons créer un fichier helpers.php pour définir notre fonction d'assistance. Ce fichier peut être placé dans le répertoire de l'application ou à tout autre emplacement préféré.

touch app/helpers.php

Ouvrez app/helpers.php et ajoutez le contenu suivant :

convertToHtml($markdown);
    }
}

Étape 3 : Inclusion du fichier d'assistance dans Composer

Pour garantir que Laravel charge automatiquement le fichier helpers.php, nous devons modifier le fichier composer.json pour ajouter le chemin d'accès à helpers.php dans la section de chargement automatique :

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

Étape 4 : Régénérer les fichiers de chargement automatique du Composer

Après avoir modifié composer.json, régénérez les fichiers de chargement automatique de Composer en exécutant :

composer dump-autoload

Étape 5 : Utiliser la fonction d'assistance dans les modèles de lame

Une fois la fonction d'assistance définie et chargée, nous pouvons désormais l'utiliser dans les modèles Blade pour convertir Markdown en HTML :

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

Ce didacticiel est fourni pour montrer comment nous pouvons rendre les fonctions personnalisées disponibles dans les modèles de lame.