PHP CLI 输入指南：掌握终端交互与用户数据获取95

作为一名专业的程序员，我非常乐意为你撰写一篇关于PHP终端获取输入的深度文章。PHP作为一门全栈语言，不仅在Web开发领域大放异彩，其强大的命令行接口（CLI）能力也使其成为编写脚本、自动化任务和系统工具的理想选择。在CLI环境中，与用户或外部进程进行交互，获取输入是构建实用工具的关键。
---

在PHP的世界里，我们常常将注意力集中在Web服务器环境下的请求-响应模式上，即通过`$_GET`、`$_POST`或`php://input`等超全局变量获取用户输入。然而，PHP的命令行接口（CLI）模式同样强大且应用广泛。当我们在终端中执行PHP脚本时，传统的Web输入方式便不再适用。那么，如何在CLI模式下与用户进行交互，从终端获取输入数据呢？本文将深入探讨PHP在终端环境下获取输入的各种方法，从命令行参数到标准输入流，再到环境变量，并介绍如何结合这些技术构建健壮、交互式的命令行工具。

一、PHP CLI 环境概述：告别Web输入

首先，我们需要明确PHP CLI环境与Web环境的根本区别。在Web环境下，PHP作为Web服务器（如Apache、Nginx）的模块或通过FPM（FastCGI Process Manager）运行，其生命周期与HTTP请求绑定。用户通过浏览器提交表单或访问URL，数据通过HTTP协议封装在请求体或URL参数中，PHP再通过封装好的`$_GET`、`$_POST`、`$_REQUEST`等超全局变量进行访问。

而在CLI环境下，PHP脚本由命令行直接执行，例如`php `。此时没有Web服务器，没有HTTP请求，因此上述的超全局变量均为空或不适用。CLI脚本通常用于：

执行后台任务
数据处理和迁移
系统管理和自动化脚本
构建交互式命令行工具

要在CLI环境下获取输入，我们需要转向操作系统层面的输入机制。

二、命令行参数：最直接的数据来源 (`$argv` 和 `$argc`)

命令行参数是CLI脚本获取输入最常见和直接的方式。当你在执行PHP脚本时，可以在脚本名后面附加任意数量的参数。PHP会自动将这些参数解析并存放在`$argv`数组中，同时提供一个`$argc`变量来表示参数的数量。

`$argv`是一个索引数组：

`$argv[0]`：始终是当前执行的PHP脚本的文件名（或路径）。
`$argv[1]`：第一个传递给脚本的参数。
`$argv[n]`：第n个传递给脚本的参数。

`$argc`是`$argv`数组的元素个数。

示例：
//
<?php
echo "脚本名: " . $argv[0] . PHP_EOL;
echo "参数数量: " . $argc . PHP_EOL;
if ($argc > 1) {
echo "传递的参数有:" . PHP_EOL;
for ($i = 1; $i < $argc; $i++) {
echo " 参数" . $i . ": " . $argv[$i] . PHP_EOL;
}
} else {
echo "没有传递额外参数." . PHP_EOL;
}
// 假设我们希望获取一个操作和一些数据
if ($argc >= 3 && $argv[1] === 'add') {
$item = $argv[2];
echo "执行 'add' 操作，添加项: " . $item . PHP_EOL;
} elseif ($argc >= 2 && $argv[1] === 'help') {
echo "Usage: php [command] [args...]" . PHP_EOL;
echo "Commands: add <item>, help" . PHP_EOL;
}

如何运行：
php
php hello world
php add "My new task"
php help
通过这种方式，我们可以轻松地实现基于命令和选项的CLI工具。对于更复杂的参数解析（如带有`--`前缀的选项或短选项`-o`），通常会借助于第三方库（如Symfony Console Component）来简化处理。

三、标准输入（STDIN）：实现交互式用户输入

命令行参数适用于一次性传递数据，但如果需要与用户进行多次交互，或者接收用户在脚本运行过程中输入的数据，就需要使用标准输入流（STDIN）。STDIN是Unix/Linux系统中所有进程默认可读取的输入通道，通常连接到用户的键盘。
PHP提供了多种函数来从STDIN读取数据：

3.1 `readline()` 函数：交互式输入的利器

`readline()`函数是PHP中专门为交互式命令行程序设计的，它提供了一个类似于shell的输入体验，支持行编辑、历史记录（通过上下箭头）等高级功能。

示例：
//
<?php
echo "欢迎来到交互式程序！" . PHP_EOL;
if (extension_loaded('readline')) {
echo "Readline扩展已加载，提供更好的交互体验。" . PHP_EOL;
// 设置历史记录文件（可选）
// readline_read_history('');
$name = readline("请输入你的名字: ");
echo "你好，" . $name . "！" . PHP_EOL;
$age = (int)readline("请输入你的年龄: ");
echo "你的年龄是: " . $age . "岁。" . PHP_EOL;
// 保存历史记录（可选）
// readline_write_history('');
} else {
echo "Readline扩展未加载，将使用基本的输入方式。" . PHP_EOL;
// 回退到fgets(STDIN)
echo "请输入你的名字: ";
$name = trim(fgets(STDIN));
echo "你好，" . $name . "！" . PHP_EOL;
}
echo "程序结束。" . PHP_EOL;

注意： `readline()`函数需要PHP的`readline`扩展支持。在大多数Linux发行版上，此扩展可能默认未启用或未安装，需要手动安装或启用（例如，在Debian/Ubuntu上是`apt install php-readline`，然后`phpenmod readline`）。在Windows上，`readline`扩展通常不可用或不推荐使用。

