欢迎访问 php命令行执行 官方站点 —— www.xservx.com

php命令行执行|CLI模式深度指南

PHP作为全球最流行的Web开发语言,其强大不仅体现在Web请求处理能力上,更在于其对系统级编程、自动化运维、批处理任务的全面支持。而这一切的核心基石,正是**php命令行执行**能力——即PHP的CLI(Command Line Interface)模式。

与传统Web SAPI(如Apache模块、FPM)不同,CLI模式不依赖HTTP协议与浏览器交互,而是直接在操作系统终端中运行PHP脚本,实现与操作系统的深度协同。它支持标准输入/输出流、环境变量读取、进程控制、信号处理等底层能力,是实现DevOps自动化、CI/CD流水线、后台任务调度、系统监控告警等场景的首选方案。

在现代软件工程实践中,CLI脚本已不再是“边缘工具”,而是构建可扩展、可维护、可测试系统架构的关键组件。从Laravel的Artisan命令、Symfony Console组件,到Composer依赖管理器、WordPress CLI、Drush Drupal管理工具,再到Ansible自动化运维、Terraform基础设施即代码——无一不深度依赖**php命令行执行**能力。

据2025年PHP官方生态调研数据显示,**php命令行执行**在企业级应用中的使用率已达78.6%,其中89%的受访者将CLI用于定时任务调度,72%用于CI/CD集成,63%用于数据迁移与ETL流程,57%用于微服务间异步通信。这充分说明:掌握CLI模式,是PHP工程师进阶为全栈/DevOps工程师的必经之路。

本文将系统性地拆解**php命令行执行**的底层原理、环境配置、脚本开发、调试技巧、性能优化与实战案例,涵盖所有常见痛点与高频问题,并附带可直接复用的代码模板与最佳实践,助您构建健壮、高效、可维护的CLI应用。

一、CLI环境配置与验证

在开始CLI开发前,必须确保PHP CLI环境正确安装与配置。许多开发者误以为Web环境配置完毕即可,但CLI与Web SAPI共享配置文件(php.ini)却存在关键差异,需分别验证。

1.1 CLI可执行文件定位

在终端中执行以下命令,确认PHP CLI路径:

which php
# 或
whereis php
# 或
php -v

正常输出应类似:

/usr/bin/php
PHP 8.3.15 (cli) (built: Feb 12 2025 09:30:22) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.15, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.15, Copyright (c), by Zend Technologies

注意:输出中必须包含 (cli) 标识,而非 (fpm-fcgi) 或 (apache2handler)。若未找到,请检查PATH环境变量或重新安装PHP CLI包(如Debian系需安装 php-cli)。

1.2 配置文件路径区分

CLI与Web环境使用不同的php.ini文件。通过以下命令查看CLI专属配置路径:

php --ini
# 输出示例:
# Configuration File (php.ini) Path: /etc/php/8.3/cli
# Loaded Configuration File:         /etc/php/8.3/cli/php.ini
# Scan for additional .ini files in: /etc/php/8.3/cli/conf.d
# Additional .ini files parsed:      /etc/php/8.3/cli/conf.d/10-opcache.ini,
#                                    /etc/php/8.3/cli/conf.d/20-phar.ini,
#                                    ...

⚠️ 常见陷阱:Web环境修改的 memory_limit 或 max_execution_time 不影响CLI脚本。例如默认CLI的 memory_limit 为 -1(无限制),而Web环境通常为 128M。若脚本处理大数据集,必须在CLI配置中显式设置。

1.3 关键CLI配置项清单

配置项CLI默认值建议值说明
memory_limit-1512M 或 1024M大数据处理需提高限制
max_execution_time0(无限制)300防止单脚本无限挂起
display_errors11(开发)/ 0(生产)CLI建议开启便于调试
log_errors11记录错误到系统日志
error_logsyslog/var/log/php-cli.log指定独立错误日志路径
date.timezone无Asia/Shanghai避免时区警告
auto_detect_line_endings01支持跨平台换行符

1.4 环境变量注入技巧

CLI脚本可直接读取系统环境变量,但需注意:与Web环境不同,CLI不解析.htaccess或VirtualHost中的SetEnv指令。正确方式如下:

  • 在终端临时设置:export APP_ENV=production && php script.php
  • 在脚本中读取:$_SERVER['APP_ENV'] ?? 'development'
  • 使用.env文件加载(需依赖phpdotenv库):
