Laravel Chisel — een bibliotheek voor post-installatiescripts van starter kits

Dit artikel is gebaseerd op onderzoek van de broncode. Het is een pakket in een vroeg ontwikkelstadium dat net het v0.1-label heeft gekregen (stand: mei 2026).

Wat is Laravel Chisel?

Laravel Chisel is een pakket dat primitieven biedt voor het bouwen van post-installatiescripts waarmee je overbodige functies uit Laravel starter kits verwijdert. Starter kits bevatten veel functionaliteit out of the box, maar afhankelijk van het project heb je een deel daarvan niet nodig. Chisel lost dit op met een mechanisme waarmee je na de installatie interactief “alleen de functies behoudt die je nodig hebt”.

Waarom is dit nodig?

Laravel starter kits bundelen veel functionaliteit, maar niet elk project heeft alles nodig. Bijvoorbeeld:

Projecten die geen e-mailverificatie nodig hebben
Projecten die geen passkey-authenticatie gebruiken
Configuraties waarin bepaalde Livewire-componenten overbodig zijn

Voorheen moest je overbodige functies handmatig verwijderen, maar met Chisel rond je de aanpassingen af via interactieve prompts tijdens de installatie.

Het chisel.php-script definiëren

Een starter kit die Chisel gebruikt, plaatst een chisel.php-bestand in de projectroot. Dit bestand definieert welke functies optioneel zijn.

<?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) {
            // Indien geselecteerd: sectiemarkeringen verwijderen en de code behouden
            $c->files(
                'resources/js/pages/settings/profile.tsx',
                'app/Providers/FortifyServiceProvider.php',
            )->removeSectionMarkers('email-verification');
        },
        else: function (Chisel $c) {
            // Indien niet geselecteerd: gerelateerde bestanden en functies verwijderen
            $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 voor scriptdefinitie

Methode	Beschrijving
`Chisel::script($directory)`	Maakt een scriptdefinitie aan
`Question::multiselect(...)`	Definieert een meerkeuzevraag
`questions([...])`	Stelt de vragen van het script in
`questions()`	Haalt de geregistreerde vragen op
`collectAnswers()`	Start het verzamelen van antwoorden op de vragen
`apply($callback)`	Registreert een onvoorwaardelijke mutatiestap
`selected($key, $value, then:, else:)`	Vertakt op één geselecteerde waarde
`selectedAny($key, $values, then:, else:)`	Vertakt wanneer een van de waarden is geselecteerd
`selectedAll($key, $values, then:, else:)`	Vertakt wanneer alle waarden zijn geselecteerd
`chisel($answers)`	Voert de geregistreerde mutaties uit

Interactief antwoorden verzamelen

collectAnswers() retourneert een antwoordverzamelaar. Alle methoden zijn fluent en kunnen in willekeurige volgorde worden aangeroepen. In niet-interactieve omgevingen worden automatisch de standaardwaarden gebruikt. Een extern Artisan-commando toont de prompts met Laravel Prompts en geeft de antwoorden door aan 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	Beschrijving
`onQuestion($callback)`	Stelt de handler voor de vraagprompt in
`interactive($interactive)`	Stelt de interactieve modus in
`withAnswers($answers)`	Levert vooraf verzamelde antwoorden aan en slaat prompts over

Bestandsmutaties

Met file($path) richt je je op één bestand, met files(...$paths) op meerdere bestanden.

Methode	Beschrijving
`replace($search, $replace)`	Vervangt een string
`removeLinesContaining($content)`	Verwijdert regels die de opgegeven string bevatten
`removeSectionMarkers($tag)`	Verwijdert de sectiemarkeringen en behoudt de inhoud
`removeSection($tag)`	Verwijdert de sectiemarkeringen én de inhoud ertussen
`delete()`	Verwijdert het doelbestand

Bewerken op basis van de PHP-AST

php($path) biedt bewerkingen via de PHP-AST. De wijzigingen worden automatisch opgeslagen wanneer het object wordt vernietigd. De basis van de PHP-AST (abstract syntax tree) en het gebruik van nikic/php-parser worden hier uitgelegd.

Methode	Beschrijving
`removeImport($class)`	Verwijdert een `use`-statement
`removeTrait($trait)`	Verwijdert het gebruik van een trait uit een klasse
`removeInterface($interface)`	Verwijdert een geïmplementeerde interface

Section markers

Je omsluit optionele code met een paar commentaren.

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

In JSX-bestanden gebruik je blokcommentaren met accolades ({}).

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

removeSectionMarkers('passkeys') — verwijdert de markeringen, de code blijft staan
removeSection('passkeys') — verwijdert zowel de markeringen als de code

De prefix chisel- wordt automatisch toegevoegd.

npm-ondersteuning

Methode	Beschrijving
`npm()->install()`	Installeert dependencies met de gedetecteerde pakketbeheerder
`npm()->run($script, ...$arguments)`	Voert een script van de pakketbeheerder uit
`npm()->remove(...$packages)`	Verwijdert pakketten met de gedetecteerde pakketbeheerder

De methode npm() detecteert automatisch npm, yarn, pnpm en bun.

Huidige ontwikkelstatus

GitHub-repository: laravel/chisel
Release: v0.1 (uitgebracht in mei 2026)
Ontwikkelperiode: gepubliceerd na drie maanden besloten ontwikkeling

Chisel is geen pakket dat eindgebruikers rechtstreeks in hun Laravel-app installeren, maar een bibliotheek die starter kits intern gebruiken. De verwachting is dat de officiële Laravel starter kits in de toekomst post-installatiescripts op basis van Chisel gaan aanbieden.

laravel/chisel repository

De broncode en de nieuwste API-referentie vind je hier.

Officiële documentatie van Laravel starter kits

Raadpleeg de officiële documentatie voor het gebruik van de starter kits zelf.

Changelog

Laravel 13

Producten

Package-introducties

Nieuwe repositories verkennen

Upgradegidsen

Authenticatie

Frontend

Omgeving opzetten

Laravel Chisel — een bibliotheek voor post-installatiescripts van starter kits

Wat is Laravel Chisel?

Waarom is dit nodig?

Het chisel.php-script definiëren

Methoden voor scriptdefinitie

Interactief antwoorden verzamelen

Bestandsmutaties

Bewerken op basis van de PHP-AST

Section markers

npm-ondersteuning

Huidige ontwikkelstatus

laravel/chisel repository

Officiële documentatie van Laravel starter kits

​Wat is Laravel Chisel?

​Waarom is dit nodig?

​Het chisel.php-script definiëren

​Methoden voor scriptdefinitie

​Interactief antwoorden verzamelen

​Bestandsmutaties

​Bewerken op basis van de PHP-AST

​Section markers

​npm-ondersteuning

​Huidige ontwikkelstatus

laravel/chisel repository

Officiële documentatie van Laravel starter kits

Wat is Laravel Chisel?

Waarom is dit nodig?

Het chisel.php-script definiëren

Methoden voor scriptdefinitie

Interactief antwoorden verzamelen

Bestandsmutaties

Bewerken op basis van de PHP-AST

Section markers

npm-ondersteuning

Huidige ontwikkelstatus