composer虚拟包如symfony/smtp-mailer仅声明提供能力，不包含任何传输代码；真实实现全在symfony/mailer中，通过transport::fromdsn()动态加载smtptransport等类。
Composer 虚拟包不能声明邮件传输实现 —— 它们只是占位符，不提供任何代码
你看到的 symfony/smtp-mailer、symfony/mailgun-mailer 等包，表面像“传输实现”，实则是 Composer 的 虚拟包（virtual package），作用仅是满足依赖约束，而非真正包含传输逻辑。真实实现始终在 symfony/mailer 本体中，通过 Transport::fromDsn() 动态加载。
为什么 symfony/smtp-mailer 不含 SMTP 代码？
检查 vendor/symfony/smtp-mailer/composer.json：它只有 "provide" 字段，声明自己“提供” symfony/transport 这个虚拟能力，但 autoload 为空，src 目录不存在。真正的 SMTP 传输类 SmtpTransport 位于 vendor/symfony/mailer/Transport/Smtp/，由 symfony/mailer 自带。
-
symfony/mailer是唯一含实际传输类的包（SmtpTransport、SendmailTransport、NullTransport等） - 所有
symfony/*-mailer包都只是空壳，只为让composer require时能触发自动发现或满足框架约束（如 Symfony Flex 的 recipe） - 安装
symfony/smtp-mailer唯一效果：让Transport::fromDsn('smtp://...')能识别并加载内置的 SMTP 实现
如何确认传输是否真正可用？
别信包名，看运行时加载结果。加一行诊断代码：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
$transport = \Symfony\Component\Mailer\Transport::fromDsn('smtp://test:test@localhost:1025');
var_dump($transport::class);
// 输出：string(42) "Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport"
- 如果输出
NullTransport，说明 DSN 解析失败或协议不匹配（比如写成smtps://但没对应实现） - 如果抛出
InvalidArgumentException：“No transporter found for…”，说明 DSN 协议未被注册 —— 此时才需要检查是否漏装了某个*-mailer虚拟包（极少见） - 更常见的是环境变量未生效：
$_ENV['MAILER_DSN']为null，导致Transport::fromDsn(null)默认回退到NullTransport
生产环境配置的真实依赖链
你只需要确保三件事：
-
symfony/mailer已安装（必须） -
MAILER_DSN环境变量格式正确（如smtp://user:pass@smtp.gmail.com:587?encryption=tls） - PHP 启用了
ext-openssl（TLS/SSL 必需）和ext-curl（部分 API 传输需要）
其余所有 symfony/*-mailer 包，对功能无实质影响 —— 它们不增加新类，不改变行为，只参与 Composer 的依赖图解析。删掉它们，只要 DSN 正确，SmtpTransport 依然工作。
最容易被忽略的点：虚拟包让你误以为“装了就等于有实现”，而实际发送失败几乎总是源于 DSN 格式错误、网络不通、证书验证失败或环境变量未加载，而不是少装了某个 -mailer 包。
