# Laravel Migrations Generator

![Style check CI](https://github.com/kitloong/laravel-migrations-generator/actions/workflows/lint.yml/badge.svg?branch=7.x)
![Tests CI](https://github.com/kitloong/laravel-migrations-generator/actions/workflows/tests.yml/badge.svg?branch=7.x)
[![codecov](https://codecov.io/gh/kitloong/laravel-migrations-generator/branch/7.x/graph/badge.svg?token=U6ZRDPY6QZ)](https://codecov.io/gh/kitloong/laravel-migrations-generator)
[![Latest Stable Version](https://poser.pugx.org/kitloong/laravel-migrations-generator/v)](https://packagist.org/packages/kitloong/laravel-migrations-generator)
[![Total Downloads](https://poser.pugx.org/kitloong/laravel-migrations-generator/downloads?1)](https://packagist.org/packages/kitloong/laravel-migrations-generator)
[![License](https://poser.pugx.org/kitloong/laravel-migrations-generator/license)](LICENSE)

Generate Laravel Migrations from an existing database, including indexes and foreign keys!

## Documentation

Checkout the [documentation](https://kitloong.github.io/laravel-migrations-generator/usage/) for more details.

## Supported Database

Laravel Migrations Generator supports all five Laravel first-party support databases:

- [x] MariaDB
- [x] MySQL
- [x] PostgreSQL
- [x] SQL Server
- [x] SQLite

## Install

The recommended way to install this is through composer:

```bash
composer require --dev kitloong/laravel-migrations-generator
```

### Laravel Setup

Laravel will automatically register service provider for you.

### Lumen Setup

<details>
  <summary>Expand</summary>

Auto-discovery is not available in Lumen, you need some modification on `bootstrap/app.php`.

#### Enable Facade

Uncomment the following line.

```php
$app->withFacades();
```

#### Register Provider

Add following line into the `Register Service Providers` section.

```php
$app->register(\KitLoong\MigrationsGenerator\MigrationsGeneratorServiceProvider::class);
```

</details>

## Usage

To generate migrations from a database, you need to have your database setup in Laravel's config (`config/database.php`).

To create migrations for all the tables, run:

```bash
php artisan migrate:generate
```

You can specify the tables you wish to generate using:

```bash
php artisan migrate:generate --tables="table1,table2,table3,table4,table5"
```

You can also ignore tables with:

```bash
php artisan migrate:generate --ignore="table3,table4,table5"
```

Laravel Migrations Generator will first generate all the tables, columns and indexes, and afterward setup all the foreign key constraints.

So make sure you include all the tables listed in the foreign keys so that they are present when the foreign keys are created.

You can also specify the connection name if you are not using your default connection with:

```bash
php artisan migrate:generate --connection="connection_name"
```

### Squash Migrations

By default, Generator will generate multiple migration files for each table.

You can squash all migrations into a single file with:

```bash
php artisan migrate:generate --squash
```

### Options

Run `php artisan help migrate:generate` for a list of options.

| Options                                                                                                                | Description                                                                                                                                                   |
|------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [-c, --connection[=CONNECTION]](https://kitloong.github.io/laravel-migrations-generator/options/connection/)           | The database connection to use                                                                                                                                |
| [-t, --tables[=TABLES]](https://kitloong.github.io/laravel-migrations-generator/options/tables/)                       | A list of tables or views you wish to generate migrations for separated by a comma: users,posts,comments                                                      |
| [-i, --ignore[=IGNORE]](https://kitloong.github.io/laravel-migrations-generator/options/ignore/)                       | A list of tables or views you wish to ignore, separated by a comma: users,posts,comments                                                                      |
| [-p, --path[=PATH]](https://kitloong.github.io/laravel-migrations-generator/options/path/)                             | Where should the file be created?                                                                                                                             |
| [-tp, --template-path[=TEMPLATE-PATH]](https://kitloong.github.io/laravel-migrations-generator/options/template-path/) | The location of the template for this generator                                                                                                               |
| [--date[=DATE]](https://kitloong.github.io/laravel-migrations-generator/options/date/)                                 | Migrations will be created with specified date. Views and foreign keys will be created with + 1 second. Date should be in format supported by `Carbon::parse` |
| [--table-filename[=TABLE-FILENAME]](https://kitloong.github.io/laravel-migrations-generator/options/table-filename/)   | Define table migration filename, default pattern: `[datetime]\_create_[name]_table.php`                                                                       |
| [--view-filename[=VIEW-FILENAME]](https://kitloong.github.io/laravel-migrations-generator/options/table-filename/)     | Define view migration filename, default pattern: `[datetime]\_create_[name]_view.php`                                                                         |
| [--proc-filename[=PROC-FILENAME]](https://kitloong.github.io/laravel-migrations-generator/options/table-filename/)     | Define stored procedure filename, default pattern: `[datetime]\_create_[name]_proc.php`                                                                       |
| [--fk-filename[=FK-FILENAME]](https://kitloong.github.io/laravel-migrations-generator/options/table-filename/)         | Define foreign key migration filename, default pattern: `[datetime]\_add_foreign_keys_to_[name]_table.php`                                                    |
| [--log-with-batch[=LOG-WITH-BATCH]](https://kitloong.github.io/laravel-migrations-generator/options/log-with-batch/)   | Log migrations with given batch number. We recommend using batch number 0 so that it becomes the first migration                                              |
| [--default-index-names](https://kitloong.github.io/laravel-migrations-generator/options/default-index-names/)          | Don\'t use DB index names for migrations                                                                                                                      |
| [--default-fk-names](https://kitloong.github.io/laravel-migrations-generator/options/default-fk-names/)                | Don\'t use DB foreign key names for migrations                                                                                                                |
| [--use-db-collation](https://kitloong.github.io/laravel-migrations-generator/options/use-db-collation/)                | Generate migrations with existing DB collation                                                                                                                |
| [--skip-log](https://kitloong.github.io/laravel-migrations-generator/options/skip-log/)                                | Don\'t log into migrations table                                                                                                                              |
| [--skip-vendor](https://kitloong.github.io/laravel-migrations-generator/options/skip-vendor/)                          | Don\'t generate vendor migrations                                                                                                                             |
| [--skip-views](https://kitloong.github.io/laravel-migrations-generator/options/skip-views/)                            | Don\'t generate views                                                                                                                                         |
| [--skip-proc](https://kitloong.github.io/laravel-migrations-generator/options/skip-proc/)                              | Don\'t generate stored procedures                                                                                                                             |
| [--squash](https://kitloong.github.io/laravel-migrations-generator/options/squash/)                                    | Generate all migrations into a single file                                                                                                                    |
| [--with-has-table](https://kitloong.github.io/laravel-migrations-generator/options/with-has-table/)                    | Check for the existence of a table using `hasTable`                                                                                                           |

## Thank You

Thanks to Bernhard Breytenbach for his great work. This package is based on https://github.com/Xethron/migrations-generator.

## Our Amazing Sponsor 🎉

A huge thank you to our sponsor for supporting this project!

<a href="https://vemto.app/" target="_blank">
    <img alt="Vemto" width="200" src="https://vemto.app/images/logo2.png" />
</a>

Want to support this project? [Become a sponsor](https://github.com/sponsors/kitloong) today!

## Contributors

[![Contributors](https://contrib.rocks/image?repo=kitloong/laravel-migrations-generator)](https://github.com/kitloong/laravel-migrations-generator/graphs/contributors)

## License

The Laravel Migrations Generator is open-sourced software licensed under the [MIT license](LICENSE)