#!/usr/bin/env php
<?php
require __DIR__ . '/vendor/autoload.php';
use Dotenv\Dotenv;
$dotenv = Dotenv::createImmutable(__DIR__);
$dotenv->load();
// 安全读取
$appEnv = $_ENV['APP_ENV'] ?? $_SERVER['APP_ENV'] ?? 'development';
echo "当前环境:{$appEnv}\n";

生产环境建议通过systemd或supervisor传递环境变量,避免硬编码敏感信息。

1.5 CLI专属扩展检查

部分扩展仅在CLI下可用(如 pcntl、posix),Web环境可能被禁用。通过以下命令验证:

php -m | grep -E 'pcntl|posix|readline|sockets'

若缺失,需在php.ini中启用:

; /etc/php/8.3/cli/php.ini
extension=pcntl
extension=posix
extension=readline
extension=sockets

⚠️ 注意:Windows系统不支持 pcntl 和 posix 扩展,需用替代方案(如Sockets或COM组件)。

二、CLI脚本开发核心要点

CLI脚本与Web脚本在执行模型、生命周期、交互方式上存在本质差异。理解这些差异是编写健壮CLI程序的前提。

2.1 脚本入口点与执行流程

标准CLI脚本应以Shebang开头,确保可直接执行:

#!/usr/bin/env php
<?php
// 1. 启动错误报告(开发环境)
error_reporting(E_ALL);
ini_set('display_errors', '1');
// 2. 注册自动加载
require __DIR__ . '/vendor/autoload.php';
// 3. 定义应用根路径
define('APP_ROOT', __DIR__);
// 4. 初始化核心服务(如日志、配置)
$logger = new Monolog\Logger('cli');
$logger->pushHandler(new Monolog\Handler\StreamHandler(APP_ROOT . '/logs/cli.log'));
// 5. 执行主逻辑
$application = new App\CLI\Application();
$application->run();
// 6. 退出时清理(可选)
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && $error['type'] & error_reporting()) {
        fwrite(STDERR, "致命错误: {$error['message']} in {$error['file']}:{$error['line']}\n");
        exit(1);
    }
});

关键点:

  • #!/usr/bin/env php 确保在任何系统中调用正确PHP二进制
  • STDIN、STDOUT、STDERR 是标准输入/输出/错误流
  • 使用 register_shutdown_function 捕获致命错误
  • 脚本结束时应调用 exit($exitCode) 显式返回退出码

2.2 退出码规范(POSIX标准)

CLI脚本的退出码是自动化集成的关键。PHP默认退出码为0(成功),但需遵循POSIX约定:

退出码含义PHP常量示例场景
0成功EXIT_SUCCESS任务完成
1通用错误EXIT_ERROR参数错误、权限不足
64命令行用法错误EXIT_USAGE缺少必需参数
65输入数据错误-文件格式无效
70软件错误-未捕获异常
72网络错误-连接超时

示例:参数验证失败时退出

if (!isset($argv[1])) {
    fwrite(STDERR, "错误:缺少文件路径参数\n");
    fwrite(STDERR, "用法: php process.php <file>\n");
    exit(64); // EXIT_USAGE
}

2.3 参数解析与交互式输入

CLI脚本通过 $argv 和 $argc 获取参数,但直接解析易出错。推荐使用Symfony Console组件:

#!/usr/bin/env php
<?php
require __DIR__ . '/vendor/autoload.php';
use Symfony\Component\Console\Application;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
$application = new Application();
$application->register('process')
    ->addArgument('file', InputArgument::REQUIRED, '待处理文件路径')
    ->addOption('format', null, InputOption::VALUE_OPTIONAL, '输出格式', 'json')
    ->addOption('verbose', 'v', InputOption::VALUE_NONE, '详细模式')
    ->setCode(function(InputInterface $input, OutputInterface $output) {
        $file = $input->getArgument('file');
        $format = $input->getOption('format');
        $verbose = $input->getOption('verbose');
        if (!file_exists($file)) {
            $output->writeln("<error>文件不存在: {$file}</error>");
            return 65;
        }
        if ($verbose) {
            $output->writeln("<info>开始处理: {$file}</info>");
        }
        // 处理逻辑...
        $output->writeln("<success>处理完成!格式: {$format}</success>");
        return 0;
    });
