PHP CLI可在命令行直接运行PHP脚本，适用于自动化任务。通过php -v确认环境，使用$argc和$argv接收参数，结合getopt()解析选项，添加shebang并设执行权限实现直接运行，输出错误到STDERR，返回退出码，并支持-help提示，配合日志记录与重定向可开发健壮的运维工具。
PHP不只是用来做网页的，它也能在命令行下运行脚本，这种模式叫CLI（Command Line Interface）。用好PHP CLI，能帮你写自动化任务、定时脚本、数据处理工具等。下面带你一步步掌握PHP命令行工具的基本用法和开发技巧。
什么是PHP CLI
CLI是PHP的一个运行模式，不依赖Web服务器，直接在终端执行PHP代码。你写的脚本不会输出到浏览器，而是打印在终端里。适合跑后台任务，比如清理日志、同步数据、发送邮件等。
检查是否安装了CLI：
php -v如果看到PHP版本信息，说明已经装好了。大多数系统默认带CLI支持。
立即学习“PHP免费学习笔记（深入）”；
运行第一个CLI脚本
创建一个简单的PHP文件，比如 hello.php：
echo "Hello from command line!\n";?>
在终端运行：
php hello.php你会看到输出：Hello from command line!
注意：加 \n 是为了让换行生效，CLI中用echo输出时最好加上换行符，否则提示符会紧跟输出后面。
接收命令行参数
CLI脚本常需要传参数。PHP提供两个全局变量：$argc 和 $argv。
- $argc：参数个数（包含脚本名）
- $argv：参数数组，索引从0开始
例子：arg_test.php
echo "共 {$argc} 个参数：\n";foreach ($argv as $index => $arg) {
echo "$index: $arg\n";
}
?>
运行：
php arg_test.php name=jack action=run --debug
输出会列出所有传入的参数。
你可以自己解析$argv，也可以用 getopt() 处理选项参数：
$options = getopt("d::", ["debug::", "action:"]);if (isset($options['debug'])) {
echo "Debug mode enabled.\n";
}
这样支持短选项（-d）和长选项（--debug），冒号表示是否需要值。
编写实用的CLI工具
真正有用的CLI脚本要有交互性和健壮性。以下几点建议：
- 加Shebang（#!）让脚本能直接运行：
#!/usr/bin/env php
保存后给执行权限：chmod +x script.php，之后可直接 ./script.php 运行 - 输出信息用 stderr 报错，避免干扰正常输出：
fwrite(STDERR, "Error: something went wrong\n"); - 返回退出码，帮助其他程序判断结果：
exit(1); // 表示出错 - 支持帮助提示，比如传 -h 或 --help 时显示用法
示例：一个简单备份脚本 backup.php
#!/usr/bin/env phpfunction showHelp() {
echo "Usage: backup.php
exit(0);
}
if ($argc != 3 || in_array('-h', $argv) || in_array('--help', $argv)) {
showHelp();
}
$source = $argv[1];
$target = $argv[2];
if (!is_dir($source)) {
fwrite(STDERR, "Error: source directory not found.\n");
exit(1);
}
// 模拟复制
echo "Copying $source to $target...\n";
sleep(1);
echo "Done.\n";
?>
运行：php backup.php /tmp/data /backup
调试与日志
CLI脚本调试比Web容易，可以直接 print_r() 或 var_dump() 输出变量。
建议把关键操作写进日志文件，尤其是长时间运行的任务：
file_put_contents($logFile, date('Y-m-d H:i:s') . " - Started\n", FILE_APPEND);
也可以结合Linux的重定向功能：
php myscript.php > output.log 2>&1把标准输出和错误都记录下来。
基本上就这些。PHP CLI模式简单直接，特别适合写中小型运维工具。关键是理解参数处理、错误输出和退出状态。只要逻辑清晰，再配合cron定时任务，就能实现很多自动化功能。
