Documentation

命令行应用(Command Line Applications)

CLI 应用即是运行在命令行窗体上的应用。主要用来实现后台任务,命令行工具等。

结构(Structure)

最小结构的 CLI 程序如下:

  • app/config/config.php
  • app/tasks/MainTask.php
  • app/cli.php <– 主要启动文件

创建引导(Creating a Bootstrap)

普通的MVC程序中,启动文件用来启动整个应用。和web应用不同, 此处应用中我们使用`cli.php`来作为启动文件。

下面是一个简单的启动文件示例:

<?php

// 使用CLI工厂类作为默认的服务容器
$di = new Phalcon\Di\FactoryDefault\Cli();

// 定义应用目录路径
defined('APPLICATION_PATH') || define('APPLICATION_PATH', realpath(dirname(__FILE__)));

/**
 * 注册类自动加载器
 */
$loader = new \Phalcon\Loader();
$loader->registerDirs(
    array(
        APPLICATION_PATH . '/tasks'
    )
);
$loader->register();

// 加载配置文件(如果存在)
if (is_readable(APPLICATION_PATH . '/config/config.php')) {
    $config =  Phalcon\Config\Adapter\Php(APPLICATION_PATH . '/config/config.php', TRUE);
    $di->set('config', $config);
}

// 创建console应用
$console = new Phalcon\Cli\Console();
$console->setDI($di);

try {
    $console->handle();
} catch (\Phalcon\Exception $e) {
    echo $e->getMessage();
    exit(255);
}

上面的代码可以使用如下方式执行:

$ php app/cli.php --task=main --action=main --params=1 --params=2

这样程序就会执行任务main以及动作main,并传递参数 `array(1, 2)`

通过 argv 解析应用参数:

<?php

use Phalcon\Di\FactoryDefault\Cli as CliDI,
    Phalcon\Cli\Console as ConsoleApp;

define('VERSION', '1.0.0');

// 使用CLI工厂类作为默认的服务容器
$di = new CliDI();

// 定义应用目录路径
defined('APPLICATION_PATH')
|| define('APPLICATION_PATH', realpath(dirname(__FILE__)));

/**
 * 注册类自动加载器
 */
$loader = new \Phalcon\Loader();
$loader->registerDirs(
    array(
        APPLICATION_PATH . '/tasks'
    )
);
$loader->register();

// 加载配置文件(如果存在)
if (is_readable(APPLICATION_PATH . '/config/config.php')) {
    $config = include APPLICATION_PATH . '/config/config.php';
    $di->set('config', $config);
}

// 创建console应用
$console = new ConsoleApp();
$console->setDI($di);

/**
 * 处理console应用参数
 */
$arguments = array();
foreach ($argv as $k => $arg) {
    if ($k == 1) {
        $arguments['task'] = $arg;
    } elseif ($k == 2) {
        $arguments['action'] = $arg;
    } elseif ($k >= 3) {
        $arguments['params'][] = $arg;
    }
}

// 定义全局的参数, 设定当前任务及动作
define('CURRENT_TASK',   (isset($argv[1]) ? $argv[1] : null));
define('CURRENT_ACTION', (isset($argv[2]) ? $argv[2] : null));

try {
    // 处理参数
    $console->handle($arguments);
} catch (\Phalcon\Exception $e) {
    echo $e->getMessage();
    exit(255);
}

上面的代码可以使用如下方式执行:

$ php app/cli.php

这样程序会直接执行默认的任务及默认动作.

从命令行参数列表中获取选项

<?php

$shortopts  = "";
$shortopts .= "n:";  // -n="Phalcon"
$shortopts .= "d::"; // -d
$shortopts .= "D";   // -D

$options = getopt(
    $shortopts,
    array(
        'namespace:', // 必选项 --namespace=Phalcon
        'task::',     // 可选项 --task=main
        'dev::',      // 可选项 --dev=true
        'debug'       // 无值   --debug
        )
);

$opts = getopt(NULL, array('namespace:', 'dev::','action::'));

