如何在Nette Mail中配置DKIM邮件签名？

阿华AIGC实验室

2026-5-20

在Nette Mail中实现DKIM签名的方案

你说得没错，Nette Mail 2.4的Nette\Mail\Message类确实没有内置的DKIM相关设置方法，但这并不代表不能实现DKIM签名——结合你提到的php-mail-signature工具，我们可以通过以下两种常用方式来完成：

方法一：手动生成邮件内容后再签名发送

这种方式的核心思路是先让Nette Mail生成完整的原始邮件文本，再用php-mail-signature对其进行DKIM签名，最后发送签名后的邮件内容。

具体步骤：

创建并配置Nette Mail Message实例
先像平时一样构建你的邮件：

use Nette\Mail\Message;

$message = new Message();
$message->setFrom('sender@yourdomain.com', 'Your Name')
        ->addTo('recipient@example.com')
        ->setSubject('Test Email with DKIM')
        ->setBody('This is a test email signed with DKIM.');

生成原始邮件字符串
Nette的Message类提供了generateMessage()方法来生成包含所有头部和正文的原始邮件内容：
```
$rawEmail = $message->generateMessage();
```

使用php-mail-signature进行DKIM签名
配置你的DKIM参数（私钥路径、域名、选择器等），然后对原始邮件进行签名：

use phpMailSignature\phpMailSignature;

$dkimConfig = [
    'private_key' => '/path/to/your/private-key.pem',
    'domain' => 'yourdomain.com',
    'selector' => 'dkim', // 你的DKIM选择器
    'identity' => 'sender@yourdomain.com',
];

$mailSignature = new phpMailSignature($dkimConfig);
$signedRawEmail = $mailSignature->sign($rawEmail);

发送签名后的邮件
你可以直接使用PHP的mail()函数发送签名后的内容，或者适配到Nette的Mailer逻辑中：
```
// 直接发送完整的签名后邮件内容
mail('', '', $signedRawEmail);
```

方法二：扩展Nette Mailer实现自动签名

如果你希望在项目中统一处理DKIM签名，不需要每次手动操作，可以扩展Nette的Mailer类，在发送前自动完成签名流程。

示例代码：

use Nette\Mail\IMailer;
use Nette\Mail\Message;
use phpMailSignature\phpMailSignature;

class DkimMailer implements IMailer
{
    private $originalMailer;
    private $dkimSignature;

    public function __construct(IMailer $originalMailer, array $dkimConfig)
    {
        $this->originalMailer = $originalMailer;
        $this->dkimSignature = new phpMailSignature($dkimConfig);
    }

    public function send(Message $message): void
    {
        // 生成原始邮件并签名
        $rawEmail = $message->generateMessage();
        $signedRawEmail = $this->dkimSignature->sign($rawEmail);

        // 直接发送签名后的完整邮件内容
        mail('', '', $signedRawEmail);
    }
}

之后在你的依赖注入配置中，把原始的Mailer替换成这个DkimMailer，这样所有通过Nette Mail发送的邮件都会自动带上DKIM签名。