Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spatie/laravel-migrate-fresh
An artisan command to build up a database from scratch
https://github.com/spatie/laravel-migrate-fresh
artisan database debug eloquent laravel migrations php
Last synced: 4 days ago
JSON representation
An artisan command to build up a database from scratch
- Host: GitHub
- URL: https://github.com/spatie/laravel-migrate-fresh
- Owner: spatie
- License: mit
- Archived: true
- Created: 2017-01-09T12:46:01.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2019-09-13T09:20:48.000Z (about 5 years ago)
- Last Synced: 2024-10-20T14:44:23.378Z (18 days ago)
- Topics: artisan, database, debug, eloquent, laravel, migrations, php
- Language: PHP
- Homepage: https://murze.be/2017/01/laravel-package-rebuild-database/
- Size: 63.5 KB
- Stars: 183
- Watchers: 7
- Forks: 24
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-dev - Laravel Artisan Fresh
README
## The migrate:fresh command is included by default since Laravel 5.5.
# An artisan command to build up the database from scratch
[](https://packagist.org/packages/spatie/laravel-migrate-fresh)
[](LICENSE.md)
[](https://travis-ci.org/spatie/laravel-migrate-fresh)
[](https://scrutinizer-ci.com/g/spatie/laravel-migrate-fresh)
[](https://styleci.io/repos/78428025)
[](https://packagist.org/packages/spatie/laravel-migrate-fresh)
Laravel has a `migrate:refresh` command to build up the database using migrations. To clear the database it'll first rollback all migrations by using the `down` method in each migration.
But what if you don't use the `down` method inside your projects? The `migrate:refresh` command will fail as the database isn't cleared first.
This package contains a `migrate:fresh` command that'll nuke all the tables in your database regardless of whether you've set up the `down` method in each migration.
## Postcardware
You're free to use this package (it's [MIT-licensed](LICENSE.md)), but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.
The best postcards are published [on our website](https://spatie.be/en/opensource/postcards).
## Requirements
This command supports MySQL, sqlite, PostgreSQL and MS SQL databases.
_Note: the `migrate:fresh` command is [included by default](https://laravel-news.com/migrate-fresh) in Laravel 5.5._
## Installation
You can install the package via composer:
```bash
composer require spatie/laravel-migrate-fresh
```
Next add the `Spatie\MigrateFresh\Commands\MigrateFresh` class to your console kernel.
```php
// app/Console/Kernel.php
protected $commands = [
...
\Spatie\MigrateFresh\Commands\MigrateFresh::class,
]
```
## Usage
This command will drop all tables from your database and run all migrations.
```bash
php artisan migrate:fresh
```
> Be aware that the command will knock down all tables in the database. Tables not belonging to your application will be dropped as well.
By tagging on the `seed` option all seeders will run as well.
```bash
php artisan migrate:fresh --seed
```
If the command is being executed in a production environment, confirmation will be asked first. To suppress the confirmation use the `force` option.
```bash
php artisan migrate:fresh --force
```
### Events
This package fires several events, which you can hook into to perform some extra logic rebuilding the database.
- `Spatie\MigrateFresh\Events\DroppingTables`: will be fired right before dropping the first table
- `Spatie\MigrateFresh\Events\DroppedTables`: will be fired right after all the tables have been dropped and before running the `up` steps of the migrations
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Testing
In order for the test to be run you should set up an empty mysql database `laravel_migrate_fresh` . The username should be `root`, the required password should be empty.
``` bash
$ composer test
```
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
## Credits
- [Freek Van der Herten](https://github.com/freekmurze)
- [All Contributors](../../contributors)
Initial code to drop all tables in a Postgresql db was provided by [Jonathan Reinink](https://gist.github.com/reinink) and reviewed by [Peter Matseykanets](https://github.com/pmatseykanets). Peter also added support for Sqlite.
## About Spatie
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects [on our website](https://spatie.be/opensource).
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.