pierresilva/laravel-generator

Laravel 5 crud Generator

5.3 2017-01-17 14:32 UTC

This package is auto-updated.

Last update: 2024-12-19 00:07:45 UTC


README

Requirements

Laravel >=5.1
PHP >= 5.5.9

Installation

  1. Run

    composer require pierresilva/laravel-generator
    
  2. Add the service provider to config/app.php.

    'providers' => [
        ...
    
        pierresilva\LaravelGenerator\LaravelGeneratorServiceProvider::class,
    ],
  3. Install laravelcollective/html helper package.

    • Run
    composer require laravelcollective/html
    
    • Add service provider & aliases to config/app.php.
    'providers' => [
        ...
    
        Collective\Html\HtmlServiceProvider::class,
    ],
    
    'aliases' => [
        ...
    
        'Form' => Collective\Html\FormFacade::class,
        'HTML' => Collective\Html\HtmlFacade::class,
    ],
  4. Run composer dump-autoload

  5. Publish vendor files of this package.

    php artisan vendor:publish --provider="pierresilva\LaravelGenerator\LaravelGeneratorServiceProvider"
    

Note: You should have configured database for this operation.

Commands

Crud command:

php artisan generate:crud Posts --fields="title#string; content#text; category#select#options=technology,tips,health" --view-path=admin --controller-namespace=Admin --route-group=admin

Crud fields from a JSON file:

{
   "fields": [
        {
            "name": "title",
            "type": "string"
        },
        {
            "name": "content",
            "type": "text"
        },
        {
            "name": "category",
            "type": "select",
            "options": ["technology", "tips", "health"]
        }
   ]
}
php artisan generate:crud Posts --fields_from_file="/path/to/fields.json" --view-path=admin --controller-namespace=Admin --route-group=admin

Options:

Other commands (optional):

For controller:

php artisan generate:controller PostsController --crud-name=posts --model-name=Post --view-path="directory" --route-group=admin

For model:

php artisan generate:model Post --fillable="['title', 'body']"

For migration:

php artisan generate:migration posts --schema="title#string; body#text"

For view:

php artisan generate:view posts --fields="title#string; body#text" --view-path="directory" --route-group=admin

By default, the generator will attempt to append the crud route to your Route file. If you don't want the route added, you can use this option --route=no.

After creating all resources, run migrate command. If necessary, include the route for your crud as well.

php artisan migrate

If you chose not to add the crud route in automatically (see above), you will need to include the route manually.

Route::resource('posts', 'PostsController');

Supported Field Types

These fields are supported for migration and view's form:

Form Field Types:

  • text
  • textarea
  • password
  • email
  • number
  • date
  • datetime
  • time
  • radio
  • select
  • file

Migration Field Types:

  • string
  • char
  • varchar
  • date
  • datetime
  • time
  • timestamp
  • text
  • mediumtext
  • longtext
  • json
  • jsonb
  • binary
  • integer
  • bigint
  • mediumint
  • tinyint
  • smallint
  • boolean
  • decimal
  • double
  • float
  • enum

Custom Generator's Stub Templates

You can customize the generator's stub files/templates to achieve your need.

  1. Make sure you've published package's assets.

    php artisan vendor:publish --provider="pierresilva\LaravelGenerator\LaravelGeneratorServiceProvider"
    
  2. Turn on custom_template support on config/laravelgenerator.php

    'custom_template' => true,
    
  3. From the directory resources/laravel-generator/ you can modify or customize the stub files.

Author

Pierre Silva