Разработка · 5 мин чтения

Laravel Seeder: наполнение базы данных при разворачивании проекта

Разворачиваю новый Laravel-проект на сервере, прогоняю миграции - и получаю пустую базу без единой строки данных. Нет ролей, нет тестового пользователя, нет справочника категорий - каталог просто нечем показать. Laravel Seeder закрывает именно эту проблему: он наполняет базу нужными данными сразу после деплоя или клонирования репозитория, и делает это одинаково на любой машине, где заново прогнали миграции.

Что делает Laravel Seeder при разворачивании проекта

Сидер - это обычный PHP-класс в папке database/seeders, у которого есть метод run(). Внутри этого метода можно писать что угодно: создавать записи напрямую через Eloquent, вызывать фабрики, читать CSV-файл со справочником городов и заливать его в таблицу. Laravel сам ничего не придумывает за вас - он просто даёт точку входа и команду, которая её вызовет.

На практике в сидеры обычно выношу:

  • роли и права доступа (admin, manager, customer);
  • тестового или дефолтного администратора для входа в панель сразу после установки;
  • справочники: категории каталога, статусы заказов, единицы измерения;
  • настройки приложения, которые хранятся в таблице, а не в .env.

Без этого после каждого разворачивания проекта на новом сервере или в новой ветке пришлось бы руками лезть в tinker и создавать записи вручную - и результат от раза к разу будет отличаться.

Seeder и Factory: в чём разница между наполнением базы и генерацией тестовых данных

Эти две сущности часто путают, хотя решают разные задачи.

Инструмент Что делает Когда использую
Migration Создаёт и меняет структуру таблиц При любом изменении схемы базы
Factory Описывает шаблон одной записи со случайными данными Для тестов и генерации большого объёма записей
Seeder Запускает наполнение базы: вызывает фабрики или вставляет конкретные записи напрямую После миграций, при разворачивании или тестировании проекта

Factory описывает, как выглядит одна случайная запись модели. Seeder решает, сколько таких записей нужно и в каком порядке их создавать, а заодно может вставлять фиксированные данные напрямую, без всякой генерации случайности.

Faker и генерация реалистичных данных

Внутри фабрики доступен объект $this->faker - он генерирует правдоподобные имена, тексты, email и адреса. Это удобно для наполнения базы демо-контентом на стейджинге: десятки статей блога, сотни заказов с разными датами и суммами, чтобы посмотреть, как ведёт себя пагинация или отчёт по продажам на реальном объёме данных. Для продакшена такой рандом не нужен - там нужны конкретные справочники, а не сгенерированный шум.

namespace Database\Factories;

use App\Models\Post;
use App\Models\User;
use Illuminate\Database\Eloquent\Factories\Factory;

class PostFactory extends Factory
{
    protected $model = Post::class;

    public function definition(): array
    {
        return [
            'title' => $this->faker->sentence(6),
            'body' => $this->faker->paragraphs(3, true),
            'user_id' => User::factory(),
        ];
    }
}

Как создать и запустить сидер через artisan

Новый сидер создаётся командой:

php artisan make:seeder RoleSeeder

Внутри него описываю, что именно вставить в таблицу:

namespace Database\Seeders;

use App\Models\Role;
use Illuminate\Database\Seeder;

class RoleSeeder extends Seeder
{
    public function run(): void
    {
        foreach (['admin', 'manager', 'customer'] as $name) {
            Role::firstOrCreate(['name' => $name]);
        }
    }
}

Главный сидер DatabaseSeeder собирает остальные через $this->call() - это единая точка входа, которую и запускает artisan:

namespace Database\Seeders;

use Illuminate\Database\Seeder;

class DatabaseSeeder extends Seeder
{
    public function run(): void
    {
        $this->call([
            RoleSeeder::class,
            AdminUserSeeder::class,
        ]);
    }
}

Запуск - это уже одна команда:

php artisan db:seed
php artisan db:seed --class=RoleSeeder
php artisan migrate:fresh --seed

Последняя команда пересоздаёт все таблицы с нуля и сразу наполняет их - это то, что обычно гоняю локально и в CI перед прогоном тестов, чтобы база каждый раз была в одинаковом состоянии.

Бесплатный материал

🎁 Полезный скрипт в подарок

Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.

Без спама. Отписка в 1 клик.

