Mail

Sample

.env

// Setting to send mail with php mail() (php mail()でメール送信する設定)

MAIL_DRIVER=sendmail
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=
MAIL_FROM_ADDRESS=hello@example.com
MAIL_FROM_NAME=Example

.env (ex gmail)

// Not G Suite.

MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your_gmail@gmail.com
MAIL_PASSWORD=your_gmail_app_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_gmail@gmail.com
MAIL_FROM_NAME=LaravelGmailSample

Plugin

use Illuminate\Support\Facades\Mail;
use App\Mail\ConnectMail;

class HogePlugin extends UserPluginBase
{

    public function index($request, $page_id, $frame_id, $errors = [])
    {
        // メール送信
        $to_mail_address = 'hello@example.com';
        $mail_subject = 'テスト件名';
        $mail_text = "本文\n本文2";
        Mail::to(trim($to_mail_address))->send(new ConnectMail(['subject' => $mail_subject, 'template' => 'mail.send'], ['content' => $mail_text]));
    }

（詳細）メールキュー送信の流れ

2021/10/20時点

データベースの投稿通知を例に説明。

・データベースで記事を登録時にメール送信処理が呼ばれる
　DatabasesPlugin::publicStore() 内
　　$this->sendPostNotice($databases_inputs, $before_databases_inputs, 'detail', $overwrite_notice_embedded_tags);
↓
・親クラス UserPluginBase:: sendPostNotice() 呼ばれ、(キュー登録 ※1)と(キュー実行 ※2)が行われる。
　UserPluginBase:: sendPostNotice()　内
　　// キュー登録
　　PostNoticeJob::dispatch($this->buckets, $notice_embedded_tags);
　　 // 非同期でキューワーカ実行
　　$this->asyncQueueWork();
↓
（※1 キュー登録）
// dispatchメソッドへ渡す引数は、ジョブのコンストラクタへ渡されます。
App\Jobs\PostNoticeJob::__construct()
・コンストラクタで、プライベートクラス変数に値をセットしています。
・この時、ジョブクラスは SerializesModelsトレイトを使っていて、ジョブ（キュー）は、DBの jobs テーブルに一度格納されます。
　・キューに入っているジョブがコンストラクタで Eloquent モデルを受け入れる場合、モデルの識別子だけがキューにシリアル化されます。

(※2 キュー実行)
　・ジョブが実際に処理されると、キューシステムはデータベースからモデルインスタンス全体を自動的に再取得します。
↓
・キューを実行して、Mail::to()でメール送信する。メールの内容はnew PostNotice()から取得。
　PostNoticeJob::handle()　内
　　Mail::to($notice_address)->send(new PostNotice($this->notice_embedded_tags, $bucket_mail));
↓
App\Mail\PostNotice::__construct() で値をセット
App\Mail\PostNotice::build() でメール内容をセット。定型文は 'mail.post.post_text‘。
↓
定型文 'mail.post.post_text‘。
resources\views\mail\post\post_text.blade.php
↓
BucketsMail::getFormatedNoticeBody() 参照
ここで埋め込みタグを使ってる。