PHP的CLI（Command Line Interface）模式让开发者可以直接在终端执行脚本，常用于定时任务、数据处理和运维工具。与通过Web服务器访问PHP不同，CLI模式由操作系统shell直接拉起php进程，不依赖Apache或Nginx。要让CLI模式可运行，必须满足解释器存在、环境路径正确、脚本权限合规以及配置项支持这几个基础条件。
一、确认PHP CLI解释器已安装
大多数Linux发行版通过包管理器安装的php包已经包含CLI版本，但部分最小化镜像可能只装了FPM。可以通过终端执行版本查询命令来判断。
如果系统返回了类似PHP 8.2.10 (cli)的字样，说明CLI可用；若提示command not found，则需要安装对应包。在Ubuntu上通常是apt_install_php-cli，CentOS则是yum_install_php-cli。Windows用户应检查PHP解压目录中是否存在php.exe，该文件就是CLI模式的入口。
# 查看PHP CLI版本信息 php -v # 若未安装，Ubuntu执行 sudo apt update sudo apt install php-cli # Windows下进入PHP目录测试 cd C:php php.exe -v
二、将PHP加入系统PATH环境变量
即使php二进制存在，如果其所在目录不在PATH中，每次运行都要写全路径。将PHP目录加入PATH后，任意位置输入php即可调用，这是CLI可运行的关键条件之一。
Linux与macOS可修改用户级或系统级profile文件，追加export语句。Windows则在系统属性中的环境变量面板编辑Path，新增php.exe所在文件夹。配置完成后需重新打开终端使其生效。下面给出Linux的永久配置示例，注意路径需替换为实际安装位置。
# 假设PHP安装在 /usr/local/php/bin echo 'export PATH=/usr/local/php/bin:$PATH' >> ~/.bashrc source ~/.bashrc php -v
三、脚本文件权限与执行方式
在Linux环境中，PHP脚本自身不必具备可执行权限也能运行，因为是由php解释器读取文件。但若想像./script.php这样直接执行，则需要在文件首行添加shebang，并赋予执行权限。
shebang行写作#!/usr/bin/env php，系统会根据它找到php解释器。随后用chmod命令添加x权限。Windows下不支持shebang机制，只能通过php script.php调用，但可借助批处理文件封装。以下示例展示如何将一个普通脚本变为可直接执行的CLI程序。
<?php
// 文件名 hello.php
if (PHP_SAPI !== 'cli') {
exit("该脚本只能在CLI模式运行n");
}
echo "Hello CLIn";
# 添加shebang并赋予权限 echo '#!/usr/bin/env php' | cat - hello.php > temp && mv temp hello.php chmod +x hello.php ./hello.php
四、php.ini配置对CLI的影响
CLI模式往往使用独立的php.ini，常见路径为/etc/php/8.2/cli/php.ini。某些在Web端被禁用的函数如exec、shell_exec，在CLI运维脚本中可能需要开启。此外，memory_limit在CLI下可设得更高，避免大批量数据处理被中断。
可以通过php --ini查看当前CLI加载的配置文件位置。若发现脚本因函数被禁用而失败，应编辑对应ini取消disable_functions中的相关项。同时建议关闭html_errors，让终端输出纯净的文本错误信息，提升调试效率。
# 查看CLI使用的ini文件 php --ini # 临时用指定ini运行 php -c /path/to/custom.ini script.php
| 配置项 | CLI推荐值 | 说明 |
|---|---|---|
| memory_limit | 512M或-1 | 命令行任务常需更大内存 |
| disable_functions | 留空或仅限危险函数 | 避免exec等被误禁 |
| html_errors | Off | 终端显示纯文本错误 |
五、常见运行条件检查清单
当CLI脚本无法运行时，可按以下顺序排查：解释器是否存在、PATH是否包含php、脚本语法是否有错、php.ini是否限制了所需函数、以及当前是否确实处于CLI环境。PHP内置常量PHP_SAPI能准确返回运行接口类型。
另外，若脚本依赖扩展如pdo_mysql，需确认CLI版PHP也编译或安装了对应扩展，因为Web与CLI的扩展目录可能不同。使用php -m可列出CLI已加载模块。只有上述条件全部满足，PHP的CLI模式才能真正顺畅运行起来。
<?php
// 检查运行环境是否满足CLI条件
if (PHP_SAPI !== 'cli') {
die("错误：非CLI环境n");
}
$required = ['pdo_mysql', 'json'];
$loaded = get_loaded_extensions();
foreach ($required as $ext) {
if (!in_array($ext, $loaded)) {
echo "缺少扩展：$extn";
}
}
echo "CLI环境基础检查完成n";