README

Combustor is a utility package for Codeigniter 3 that generates controllers, models, and views based on the provided database tables. It uses the Describe package for getting columns from a database table and as the basis for code generation.

Features

Generates code based on the structure of the Codeigniter 3 framework;
Speeds up the code development for prototyping web applications;
View templates can be based on Bootstrap and are upgradable; and
Only worry on the database schema, and Combustor will do the rest.

Installation

Extract the contents of the latest Codeigniter 3 project first:

$ wget https://github.com/bcit-ci/CodeIgniter/archive/3.1.13.zip
$ unzip 3.1.13.zip -d ciacme

Then configure the project's database connectivity settings:

$ cd ciacme
$ nano application/config/database.php

// ciacme/application/config/database.php

// ...

$db['default'] = array(
    'dsn'   => '',
    'hostname' => 'localhost',
    'username' => '',
    'password' => '',
    'database' => '',
    'dbdriver' => 'mysqli',
    
    // ...
);

Next is to proceed in installing Combustor via Composer:

$ composer require rougin/combustor --dev

// ciacme/composer.json

{
  // ...

  "require-dev":
  {
    "mikey179/vfsstream": "1.6.*",
    "phpunit/phpunit": "4.* || 5.* || 9.*",
    "rougin/combustor": "~1.0"
  }
}

Lastly, install the ORM wrappers like Wildfire or Doctrine:

$ vendor/bin/combustor install:wildfire
$ vendor/bin/combustor install:doctrine

Note

Using the install:wildfire command installs the Wildfire package while the install:doctrine installs the Credo package.

Reminders

Prior in executing any commands, kindly ensure that the database tables are defined properly (foreign keys, indexes, relationships, normalizations) in order to minimize the modifications after the code structure has been generated.

Also, please proceed first in generating models, views, or controllers to database tables that are having no relationship with other tables in the database.

Tip

Combustor will generate controllers, models, or views based on the specified database schema. If there's something wrong in the specified database schema, Combustor will generate a bad codebase.

Commands

`create:layout`

Create a new header and footer file.

Options

--bootstrap - adds styling based on Bootstrap
--force - generates file/s even they already exists

Example

$ vendor/bin/combustor create-layout --bootstrap

`create:controller`

Create a new HTTP controller.

Arguments

table - name of the database table

Options

--doctrine - generates a Doctrine-based controller
--wildfire - generates a Wildfire-based controller
--empty - generates an empty HTTP controller
--force - generates file/s even they already exists

Note

If either Wildfire or Doctrine is installed, no need to specify it as option for executing a specified command (e.g. --wildfire). However if both are installed, a command must have a --wildfire or --doctrine option added.

Example

$ vendor/bin/combustor create:controller users --wildfire

`create:model`

Create a new model.

Arguments

table - name of the database table

Options

--doctrine - generates a Doctrine-based model
--wildfire - generates a Wildfire-based model
--empty - generates an empty model
--force - generates file/s even they already exists

Example

$ vendor/bin/combustor create:model users --wildfire

`create:repository`

Create a new entity repository.

Arguments

table - name of the database table

Options

--force - generates file/s even they already exists

Example

$ vendor/bin/combustor create:repository users

Note

This command is only applicable to a Doctrine implementation.

`create:view`

Create view templates.

Arguments

table - name of the database table

Options

--bootstrap - adds styling based on Bootstrap
--doctrine - generates Doctrine-based views
--wildfire - generates Wildfire-based views
--force - generates file/s even they already exists

Example

$ vendor/bin/combustor create:view users --bootstrap

`create:scaffold`

Create a new HTTP controller, model, and view templates.

Arguments

table - name of the database table

Options

--bootstrap - adds styling based on Bootstrap
--doctrine - generates a Doctrine-based controller, model, and views
--wildfire - generates a Wildfire-based controller, model, and views
--force - generates file/s even they already exists

Example

$ vendor/bin/combustor create:scaffold users --bootstrap --wildfire

Note

If --doctrine is selected, the command will also execute the create:repository command.

`install:doctrine`

Install the Doctrine package.

Example

$ vendor/bin/combustor install:doctrine

Note

This command will be available if Doctrine is not installed in the project.
It also adds a Loader.php in the core directory. The said file is used for loading custom repositories extended to EntityRepository.

`install:wildfire`

Install the Wildfire package.

Example

$ vendor/bin/combustor install:wildfire

Note

This command will be available if Wildfire is not installed in the project.

`remove:doctrine`

Remove the Doctrine package.

Example

$ vendor/bin/combustor remove:doctrine

Note

This command will be available if Doctrine is installed in the project.

`remove:wildfire`

Remove the Wildfire package.

Example

$ vendor/bin/combustor remove:wildfire

Note

This command will be available if Wildfire is installed in the project.

Using `combustor.yml`

