PHP命令行使用教程：CLI脚本开发指南

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 模式，可以用：

这个判断常用于兼容 Web 和 CLI 双模式运行的脚本。

如何运行 PHP CLI 脚本

打开终端，进入脚本所在目录，使用 php 命令加上脚本文件名即可运行：

• php script.php —— 最基本的执行方式
• php -f script.php —— 显式指定文件（可选）
• php -r 'echo "Hello CLI";' —— 直接运行一行代码，不需文件

你还可以给脚本传参，就像其他命令一样：

这些参数会存入全局变量 $argv，其中 $argv[0] 是脚本名，$argv[1] 开始是传入的参数，总共个数为 $argc。

读取用户输入与交互

CLI 脚本可以和用户互动，比如提示输入账号密码或确认操作。常用方法是读取标准输入：

例如：

注意：使用 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");，不影响正常输出流

示例脚本结构：

基本上就这些。PHP CLI 模式简单直接，特别适合写运维脚本、队列处理、数据库迁移等任务。只要会写 PHP，再了解下命令行传参和输入输出，就能轻松上手。不复杂但容易忽略细节，比如参数解析和错误输出分流，写得规范些，后期维护更省心。