SwiftMailer 已停维，新项目禁用；应改用 symfony/mailer + symfony/mime；旧项目若必须使用，仅限 composer require swiftmailer/swiftmailer:^6.3 并验证版本。
如果你在新项目中尝试 composer require swiftmailer/swiftmailer，大概率会碰壁。这并非网络问题，而是因为这个曾经流行的邮件库已经正式停止维护。直接安装不仅常常失败，即便侥幸装上，也可能在 PHP 8.2+ 或 Lara vel 10+ 等现代环境下无法运行。
composer require swiftmailer/swiftmailer 为什么失败
核心原因在于包本身已被归档。自 2019 年起，SwiftMailer 就不再发布新版本。Packagist 上记录的最新稳定版定格在 v6.3.0。这意味着，任何试图安装更高版本（如 ^6.4）或无明确版本约束的命令，都会因为找不到对应的包而报错。
composer require swiftmailer/swiftmailer→ 默认寻找最新版，找不到，直接报错。composer require swiftmailer/swiftmailer:~6.0→ 波浪号范围会尝试匹配不存在的6.4.x，导致失败。composer require swiftmailer/swiftmailer:^6.3→ 这是唯一可行的方式，但仅限于维护旧项目的场景。- 更重要的是，即使在老项目中装上了
v6.3.0，在 PHP 8.2+、Symfony 6.4+ 等新环境中，也可能因内部的反射机制变更或废弃函数而引发致命错误。
新项目该用什么替代 SwiftMailer
答案是明确的：直接切换到 symfony/mailer 加上 symfony/mime。这是 Symfony 官方推出的现代化方案，旨在接替 SwiftMailer 的职责。它更轻量、更安全，并且持续活跃维护。
- 安装命令很简单：
composer require symfony/mailer symfony/mime。 - 它原生支持 SMTP、Mailgun、Postmark、Amazon SES、Sendmail 等多种传输方式，API 设计更简洁，错误提示也更为清晰。
- 在纯 SMTP 场景下，它甚至不强制依赖
ext-curl或 Guzzle 等 HTTP 客户端，配置好传输层即可发信。 - 事实上，主流框架早已转向：Lara vel 9+ 已默认采用此方案；Yii 3、CakePHP 4+ 等也优先适配它。
老项目必须用 SwiftMailer 怎么安全安装
对于不得不使用 SwiftMailer 的遗留系统，安装策略必须精确无误：锁定 v6.3.0，并手动验证安装结果。
- 执行命令：
composer require swiftmailer/swiftmailer:^6.3。 - 安装后立即验证：运行
cat vendor/swiftmailer/swiftmailer/CHANGES.md | head -n 5，确认第一行显示的是Changelog for Swift Mailer v6.3.0。 - 务必注意：不要在
composer.json中写"swiftmailer/swiftmailer": "^6"这样的范围，它仍可能尝试寻找不存在的6.4版本。 - 如果你的项目基于 Yii2，应该使用
yiisoft/yii2-swiftmailer:^2.1（它对应 SwiftMailer 6.3），而不是~2.0（后者对应的是 SwiftMailer 5，与 PHP 8 不兼容）。
SMTP 连接失败时先别查代码，查 transport 配置
遇到 “连接超时” 或 “535 认证失败” 这类错误，先别急着怀疑代码逻辑。十有八九问题出在传输层配置与邮件服务商的要求不匹配上。
- Gmail：必须开启“应用专用密码”，并使用
tls加密 + 端口587。直接填写账户密码或使用ssl+ 端口465必定失败。 - 阿里云邮件推送：仅支持
tls+ 端口587，不支持ssl+ 端口465。 - QQ 邮箱：如果坚持使用
465端口，需要在测试环境中显式添加$transport->setStreamOptions(['ssl' => ['verify_peer' => false]])选项（生产环境必须配置有效的 CA 证书）。 - 另外，PHP 8.1+ 默认会拒绝自签名证书，因此
verify_peer => false有时是必要的绕过手段，但务必清楚其中潜在的安全风险。
真正的麻烦往往不在于安装本身，而在于安装成功后，发信时卡在 TLS 握手或认证环节。这些错误通常不会明确提示是“SwiftMailer 错误”，只会抛出诸如 Connection could not be established 这样模糊的信息。解决之道，在于仔细逐层比对邮件服务商的官方文档和 PHP 的流上下文配置选项。
