unyii2/yii2-giiant

Gii CRUD generator for Yii 2 Framework

yii2-giiant

"Giiant is huge!", _(*1)

PROJECT IS IN BETA STAGE!, _(*2)

Note: Major changes from 0.4 to 0.5, see upgrading for details., _(*3)

, _(*4)

What is this?

Giiant is an extended code-generator for models and CRUDs, based upon Gii (Yii 2.0 Framework)., _(*5)

It creates prototypes for database models and backends including relations defined by foreign-key constrains in no-time., _(*6)

To provide a highly flexible configuration system it features a callback-provider-queue to define rendering of customized inputs, columns or attribute values., _(*7)

A main project goal is porting many features and learnings from gtc, giix, awecrud and other code-generators into one solution., _(*8)

Resources

• Documentation
• Project Source-Code
• Packagist
• Yii Extensions

Features

Batch command

• yii batch creates all models and/or CRUDs for a set of tables sequentially with a single command

Model generator

• generates separate model classes to customize and base models classes which can be regenerated on schema changes
• table prefixes can be stipped off model class names (not bound to db connection settings from Yii 2.0)

CRUD generator

• input, attribute, column and relation customization with provider queues
• callback provider to inject any kind of code for inputs, attributes and columns via dependency injection
• virtual-relation support (non-foreign key relations)
• model, view and controller locations can be customized to use subfolders
• horizontal and vertical form layout
• options for tidying generated code
• action button class customization (Select "App Class" option on the Action Button Class option on CRUD generator to customize)

Installation

The preferred way to install this extension is through composer., _(*9)

Using a stable version, _(*10)

composer require schmunk42/yii2-giiant:"@stable"

Using latest master, _(*11)

composer require schmunk42/yii2-giiant:"@dev"

The generators are registered automatically in the application bootstrap process, if Gii module is enabled., _(*12)

You can try giiant via phd (dockerized PHP application template)., _(*13)

Configuration

It's recommended to configure a customized batch command in your application CLI configuration., _(*14)

'controllerMap' => [
    'batch' => [
        'class' => 'schmunk42\giiant\commands\BatchController',
        'overwrite' => true,
        'modelNamespace' => 'app\\modules\\crud\\models',
        'crudTidyOutput' => true,
    ]
],

Note: yii giiant-batch is an alias for the default configuration of BatchController registered by this extension., _(*15)

You can add the giiant specific configuration config/giiant.php, and include this from your config/main.php., _(*16)

See the batches section for configuration details., _(*17)

Usage

To create a full-featured database backend, run the CLI batch command, _(*18)

yii batch

You can still override the settings from the configuration, like selecting specific tables, _(*19)

yii batch --tables=a,list,of,tables

Core commands

Show help for gii, _(*20)

yii help gii

Create application-module for giiant CRUDs, _(*21)

yii gii/giiant-module

The commands for generating models and CRUD, there are usually run via the batch command above., _(*22)

yii gii/giiant-model
yii gii/giiant-crud

Advanced

Provider usage and configuration via dependency injection

See docs for details., _(*23)

Using callbacks to provide code-snippets

See docs for details., _(*24)

Troubleshooting

See docs for known-issues, platform specific usage, quirks, faq, ..., _(*25)

Extras

Special thanks to motin, thyseus, uldisn and rcoelho for their work, inspirations and feedback., _(*26)

Screenshots

, _(*27)

Built by dmstr, _(*28)