[NFR] Examples and docs about cli modules

[alvassin]

I found that there are some CLI classes. Perhaps you could spend some time on tutorials about writing cli applications with such modules....

If writing cli applications would be simple as writing micro applications it would be unbeliveable.

Perhaps, i need to make cli application, that accepts parameters in the following way:
cli-app.php $command --param1=value1 --param2=value2

If it would be possible to handle such requests automatically and focus on business logic, it would ecomony many time :)

[alvassin]

Another way i thought about:

./script.php robot/create --color=red --feature=weapon

and to get this inside my application with controllers, actions, etc in this way:

controller: robot
action: create
GET params: color=red,feature=weapon

[alvassin]

We have four classes, that are prepared especially for CLI:

• Phalcon\CLI\Console - analog of Phalcon\Mvc\Micro or Phalcon\Mvc\Application, main controller for all objects, everything
• Phalcon\CLI\Router - router, same as router in usual web applications
• Phalcon\CLI\Task - analog of usual controller
• Phalcon\CLI\Dispatcher - same as Phalcon\Dispatcher

What i really can't get - is phalcon able to get and handle argv parameters manually, and those classes should work in group.

Perhaps you will find some little amount of time to describe this shortly. I believe that with Phalcon my CLI app will look much nicer then without it :)

Thanks in advance

[alvassin]

I've added my example here:
http://stackoverflow.com/questions/14807676/phalcon-and-cli-applications

[alvassin]

One bad thing: cli/console is accepting all parameters as action names, for example:

./app.php test --param1=value1 --param2=value2

Will output:
PHP Fatal error: Uncaught exception 'Phalcon\CLI\Dispatcher\Exception' with message 'Action '--param1=value1' was not found on handler 'station'' in /var/www/source-api/cli/app.php:37
Stack trace:
#0 [internal function]: Phalcon\CLI\Dispatcher->_throwDispatchException('Action '--param...', 5)
#1 [internal function]: Phalcon\Dispatcher->dispatch()
#2 /var/www/source-api/cli/app.php(37): Phalcon\CLI\Console->handle(Array)
#3 {main}
thrown in /var/www/source-api/cli/app.php on line 37

How it is possible to get params for specified action?

[alvassin]

It's also impossible to pass parameters as:

./script.php testtask?param=value

./script.php testtask -param

[alvassin]

If i specity parameters following way:

./app.php test test --param=value

in test task i have following code:

    public function testAction()
    {
        var_dump($this->dispatcher->getParams());
    }

i will get following values:

array(1) {
  [0]=>
  string(13) "--param=value"
}

How to get array keys as param names and array values as param values?

[alvassin]

If i specify parameters divided by a space, i will get them as separate params:

./app.php test test param value

array(2) {
  [0]=>
  string(7) "param"
  [1]=>
  string(5) "value"
}

How it is possible to get array as following?

array(1) {
  ['param']=> string(5) "value"
}

[alvassin]

Was unable find the way for this in the end. Finally stopped at solution to define parameters in action methods, like this:

public function doSmth($param1, $param2)

This works fine.

Perhaps it's a good idea for NFR to implement param=value or --param=value, which will look more native in cli?