最可靠的方式是用 php_sapi_name() 判断：if (php_sapi_name() !== 'cli') { die("This script can only be run in CLI mode.\n");}，返回 'cli' 才代表真正处于命令行上下文。
判断当前是否在 CLI 环境下运行
PHP 脚本既可能被 Web 服务器调用，也可能被命令行直接执行。必须先确认运行环境，否则 $_SERVER['argv'] 可能未定义或行为异常，Web 环境下还可能暴露敏感参数。
最可靠的方式是用 php_sapi_name() 判断：
if (php_sapi_name() !== 'cli') {
die("This script can only be run in CLI mode.\n");
}
-
php_sapi_name()返回'cli'才代表真正处于命令行上下文；isset($_SERVER['argv'])或!empty($_SERVER['argv'])不够严谨，某些 CGI 模式下也存在 - 避免用
getenv('TERM')或检测STDIN是否为终端，这些在 Docker 容器或 CI 环境中容易误判
解析 $argv 和 $argc 的基本套路
PHP CLI 启动时自动填充全局变量 $argv（参数数组）和 $argc（参数个数）。$argv[0] 是脚本路径，后续才是用户传入的参数。
简单位置参数处理示例：
立即学习“PHP免费学习笔记（深入）”；
if ($argc < 2) {
echo "Usage: php {$argv[0]} <filename>\n";
exit(1);
}
$filename = $argv[1];
if (!file_exists($filename)) {
echo "Error: file '{$filename}' not found.\n";
exit(1);
}
- 不要直接遍历
$argv做逻辑分支——它不区分选项与值，也不支持--help这类长选项 - 如果需要复杂参数（如
-v --output=foo.txt -d path/to/dir），建议用getopt()函数，而非手写字符串分割 -
getopt()的短选项字符串如'hvqf:'表示-h、-v、-q是开关，-f必须带值；长选项需配合$longopts数组
用 getopt() 实现带值/开关的混合参数
原生 getopt() 足够应付大多数 CLI 工具需求，无需引入外部库。关键是正确声明选项类型并处理返回值。
$shortopts = 'hvqf:';
$longopts = ['help', 'verbose', 'quiet', 'file:', 'output:'];
$options = getopt($shortopts, $longopts);
if (isset($options['h']) || isset($options['help'])) {
echo "Usage: php tool.php [-h|--help] [-v|--verbose] -f <file>\n";
exit(0);
}
if (!isset($options['f']) && !isset($options['file'])) {
echo "Error: -f or --file is required.\n";
exit(1);
}
$inputFile = $options['f'] ?? $options['file'];
$outputFile = $options['o'] ?? $options['output'] ?? 'result.txt';
-
getopt()对大小写敏感，-F和-f是不同选项；长选项名不带=，赋值用冒号:标记 - 返回的数组键是选项字母（短选项）或完整名字（长选项），值是对应参数内容；无值开关项的值为
false或空字符串 - 注意：PHP 7.4+ 中
getopt()支持 GNU 风格的非选项参数提前终止（--），但旧版本不支持，跨版本项目要测试
让 PHP CLI 脚本像系统命令一样直接执行
加了 #!/usr/bin/env php 开头并设可执行权限后，就能像 ./tool.php --help 这样运行，不用显式调用 php。
操作步骤：
#!/usr/bin/env php <?php // ... your CLI logic here ?>
- 第一行必须是
#!/usr/bin/env php，且文件开头不能有 BOM 或空格，否则内核找不到解释器 - 保存后执行
chmod +x tool.php，再运行./tool.php -f data.json - 如果部署到多环境（如 Alpine Linux），
/usr/bin/env更可靠；硬写/usr/bin/php在某些容器里会失败 - Windows 下无效，但 WSL 或 Git Bash 可用；生产环境 CLI 工具尽量避开 Windows 本地运行场景
CLI 参数解析本身不难，真正容易出问题的是对 $argv 边界条件的误判、选项冲突处理缺失，以及忘记校验输入合法性就直接传给 file_get_contents() 或 exec() —— 这些地方一旦疏忽，轻则报错，重则引发路径遍历或命令注入。
