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

Vorstellung von laravel/chisel. Ein Paket, das Primitive für Post-Install-Skripte bereitstellt, mit denen sich nicht benötigte Funktionen aus einem Starterkit entfernen lassen. Im Mai 2026 als v0.1 veröffentlicht.

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.