// 创建console应用
$console = new \Phalcon\Cli\Console();
$console->setDI($di);

// 处理console应用参数
$arguments = array(
    'namespace' => \Phalcon\Arr::get($opts, 'namespace'),
    'task' => \Phalcon\Arr::get($opts, 'task'),
    'action' => \Phalcon\Arr::get($opts, 'action')
);

try {
    $console->handle($arguments);
} catch (\Phalcon\Exception $e) {
    echo $e->getMessage();
}

使用命令行选项类(Cli Options)

<?php

$opts = new \Phalcon\Cli\Options('Phalcon Task CLI');
$opts->add([
    'type' => \Phalcon\Cli\Options::TYPE_STRING,
    'name' => 'namespace',
    'shortName' => 'n',
    'required' => true,
    'defaultValue' => 'Phalcon'
]);
$opts->add([
    'type' => \Phalcon\Cli\Options::TYPE_STRING,
    'name' => 'task',
    'shortName' => 't',
    'required' => true,
    'defaultValue' => 'main'
]);
$opts->add([
    'type' => \Phalcon\Cli\Options::TYPE_STRING,
    'name' => 'action',
    'shortName' => 'a',
    'required' => true,
    'defaultValue' => 'main'
]);
$vals = $opts->parse();
    if (!$vals) {
            return;
    }

// 创建console应用
$console = new \Phalcon\Cli\Console();

// 处理console应用参数
$arguments = array(
    'namespace' => \Phalcon\Arr::get($vals, 'namespace'),
    'task' => \Phalcon\Arr::get($vals, 'task'),
    'action' => \Phalcon\Arr::get($vals, 'action')
);

try {
    $console->handle($arguments);
} catch (\Phalcon\Exception $e) {
    echo $e->getMessage();
}

任务(Tasks)

这里的任务同于web应用中的控制器。 任一 CLI 应用程序都至少包含一个mainTask 及一个 mainAction, 每个任务至少有一个mainAction, 这样在使用者未明确的 指定action时 此mainAction就会执行。

下面即是一个mainTask的例子( app/tasks/MainTask.php ):

<?php

class MainTask extends \Phalcon\Cli\Task
{
    public function mainAction()
    {
        echo "\nThis is the default task and the default action \n";
    }
}

处理动作参数(Processing action parameters)

CLI应用中, 开发者也可以在action中处理传递过来的参数, 下面的例子中已经对传递过来的参数进行了处理。

如果你使用下面的参数和动作运行应用程序:

<?php

class MainTask extends \Phalcon\Cli\Task
{
    public function mainAction()
    {
        echo "\nThis is the default task and the default action \n";
    }

    /**
     * @param array $params
     */
    public function testAction(array $params)
    {
        echo sprintf('hello %s', $params[0]) . PHP_EOL;
        echo sprintf('best regards, %s', $params[1]) . PHP_EOL;
    }
}

我们可以使用下面的命令行及参数执行程序:

$ php app/cli.php main test world universe

hello world
best regards, universe

链中运行任务(Running tasks in a chain)

CLI应用中可以在一个action中执行另一action. 要实现这个需要在 DI 中设置console.

<?php

$di->setShared('console', $console);

try {
    // Handle incoming arguments
    $console->handle($arguments);
} catch (\Phalcon\Exception $e) {
    echo $e->getMessage();
    exit(255);
}

然后开发者即可在一个action中使用用其它的action了. 下面即是例子:

<?php

class MainTask extends \Phalcon\Cli\Task
{
    public function mainAction()
    {
        echo "\nThis is the default task and the default action \n";

        $this->console->handle(
            array(
                'task'   => 'main',
                'action' => 'test'
            )
        );
    }

    public function testAction()
    {
        echo "\nI will get printed too!\n";
    }
}

当然, 通过扩展 Phalcon\Cli\Task 来实现如上操作会是一个更好主意。

运行 MVC 应用(Running MVC Application)

使用MVC架构来开发的程序,在命令行下运行命令如下:

$ php app/index.php --url="/auth/login"