PHP的CLI模式即命令行接口,允许开发者脱离Web服务器环境直接运行PHP脚本,适合执行定时任务、批量数据处理、脚本调试等场景,是PHP开发中的常用功能。

确认PHP CLI环境是否可用
首先需要检查当前系统是否已经安装了支持CLI模式的PHP环境,不同操作系统的检查方式略有区别。
Windows系统检查
打开命令提示符(cmd)或者PowerShell,输入以下命令查看PHP版本信息:
php -v
如果输出类似PHP 8.2.0 (cli) (built: Dec 6 2022 17:00:00) (NTS Visual C++ 2019 x64)的内容,说明CLI环境已经正常安装,其中(cli)标识就代表当前是命令行模式。
如果提示php不是内部或外部命令,需要将PHP的安装目录添加到系统环境变量Path中,添加完成后重新打开命令行工具即可生效。
macOS和Linux系统检查
打开终端工具,输入同样的版本查看命令:
php -v
大部分Linux发行版和macOS系统默认已经安装了PHP CLI环境,若未安装,可以通过包管理器安装,比如Ubuntu系统可以执行sudo apt install php-cli命令安装。
编写可执行的PHP脚本
PHP CLI脚本的编写和普通的PHP Web脚本基本一致,只是不需要输出HTML内容,更适合纯逻辑处理。以下是一个简单的测试脚本示例:
<?php // 输出当前PHP运行模式 echo "当前PHP运行模式:" . php_sapi_name() . PHP_EOL; // 输出命令行传入的参数 echo "传入的参数列表:" . PHP_EOL; print_r($argv); ?>
将上述代码保存为test.php文件,注意文件编码建议使用UTF-8,避免出现中文乱码问题。
通过CLI模式执行PHP脚本
执行PHP CLI脚本的核心命令格式为php 脚本文件路径,根据脚本所在位置不同,执行方式也有区别。
执行当前目录下的脚本
如果脚本就在当前命令行的工作目录下,直接输入脚本文件名即可:
php test.php
执行后会输出PHP运行模式为cli,同时会打印出传入的参数列表,默认第一个参数是脚本本身的文件名。
执行其他目录下的脚本
如果脚本不在当前工作目录,需要填写完整的绝对路径或者相对路径:
# 绝对路径示例(Windows) php D:php_scriptstest.php # 相对路径示例(Linux/macOS) php ../scripts/test.php
给脚本传递参数
CLI模式下可以给脚本传递自定义参数,参数会保存在$argv数组中,$argc变量保存参数的总数量:
php test.php 参数1 参数2 参数3
此时$argc的值为4,$argv数组的内容为["test.php", "参数1", "参数2", "参数3"]。
常见的CLI模式使用技巧
- 使用
-r参数可以直接运行单行PHP代码,不需要编写脚本文件,比如php -r "echo 'hello world';" - 使用
-l参数可以检查PHP脚本的语法错误,比如php -l test.php,无错误会输出No syntax errors detected in test.php - 使用
--ini参数可以查看当前CLI模式加载的php.ini配置文件路径,方便调整运行配置 - 如果脚本需要长时间运行,可以搭配
nohup命令(Linux/macOS)让脚本在后台运行,避免终端关闭后脚本终止
注意事项
CLI模式和Web模式的PHP配置可能存在差异,部分在Web环境下生效的配置在CLI模式下不会生效,比如max_execution_time在CLI模式下默认是0,即没有执行时间限制。另外CLI模式下没有$_GET、$_POST等Web相关的超全局变量,不要尝试在CLI脚本中使用这些变量。