PHP CLI模式可在终端直接运行脚本,适用于定时任务与数据处理;通过$argc和$argv获取参数数量与列表,使用getopt()解析短选项(如-f)和长选项(如--verbose);建议校验参数、输出换行、正确退出,并可结合Phar或Symfony Console提升工具性。

在PHP中编写命令行脚本(CLI模式)非常实用,比如用于定时任务、数据处理、自动化运维等场景。与Web模式不同,CLI模式下PHP直接在终端运行,不依赖Web服务器。下面介绍如何用PHP实现命令行脚本运行,并解析传入的参数。
什么是PHP CLI模式
CLI是“Command Line Interface”的缩写,即命令行接口。PHP CLI允许你在终端或命令提示符中直接执行PHP脚本:
php your-script.php这种运行方式不会经过Apache或Nginx,适合后台任务处理。CLI环境下,一些配置也有所不同,例如默认关闭了输出缓冲,错误会直接打印到终端。
访问命令行参数:$argv 与 $argc
在CLI脚本中,PHP提供了两个超全局变量来获取命令行输入:
立即学习“PHP免费学习笔记(深入)”;
- $argc:表示传入参数的数量(包括脚本名本身)
- $argv:是一个数组,包含所有传入的参数
示例脚本 demo.php:
if ($argc echo "用法: php demo.php [名字]\n";exit(1);
}
$name = $argv[1];
echo "你好, $name!\n";
?>
运行命令:
php demo.php 张三输出:
支持选项参数:getopt() 函数
对于更复杂的命令行工具,通常需要支持带选项的参数,如 -f file.txt 或 --verbose。PHP提供 getopt() 函数来解析这些选项。
语法:
getopt(string $short_options [, array $long_options])- 短选项:如 v 表示 -v,f: 表示 -f 必须带值,o:: 表示 -o 可选值
- 长选项:如 ['verbose', 'file:', 'output::'],对应 --verbose、--file=value、--output[=value]
示例:parse_args.php
// 定义支持的选项$shortopts = "f:v";
$longopts = [
"file:",
"verbose",
"output::"
];
$options = getopt($shortopts, $longopts);
if (isset($options['f']) || isset($options['file'])) {
$file = $options['f'] ?? $options['file'];
echo "文件: $file\n";
}
if (isset($options['v']) || isset($options['verbose'])) {
echo "启用详细模式\n";
}
if (isset($options['output'])) {
$out = $options['output'] ?? 'default.out';
echo "输出到: $out\n";
}
?>
运行示例:
php parse_args.php -f config.json --verbose --output=result.txt输出:
文件: config.json启用详细模式
输出到: result.txt
实际应用建议
编写健壮的CLI脚本时,注意以下几点:
- 始终检查参数数量,给出清晰的使用提示
- 使用 echo 或 print 输出信息,结尾加上 "\n" 换行
- 通过 exit(0) 表示成功,exit(1) 表示出错
- 可结合 Phar 打包脚本为单文件便于分发
- 考虑使用Symfony Console等组件构建复杂命令行工具
基本上就这些。掌握 $argv、$argc 和 getopt(),你就能写出功能完整的PHP命令行脚本。不复杂但容易忽略细节,比如参数校验和用户提示,写工具时别忘了加帮助信息。











