kasundon/lib-console

Lib-Console

Simple PHP CLI Framework, _(*1)

Installation

There are two ways to use lib-console., _(*2)

1. Using Composer

composer.json file, _(*3)

{
    "require": {
        "kasundon/lib-console": "~0.0.6"
    }
}

php composer.phar install

2. Using PHAR Archive (console.phar)

Fist of all, Download latest console.phar., _(*4)

curl -O https://github.com/KasunDon/lib-console/raw/master/build/console.phar

Get help for console.phar

php console.phar -help

Setup Default Command file path

place console.json file to your current working directory. Leave emtpty file_path in order to use current working directory., _(*5)

{
    "file_path": "commands/"
}

Writing Commands

Simply implement Command Interface on to your custom command class., _(*6)

If using console.phar - Dont forget to require_once follwoing statement before implements from Command Interface.

require_once 'phar://console.phar/Command.php';

Standard Custom Command

<?php

class Test implements Command {

    /**
     * Pre-execution command setup
     */
    public function setup() 
    {
        CommandUtility::log("pre command setup");
    }

    /**
     * Executes command routines
     */
    public function execute() 
    {
        CommandUtility::log("execute");
    }

    /**
     *  Returns command name/description
     * 
     * @return string
     */
    public function getCommand() 
    {
        return "Test Command";
    }
}

Run Commands

Place app.php into current working directory and execute on following format. first argument is your custom command name. when pass in arguments use following format --abc 1., _(*7)

Please note: class name will be use as command name., _(*8)

php app.php Test --abc 1

Or using console.phar

php console.phar Test --abc 1

Using cli arguments in inside command script

lib-console automatically injecting input cli arguments into arguments property. you can simple use them as follows,, _(*9)

 $this->arguments

Feel free to contribute / feedback

if any questions please feel free to contact kasun@phpbox.info