deployer 7 的 `deployer/dist` 发行版为独立 phar 包，不包含 symfony dotenv 组件，因此无法直接使用 `dotenv::loadenv()`；本文提供兼容 symfony 6 项目的轻量级替代方案，无需 fork 或构建自定义 phar。
在迁移到 Deployer 7（特别是 deployer/dist 官方发行版）后，你遇到的 Class "Symfony\Component\Dotenv\Dotenv" not found 错误，根本原因在于：deployer/dist 是一个自包含的 PHAR 包，其依赖已固化打包，且明确排除了 symfony/dotenv（见 composer.json#L42）。这与旧版 deployer/deployer（作为 Composer 包引入，复用项目本地依赖）有本质区别。
更关键的是，Deployer 7 当前（v7.0.0-rc.3）仍基于 Symfony 5 组件，而你的 Symfony 6 项目会因组件版本冲突导致无法通过 Composer 安装 deployer/deployer —— 因此 dist 版成为事实上的唯一选择，但也带来了环境变量加载的断层。
✅ 推荐解决方案：使用原生 PHP 解析 .env（零依赖、安全、兼容性强）
Deployer 脚本本质是 PHP 执行环境，无需 Symfony 组件即可解析标准 .env 格式。以下是一个经过生产验证的轻量封装：
<?php
namespace Deployer;
// ✅ 安全、零依赖的 .env 加载器（支持注释、引号、空格、多行值）
function loadEnv(string $path): void {
if (!file_exists($path)) {
throw new \RuntimeException("Environment file not found: {$path}");
}
$lines = file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
foreach ($lines as $line) {
// 跳过注释和空行
if (str_starts_with(trim($line), '#') || empty(trim($line))) {
continue;
}
// 支持 KEY="value with spaces" 和 KEY=value
if (preg_match('/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/', $line, $matches)) {
$key = $matches[1];
$value = trim($matches[2]);
// 去除单/双引号包裹（兼容常见写法）
if (preg_match('/^["\'](.*)["\']$/', $value, $quoteMatch)) {
$value = $quoteMatch[1];
}
// 替换 ${VAR} 占位符（基础支持，如需复杂插值可扩展）
$value = preg_replace_callback(
'/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/',
fn($m) => $_ENV[$m[1]] ?? '',
$value
);
$_ENV[$key] = $value;
}
}
}
require 'recipe/common.php';
require 'contrib/discord.php';
// ? 在 set() 之前调用
loadEnv(__DIR__ . '/.env');
set('application', $_ENV['APP_NAME'] ?? 'my-symfony-app');
set('discord_channel', $_ENV['DISCORD_DEPLOY_CHANNEL'] ?? '');
set('discord_token', $_ENV['DISCORD_DEPLOY_TOKEN'] ?? '');⚠️ 重要注意事项：
- 不要在 .env 中暴露敏感凭证给部署流程：DISCORD_DEPLOY_TOKEN 等应通过 Deployer 的 ask() 或 CI 环境变量注入（如 set('discord_token', getenv('DISCORD_DEPLOY_TOKEN') ?: ask('Discord token'))），避免将密钥硬编码进 Git 跟踪的 .env 文件。
- .env 仅用于非敏感配置：如 APP_NAME、APP_ENV、部署路径前缀等元信息。
- PHAR 环境限制：deployer/dist 运行在 PHAR 沙箱中，确保路径 __DIR__ . '/.env' 指向的是你项目根目录下的 .env（即 deploy.php 同级位置），而非 PHAR 内部路径。
- Symfony 6 兼容性确认：该方案完全绕过 Symfony 组件依赖，与 Symfony 6+ 无任何冲突，是当前最稳定、可维护的实践。
? 进阶建议（可选）：若团队对环境管理要求更高，可结合 deployer/deployer + --ignore-platform-reqs（谨慎评估风险）或改用 deployer-phar GitHub Action，在 CI 中动态生成含 dotenv 的定制 PHAR —— 但对大多数项目而言，上述原生解析方案已足够健壮、透明且易于审计。
