PHP命令行使用教程:CLI脚本开发指南
PHPCLI模式可用于执行定时任务和数据处理,通过php命令运行脚本,支持传参($argv)、交互输入(fgets(STDIN)),建议添加Shebang、设置编码、使用exit状态码和STDERR输出错误。
PHP CLI模式可用于执行定时任务和数据处理,通过php命令运行脚本,支持传参($argv)、交互输入(fgets(STDIN)),建议添加Shebang、设置编码、使用exit状态码和STDERR输出错误。

PHP 不只是用来做网页的,它也能通过命令行运行脚本,这就是 PHP 的 CLI(Command Line Interface)模式。相比 Web 模式,CLI 更适合执行定时任务、数据处理、自动化脚本等后台操作。下面带你快速掌握 PHP CLI 的基本用法和开发技巧。
什么是 PHP CLI
CLI 是 PHP 的命令行接口,允许你在终端或控制台中直接运行 PHP 脚本,不需要依赖 Web 服务器。你输入一条命令,PHP 解释器就会执行对应的脚本,并将结果输出到终端。
判断当前是否运行在 CLI 模式,可以用:
if (php_sapi_name() === 'cli') { ... }这个判断常用于兼容 Web 和 CLI 双模式运行的脚本。
如何运行 PHP CLI 脚本
打开终端,进入脚本所在目录,使用 php 命令加上脚本文件名即可运行:
- php script.php —— 最基本的执行方式
- php -f script.php —— 显式指定文件(可选)
- php -r 'echo "Hello CLI";' —— 直接运行一行代码,不需文件
你还可以给脚本传参,就像其他命令一样:
php myscript.php arg1 arg2 arg3这些参数会存入全局变量 $argv,其中 $argv[0] 是脚本名,$argv[1] 开始是传入的参数,总共个数为 $argc。
读取用户输入与交互
CLI 脚本可以和用户互动,比如提示输入账号密码或确认操作。常用方法是读取标准输入:
$handle = fopen("php://stdin", "r");$input = trim(fgets($handle));
fclose($handle);
例如:
echo "确定要继续吗?(y/n): ";$answer = trim(fgets(STDIN));
if ($answer === 'y') { echo "开始执行...\n"; }
注意:使用 STDIN 前确保是在 CLI 环境下,否则可能报错。
编写实用的 CLI 脚本技巧
写好 CLI 脚本有几个实用建议:
- 加 Shebang 行:在脚本开头加上 #!/usr/bin/env php,Linux/Mac 下可直接 ./script.php 执行
- 设置输出编码:避免乱码,可加 ini_set('default_charset', 'UTF-8');
- 退出状态码:成功用 exit(0); 失败用 exit(1);,便于脚本调用判断结果
- 日志输出到 stderr:错误信息用 fwrite(STDERR, "错误提示\n");,不影响正常输出流
示例脚本结构:
#!/usr/bin/env phpif ($argc < 2) {
fwrite(STDERR, "用法: php script.php
exit(1);
}
echo "你好, " . $argv[1] . "\n";
exit(0);
基本上就这些。PHP CLI 模式简单直接,特别适合写运维脚本、队列处理、数据库迁移等任务。只要会写 PHP,再了解下命令行传参和输入输出,就能轻松上手。不复杂但容易忽略细节,比如参数解析和错误输出分流,写得规范些,后期维护更省心。
Windows 10 是一款微软推出的经典操作系统,拥有硬件兼容性与多任务处理能力。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。
极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。
















