PHP跨平台CLI应用开发实战教程-源码库

PHP跨平台CLI应用开发实战教程：从零构建你的第一个命令行工具

作为一名PHP开发者，我们通常将PHP与Web开发绑定在一起。但在实际项目中，我经常需要编写一些自动化脚本、数据处理工具或系统管理程序。今天就来分享如何用PHP开发跨平台CLI应用，让你体验到PHP在命令行环境下的强大能力。

环境准备与基础配置

首先确保你的PHP环境支持CLI模式。打开终端，输入以下命令检查：

php -v
php -m

在我的开发过程中，发现需要特别注意几个扩展：readline（用于交互式输入）、pcntl（进程控制）、posix（系统调用）。如果缺少这些扩展，在Linux/macOS下可以通过包管理器安装，Windows下则需要修改php.ini。

创建你的第一个CLI应用

让我们从一个简单的”Hello World”开始。创建hello.php文件：


给文件添加执行权限（Linux/macOS）：
chmod +x hello.php
./hello.php
处理命令行参数
在实际项目中，处理参数是必不可少的。PHP提供了$argv和$argc变量，但我更推荐使用getopt()函数：

实现交互式输入
在某些场景下，我们需要与用户交互。这是我常用的一个封装函数：
function ask(string $question, string $default = ''): string {
    echo $question;
    if (!empty($default)) {
        echo " [{$default}]";
    }
    echo ": ";
    
    $handle = fopen("php://stdin", "r");
    $answer = trim(fgets($handle));
    fclose($handle);
    
    return empty($answer) ? $default : $answer;
}

$name = ask("请输入你的名字", "匿名用户");
echo "你好, {$name}!n";
跨平台文件路径处理
这是我踩过的一个大坑！不同系统的路径分隔符不同：
// 错误的做法
$filePath = 'src/utils/logger.php';

// 正确的做法
$filePath = implode(DIRECTORY_SEPARATOR, ['src', 'utils', 'logger.php']);

// 或者使用更现代的方式
$filePath = join(DIRECTORY_SEPARATOR, func_get_args());
颜色输出与进度条
为了让CLI应用更友好，我通常会添加颜色输出：
class CLIFormatter {
    const COLOR_RED = "33[31m";
    const COLOR_GREEN = "33[32m";
    const COLOR_YELLOW = "33[33m";
    const COLOR_RESET = "33[0m";
    
    public static function success($text) {
        echo self::COLOR_GREEN . $text . self::COLOR_RESET . "n";
    }
    
    public static function error($text) {
        echo self::COLOR_RED . $text . self::COLOR_RESET . "n";
    }
}

CLIFormatter::success("操作成功完成！");
CLIFormatter::error("发生了一个错误");
实战案例：文件批量处理器
让我们把这些知识点组合起来，创建一个实用的文件批量处理器：
processFiles($directory, $outputDir);
        CLIFormatter::success("文件处理完成！");
    }
    
    private function processFiles($sourceDir, $outputDir) {
        $files = scandir($sourceDir);
        $count = 0;
        
        foreach ($files as $file) {
            if ($file === '.' || $file === '..') continue;
            
            $sourceFile = $sourceDir . DIRECTORY_SEPARATOR . $file;
            $outputFile = $outputDir . DIRECTORY_SEPARATOR . $file;
            
            if (is_file($sourceFile)) {
                $this->processSingleFile($sourceFile, $outputFile);
                $count++;
                echo "已处理: {$file}n";
            }
        }
        
        echo "总计处理文件数: {$count}n";
    }
    
    private function processSingleFile($source, $destination) {
        // 这里可以添加具体的文件处理逻辑
        copy($source, $destination);
    }
}

$processor = new FileBatchProcessor();
$processor->run();
部署与分发技巧
最后分享一些部署经验。对于简单的脚本，可以直接复制PHP文件。但对于复杂应用，我推荐使用：
# 使用Composer管理依赖
composer init
composer require monolog/monolog

# 使用Phar打包（创建build.php）
php build.php
Phar打包示例：
buildFromDirectory(__DIR__ . '/src');
$phar->setStub($phar->createDefaultStub('cli.php'));
通过这篇教程，相信你已经掌握了PHP CLI应用开发的核心技能。在实际项目中，记得多考虑异常处理、日志记录和性能优化。Happy coding！