Разворачиваю новый 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() при повторном запуске. Ошибка внешнего ключа - что сидер с зависимой таблицей вызывается раньше сидера с таблицей, на которую он ссылается. Оба случая лечатся правкой самого сидера, а не отключением проверок в базе.