PHP CLI 模式入门：原理、操作与核心代码示例

结果或目标

通过阅读本文，你将了解如何脱离 Web 服务器直接使用 PHP 进行开发，解决需要长驻内存、高并发异步处理（如模拟多线程采集）以及周期性数据备份等实际需求。

准备条件

系统环境：支持 CLI 模式的 PHP 版本（Windows 或 Linux）。

工具准备：

1. Linux：已安装 PHP，知晓可执行文件路径（通常通过 which php 查询）。
2. Windows：推荐 XAMPP 或 WAMP 集成环境，以便直接进入 DOS/命令行模式。
3. 编辑器：用于编写 .php 脚本文件。

真实操作顺序

第1步：验证并启动 PHP CLI 环境

目的：确认当前系统已正确安装 PHP 且处于命令行可执行状态。

动作：

• Windows：在 CMD 中确保 PHP 环境变量已配置，或直接进入集成环境的 bin 目录。
• Linux：在终端输入 php -v 检查版本信息。

完成状态：终端返回 PHP 版本号，无报错信息。

第2步：执行 PHP 脚本文件

目的：在命令行中运行指定的 PHP 逻辑文件。

入口：系统命令行终端。

动作：使用 php 命令后跟脚本绝对路径。

• Windows 示例：
  假设 php.exe 位于 D:\xampp\php\

D:\xampp\php\php.exe D:\xampp\htdocs\test.php

• Linux 示例：
  假设 php 安装在 /usr/local/php/bin/，脚本位于 /usr/local/apache/htdocs/

/usr/local/php/bin/php /usr/local/apache/htdocs/test.php

重要参数：若需开启调试模式，可添加 -d display_errors=On。

可观察的完成状态：终端打印出 echo 输出内容或脚本执行完毕后的反馈，进程结束退出。

第3步：检测当前是否为 CLI 模式

目的：确保代码仅在命令行环境下执行，防止被 Web 请求非法调用。

动作：在脚本中使用以下任一方法判断。

<?php
// 方法1：常量比较
if (PHP_SAPI === 'cli') {
    // ... 执行CLI逻辑
}

// 方法2：函数获取
if (php_sapi_name() === 'cli') {
    // ... 执行CLI逻辑
}

完成状态：非 CLI 环境下（如浏览器访问），条件判断为 false，不执行敏感或后台逻辑。

第4步：接收并解析命令行参数

目的：向脚本传递配置项或业务数据，替代交互式输入。

入口：执行命令时追加参数，如：php test.php --config=dev

动作：PHP 默认将参数封装在 $argv 数组中。第一个元素 $argv[0] 为文件名，后续为传入参数。

为了更直观地处理参数（如识别 --key=value 或 -k v 格式），可参考以下解析逻辑：

<?php 
function parseArgs($argv){ 
    array_shift($argv); // 移除文件名
    $out = array(); 
    foreach ($argv as $arg){ 
        if (substr($arg,0,2) == '--'){ // 长选项 --key=val
            $eqPos = strpos($arg,'='); 
            if ($eqPos === false){ 
                $key = substr($arg,2); 
                $out[$key] = isset($out[$key]) ? $out[$key] : true; 
            } else { 
                $key = substr($arg,2,$eqPos-2); 
                $out[$key] = substr($arg,$eqPos+1); 
            } 
        } else if (substr($arg,0,1) == '-'){ // 短选项 -k=v 或 -abc
            if (substr($arg,2,1) == '='){ 
                $key = substr($arg,1,1); 
                $out[$key] = substr($arg,3); 
            } else { 
                $chars = str_split(substr($arg,1)); 
                foreach ($chars as $char){ 
                    $key = $char; 
                    $out[$key] = isset($out[$key]) ? $out[$key] : true; 
                } 
            } 
        } else { 
            $out[] = $arg; // 位置参数
        } 
    } 
    return $out; 
} 
// var_dump(parseArgs($argv)); exit;

经过上述解析，可将原始的 $argv 转换为易于处理的关联数组 $out。

常见应用场景

1. 类多线程与长驻进程

虽然 PHP 原生不支持标准的多线程（如 Java Thread），但在 CLI 模式下，可以通过多进程模拟实现类似效果。相比 Web 模式（CGI/FPM），CLI 模式下的脚本作为独立进程运行：

• 资源回收由操作系统内核负责，子进程结束后自动释放。
• 父进程可控，子进程异常不会直接导致整个服务崩溃。
• 适合批量数据处理、爬虫采集等高耗时任务，能有效避免 Web 服务器的超时限制。

2. 定时任务（CronJob）

利用 Linux 的 Cron 服务，可以定期执行 PHP 脚本，适用于数据备份、日志清理、报表生成等。

操作方法：编辑 crontab (crontab -e)，添加如下规则：

# 每天凌晨 2 点执行一次
0 2 * * * /usr/bin/php -f /data/htdocs/test.php

完成判断：Cron 日志（通常位于 /var/log/cron 或 /var/spool/mail/root）中出现执行记录，且脚本正常运行无误。

简要总结

PHP CLI 极大地拓展了 PHP 的使用边界，使其不仅能服务于前端页面，还能胜任后端守护进程、批量处理及自动化运维工具的开发。掌握命令行执行方式、参数解析机制以及定时任务的配合，是使用 PHP 构建全栈系统的重要技能。