diegohq / laravel-seeder
Versioned, environment-based Seeders in Laravel. Used while original does not update to Laravel 5.7
Requires
- php: >=7.1.0
- illuminate/console: 5.7.*|5.8.*|^6.0|^7.0|^8.0
- illuminate/database: 5.7.*|5.8.*|^6.0|^7.0|^8.0
- illuminate/filesystem: 5.7.*|5.8.*|^6.0|^7.0|^8.0
- illuminate/support: 5.7.*|5.8.*|^6.0|^7.0|^8.0
Requires (Dev)
- mockery/mockery: ^1.1
- orchestra/testbench: ^3.0
- phpunit/phpunit: ^7.0
README
Seeding as it is currently done in Laravel is intended only for dev builds, but what if you're iteratively creating your database and want to constantly flush it and repopulate it during development?
What if you want to seed a production database with different data from what you use in development? What if you want to seed a table you've added to a database that is currently in production with new data?
LaravelSeeder takes the database migration features in Laravel and extends them to database seeders, making them "migratable". All of the functionality you have grown accustomed to with Laravel migrations have been mirrored and behave similarly for seeders.
Requirements
- Laravel >= 5.4
- PHP >= 7.1
Installation
- Run
composer require eighty8/laravel-seeder
- Add
Eighty8\LaravelSeeder\SeederServiceProvider::class
to your providers array inapp/config/app.php
- Run
php artisan vendor:publish
to push config files to your config folder if you want to override the name of the seeds folder or the name of the table where seeds are stored
Features
- Allows you to seed databases in different environments with different values.
- Allows you to "version" seeds the same way that Laravel currently handles migrations. Running
php artisan seed
will only run seeds that haven't already been run. - Allows you to run multiple seeds of the same model/table
- Prompts you if your database is in production
Usage
When you install LaravelSeeder, various artisan commands are made available to you which use the same methodology you're used to using with Migrations.
seed | Runs all the seeds in the "seeders" directory that haven't been run yet. |
seed:rollback | Rollback doesn't undo seeding (which would be impossible with an auto-incrementing primary key). It just allows you to re-run the last batch of seeds. |
seed:reset | Resets all the seeds. |
seed:refresh | Resets and re-runs all seeds. |
seed:status | Gets the status of each migratable seeder. |
seed:make | Makes a new seed class in the environment you specify. |
seed:install | You don't have to use this... it will be run automatically when you call "seed" |
Local Development
A Dockerfile with PHP 7.2, XDebug and Composer installed is bundled with the project to facilitate local development.
To easily bring up the local development environment, use the Docker Compose configuration:
docker-compose up -d --build
By default, the entrypoint script will install the Composer dependencies for you.
To run the test suite, execute the following:
docker-compose exec laravel-seeder test.sh
To run the code coverage suite, execute the following:
docker-compose exec laravel-seeder code-coverage.sh
Happy testing!