Codeigniter Matches CLI
Codeigniter Matches is a PHP CLI script that allows you to write controllers, models and views faster.
Setup
To verify if you have php cli installed, type into terminal/command prompt.
php -v
If you receive the php version number, then you are good to go.
Go to your config.php file inside the application/config and make sure the following line looks like below:
$config['uri_protocol'] = 'AUTO';
After that line, add:
$config['uri_protocol'] = isset($_SERVER['REQUEST_URI']) ? 'PATH_INFO' : 'CLI';
Save the file...
Put Matches.php (or matches.php if you have a lesser than v.3 Codeigniter) inside the controllers directory. Put config/matches.php inside your app config folder. Also, put matches_templates folder inside the views folder. From terminal or command prompt go to the application's index.php and type:
php index.php matches
If everything went well, you should be greeted by Matches.
Usage
Application
To create MVC stack (controller, model, view) you can use create:app.
Usage example
// Create an MVC stack
php index.php matches create:app users
Controllers
create:controller name_of_controller
You can use Matches to create a Controller file. The command will need at leas a parameter which represents the name of the controller.
You can put the controller inside a directory. Directories are delimited with ".". So, if you want to create the controller inside controllers/admin, you can do create:controller admin.name_of_controller.
Usage examples
// Create a Welcome controller that extends MY_Controller
php index.php matches create:controller welcome e:my
// Create a User controller inside admin directory that will extend Admin_Controller
php index.php matches create:controller admin.user extend:admin
Models
create:model name_of_model
Creates a model having name_of_model as name. You can put the model inside a directory. Directories are delimited with ".". So, if you want to create the model inside models/admin, you can do create model admin.name_of_model.
Usage examples
// Create a user_model model that extends MY_Model
php index.php matches create:model user_model e:my
// Create a User model inside admin directory that will extend MY_Model
php index.php matches create:model admin.user extend:my
Views
create:view name_of_view
Creates a view having name_of_view as file name. You can put the view inside a directory. Directories are delimited with ".". So, if you want to create the view inside views/admin, you can do create view admin.name_of_view.
Usage examples
// Create an index_view.php
php index.php matches create:view user_view
// Create an index_view.php inside users directory
php index.php matches create:view users.index_view
Migrations
CodeIgniter Matches helps you create, do, undo, and reset migrations.
create:migration
To create a migration you can call create:migration. As a result, a migration will be created in the migrations directory prefixed with version as file name. You can also pass a table name as parameter. If no table name is given, you will have to put the name of the table in the migration file. Below are usage examples:
Usage examples
// Create a migration
php index.php matches create:migration create_users_table
// Create a migration with a table inside it
php index.php matches create:migration create_users_table table:users
// Create a migration with a table inside it
php index.php matches create:migration create_users_table t:users
// Create a migration and name the table like the migration
// -> The table name will be 'users' in this exmaple
php index.php matches create:migration t:%inherit% create_users_table
do:migration
do:migration executes the migrations' up() methods. If you pass the version of the migration a parameter, it will stop at that version of the migration.
Usage examples:
// Execute all migrations until the last one
php index.php matches do:migration
// Execute all migrations until a certain version of migration
php index.php matches do:migration 20150722
undo:migration
undo:migration returns you to the previous migration version. This one also can accept a migration version as parameter to return to a migration.
Usage examples:
// Undo last migration
php index.php matches undo:migration
// Undo the migrations until a specified migration version
php index.php matches undo:migration 20150722
reset:migration
reset:migration will reset the migrations until the migration mentioned in $config['migration_version'] (in the migration configuration file).
Usage example:
// Reset the migrations
php index.php matches reset:migration
encryption_key
encryption_key string_to_hash-(OPTIONAL)
- creates an encryption key inside all config.php's found in config folder. If $config['encryption_key'] = '';
doesn't exist or has a value, the encryption key won't be written.
Copyright
Copyright (C) 2014 @avenirer [avenir.ro@gmail.com] Everyone is permitted to copy and distribute verbatim or modified copies of this license document, and changing it is allowed as long as the name is changed.
DON'T BE A DICK PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
Do whatever you like with the original work, just don't be a dick. Being a dick includes - but is not limited to - the following instances: 1a. Outright copyright infringement - Don't just copy this and change the name. 1b. Selling the unmodified original with no work done what-so-ever, that's REALLY being a dick. 1c. Modifying the original work to contain hidden harmful content. That would make you a PROPER dick. If you become rich through modifications, related works/services, or supporting the original work, share the love. Only a dick would make loads off this work and not buy the original works creator(s) a pint. Code is provided with no warranty. Using somebody else's code and bitching when it goes wrong makes you a DONKEY dick. Fix the problem yourself. A non-dick would submit the fix back. License info: http://www.dbad-license.org/