Série Laravel 13 & Filament 5 (1/8) : Configurer son poste de dev moderne

Bienvenue dans le premier module de cette série complète consacrée au développement d’applications d’entreprise avec Laravel 13 et Filament 5.

Plutôt que d’empiler des briques logicielles au hasard, nous allons mettre en place un environnement de développement sain, reproductible et outillé pour la qualité logicielle dès la première ligne de code.

Les prérequis logiciels pour 2026

Pour exécuter Laravel 13 et Filament 5 dans des conditions optimales, assurez-vous de disposer des bases suivantes :

• PHP 8.6 (avec les extensions requises : pdo, mbstring, intl, bcmath, curl, zip)
• Composer (v2.7+)
• Node.js (v22+ LTS) ou Bun / PNPM
• Git
• Un moteur de base de données (PostgreSQL 16+, MySQL 8.4+ ou SQLite 3 pour le prototypage local)

Étape 1 : Choisir son gestionnaire de stack locale

Selon votre système d’exploitation, plusieurs approches s’offrent à vous :

• macOS / Windows : Laravel Herd reste la méthode la plus rapide et la plus légère. Il isole les versions de PHP sans Docker et gère les certificats SSL locaux automatiquement.
• Linux / WSL2 : Installez PHP 8.6 via le dépôt de référence (ondrej/php sous Ubuntu/Debian) ou utilisez Laravel Sail (Docker) si vous tenez à conteneuriser votre environnement dès le premier jour.

Vérifiez votre version active dans votre terminal :

php -v
composer --version

Étape 2 : Création du squelette du projet

Créons notre application, que nous baptiserons EquipFlow :

composer create-project laravel/laravel:^13.0 equip-flow
cd equip-flow

Initialisez le dépôt Git local immédiatement :

git init
git add .
git commit -m "chore: initial commit Laravel 13"

Étape 3 : Configuration de la base de données locale

Ouvrez le fichier .env. Pour développer vite et sans friction locale, vous pouvez utiliser SQLite :

DB_CONNECTION=sqlite

Puis créez le fichier correspondant :

touch database/database.sqlite

Exécutez la première vague de migrations de base :

php artisan migrate

Étape 4 : Outillage de qualité logicielle dès le jour 1

Une application métier qui dure dans le temps repose sur des standards de code stricts et de l’analyse statique. Deux outils sont indispensables :

Formatage du code avec Laravel Pint

Laravel inclut nativement Pint. Vous pouvez vérifier et corriger votre code selon le standard PSR-12 / Laravel avec :

./vendor/bin/pint --test

Analyse statique avec Larastan / PHPStan

L’analyse statique détecte les erreurs de typage et les appels de méthodes inexistantes sans exécuter le code. Installez Larastan :

composer require --dev larastan/larastan:^3.0

Créez le fichier phpstan.neon à la racine de votre projet :

includes:
    - vendor/larastan/larastan/extension.neon

parameters:
    paths:
        - app/
    level: 6
    checkGenericClassInNonGenericObjectType: false

Ajoutez un script dans votre composer.json pour lancer vos vérifications en une seule commande :

"scripts": {
    "analyse": [
        "./vendor/bin/pint --test",
        "./vendor/bin/phpstan analyse"
    ]
}

Désormais, un simple composer run analyse validera la propreté de votre code.

Étape 5 : Installation du socle Filament 5

Installons le panneau d’administration de Filament 5 :

composer require filament/filament:^5.0
php artisan filament:install --panels --id=admin

Cette commande génère le fichier app/Providers/Filament/AdminPanelProvider.php, qui contrôle l’ensemble des routes, thèmes et middlewares de votre futur panneau d’administration.

Créez ensuite votre compte administrateur local :

php artisan make:filament-user

Renseignez votre nom, votre adresse email et un mot de passe de test.

Étape 6 : Test de validation du poste

Démarrez les serveurs de développement :

php artisan serve

Ouvrez votre navigateur sur http://127.0.0.1:8000/admin. Connectez-vous avec les identifiants créés précédemment. Vous devez arriver sur le tableau de bord vierge de Filament 5.

Ce que nous avons validé

• Une base Laravel 13 initialisée sous Git.
• Une suite d’outils de qualité logicielle opérationnelle (Pint et Larastan).
• Un socle Filament 5 prêt à recevoir notre domaine métier.

Dans le Module 2, nous attaquerons le cœur de notre application : la modélisation du domaine d’EquipFlow (migrations strictes, modèles Eloquent typés, Enums PHP 8.6 et factories avancées).