Comment fonctionnent les migrations et les seeders ?

Question

Accepted Answer

**Les migrations** sont des définitions versionnées de votre schéma de base de données (créer/modifier des tables) écrites en PHP, de sorte que les modifications de schéma sont suivies avec votre code et reproductibles dans tous les environnements. **Les seeders** remplissent la base de données avec des données de test ou par défaut.

## Une migration

```php
<?php
// generate: php artisan make:migration create_users_table
return new class extends Migration {
    public function up(): void {        // apply the change
        Schema::create('users', function (Blueprint $table) {
            $table->id();                          // auto-increment primary key
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamps();                   // created_at + updated_at
        });
    }
    public function down(): void {       // reverse the change (rollback)
        Schema::dropIfExists('users');
    }
};
```

La méthode `up()` d'une migration définit le changement de schéma (en utilisant le constructeur `Schema`), et `down()` l'annule. Vous écrivez le schéma en PHP, pas en SQL — et c'est indépendant de la base de données.

## Exécuter les migrations

```bash
php artisan migrate              # apply all pending migrations
php artisan migrate:rollback     # undo the last batch (uses down())
php artisan migrate:fresh         # drop everything and re-run all (dev)
php artisan make:migration add_phone_to_users   # a new migration to alter a table
```

Les migrations sont **committées au contrôle de version**, ainsi chaque développeur, CI et environnement de production atteint le même schéma en exécutant `migrate` — reproductible et convivial pour l'équipe.

## Seeders — remplir les données

```php
class DatabaseSeeder extends Seeder {
    public function run(): void {
        User::factory()->count(50)->create();        // 50 fake users via a factory
        User::create(['name' => 'Admin', 'email' => 'admin@x.com']);
    }
}
// run with: php artisan db:seed
```

Les seeders remplissent la base de données avec des données par défaut ou de test. Ils s'associent aux **factories** (générant des données fausses réalistes) — inestimables pour le développement et les tests.

## Pourquoi c'est important

Les migrations et les seeders sont essentiels pour travailler avec la couche base de données de Laravel de manière professionnelle et conviviale pour l'équipe. **Les migrations** résolvent le problème critique de maintenir le schéma de base de données en synchronisation avec le code : en définissant les modifications de schéma comme des fichiers PHP versionnés, elles rendent l'évolution du schéma **reproductible** (chaque environnement — la machine de chaque développeur, CI, production — atteint le schéma identique en exécutant `migrate`), **traçable** (les modifications sont examinées dans les demandes de fusion aux côtés du code), et **sûre** (écrire le schéma en PHP plutôt que du SQL manuel, avec des méthodes `down()` réversibles).

Cela élimine la dérive du schéma et les environnements incohérents — une source courante de bogues. **Les seeders** (avec les factories générant des données fausses réalistes) remplissent la base de données pour le développement et les tests, ce qui facilite le travail avec des données réalistes et la configuration de scénarios de test.

Comprendre le flux de travail des migrations (`make:migration`, `migrate`, `rollback`), que les migrations sont committées au contrôle de version pour la reproductibilité, et comment les seeders/factories remplissent les données est une connaissance fondamentale et quotidienne pour tout projet Laravel réel — c'est comment les équipes font évoluer leur schéma de base de données de manière collaborative et fiable et configurent les données pour le développement et les tests, ce qui en fait un matériel essentiel pour le développement professionnel de Laravel.