Como funcionam migrações e seeders?

Question

Accepted Answer

**Migrações** são definições versionadas do seu esquema de banco de dados (criando/modificando tabelas) escritas em PHP, portanto as mudanças de esquema são rastreadas com seu código e reproduzíveis entre ambientes. **Seeders** preenchem o banco de dados com dados de teste ou padrão.

## Uma migração

```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');
    }
};
```

O método `up()` de uma migração define a mudança de esquema (usando o construtor `Schema`), e `down()` a reverte. Você escreve o esquema em PHP, não em SQL — e é agnóstico a banco de dados.

## Executando migrações

```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
```

Migrações são **commitadas para controle de versão**, portanto cada desenvolvedor, CI e ambiente de produção atingem o mesmo esquema executando `migrate` — reproduzível e amigável para o time.

## Seeders — populam dados

```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
```

Seeders preenchem o banco de dados com dados padrão ou de teste. Eles funcionam em conjunto com **factories** (gerando dados falsos realistas) — inestimáveis para desenvolvimento e testes.

## Por que isso importa

Migrações e seeders são essenciais para trabalhar com a camada de banco de dados do Laravel de forma profissional e amigável para o time. **Migrações** resolvem o problema crítico de manter o esquema do banco de dados sincronizado com o código: ao definir mudanças de esquema como arquivos PHP versionados, elas tornam a evolução de esquema **reproduzível** (cada ambiente — a máquina de cada desenvolvedor, CI, produção — atinge o esquema idêntico executando `migrate`), **rastreável** (as mudanças são revisadas em pull requests junto com o código) e **segura** (escrever o esquema em PHP em vez de SQL manual, com métodos `down()` reversíveis).

Isso elimina desvio de esquema e ambientes inconsistentes — uma fonte comum de bugs. **Seeders** (com factories gerando dados falsos realistas) preenchem o banco de dados para desenvolvimento e testes, facilitando o trabalho com dados realistas e a configuração de cenários de teste.

Compreender o fluxo de migração (`make:migration`, `migrate`, `rollback`), que migrações são commitadas para controle de versão para reproduzibilidade, e como seeders/factories preenchem dados é conhecimento fundamental e cotidiano para qualquer projeto Laravel real — é como times evoluem seu esquema de banco de dados colaborativamente e de forma confiável e configuram dados para desenvolvimento e testes, tornando-o material central para desenvolvimento Laravel profissional.