Наполнение базы стартовыми данными на продакшене

На боевом сервере сидеры нужны только для справочных данных, которые обязаны там быть: роли, статусы заказов, налоговые ставки, зоны доставки, дефолтные настройки. Демо-контент и рандомные фабрики туда не идут.

Чтобы один и тот же DatabaseSeeder вёл себя по-разному в зависимости от окружения, проверяю app()->environment():

public function run(): void
{
    $this->call(RoleSeeder::class);
    $this->call(AdminUserSeeder::class);

    if (! app()->environment('production')) {
        $this->call(DemoDataSeeder::class);
    }
}

Второй момент - идемпотентность. Если задеплоить проект второй раз и снова прогнать сидер, вставка через create() упадёт с ошибкой дубликата по уникальному полю. Поэтому для справочных данных всегда беру firstOrCreate() или updateOrCreate() - тогда сидер можно безопасно запускать хоть при каждом деплое: firstOrCreate() не создаст существующую запись повторно, а updateOrCreate() обновит её. На production команда db:seed спрашивает подтверждение, поэтому в скрипте деплоя её запускают с флагом --force.

Когда собираю разработку API или бэкенда на Laravel для клиента, сразу закладываю в проект сидеры для ролей и администратора - после выкладки на сервер у заказчика есть рабочий вход в панель, а не пустая база, в которую нужно лезть через tinker вручную.

Порядок выполнения сидеров и связи между таблицами

Порядок вызова в массиве $this->call() имеет значение, если между таблицами есть внешние ключи. Сначала должны появиться роли, потом пользователи со ссылкой на роль, потом их посты или заказы. Если это правило нарушить, вставка упадёт с ошибкой нарушения внешнего ключа.

Для связанных моделей фабрики умеют строить дерево записей одной командой, без ручного перебора:

User::factory()
    ->count(20)
    ->has(Post::factory()->count(3))
    ->create();

Эта запись создаст 20 пользователей и по три поста на каждого, автоматически проставив внешний ключ. Отключать проверку внешних ключей через Schema::disableForeignKeyConstraints() ради того, чтобы обойти правильный порядок, не стоит - это маскирует реальную проблему в структуре сидеров, а не решает её.

Частые ошибки при работе с сидерами Laravel

  • Гонять тяжёлый DemoDataSeeder с тысячами фейковых записей на продакшене - это лишняя нагрузка на базу и мусор, который потом сложно вычистить.
  • Забыть про идемпотентность и получить ошибку дубликата при повторном деплое, хотя сидер должен был просто ничего не делать.
  • Хранить в сидере реальные email и телефоны клиентов ради «удобного тестового набора» - такие данные не место в git-репозитории, для тестов достаточно Faker.
  • Нарушать порядок вызова сидеров и получать ошибку внешнего ключа вместо того, чтобы просто переставить строки местами в массиве call().

Laravel регулярно обновляется, поэтому перед внедрением сидеров в очередной проект я сверяюсь с актуальной документацией фреймворка.

Частые вопросы

Чем Seeder отличается от миграции?

Миграция описывает структуру таблицы: какие столбцы, какие индексы, какие внешние ключи. Seeder работает уже с готовой структурой и заполняет её данными - миграция ничего не знает про содержимое таблиц, а сидер ничего не знает про их структуру.

Можно ли использовать сидеры на продакшене?

Да, но только для справочных и обязательных данных: ролей, статусов, настроек, дефолтного администратора. Через проверку окружения в run() легко разделить, что уходит на боевой сервер, а что остаётся только для локальной разработки и тестов.

Как запустить только один сидер, а не весь DatabaseSeeder?

Командой php artisan db:seed --class=ИмяСидера. Это удобно, когда нужно обновить только один справочник, не трогая остальные таблицы.

Что делать, если сидер падает с ошибкой дубликата или внешнего ключа?

Ошибка дубликата обычно значит, что вставка идёт через create() вместо firstOrCreate() при повторном запуске. Ошибка внешнего ключа - что сидер с зависимой таблицей вызывается раньше сидера с таблицей, на которую он ссылается. Оба случая лечатся правкой самого сидера, а не отключением проверок в базе.

Есть задача?

Обсудим в мессенджере

Расскажите, что нужно сделать — отвечу в течение 4 часов в рабочее время. Первая консультация бесплатно.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно