在 PHP 中，cli模式一共包含哪些部分？使用场景是什么？

本文链接：https://blog.csdn.net/qq_36777143/article/details/146370487

1. 什么是 CLI 模式？

简单解释

CLI 模式是一种运行 PHP 脚本的方式，它通过命令行（如终端或控制台）直接执行 PHP 文件，而不是通过 Web 服务器（如 Apache 或 Nginx）。

通俗比喻

想象你在电脑上玩游戏时，可以通过鼠标点击屏幕来操作游戏；但如果用键盘输入指令来控制游戏，这就是 CLI 模式。PHP 的 CLI 模式就像一个“命令行助手”，你可以通过它运行脚本并看到结果。

2. CLI 模式包含哪些部分？

(1) 核心组成部分

PHP 可执行文件：在命令行中调用的 PHP 解释器（如 php 命令）。
PHP 脚本文件：包含 PHP 代码的 .php 文件。
命令行参数：传递给脚本的额外数据（可选）。
标准输入/输出：
- stdin：从命令行读取输入。
- stdout：向命令行输出内容。
- stderr：输出错误信息。

(2) 常用工具

$argv 和 $argc：用于获取命令行参数。
STDIN、STDOUT、STDERR：用于处理输入和输出。
exec()、shell_exec()：执行外部命令。

3. 使用场景是什么？

(1) 定时任务

场景：使用 Cron Job（定时任务）运行脚本。
示例：
```
* * * * * php /path/to/script.php
```

(2) 数据处理

场景：批量处理数据，如生成报告、清理日志等。

示例：

php process_data.php input.csv output.csv

(3) 测试和调试

场景：快速测试 PHP 代码的功能。
示例：
```
php test.php
```

(4) 工具开发

场景：编写命令行工具，如代码生成器、部署脚本等。
示例：
```
php generate_code.php --module=user
```

4. 底层原理是什么？

通俗解释

CLI 模式的底层原理是通过 PHP 解释器直接解析并执行脚本文件，而不需要 Web 服务器的参与。PHP 在 CLI 模式下会读取命令行参数，并通过标准输入/输出与用户交互。

关键点：
- CLI 模式不依赖 HTTP 请求/响应模型。
- 输出直接显示在命令行中，而不是通过浏览器。
- 支持长时间运行的任务（如后台服务）。

5. 具体步骤是怎样的？

流程图

以下是 CLI 模式的执行流程：

开始
  ↓
编写 PHP 脚本
  ↓
通过命令行运行脚本
  ↓
PHP 解释器解析并执行脚本
  ↓
处理输入参数和输出结果
  ↓
结束

示意图

以下是 CLI 模式的动态过程示意图：

输入：php script.php arg1 arg2
↓
PHP 解释器执行 script.php
↓
脚本读取 $argv 参数
↓
脚本处理逻辑并输出结果
↓
输出：Hello, arg1 and arg2!

概念图

以下是 CLI 模式的核心概念：

CLI 模式
  ├── PHP 解释器
  ├── 脚本文件
  ├── 命令行参数
  └── 输入输出

UML 类图

以下是 CLI 模式的简化 UML 类图：

+--------------------------------+
|           PHP Script           |
+--------------------------------+
| + main($argv): void            |
+--------------------------------+
         ▲
         |
+--------------------------------+
|        Command Line            |
+--------------------------------+

思维导图

以下是 CLI 模式的思维导图：

CLI 模式
  ├── 核心功能
  │     ├── 执行 PHP 脚本
  │     └── 处理命令行参数
  ├── 使用场景
  │     ├── 定时任务
  │     ├── 数据处理
  │     └── 工具开发
  └── 底层原理
        └── PHP 解释器

6. 完整实例代码

以下是一个具体的示例代码，展示如何使用 CLI 模式处理命令行参数并输出结果。

<?php

// 1. 获取命令行参数
/*
 * 这行代码的作用：
 *   - $argv 是一个数组，包含所有命令行参数。
 *   - $argc 是参数的数量。
 * 知识点：
 *   - $argv[0] 是脚本名称，后续元素是传递的参数。
 */
$scriptName = $argv[0]; // 脚本名称
$firstName = $argv[1] ?? "World"; // 第一个参数，默认为 "World"
$lastName = $argv[2] ?? ""; // 第二个参数，默认为空

// 2. 检查参数数量
if ($argc < 2) {
    /*
     * 这行代码的作用：
     *   - 如果没有传递足够的参数，提示用户。
     * 知识点：
     *   - $argc 表示参数数量。
     */
    fwrite(STDERR, "Usage: php {$scriptName} [FirstName] [LastName]\n");
    exit(1); // 退出程序，返回状态码 1 表示错误
}

// 3. 输出欢迎信息
/*
 * 这行代码的作用：
 *   - 向命令行输出欢迎信息。
 * 知识点：
 *   - fwrite() 用于写入输出流（如 STDOUT）。
 */
fwrite(STDOUT, "Hello, {$firstName} {$lastName}!\n");

?>

7. 如何运行代码？

将上述代码保存为 greet.php，然后在命令行中运行：

php greet.php Alice Smith

输出结果

Hello, Alice Smith!

如果未传递参数：

php greet.php

输出结果

Usage: php greet.php [FirstName] [LastName]

8. 总结

通过以上讲解和代码，你应该已经理解了 CLI 模式的作用、使用场景、底层原理以及具体实现。以下是关键点总结：

CLI 模式是什么：
- 通过命令行运行 PHP 脚本的方式。
- 不依赖 Web 服务器。
有哪些使用场景：
- 定时任务、数据处理、测试调试、工具开发等。
底层原理：
- PHP 解释器直接解析并执行脚本。
- 支持命令行参数和标准输入/输出。
具体步骤：
- 编写 PHP 脚本。
- 通过命令行运行脚本。
- 处理输入参数并输出结果。