PHP下的命令行执行

封面图 • 2026-01-06 • PHP

在 PHP 中，**命令行执行**（Command Line Execution）指的是通过命令行（终端或命令提示符）直接运行 PHP 脚本，而不是通过 Web 服务器（如 Apache 或 Nginx）。这种方式常用于：

- 执行定时任务（cron jobs）
- 批量处理数据
- 后台任务
- 调试脚本

---

## 一、基本用法

### 1. 运行 PHP 脚本

```bash
php your_script.php
```

例如：

```bash
php hello.php
```

### 2. 传递参数给 PHP 脚本

你可以在命令行中传递参数给 PHP 脚本，PHP 会将这些参数存储在 `$_SERVER['argv']` 数组中。

示例：`script.php`

```php
<?php
print_r($_SERVER['argv']);
?>
```

运行：

```bash
php script.php arg1 "arg two" 3
```

输出：

```
Array
(
    [0] => script.php
    [1] => arg1
    [2] => arg two
    [3] => 3
)
```

---

## 二、常用命令行选项

| 选项 | 说明 |
|------|------|
| `-r` | 直接运行一段 PHP 代码，无需文件 |
| `-f` | 指定要运行的文件（默认是第一个参数） |
| `-n` | 不加载 `php.ini` 文件 |
| `-c` | 指定 `php.ini` 的路径 |
| `-d` | 设置配置项（如：`-d display_errors=1`） |
| `-s` | 显示源码（带语法高亮） |
| `-v` | 显示版本信息 |
| `-i` | 显示 phpinfo() 信息 |
| `-l` | 仅检查语法错误（不执行脚本） |

---

## 三、使用 `-r` 直接运行代码

```bash
php -r 'echo "Hello, World!\n";'
```

输出：

```
Hello, World!
```

---

## 四、执行 PHP 脚本时的环境变量

你可以通过 `getenv()` 函数获取命令行中的环境变量：

```bash
export MY_VAR="test"
php script.php
```

`script.php`:

```php
<?php
echo getenv('MY_VAR');
```

输出：

```
test
```

---

## 五、在 Windows 和 Linux 下的差异

- **Windows**：通常需要安装 PHP 并将其添加到系统 PATH 中。
- **Linux/macOS**：可以直接使用 `php` 命令（前提是已安装 PHP）。

---

## 六、常见问题

### 1. “php” 命令找不到？

确保 PHP 已正确安装，并且其可执行文件路径已加入系统环境变量 `PATH`。

你可以通过以下命令查看 PHP 是否可用：

```bash
php -v
```

如果报错，可以尝试：

```bash
/usr/bin/php -v   # 根据实际安装路径调整
```

---

## 七、PHP CLI 模式 vs Web 模式

| 特性 | CLI 模式 | Web 模式 |
|------|----------|----------|
| 执行方式 | 命令行 | Web 请求 |
| 输出方式 | 直接输出到终端 | 输出到浏览器 |
| 错误显示 | 默认开启 | 可配置 |
| 脚本执行时间限制 | 无（除非设置） | 通常为 30 秒 |
| 内存限制 | 无（除非设置） | 通常有限制 |

---

## 八、示例：定时任务（Cron Job）

在 Linux 中，可以使用 `crontab` 定时执行 PHP 脚本：

```bash
# 每天凌晨 1 点执行
1 0 * * * /usr/bin/php /path/to/script.php
```

---

## 九、调试技巧

- 使用 `var_dump()` 或 `print_r()` 来输出变量。
- 使用 `error_reporting(E_ALL);` 开启所有错误报告。
- 使用 `-l` 检查语法错误：

```bash
php -l script.php
```

---

如果你有具体的场景或需求（比如想写一个定时任务、执行某个脚本、传递参数等），欢迎继续提问！