mileschou/schemarkdown

The schema generate helper

v2.0.1 2021-03-24 17:40 UTC

Requires

• php: ^7.2 | ^8.0
• doctrine/dbal: ^2.6
• illuminate/console: ^6 | ^7 | ^8
• illuminate/database: ^6 | ^7 | ^8
• illuminate/events: ^6 | ^7 | ^8
• illuminate/support: ^6 | ^7 | ^8
• illuminate/view: ^6 | ^7 | ^8
• mikey179/vfsstream: ^1.6.7
• mileschou/codegener: ^1.0.2

Requires (Dev)

• illuminate/container: ^6 | ^7 | ^8
• laravel-bridge/scratch: ^1.3
• phpunit/phpunit: ^8.5 | ^9
• psy/psysh: ^0.10.7
• squizlabs/php_codesniffer: ^3.5
• symfony/var-dumper: ^5.2

MIT

• MilesChou

• database
• laravel

README

The core library for generate Markdown document and Laravel Eloquent Model classes from database schema.

Installation

Use Composer to install:

composer require mileschou/schemarkdown

Usage

Use following command to generate schema documents:

cd /path/to/your-laravel-project
php artisan schema:markdown

Schema document are stored to docs/schema directory default. Use the --path option to change it.

In the other framework, you must provide config file like Laravel. Use --config option to specify customize configuration.

This tool will load .env before load config. Use the --env option to specify .env path.

Use the --database option to specify connection name in Laravel config to generate the document of one database.

Use the --overwrite option if you want to overwrite the exists document.

Use following command to generate eloquent models:

cd /path/to/your-laravel-project
php artisan schema:model

It's will generate model code into app/Models directory (Laravel 8 default), use the --path option can change output dir. If want to change namespace, use the --namespace option.

In the other framework but using Eloquent ORM library, you must provide config file like laravel project. Use --config option to specify customize configuration.

If only want build one connection, use the --database option to specify.

Use the --overwrite option if you want to overwrite exist code.

Example

Here is example SQL, import MySQL and run following command:

php artisan schemarkdown --config=tests/Fixtures/database.php --database=examples --output-dir=examples

It will generate this Markdown documents.

Troubleshooting

Use -vv option to see info log.

License

The MIT License (MIT). Please see License File for more information.