CakePHP发送邮件配置DKIM签名解决垃圾邮件问题咨询

我明白这种邮件被莫名标记成垃圾邮件的烦躁——Google和Yahoo现在对邮件认证的要求越来越严格了。要在CakePHP里给发送的邮件加上DKIM签名，你需要完成以下两步配置，我结合你的现有代码一步步说明：

1. 先搞定域名侧的DKIM前置配置 #

这是基础，必须先做：

• 先在你的域名服务商后台生成一对DKIM密钥（公钥+私钥），大多数域名服务商都有现成的DKIM生成工具，或者你也可以用OpenSSL命令生成
• 把公钥添加到域名的DNS记录中：新建一条TXT记录，记录名称填类似 default._domainkey.yourdomain.com（这里的default是「selector」，你可以自定义，但后面代码里要和这个保持一致），记录内容格式为 v=DKIM1; k=rsa; p=你的公钥内容（注意公钥内容不要有多余换行，复制完整）
• 等待DNS生效（通常需要10分钟到几小时，取决于DNS服务商的刷新速度）

2. 修改CakePHP的邮件代码，添加DKIM配置 #

你的现有代码需要调整为使用Smtp传输（CakePHP的默认Mail传输不支持DKIM），并添加DKIM相关参数。修改后的完整代码如下：

$email = $user['User']['email']; 
$verify_link = Router::url('/', true).'user/welcome/'.base64_encode($id).'/'.base64_encode($email); 
$message = "Hello $name,<br/><br/>Welcome to our domain"; 

$Email = new CakeEmail();
// 配置SMTP服务器和DKIM签名
$Email->transport('Smtp')
      ->config([
          'host' => 'smtp.yourdomain.com', // 替换成你的SMTP服务器地址（比如smtp.gmail.com如果用Gmail企业邮箱）
          'port' => 587, // 常用端口，也可能是465，根据你的SMTP服务商设置
          'username' => $site_sender_email, // 你的发件邮箱地址，要和DKIM域名一致
          'password' => '你的SMTP邮箱密码', // 或者授权码，比如Gmail需要应用专用密码
          'tls' => true, // 开启TLS加密，大多数SMTP服务商要求这个
          'dkim' => [
              'domain' => 'yourdomain.com', // 你的域名，必须和发件邮箱的域名一致
              'selector' => 'default', // 和你DNS记录里的selector对应（比如刚才用的default）
              'privateKey' => file_get_contents(APP . 'Config/dkim/private.key'), // 私钥文件的路径，确保服务器有读取权限
              // 如果你的私钥设置了密码，取消下面这行注释并填写密码
              // 'passphrase' => '你的私钥密码'
          ]
      ]);

// 保留你原来的邮件内容配置
$Email->from([$site_sender_email => 'Ourdomain'])
      ->to($email)
      ->subject('Welcome to our domain')
      ->emailFormat('html')
      ->send($message);

可选：全局配置DKIM（避免重复代码） #

如果你不想每次发邮件都写一遍配置，可以在Config/email.php里添加一个全局配置项：

public $dkim_smtp = [
    'transport' => 'Smtp',
    'host' => 'smtp.yourdomain.com',
    'port' => 587,
    'username' => 'sender@yourdomain.com',
    'password' => '你的SMTP密码',
    'tls' => true,
    'dkim' => [
        'domain' => 'yourdomain.com',
        'selector' => 'default',
        'privateKey' => file_get_contents(APP . 'Config/dkim/private.key'),
    ]
];

之后发邮件时直接调用这个配置即可：

$Email = new CakeEmail('dkim_smtp');

几个关键注意事项 #

• 发件邮箱的域名必须和DKIM配置的domain完全一致，比如发件邮箱是support@yourdomain.com，那domain就得是yourdomain.com
• 确保服务器能读取到私钥文件，设置正确的文件权限（一般给644权限就行）
• 配置完成后，可以发送一封测试邮件，查看邮件头里是否有DKIM-Signature字段，来确认签名是否生效

内容的提问来源于stack exchange，提问作者Emad A