How to Install and Configure Laravel IDE Helper with Composer

This article provides step‑by‑step instructions for integrating the barryvdh/laravel-ide-helper package into a Laravel project.

First, add the package as a development dependency using Composer:

composer require --dev barryvdh/laravel-ide-helper

After updating Composer, register the service provider. You can either add it to config/app.php or, preferably, register it conditionally in app/Providers/AppServiceProvider.php within the register() method:

public function register() {
    if ($this->app->environment() !== 'production') {
        $this->app->register(\Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider::class);
    }
}

To automate helper generation after each Composer update, add scripts to composer.json :

"scripts": {
    "post-update-cmd": [
        "Illuminate\Foundation\ComposerScripts::postUpdate",
        "@php artisan ide-helper:generate",
        "@php artisan ide-helper:meta"
    ]
}

You can also publish the package's configuration file to customize defaults:

php artisan vendor:publish --provider="Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider" --tag=config

Finally, generate the IDE helper files manually when needed:

php artisan ide-helper:generate

Following these steps enables enhanced IDE autocompletion and metadata for Laravel applications.