Swift Mailer 使用与技术文档

1. 安装指南

Swift Mailer 是一个基于组件的 PHP 邮件发送解决方案。要使用 Swift Mailer，您需要通过 Composer 进行安装。

composer require "swiftmailer/swiftmailer:^6.0"

确保您的环境满足 Swift Mailer 的系统要求：PHP 7.0 到 PHP 8.1 版本，并且 proc_* 函数可用。同时，当 mbstring.func_overload 设置为 2 时，Swift Mailer 无法正常工作。

2. 项目使用说明

Swift Mailer 提供了一个非常灵活的面向对象的接口，适用于复杂 web 应用程序。以下是最基本的 Swift Mailer 使用示例：

require_once '/path/to/vendor/autoload.php';

// 创建传输对象
$transport = (new Swift_SmtpTransport('smtp.example.org', 25))
    ->setUsername('your username')
    ->setPassword('your password');

// 使用传输对象创建邮件发送者
$mailer = new Swift_Mailer($transport);

// 创建邮件消息
$message = (new Swift_Message('Wonderful Subject'))
    ->setFrom(['[e-mail]' => 'John Doe'])
    ->setTo(['[e-mail]', '[e-mail]' => 'A name'])
    ->setBody('Here is the message itself');

// 发送邮件
$result = $mailer->send($message);

您还可以使用 Sendmail 作为传输：

// Sendmail
$transport = new Swift_SendmailTransport('/usr/sbin/sendmail -bs');

3. 项目API使用文档

Swift Mailer 的 API 文档详细介绍了其类和方法的使用。以下是部分类的简要说明：

• SwiftMailer: 邮件发送者的主类，用于发送邮件。
• Swift_Transport: 传输接口，定义了邮件传输的抽象方法。
• Swift_SmtpTransport: SMTP 传输类，用于通过 SMTP 服务器发送邮件。
• Swift_SendmailTransport: Sendmail 传输类，用于通过本地 Sendmail 程序发送邮件。
• Swift_Message: 邮件消息类，用于创建和格式化邮件内容。

请参考官方文档以获取详细的 API 使用说明。

4. 项目安装方式

如前所述，Swift Mailer 通过 Composer 进行安装。确保您已安装 Composer，然后在项目根目录下执行以下命令：

composer require "swiftmailer/swiftmailer:^6.0"

这将自动处理所有依赖项，并将 Swift Mailer 库添加到您的项目中。安装后，您可以通过 vendor/autoload.php 文件自动加载 Swift Mailer 类。

请注意，Swift Mailer 已经停止维护，建议您尽快迁移到 Symfony Mailer，这是 Swift Mailer 的继承者，提供了相同的特性，并且支持现代 PHP 代码和第三方服务提供商。