PHP SAPI---CLI命令行

封面图 • 2025-10-29 • PHP

在 PHP 中，**SAPI（Server API）** 是指 PHP 与服务器环境交互的接口。`CLI`（Command Line Interface）是其中一种 SAPI 类型，用于在命令行中运行 PHP 脚本。

---

## ✅ 什么是 CLI SAPI？

`CLI` 是 PHP 在命令行模式下运行的方式。它允许你直接通过终端或命令提示符执行 PHP 脚本，而不是通过 Web 服务器（如 Apache、Nginx）来处理请求。

---

## 🧪 示例：使用 CLI 运行 PHP 脚本

### 1. 编写一个 PHP 脚本（例如 `hello.php`）：

```php
<?php
echo "Hello, CLI!\n";
```

### 2. 在命令行中运行：

```bash
php hello.php
```

输出结果：

```
Hello, CLI!
```

---

## 📌 常见用途

- 执行定时任务（Cron Jobs）
- 执行脚本进行数据处理
- 运行单元测试
- 自动化部署脚本
- 开发工具脚本（如 Laravel 的 Artisan）

---

## 🧾 获取当前 SAPI 类型

你可以使用以下代码查看当前 PHP 脚本运行的 SAPI 类型：

```php
<?php
echo php_sapi_name();
```

如果在命令行中运行，输出将是：

```
cli
```

如果是通过 Web 服务器运行，则可能是 `apache2handler`、`fpm-fcgi` 等。

---

## 🧩 CLI 模式下的特性

| 特性 | 说明 |
|------|------|
| 不依赖 HTTP 协议 | 可以直接调用函数、操作文件等 |
| 支持参数传递 | 可以通过 `$argv` 接收命令行参数 |
| 更高的性能 | 不需要处理 HTTP 请求头等 |
| 适合后台任务 | 适合长时间运行的任务 |

---

## 🔁 使用命令行参数

PHP CLI 支持从命令行传入参数，例如：

```bash
php script.php arg1 arg2
```

在脚本中可以通过 `$argv` 数组获取参数：

```php
<?php
print_r($argv);
```

输出示例：

```
Array
(
    [0] => script.php
    [1] => arg1
    [2] => arg2
)
```

---

## ✅ 小技巧：创建可执行的 PHP 脚本

你可以让 PHP 脚本像 shell 脚本一样直接运行：

1. 在脚本顶部添加 shebang：

```php
#!/usr/bin/env php
<?php
echo "This is a CLI PHP script.\n";
```

2. 赋予执行权限：

```bash
chmod +x script.php
```

3. 直接运行：

```bash
./script.php
```

---

## 📚 参考资料

- [PHP 官方文档 - CLI](https://www.php.net/manual/zh/features.commandline.php)
- [PHP SAPI 类型列表](https://www.php.net/manual/zh/function.php-sapi-name.php)

---

如果你有具体的使用场景（比如开发 CLI 工具、定时任务等），我可以提供更详细的示例和建议！