CodeIgniter4 通过CLI方式运行

除了通过在浏览器中输入URL的方式访问我们的应用程序 Controllers 我们还可以通过命令行（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 工具的库。

CLI-Only 路由

在 Routes.php 文件中你可以像创建其他路由的方式轻松新建只能通过 CLI 方式访问的路由，这些路由并不是使用类似 get() 、 post() ，或者其他类似的方法，在这里你需要使用 cli() 方法:

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

更多信息，可以查看这里 Routes 。

CLI 库

CLI 库让我们的 CLI工作变得简单。它提供了简单的方法然我们将多种颜色的文本输出在终端上。它还可以让你给用户输出提示信息，构建出一个更加智能的工具。

更多信息，可以查看这里 CLI Library 。