CakePHP 4 Mailer配置文件存储位置及调用方法咨询

配置文件位置与通用设置写法 #

邮件通用配置有两种管理方式，都能实现复用：

方式1：修改主配置文件config/app.php #

找到文件中的'Email'数组，修改或补充default配置项，将重复的发件人、格式等设置填入：

'Email' => [
    'default' => [
        'transport' => 'default', // 关联到EmailTransport中的投递配置（如SMTP、本地Mail）
        'from' => ['me@example.com' => 'My Company Name'],
        'sender' => ['me@example.com' => 'My Company Name'],
        'emailFormat' => 'both',
        // 可额外添加charset、headerCharset等通用配置
    ],
],

方式2：创建独立邮件配置文件config/email.php #

如果想将邮件配置与主配置分离，新建config/email.php文件，内容示例如下：

<?php
return [
    // 投递层配置（如SMTP参数）
    'EmailTransport' => [
        'default' => [
            'className' => 'Smtp',
            'host' => 'smtp.example.com',
            'port' => 587,
            'username' => 'your-smtp-account',
            'password' => 'your-smtp-password',
            'tls' => true,
        ],
    ],
    // 邮件内容通用配置
    'Email' => [
        'company_mailer' => [ // 自定义配置名，后续调用时使用
            'transport' => 'default',
            'from' => ['me@example.com' => 'My Company Name'],
            'sender' => ['me@example.com' => 'My Company Name'],
            'emailFormat' => 'both',
        ],
    ],
];

调用复用的配置 #

调用默认配置（修改app.php的default项后） #

直接实例化默认Mailer，自动加载配置好的通用设置：

// 记得顶部引入命名空间
use Cake\Mailer\Mailer;

$mailer = new Mailer('default');
// 仅需补充个性化设置（收件人、主题、内容等）
$mailer->setTo('user@example.com')
       ->setSubject('测试邮件')
       ->deliver('这是通过通用配置发送的邮件');

调用自定义配置（如email.php中的company_mailer） #

实例化时传入自定义配置名即可：

use Cake\Mailer\Mailer;

$mailer = new Mailer('company_mailer');
// 后续只需添加个性化内容
$mailer->setTo('client@example.com')
       ->setSubject('自定义配置邮件')
       ->deliver('使用独立配置文件发送的邮件');

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