Symfony 6使用Process执行Composer卸载Bundle时触发Twig目录不存在错误

通过Symfony Process组件执行composer remove时触发目录不存在错误，根源在于：
当执行卸载命令时，Composer会自动触发Symfony的缓存清理/容器编译脚本。此时PaypalBundle已被从vendor目录移除，但之前由该bundle的prependExtension方法添加的Twig模板路径配置，仍会在容器编译阶段被验证——由于模板目录已随bundle卸载被删除，因此抛出路径不存在的异常。

手动执行composer remove时无此问题，是因为手动执行环境与运行中的Symfony应用完全隔离，缓存清理流程不会受到当前应用状态的干扰。

1. 让Bundle的路径配置兼容目录不存在的场景 #

修改PaypalBundle的prependExtension方法，仅当模板目录实际存在时才添加Twig路径配置：

class PaypalBundle extends AbstractBundle
{
    public function prependExtension(ContainerConfigurator $container, ContainerBuilder $builder): void
    {
        $templateDir = $builder->getParameter('kernel.project_dir') . '/vendor/xxx/paypal-bundle/templates';
        
        // 仅当目录存在时才配置Twig路径
        if (is_dir($templateDir)) {
            $container->extension('twig', [
                'paths' => [
                    $templateDir => 'PaypalBundle',
                ],
            ]);
        }
        
        // 其他原有逻辑
        ...
    }
}

这种方式从根源避免了无效路径被添加到配置中，容器编译时不会再触发路径验证错误。

2. 跳过Composer自动脚本，手动清理缓存 #

在执行composer remove时添加--no-scripts参数，阻止Composer自动执行缓存清理脚本，之后再手动调用缓存清理命令：

$commands = [];
if ('1' == $installed) {
   // 跳过自动脚本，避免卸载过程中触发容器编译
   $commands[] = ['php', '/usr/local/bin/composer', 'remove', $extensionName, '--no-scripts'];
   // 手动清理缓存，此时Bundle已被卸载，不会加载无效配置
   $commands[] = ['php', $kernel->getProjectDir() . '/bin/console', 'cache:clear'];
}

if ('0' == $installed) {
   $commands[] = ['php', '/usr/local/bin/composer', 'require', $extensionName];
}

foreach ($commands as $command) {
   $process = new Process($command);
   $process->setWorkingDirectory($kernel->getProjectDir());
   // 移除或修正COMPOSER_HOME配置，使用默认环境
   // $process->setEnv([
   //     'COMPOSER_HOME' => $kernel->getProjectDir(),
   // ]);
   $process->run();

   if (!$process->isSuccessful()) {
       throw new \RuntimeException($process->getErrorOutput());
   }
}

3. 修正COMPOSER_HOME环境变量配置 #

代码中设置COMPOSER_HOME为项目目录，这会改变Composer的默认行为（比如使用项目目录下的缓存和配置）。移除该配置，让Process使用系统默认的Composer环境：

// 移除以下配置块
// $process->setEnv([
//     'COMPOSER_HOME' => $kernel->getProjectDir(),
// ]);

或者设置为正确的用户级Composer目录：

$process->setEnv([
    'COMPOSER_HOME' => $_SERVER['HOME'] . '/.composer',
]);

内容的提问来源于stack exchange，提问作者Talha Amir