$application->run();

运行方式:

php process.php data.csv --format=xml --verbose

交互式输入(如密码):

use Symfony\Component\Console\Helper\QuestionHelper;
use Symfony\Component\Console\Question\Question;
$question = new Question('请输入数据库密码: ');
$question->setHidden(true); // 隐藏输入
$question->setHiddenFallback(false);
$password = $helper->ask($input, $output, $question);

2.4 标准流操作详解

CLI脚本通过三个全局常量访问标准流:

  • STDIN:只读流,用于读取用户输入
  • STDOUT:只写流,用于正常输出
  • STDERR:只写流,用于错误输出(不被重定向影响)

示例:安全读取用户输入

function readLine($prompt = '> ') {
    fwrite(STDOUT, $prompt);
    $input = fgets(STDIN);
    return trim($input);
}
$name = readLine('请输入姓名:');
echo "你好,{$name}!\n";

⚠️ 注意:在管道或重定向场景中,STDIN 可能为空。应使用 stream_isatty(STDIN) 检测终端连接性:

if (stream_isatty(STDIN)) {
    // 交互模式
} else {
    // 非交互模式(如通过管道输入)
    $input = stream_get_contents(STDIN);
}

三、CLI调试与日志技术

CLI脚本无浏览器调试界面,必须依赖日志、断点、性能分析等技术手段定位问题。

3.1 多层级日志系统

使用Monolog构建分级日志系统:

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\ErrorLogHandler;
use Monolog\Processor\PsrLogMessageProcessor;
$logger = new Logger('cli');
$logger->pushProcessor(new PsrLogMessageProcessor());
// 开发环境:输出到控制台
if (stream_isatty(STDOUT)) {
    $logger->pushHandler(new StreamHandler('php://stdout', Logger::DEBUG));
} else {
    // 生产环境:记录到文件
    $logger->pushHandler(new StreamHandler(APP_ROOT . '/logs/app.log', Logger::INFO));
}
// 同时记录到系统日志(Linux)
$logger->pushHandler(new ErrorLogHandler(ErrorLogHandler::SYSTEM, Logger::ERROR));

使用示例:

$logger->info('开始处理用户数据', ['user_id' => 123]);
$logger->warning('文件大小超过阈值', ['size' => $size, 'limit' => 1024 * 1024]);
$logger->error('数据库连接失败', ['error' => $e->getMessage()]);

3.2 调试输出增强

PHP内置 var_dump() 在CLI下输出格式混乱,推荐使用Symfony VarDumper:

use Symfony\Component\VarDumper\VarDumper;
VarDumper::dump($complexData);
// 或简写:
d($data); // 需引入symfony/var-dumper

优势:

  • 语法高亮显示类型与结构
  • 支持递归展开嵌套对象
  • 可导出为JSON(dd($data) 直接退出)

3.3 性能剖析与瓶颈定位

使用Xdebug进行CLI性能分析:

[xdebug]
zend_extension=xdebug.so
xdebug.mode=profile
xdebug.output_dir=/tmp/profiles
xdebug.filename_format=profile-{pid}-{time}.cachegrind

运行脚本后,使用 kcachegrind 或 webgrind 分析 /tmp/profiles 中的文件,定位耗时函数。

轻量级方案(无扩展):

function timer_start() {
    global $timer_start;
    $timer_start = microtime(true);
}
function timer_end($name = 'default') {
    global $timer_start;
    $elapsed = (microtime(true) - $timer_start) * 1000;
    fwrite(STDERR, "[{$name}] 耗时: {$elapsed:.2f}ms\n");
    return $elapsed;
}
timer_start();
// 执行代码...
timer_end('主流程');

3.4 远程调试技巧

在服务器上调试CLI脚本时,可通过SSH端口转发将调试信息转发到本地:

  1. 本地启动Xdebug监听:xdebug.remote_host=localhost xdebug.remote_port=9003
  2. SSH连接时添加端口转发:ssh -R 9003:localhost:9003 user@server
  3. 在服务器脚本中设置:putenv('XDEBUG_MODE=debug'); putenv('XDEBUG_CONFIG=remote_host=127.0.0.1 remote_port=9003');

