Laravel Chisel – Post-Install-Skript-Bibliothek für Starterkits

Dieser Artikel basiert auf einer Analyse des Quellcodes. Das Paket befindet sich in einem frühen Entwicklungsstadium und trägt gerade erst das Tag v0.1 (Stand: Mai 2026).

Was ist Laravel Chisel?

Laravel Chisel ist ein Paket, das Primitive bereitstellt, um Post-Install-Skripte zu bauen, welche nicht benötigte Funktionen aus einem Laravel-Starterkit entfernen. Starterkits enthalten viele vorgefertigte Funktionen; je nach Projekt sind aber nur ein Teil davon nötig. Chisel löst dieses Problem, indem es einen Mechanismus bereitstellt, mit dem sich nach der Installation interaktiv „nur die benötigten Funktionen behalten” lassen.

Warum wird das benötigt?

Laravel-Starterkits bündeln viele Funktionen, aber nicht in jedem Projekt sind alle davon nötig. Beispiele:

Projekte, die keine E-Mail-Verifizierung brauchen
Projekte, die keine Passkey-Authentifizierung nutzen
Konstellationen, in denen bestimmte Livewire-Komponenten nicht gebraucht werden

Bisher musste man nicht benötigte Features manuell entfernen. Mit Chisel lässt sich die Anpassung direkt bei der Installation über interaktive Prompts abschließen.

Definition des chisel.php-Skripts

Ein Starterkit, das Chisel nutzt, legt eine Datei chisel.php im Projekt-Root an. Darin wird definiert, „welche Funktionen optional sein sollen”.

<?php

require getenv('LARAVEL_INSTALLER_AUTOLOADER');

use Laravel\Chisel\Chisel;
use Laravel\Chisel\Question;

return Chisel::script(dirname(__DIR__))
    ->questions([
        Question::multiselect(
            name: 'auth_features',
            label: 'Which authentication features would you like to enable?',
            options: [
                'email-verification' => 'Email verification',
            ],
            hint: 'Use space to select, enter to confirm.',
        ),
    ])
    ->selected('auth_features', 'email-verification',
        then: function (Chisel $c) {
            // Bei Auswahl: Section-Marker entfernen, Code beibehalten
            $c->files(
                'resources/js/pages/settings/profile.tsx',
                'app/Providers/FortifyServiceProvider.php',
            )->removeSectionMarkers('email-verification');
        },
        else: function (Chisel $c) {
            // Wenn nicht gewählt: zugehörige Dateien und Funktionen entfernen
            $c->php('app/Models/User.php')
                ->removeImport('Illuminate\Contracts\Auth\MustVerifyEmail')
                ->removeInterface('MustVerifyEmail');

            $c->file('config/fortify.php')->removeLinesContaining('Features::emailVerification()');

            $c->files(
                'app/Providers/FortifyServiceProvider.php',
                'resources/js/pages/settings/profile.tsx',
            )->removeSection('email-verification');

            $c->files(
                'resources/js/components/email-verification-notice.tsx',
                'resources/js/pages/auth/verify-email.tsx',
                'tests/Feature/Auth/EmailVerificationTest.php',
                'tests/Feature/Auth/VerificationNotificationTest.php',
            )->delete();
        },
    );

Methoden zur Skript-Definition

Methode	Beschreibung
`Chisel::script($directory)`	Legt eine Skript-Definition an
`Question::multiselect(...)`	Definiert eine Mehrfachauswahl-Frage
`questions([...])`	Setzt die Fragen des Skripts
`questions()`	Gibt die registrierten Fragen zurück
`collectAnswers()`	Startet das Einsammeln der Antworten
`apply($callback)`	Registriert einen bedingungslosen Mutationsschritt
`selected($key, $value, then:, else:)`	Verzweigt bei einem einzelnen ausgewählten Wert
`selectedAny($key, $values, then:, else:)`	Verzweigt, wenn einer der Werte ausgewählt wurde
`selectedAll($key, $values, then:, else:)`	Verzweigt, wenn alle Werte ausgewählt wurden
`chisel($answers)`	Führt die registrierten Mutationen aus

Interaktives Einsammeln der Antworten

collectAnswers() gibt einen Answer-Collector zurück. Alle Methoden sind fluent und in beliebiger Reihenfolge aufrufbar. In nicht-interaktiven Umgebungen werden automatisch die Standardwerte verwendet. Ein externes Artisan-Kommando zeigt Prompts mithilfe von Laravel Prompts an und übergibt die Antworten an Chisel.

use Illuminate\Console\Command;
use Laravel\Chisel\Chisel;
use Laravel\Chisel\Question;
use RuntimeException;

use function Laravel\Prompts\multiselect;

class InstallFeatures extends Command
{
    protected $signature = 'install:features
        {--answers= : JSON string of answers to skip interactive prompts}';

