在现代PHP开发中，Composer不仅是依赖管理的基石，更逐渐演变为项目自动化流程的重要工具。许多开发者习惯通过composer.json中的scripts字段来执行诸如代码格式化、测试运行、数据库迁移等任务。然而，随着项目复杂度上升，简单的脚本调用已无法满足需求——我们常常需要根据环境、参数或系统状态做出不同的行为决策。这时，如何在Composer脚本中实现条件逻辑就成了关键。

虽然Composer本身并不原生支持脚本内的“if-else”语法，但通过巧妙的设计与外部工具的结合，完全可以实现灵活的条件判断机制。本文将带你一步步掌握在Composer脚本中嵌入条件逻辑的实用技巧。

首先，我们需要明确一点：Composer的scripts配置本质上是命令的映射，它调用的是可执行的PHP函数、闭包或外部命令（如shell脚本）。因此，真正的“条件判断”必须发生在这些被调用的处理程序中，而不是直接写在composer.json里。

一个常见的场景是：在本地开发环境中运行测试时，希望跳过某些耗时较长的集成测试；而在CI/CD环境中，则需要完整执行所有测试套件。此时，可以通过检测环境变量来决定执行路径。

例如，在composer.json中定义如下脚本：

json { "scripts": { "test": "@php test/run.php" } }

然后创建test/run.php文件，内容如下：

php

!/usr/bin/env php

<?php

// 检查是否处于CI环境
$isCi = getenv('CI') === 'true';

echo "开始运行测试...\n";

if ($isCi) {
echo "【CI模式】执行全部测试\n";
exec('./vendor/bin/phpunit', $output, $status);
} else {
echo "【本地模式】跳过集成测试\n";
exec('./vendor/bin/phpunit --exclude-group integration', $output, $status);
}

// 输出结果并传递退出码
foreach ($output as $line) {
echo "$line\n";
}

exit($status);

这个例子展示了如何通过PHP脚本读取环境变量，并据此选择不同的命令执行路径。注意，脚本开头的#!/usr/bin/env php称为Shebang，确保该文件可在类Unix系统中直接执行。

另一种常见做法是使用闭包形式在composer.json中注册事件监听器。例如，在scripts中定义：

json { "scripts": { "post-install-cmd": [ "App\\ComposerScripts::postInstall" ] } }

然后在对应的类中编写条件逻辑：

php
namespace App;

use Composer\Script\Event;

class ComposerScripts
{
public static function postInstall(Event $event)
{
$io = $event->getIO();
$isProduction = getenv('APP_ENV') === 'production';

    if ($isProduction) {
        $io->write('<info>生产环境，正在优化自动加载...</info>');
        shell_exec('composer dump-autoload --optimize');
    } else {
        $io->write('<comment>开发环境，跳过优化</comment>');
    }

    // 可选：根据操作系统执行不同命令
    if (PHP_OS_FAMILY === 'Windows') {
        $io->write('当前为Windows系统，执行特殊处理...');
        // 执行Windows兼容命令
    }
}

}

这种方式的优势在于可以直接访问Composer提供的IO对象，输出带颜色的日志信息，提升可读性。

此外，还可以借助外部Shell脚本实现更复杂的判断。比如创建一个scripts/deploy.sh：

bash

!/bin/bash

echo "检查数据库配置..."
if [ -f ".env" ]; then
echo "环境文件存在，开始迁移"
php artisan migrate --force
else
echo "警告：未找到 .env 文件，跳过迁移"
fi

并在composer.json中调用：

json { "scripts": { "deploy": "sh scripts/deploy.sh" } }

掌握这一技巧后，你的Composer脚本将不再只是简单的命令串联，而成为一个可根据上下文动态响应的智能助手，极大提升开发效率与部署可靠性。