3.2 `fgets(STDIN)` 函数：通用且可靠的输入方式

`fgets()`函数用于从文件指针中读取一行。`STDIN`是一个预定义的常量，它代表了标准输入流的文件指针。这是从终端获取一行文本最基础且普遍适用的方法，不需要任何特殊扩展。

示例：
//
<?php
echo "请输入你的用户名: ";
$username = trim(fgets(STDIN)); // fgets会包含换行符，需要trim()去除
echo "请输入你的密码: ";
// 对于敏感输入，可以使用shell_exec('stty -echo')暂时关闭回显
// 并在输入后恢复 shell_exec('stty echo')
// 这里为了简化，我们直接读取
$password = trim(fgets(STDIN));
echo "你的用户名是: " . $username . PHP_EOL;
echo "你的密码是: " . $password . " (请勿在生产环境直接显示密码！)" . PHP_EOL;

`fgets(STDIN)`的优点是跨平台兼容性好，无需额外配置。缺点是它不提供行编辑、历史记录等高级功能，用户体验不如`readline()`。通常，对于不需要高级交互的简单脚本，`fgets(STDIN)`是首选。

3.3 `file_get_contents('php://stdin')`：读取所有输入

`php://stdin`是一个特殊的流包装器，它允许你像读取文件一样读取标准输入流。使用`file_get_contents()`配合`php://stdin`会读取所有可用的标准输入数据，直到遇到EOF（End Of File）标记。这对于处理管道（pipe）传输过来的数据非常有用，例如：`echo "hello world" | php `。

示例：
//
<?php
// 从管道或手动输入中读取所有内容直到EOF
$allInput = file_get_contents('php://stdin');
if (!empty($allInput)) {
echo "接收到所有输入内容:" . PHP_EOL;
echo $allInput;
} else {
echo "未接收到任何输入或输入为空。" . PHP_EOL;
}

如何运行：
echo "这是通过管道传递的一段文本。" | php
php
// 在这里手动输入内容，按 Ctrl+D (Unix/Linux) 或 Ctrl+Z (Windows) + Enter 结束输入
// 例如：
// 第一行文本
// 第二行文本
// ^D

这种方法适用于一次性接收大量或多行输入，而不适合逐行交互。

四、环境变量：配置与上下文信息

环境变量是操作系统提供的一种进程间通信（IPC）机制，允许我们为程序提供配置信息或上下文数据。在PHP CLI脚本中，可以通过`getenv()`函数或`$_ENV`超全局变量来获取环境变量。

示例：
//
<?php
// 从环境变量中获取
$appName = getenv('APP_NAME');
if ($appName) {
echo "应用程序名称 (来自getenv): " . $appName . PHP_EOL;
} else {
echo "未设置 APP_NAME 环境变量。" . PHP_EOL;
}
// 也可以通过 $_ENV 超全局变量（需要中variables_order包含E）
if (isset($_ENV['APP_ENV'])) {
echo "应用程序环境 (来自_ENV): " . $_ENV['APP_ENV'] . PHP_EOL;
} else {
echo "未设置 APP_ENV 环境变量或无法通过_ENV获取。" . PHP_EOL;
}
echo "所有环境变量:" . PHP_EOL;
print_r($_SERVER); // $_SERVER 通常也包含一些环境变量

如何运行：
# 设置环境变量并运行
export APP_NAME="MyCliTool"
export APP_ENV="development"
php
# 或者只运行
php

环境变量常用于：

存储数据库连接字符串、API密钥等敏感配置。
定义运行环境（开发、测试、生产）。
传递不适合作为命令行参数的全局配置。

五、构建一个简单的交互式任务管理工具

现在，让我们将上述知识点结合起来，构建一个简单的交互式任务管理CLI工具。
//
<?php
echo "-------------------------" . PHP_EOL;
echo " 简单任务管理器 CLI" . PHP_EOL;
echo "-------------------------" . PHP_EOL;
$tasks = []; // 存储任务
// 检查是否启用了readline扩展
$hasReadline = extension_loaded('readline');
function prompt(string $message, bool $allowEmpty = false): string
{
global $hasReadline;
if ($hasReadline) {
$input = readline($message . ": ");
} else {
echo $message . ": ";
$input = trim(fgets(STDIN));
}
if (empty($input) && !$allowEmpty) {
echo "输入不能为空，请重试！" . PHP_EOL;
return prompt($message, $allowEmpty); // 递归提示直到输入有效
}
return $input;
}
function displayTasks(array $tasks): void
{
if (empty($tasks)) {
echo "当前没有任务。" . PHP_EOL;
return;
}
echo "--- 你的任务列表 ---" . PHP_EOL;
foreach ($tasks as $index => $task) {
echo ($index + 1) . ". " . $task . PHP_EOL;
}
echo "--------------------" . PHP_EOL;
}
while (true) {
echo PHP_EOL;
echo "命令: (add)添加, (list)列表, (done)完成, (exit)退出" . PHP_EOL;
$command = strtolower(prompt("请输入你的命令", false));
switch ($command) {
case 'add':
$newTask = prompt("请输入新任务内容");
$tasks[] = $newTask;
echo "任务 '" . $newTask . "' 已添加。" . PHP_EOL;
break;
case 'list':
displayTasks($tasks);
break;
case 'done':
displayTasks($tasks);
if (!empty($tasks)) {
$taskNumber = (int)prompt("请输入要完成的任务编号", false);
if ($taskNumber > 0 && $taskNumber