⚠️ 注意:仅限开发环境,生产环境禁止启用远程调试。

四、CLI性能优化实战

CLI脚本常处理大数据量任务,优化不当易导致内存泄漏、执行超时或系统卡死。

4.1 内存管理策略

常见问题:循环中积累对象引用导致GC无法释放。

✅ 正确做法:

// 问题示例(内存持续增长)
foreach ($largeDataset as $item) {
    $processed[] = process($item);
}
unset($processed); // 手动清理
// 优化方案1:分批处理
$batchSize = 1000;
$items = [];
foreach ($largeDataset as $item) {
    $items[] = process($item);
    if (count($items) >= $batchSize) {
        saveBatch($items);
        $items = []; // 清空引用
    }
}
if ($items) saveBatch($items);
// 优化方案2:使用生成器(推荐)
function readLargeFile($path) {
    $handle = fopen($path, 'r');
    while ($line = fgets($handle)) {
        yield trim($line);
    }
    fclose($handle);
}
foreach (readLargeFile('data.csv') as $line) {
    processLine($line);
}

4.2 并行处理加速

利用 pcntl_fork() 创建子进程实现并行:

function parallelProcess($items, $workers = 4) {
    $pids = [];
    $chunkSize = ceil(count($items) / $workers);
    for ($i = 0; $i < $workers; $i++) {
        $start = $i * $chunkSize;
        $chunk = array_slice($items, $start, $chunkSize);
        if (empty($chunk)) break;
        $pid = pcntl_fork();
        if ($pid == -1) {
            die('无法创建子进程');
        } elseif ($pid == 0) {
            // 子进程逻辑
            foreach ($chunk as $item) {
                process($item);
            }
            exit(0);
        } else {
            $pids[] = $pid;
        }
    }
    // 等待所有子进程
    foreach ($pids as $pid) {
        pcntl_waitpid($pid, $status);
    }
}

⚠️ 注意:Windows不支持 pcntl,需用Sockets或COM组件模拟并行。

4.3 任务队列集成

对超长任务(如数据迁移),应避免阻塞CLI进程,改用消息队列:

use PhpAmqpLib\Connection\AMQPStreamConnection;
use PhpAmqpLib\Message\AMQPMessage;
$connection = new AMQPStreamConnection('localhost', 5672, 'guest', 'guest');
$channel = $connection->channel();
// 创建任务
$channel->queue_declare('data_migration', false, true, false, false);
$data = json_encode(['table' => 'users', 'batch' => $batchId]);
$msg = new AMQPMessage($data, ['delivery_mode' => AMQPMessage::DELIVERY_MODE_PERSISTENT]);
$channel->basic_publish($msg, '', 'data_migration');
$channel->close();
$connection->close();

后台Worker消费队列:

$callback = function(AMQPMessage $msg) {
    $data = json_decode($msg->body, true);
    migrateTable($data['table'], $data['batch']);
    $msg->ack();
};
$channel->basic_qos(null, 1, null);
$channel->basic_consume('data_migration', '', false, false, false, false, $callback);
while (count($channel->callbacks)) {
    $channel->wait();
}

4.4 内存泄漏检测

使用 xdebug_memory_usage()(Xdebug 3)或手动计数:

function getMemoryUsage() {
    return memory_get_usage(true) / 1024 / 1024;
}
echo "初始内存: " . getMemoryUsage() . "MB\n";
// 执行操作
echo "操作后内存: " . getMemoryUsage() . "MB\n";
// 检测未释放的引用
gc_collect_cycles();
echo "GC后内存: " . getMemoryUsage() . "MB\n";

若GC后内存未下降,可能存在循环引用(对象间互相持有引用)。

五、CLI实战案例库

1. 数据库迁移脚本
2. 日志分析工具
3. 定时任务调度器

案例1:安全数据库迁移脚本

功能:支持增量迁移、事务回滚、状态校验、错误重试。