Combustor currently works out of the box after the configuration based on Installation. However, using a combustor.yml can be used for complex setups like specifying the new application path and excluding columns:

# combustor.yml

app_path: %%CURRENT_DIRECTORY%%/Sample

excluded_fields:
  - created_at
  - updated_at
  - deleted_at

To create a combustor.yml, simply run the initialize command:

$ vendor/bin/combustor initialize
[PASS] "combustor.yml" added successfully!

`app_path`

This property specifies the application directory. It may updated to any directory (e.g., ciacme/application, ciacme/config, etc.) as long it can detect the config/config.php file from the defined directory:

# combustor.yml

app_path: %%CURRENT_DIRECTORY%%/Sample

# ...

Note

Combustor will try to check the path specified in app_path if it is a valid Codeigniter 3 project. Then it will perform another check if the application directory exists or if the config directory can be accessed directly from the directory defined in app_path.

`excluded_fields`

Specified fields in this property are excluded from generation to the following templates:

controllers
models
views (only for create and edit templates)

# combustor.yml

# ...

excluded_fields:
  - created_at
  - updated_at
  - deleted_at

Note

The timestamps are added by default when creating a combustor.yml for the first time as they are usually populated automatically by installed ORMs such as Wildfire or Doctrine.

`custom_fields`

By default, all of the fields generated by Combustor to create and edit pages will use the form_input helper:

<div class="mb-3">
  <?= form_label('Email', '', ['class' => 'form-label mb-0']) ?>
  <?= form_input('email', set_value('email'), 'class="form-control"') ?>
  <?= form_error('email', '<div><span class="text-danger small">', '</span></div>') ?>
</div>

However, some fields like email and boolean types may need to use other form helpers:

<div class="mb-3">
  <?= form_label('Email', '', ['class' => 'form-label mb-0']) ?>
  // Still using form_input, but the type is "email" instead
  <?= form_input(['type' => 'email', 'name' => 'email', 'value' => set_value('email'), 'class' => 'form-control']) ?>
  <?= form_error('email', '<div><span class="text-danger small">', '</span></div>') ?>
</div>

<div class="mb-3">
  <?= form_label('Admin', '', ['class' => 'form-label mb-0']) ?>
  // Use "form_checkbox" for boolean-based data types
  <div>
    <?= form_checkbox('admin', true, set_value('admin'), 'class="form-check-input"') ?>
  </div>
  <?= form_error('admin', '<div><span class="text-danger small">', '</span></div>') ?>
</div>

To achieve this, Combustor provides a utility for handling specified field names or data types using custom_fields:

# combustor.yml

# ...

custom_fields:
  - Rougin\Combustor\Template\Fields\BooleanField

When adding a custom field, kindly create a class that extends to the Colfield class:

namespace Acme\Fields;

use Rougin\Combustor\Colfield;

class EmailField extends Colfield
{
    protected $class = 'form-control';

    /**
     * If $name is specified, it will check if the current field
     * name matches the in this $name field.
     */
    protected $name = 'email';

    public function getPlate()
    {
        $field = $this->accessor;

        $class = $this->getClass();

        /** @var string */
        $name = $this->getName();

        $html = '<?= form_input([\'type\' => \'email\', \'name\' => \'' . $name . '\', \'value\' => set_value(\'' . $name . '\')]) ?>';

        if ($this->edit)
        {
            $html = str_replace('set_value(\'' . $name . '\')', 'set_value(\'' . $name . '\', ' . $field . ')', $html);
        }

        $html = str_replace(')]) ?>', '), \'class\' => \'' . $class . '\']) ?>', $html);

        return array($html);
    }
}

Then after creating the custom field, simply add the class name to the combustor.yml:

# combustor.yml

# ...

custom_fields:
  - Rougin\Combustor\Template\Fields\BooleanField
  - Acme\Fields\EmailField

Changelog

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Credits

All contributors

License

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

rougin / combustor

Maintainers

Details

README

Features

Installation

Reminders

Commands

`create:layout`

`create:controller`

`create:model`

`create:repository`

`create:view`

`create:scaffold`

`install:doctrine`

`install:wildfire`

`remove:doctrine`

`remove:wildfire`

Using `combustor.yml`

`app_path`

`excluded_fields`

`custom_fields`

Changelog

Testing

Credits

License

rougin / combustor

Maintainers

Details

README

Features

Installation

Reminders

Commands

create:layout

create:controller

create:model

create:repository

create:view

create:scaffold

install:doctrine

install:wildfire

remove:doctrine

remove:wildfire

Using combustor.yml

app_path

excluded_fields

custom_fields

Changelog

Testing

Credits

License

`create:layout`

`create:controller`

`create:model`

`create:repository`

`create:view`

`create:scaffold`

`install:doctrine`

`install:wildfire`

`remove:doctrine`

`remove:wildfire`

Using `combustor.yml`

`app_path`

`excluded_fields`

`custom_fields`