In diesem Tutorial erstellen wir eine Hilfsfunktion in einer Laravel-Anwendung, um Markdown-Inhalte mithilfe der League/Commonmark-Bibliothek in HTML zu konvertieren. Wir behandeln die Schritte zum Erstellen einer Hilfsdatei, zum Einbinden in unser Laravel-Projekt und zum Verwenden in einer Blade-Vorlage. Dieser Mechanismus wird in Laravel 11 verwendet, um Funktionen global verfügbar zu machen.

Optional: Markdown-Konvertierung im Controller verwalten

Die Alternative besteht darin, die Markdown-Konvertierung im Controller durchzuführen, bevor die Daten an die Ansicht übergeben werden, sodass wir keine Hilfsdatei mehr erstellen müssen:

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

Erstellen einer Hilfsdatei, um die Konvertierungsfunktion in der Blade-Vorlage verfügbar zu machen

Schritt 1: League/Commonmark installieren

Zuerst installieren wir die League/Commonmark-Bibliothek über Composer:

composer require league/commonmark

Schritt 2: Erstellen Sie die Datei „helpers.php“.

Als nächstes erstellen wir eine Datei „helpers.php“, um unsere Hilfsfunktion zu definieren. Diese Datei kann im App-Verzeichnis oder an einem anderen bevorzugten Ort abgelegt werden.

touch app/helpers.php

Öffnen Sie app/helpers.php und fügen Sie den folgenden Inhalt hinzu:

convertToHtml($markdown);
    }
}

Schritt 3: Einbinden der Hilfsdatei in Composer

Um sicherzustellen, dass Laravel die Datei „helpers.php“ automatisch lädt, müssen wir die Datei „composer.json“ ändern, um den Pfad zu „helpers.php“ im Abschnitt „Autoload“ hinzuzufügen:

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

Schritt 4: Composer-Autoload-Dateien neu generieren

Generieren Sie nach dem Ändern von „composer.json“ die Composer-Autoload-Dateien neu, indem Sie Folgendes ausführen:

composer dump-autoload

Schritt 5: Verwenden Sie die Hilfsfunktion in Blade-Vorlagen

Da die Hilfsfunktion definiert und geladen ist, können wir sie jetzt in den Blade-Vorlagen verwenden, um Markdown in HTML zu konvertieren:

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

Dieses Tutorial soll zeigen, wie wir benutzerdefinierte Funktionen in Blade-Vorlagen verfügbar machen können.