PHP CLI模式允许在命令行运行PHP脚本，适用于定时任务和自动化工具。通过$argc和$argv获取参数数量与数组，使用getopt()函数解析短选项（如-f）和长选项（如--format），推荐用于规范参数处理。编写脚本时应提供帮助信息、校验参数、合理输出并考虑日志记录，exit(0)表示成功，非零值表示错误，提升脚本健壮性与用户体验。
PHP 不仅可以用于开发 Web 应用，在命令行（CLI）环境下也能发挥强大作用。通过 PHP CLI 模式，你可以运行定时任务、数据处理脚本、自动化工具等无需浏览器参与的程序。掌握 CLI 使用方式和参数解析方法，是编写高效命令行脚本的关键。
什么是 PHP CLI 模式
CLI 是 Command Line Interface 的缩写，PHP CLI 模式允许你在终端或命令提示符中直接执行 PHP 脚本。与 Web SAPI（如 Apache 或 FPM）不同，CLI 模式不涉及 HTTP 请求，输出直接打印到控制台。
运行一个 PHP 命令行脚本非常简单：
php script.php
你可以在任何安装了 PHP 的系统中使用该命令。CLI 模式下，一些配置也有所不同，例如默认关闭 HTML 错误输出、不限制执行时间（max_execution_time=0）等，更适合长时间运行的任务。
立即学习“PHP免费学习笔记（深入）”；
访问命令行参数：$argv 与 $argc
在 CLI 脚本中，传递给脚本的参数可以通过两个预定义变量获取：
- $argc：表示传入参数的数量（包括脚本名本身）
- $argv：是一个数组，包含所有传入的参数
例如，有如下调用：
php process.php input.txt --format=json -v
在 process.php 中：
var_dump($argc); // 输出: 4
var_dump($argv);
// 输出:
// array(4) {
// [0] => "process.php"
// [1] => "input.txt"
// [2] => "--format=json"
// [3] => "-v"
// }
你可以遍历 $argv 来解析这些参数。注意第一个元素总是脚本路径，实际参数从索引 1 开始。
手动解析参数的基本方法
对于简单的脚本，可以直接遍历 $argv 进行参数处理：
array_shift($argv); // 移除脚本名
foreach ($argv as $arg) {
if (strpos($arg, '--format=') === 0) {
$format = substr($arg, 9);
} elseif ($arg === '-v' || $arg === '--verbose') {
$verbose = true;
} elseif (pathinfo($arg, PATHINFO_EXTENSION) === 'txt') {
$file = $arg;
}
}
这种方式适合参数少、结构简单的场景。但随着参数增多，容易出错且维护困难。
使用 getopt() 函数进行标准参数解析
PHP 提供了 getopt() 函数，用于按规范解析短选项（-f）和长选项（--file）。
语法：
getopt(string $short_options, array $long_options = [])
示例：
$options = getopt('f:v', ['format:', 'verbose', 'help']);
说明：
- f: 表示 -f 后必须跟一个值，如 -f json
- v：表示 -v 是开关型参数，无需值
- format: 对应 --format=value
- verbose：对应 --verbose
调用：
php script.php -f json --verbose --format=json -v
返回数组：
[ 'f' => 'json', 'v' => false, 'format' => 'json', 'verbose'=> false ]
getopt() 大大简化了解析逻辑，推荐在大多数 CLI 脚本中使用。
实用建议与最佳实践
编写健壮的命令行脚本时，注意以下几点：
- 始终提供帮助信息，比如检测到 --help 时输出用法说明
- 对关键参数做类型和存在性校验
- 使用 exit(0) 表示成功，exit(1) 或其他非零值表示错误
- 输出信息尽量清晰，可加入颜色或前缀（如 [INFO]、[ERROR]）提升可读性
- 考虑日志记录，尤其是长时间运行的脚本
示例：输出帮助文本
if (in_array('--help', $argv)) {
echo "Usage: php script.php [options]\n";
echo "Options:\n";
echo " -f, --format=FORMAT Set output format\n";
echo " -v, --verbose Enable verbose mode\n";
echo " --help Show this help message\n";
exit(0);
}
基本上就这些。PHP CLI 模式配合合理的参数解析，能让你快速构建功能完整的命令行工具。getopt() 是最实用的内置方法，足够应对多数需求。理解 $argv 和 $argc 的工作机制，是深入定制脚本的基础。
