通过CLI方式运行¶

什么是 CLI ？¶

命令行是一个基于文本的与计算机交互方式。更多的内容，可以通过 维基百科的文章 了解。

为什么要通过命令行的方式运行？¶

对于 CodeIgniter 而言，有很多理由需要你使用命令行。但他们并非显而易见。

• 在使用 wget 或者 curl 的方式执行你的定时脚本。
• 通过获取 is_cli() 的返回值，使你的定制脚本无法通过URL访问。
• 编写交互式的“任务”，比如一些需要设置权限，修改缓存文件夹，执行备份等操作。
• 和其他语言编写的其他应用程度交互，比如：一个随机的 C++ 脚本可以通过调用一个命令的方式在你编写的模块中执行。

让我们尝试一下: Hello World!¶

首先我们来新建一个简单的控制器，这样你就可以看到他的行为。使用你的编辑器，新建一个名为 Tools.php 的文件，并在文件中写入如下代码:

<?php
class Tools extends \CodeIgniter\Controller {

        public function message($to = 'World')
        {
                echo "Hello {$to}!".PHP_EOL;
        }
}

然后将这个文件保存在 application/Controllers/ 目录下。

通常你会使用如下的URL访问你的网站:

example.com/index.php/tools/message/to

然而，我们现在要打开 Mac/Linux 下的 Terminal 或者在 Windows 下点击 运行并输入“cmd”之后进入我们 CodeIgniter 项目的 web 根目录，并执行以下命令：

$ cd /path/to/project/public
$ php index.php tools message

如果你的操作正确，你将会看到这个输出 Hello World!

$ php index.php tools message "John Smith"

我们可以在这里像传入URL参数一样，传入一个参数。“John Smith”这个参数作为输入得到的的输出如下:

Hello John Smith!

这里是基础!¶

简而言之，就是我们要知道命令行上的控制器。需要记住的是，这是一个正常的控制器，所以路由和 _remap() 都是正常运作的。

但是， CodeIgniter 提供了额外的工具，可以是更加轻松地创建 CLI 可访问的脚本：包括 CLI-only 路由和一个帮助你使用 CLI-only 工具的库。

$routes->cli('tools/message/(:segment)', 'Tools::message/$1');