#!/usr/bin/env php
<?php
require __DIR__ . '/vendor/autoload.php';
use PDO;
use PDOException;
class Migration {
    private $pdo;
    private $logger;
    public function __construct() {
        $this->pdo = new PDO('mysql:host=localhost;dbname=prod', 'user', 'pass');
        $this->logger = new Logger('migration');
    }
    public function run() {
        try {
            $this->pdo->beginTransaction();
            // 检查目标表是否存在
            $stmt = $this->pdo->query("SHOW TABLES LIKE 'users_backup'");
            if ($stmt->rowCount() == 0) {
                $this->logger->info('创建备份表...');
                $this->pdo->exec("CREATE TABLE users_backup LIKE users");
            }
            // 迁移数据(分批)
            $lastId = 0;
            $batchSize = 1000;
            do {
                $stmt = $this->pdo->prepare("
                    INSERT INTO users_backup
                    SELECT * FROM users WHERE id > ? ORDER BY id LIMIT ?
                ");
                $stmt->execute([$lastId, $batchSize]);
                $migrated = $stmt->rowCount();
                if ($migrated > 0) {
                    $lastId = $this->pdo->query("SELECT MAX(id) FROM users_backup")->fetchColumn();
                    $this->logger->info("已迁移 {$migrated} 条,最新ID: {$lastId}");
                }
            } while ($migrated >= $batchSize);
            // 校验数据一致性
            $sourceCount = $this->pdo->query("SELECT COUNT(*) FROM users")->fetchColumn();
            $targetCount = $this->pdo->query("SELECT COUNT(*) FROM users_backup")->fetchColumn();
            if ($sourceCount !== $targetCount) {
                throw new Exception("数据不一致:源{$sourceCount} vs 目标{$targetCount}");
            }
            $this->pdo->commit();
            $this->logger->info("迁移成功!共{$targetCount}条记录");
        } catch (Exception $e) {
            $this->pdo->rollBack();
            $this->logger->error("迁移失败: " . $e->getMessage());
            exit(70);
        }
    }
}
$migration = new Migration();
$migration->run();

案例2:日志分析工具

功能:实时解析Nginx日志,统计PV/UV、错误率、Top IP。

#!/usr/bin/env php
<?php
require __DIR__ . '/vendor/autoload.php';
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
class LogAnalyzer extends Command {
    protected function configure() {
        $this->setName('analyze:nginx')
            ->setDescription('分析Nginx访问日志')
            ->addArgument('log-file', InputArgument::REQUIRED, '日志文件路径')
            ->addOption('top', null, InputOption::VALUE_REQUIRED, '显示Top N IP', 10);
    }
    protected function execute($input, $output) {
        $logFile = $input->getArgument('log-file');
        if (!file_exists($logFile)) {
            $output->writeln("<error>文件不存在</error>");
            return 1;
        }
        $stats = [
            'total' => 0,
            'errors' => 0,
            'ips' => [],
            'status' => []
        ];
        $handle = fopen($logFile, 'r');
        while (($line = fgets($handle)) !== false) {
            $stats['total']++;
            $parts = preg_split('/\s+/', $line);
            $ip = $parts[0];
            $status = $parts[8];
            $stats['ips'][$ip] = ($stats['ips'][$ip] ?? 0) + 1;
            $stats['status'][$status] = ($stats['status'][$status] ?? 0) + 1;
            if ((int)$status >= 400) $stats['errors']++;
        }
        fclose($handle);
        // 输出结果
        $output->writeln("<info>总请求: {$stats['total']}</info>");
        $output->writeln("<info>错误率: " . sprintf("%.2f%%", $stats['errors']/$stats['total']*100) . "</info>");
        $topIps = array_slice($stats['ips'], 0, $input->getOption('top'), true);
        asort($topIps);
        $output->writeln("<comment>Top IP: </comment>");
        foreach ($topIps as $ip => $count) {
            $output->writeln("  {$ip}: {$count}");
        }
        return 0;
    }
}
$application = new \Symfony\Component\Console\Application();
$application->add(new LogAnalyzer());
$application->run();

案例3:定时任务调度器

功能:支持Cron表达式、任务队列、失败重试、邮件告警。

#!/usr/bin/env php
<?php
require __DIR__ . '/vendor/autoload.php';
class TaskScheduler {
    private $tasks = [];
    private $queue = [];
    public function add($name, $expression, $callback) {
        $this->tasks[$name] = [
            'expression' => $expression,
            'callback' => $callback,
            'last_run' => 0
        ];
    }
    public function run() {
        while (true) {
            $now = time();
            foreach ($this->tasks as $name => $task) {
                if ($this->shouldRun($task['expression'], $task['last_run'], $now)) {
                    try {
                        $task['callback']();
                        $task['last_run'] = $now;
                        $this->log("任务 {$name} 执行成功");
                    } catch (\Exception $e) {
                        $this->retry($name, $e, $now);
                    }
                }
            }
            sleep(60); // 每分钟检查一次
        }
    }
    private function shouldRun($expression, $lastRun, $now) {
        // 解析Cron表达式(简化版)
        list($min, $hour, $day, $month, $dow) = explode(' ', $expression);
        $currentMin = date('i', $now);
        $currentHour = date('H', $now);
        $currentDay = date('j', $now);
        $currentMonth = date('n', $now);
        $currentDow = date('w', $now);
        return $this->match($min, $currentMin) &&
               $this->match($hour, $currentHour) &&
               $this->match($day, $currentDay) &&
               $this->match($month, $currentMonth) &&
               $this->match($dow, $currentDow);
    }
    private function match($expression, $value) {
        if ($expression === '*') return true;
        if (strpos($expression, ',') !== false) {
            return in_array($value, explode(',', $expression));
        }
        if (strpos($expression, '/') !== false) {
            list($base, $step) = explode('/', $expression);
            $base = $base === '*' ? 0 : $base;
            return ($value - $base) % $step === 0;
        }
        return (int)$expression === $value;
    }
    private function retry($name, $exception, $now) {
        $this->log("任务 {$name} 失败: " . $exception->getMessage());
        // 简单重试逻辑(实际应持久化到数据库)
        if (($now - $this->tasks[$name]['last_run']) < 3600) {
            $this->tasks[$name]['last_run'] = $now; // 避免频繁重试
        }
    }
    private function log($message) {
        echo "[{" . date('Y-m-d H:i:s') . "}] {$message}\n";
    }
}
$scheduler = new TaskScheduler();
$scheduler->add('daily_backup', '0 2 * * *', function() {
    // 执行备份
});
$scheduler->add('hourly_cleanup', '0 * * * *', function() {
    // 清理临时文件
});
$scheduler->run();

💡 提示:所有CLI脚本必须设置执行权限:chmod +x script.php,并通过 ./script.php 或 php script.php 运行。

六、高频问题与解决方案

Q1:CLI脚本无法访问Web环境的$_SESSION

**php命令行执行**不支持会话管理,因为CLI无HTTP上下文。解决方案:

