PHP CLI脚本编写教程｜命令行工具开发入门

PHP CLI是命令行接口，用于在终端运行PHP脚本，适合处理定时任务和自动化操作。通过php -v检查环境，编写脚本时可使用$argc和$argv获取参数，添加Shebang行并赋予执行权限后可直接运行。注意开启错误报告、合理输出日志、返回状态码，提升脚本实用性。

编写PHP CLI脚本其实并不复杂，关键在于理解命令行环境和普通Web环境的区别。PHP不仅能用于网页开发，也能高效地运行在命令行中，适合做定时任务、数据处理、自动化脚本等。下面带你一步步入门PHP命令行工具开发。

什么是PHP CLI？

CLI 是 Command Line Interface 的缩写，指的是PHP的命令行接口。当你在终端运行 php script.php 时，就是使用CLI模式执行PHP代码。与Web环境下通过Apache或Nginx调用PHP不同，CLI没有HTTP请求头、会话、输出缓冲等限制，更适合长时间运行的任务。

可以通过以下命令检查是否安装了PHP CLI：

如果显示PHP版本信息，说明环境已准备就绪。

编写第一个CLI脚本

创建一个名为 hello.php 的文件：

在终端执行：

你会看到输出：Hello from CLI!

\n 表示换行，在CLI中比
更合适。避免使用HTML标签，命令行不解析它们。

接收命令行参数

CLI脚本常需要接收外部输入。PHP提供了两个全局变量：

• $argc：参数总数（包含脚本名）
• $argv：参数数组

例如，修改脚本为 greet.php：

执行：php greet.php Alice，输出：Hello, Alice!

如果没传参数，提示用法并退出，这是良好CLI实践。

让脚本可直接运行

可以省略 php 命令前缀，让脚本像普通命令一样运行。方法是添加Shebang行：

保存为 mytool，并添加执行权限：

然后直接运行：

系统会自动调用PHP解释器执行脚本。

实用技巧与注意事项

开发CLI脚本时，注意以下几点能提升体验：

• 使用 error_reporting(E_ALL) 和 ini_set('display_errors', 1) 确保错误可见
• 用 file_get_contents('php://stdin') 读取管道输入
• 返回状态码：成功用 exit(0)，失败用非零值
• 长脚本中可用 sleep() 或 pcntl 扩展做进程控制
• 日志输出建议写入文件或标准错误（stderr）

基本上就这些。掌握基础后，你可以开发更复杂的工具，比如数据库迁移脚本、日志分析器、API批量调用工具等。PHP CLI简单直接，特别适合已有PHP技能的开发者扩展使用场景。