    public function handle(): void
    {
        $script = require base_path('chisel.php');

        $providedAnswers = $this->option('answers') === null
            ? []
            : json_decode((string) $this->option('answers'), true, 512, JSON_THROW_ON_ERROR);

        $answers = $script
            ->collectAnswers()
            ->onQuestion(fn (Question $question) => match ($question->type) {
                'multiselect' => multiselect(
                    label: $question->label,
                    options: $question->options,
                    default: $question->default ?? [],
                    required: $question->required,
                    hint: $question->hint,
                ),
                default => throw new RuntimeException("Unsupported question type [{$question->type}]."),
            })
            ->interactive($this->input->isInteractive())
            ->withAnswers($providedAnswers);

        $script->chisel($answers);

        $chisel = Chisel::in(base_path());

        $chisel->npm()->install();
        $chisel->npm()->run('build');
    }
}

Methode	Beschreibung
`onQuestion($callback)`	Legt den Handler für Frage-Prompts fest
`interactive($interactive)`	Setzt den interaktiven Modus
`withAnswers($answers)`	Liefert vorab gesammelte Antworten und überspringt Prompts

Datei-Mutationen

Mit file($path) wird eine einzelne Datei, mit files(...$paths) mehrere Dateien angesprochen.

Methode	Beschreibung
`replace($search, $replace)`	Zeichenkette ersetzen
`removeLinesContaining($content)`	Zeilen mit der angegebenen Zeichenkette entfernen
`removeSectionMarkers($tag)`	Section-Marker entfernen, Inhalt beibehalten
`removeSection($tag)`	Section-Marker und den enthaltenen Inhalt entfernen
`delete()`	Zieldatei löschen

Bearbeitung auf Basis des PHP-AST

php($path) ermöglicht das Bearbeiten über den PHP-AST. Änderungen werden beim Zerstören des Objekts automatisch gespeichert. Die Grundlagen des PHP-AST (Abstract Syntax Tree) und die Nutzung von nikic/php-parser sind hier erläutert.

Methode	Beschreibung
`removeImport($class)`	`use`-Statement entfernen
`removeTrait($trait)`	Nutzung eines Traits aus einer Klasse entfernen
`removeInterface($interface)`	Implementiertes Interface entfernen

Section Marker

Optionaler Code wird von Kommentar-Paaren umschlossen.

/* @chisel-passkeys */
Fortify::authenticateUsingPasskeys();
/* @end-chisel-passkeys */

In JSX-Dateien werden Block-Kommentare mit geschweiften Klammern ({}) verwendet.

{
    /* @chisel-passkeys */
}
<PasskeyButton />;
{
    /* @end-chisel-passkeys */
}

removeSectionMarkers('passkeys') – entfernt die Marker, der Code bleibt erhalten
removeSection('passkeys') – entfernt sowohl Marker als auch Code

Das Präfix chisel- wird automatisch ergänzt.

npm-Unterstützung

Methode	Beschreibung
`npm()->install()`	Abhängigkeiten mit dem erkannten Paketmanager installieren
`npm()->run($script, ...$arguments)`	Ein Skript des Paketmanagers ausführen
`npm()->remove(...$packages)`	Pakete mit dem erkannten Paketmanager entfernen

Die Methode npm() erkennt npm, yarn, pnpm und bun automatisch.

Aktueller Entwicklungsstand

GitHub-Repository: laravel/chisel
Release: v0.1 (veröffentlicht Mai 2026)
Entwicklungszeit: nach dreimonatiger nicht-öffentlicher Entwicklung veröffentlicht

Chisel ist kein Paket, das Endnutzer direkt in einer Laravel-Anwendung installieren, sondern eine Bibliothek, die intern von Starterkits verwendet wird. Perspektivisch ist zu erwarten, dass die offiziellen Laravel-Starterkits Post-Install-Skripte auf Basis von Chisel anbieten.

Repository laravel/chisel

Quellcode und aktuelle API-Referenz finden Sie hier.

Offizielle Dokumentation der Laravel-Starterkits

Zur Nutzung der Starterkits selbst konsultieren Sie bitte die offizielle Dokumentation.

​Was ist Laravel Chisel?

​Warum wird das benötigt?

​Definition des chisel.php-Skripts

​Methoden zur Skript-Definition

​Interaktives Einsammeln der Antworten

​Datei-Mutationen

​Bearbeitung auf Basis des PHP-AST

​Section Marker

​npm-Unterstützung

​Aktueller Entwicklungsstand

Repository laravel/chisel

Offizielle Dokumentation der Laravel-Starterkits

Was ist Laravel Chisel?

Warum wird das benötigt?

Definition des chisel.php-Skripts

Methoden zur Skript-Definition

Interaktives Einsammeln der Antworten

Datei-Mutationen

Bearbeitung auf Basis des PHP-AST

Section Marker

npm-Unterstützung

Aktueller Entwicklungsstand