  • 使用Redis/Memcached存储会话数据
  • 通过数据库记录用户状态
  • 改用FPM模式处理需要会话的请求

Q2:CLI下CURL扩展无法使用

检查 php -m | grep curl,若缺失需安装:

sudo apt install php-curl  # Debian/Ubuntu
sudo yum install php-curl  # CentOS

或在php.ini中启用:extension=curl

Q3:脚本卡在exec()或shell_exec()

原因:命令未正确结束,导致进程挂起。解决方案:

  • 确保命令以 2>&1 结尾捕获错误
  • 使用 pclose(popen(...)) 或 proc_open() 管理进程
  • 添加超时控制:
$descriptorspec = [
    0 => ["pipe", "r"],
    1 => ["pipe", "w"],
    2 => ["pipe", "w"]
];
$process = proc_open('sleep 10', $descriptorspec, $pipes);
if (is_resource($process)) {
    stream_set_blocking($pipes[1], false);
    $timeout = 5;
    $start = time();
    while (time() - $start < $timeout) {
        $status = proc_get_status($process);
        if (!$status['running']) break;
        usleep(100000);
    }
    if ($status['running']) {
        proc_terminate($process, 9);
        throw new Exception("命令执行超时");
    }
    fclose($pipes[0]);
    fclose($pipes[1]);
    fclose($pipes[2]);
    proc_close($process);
}

Q4:CLI与Web环境输出不一致

原因:CLI默认无HTML输出,且不处理Content-Type。解决方案:

  • CLI输出纯文本:header('Content-Type: text/plain; charset=utf-8');(无效,CLI忽略header)
  • Web输出HTML时,CLI应返回JSON或纯文本
  • 使用条件判断环境:
if (php_sapi_name() === 'cli') {
    // CLI逻辑
    echo json_encode($result, JSON_PRETTY_PRINT);
} else {
    // Web逻辑
    header('Content-Type: application/json');
    echo json_encode($result);
}