メール設定

Chamiloでは、メール送信の設定を管理ダッシュボードのプラットフォーム設定セクション（メール専用の項目があります）から管理できるようになりました。メールはアカウント作成、パスワードリセット、コース通知、メッセージアラート、その他のプラットフォームイベントのために送信されます。メール配信はMAILER_DSN設定を通じて構成されます。

設定方法

/admin/settings/mailセクションでMail DSNオプションを設定します。形式は使用するメールトランスポートによって異なります。

SMTP

最も一般的な設定で、任意のSMTPサーバーに適しています：

# システムに任せる
native://default

# 基本的なSMTP
smtp://username:[e-mail]:587

# TLSを使用したSMTP（ほとんどのプロバイダ）
smtp://username:[e-mail]:587?encryption=tls

# 認証なしのSMTP（ローカルリレー）
smtp://localhost:25

username、password、およびホストをSMTPサーバーの認証情報に置き換えてください。

Amazon SES

# SMTPインターフェースを使用
ses+smtp://ACCESS_KEY:SECRET_KEY@default?region=us-east-1

# APIを使用
ses+api://ACCESS_KEY:SECRET_KEY@default?region=us-east-1

Symfony Amazon MailerトランスポートはChamiloに組み込まれています。追加のインストールは不要です。

Mailjet

mailjet+api://API_KEY:SECRET_KEY@default

Symfony MailjetトランスポートはChamiloに組み込まれています。追加のインストールは不要です。

Brevo（旧Sendinblue）

brevo+api://API_KEY@default

Symfony BrevoトランスポートはChamiloに組み込まれています。追加のインストールは不要です。

Gmail（開発/小規模プラットフォーム向け）

gmail+smtp://[e-mail]:app-password@default

通常のGmailパスワードではなく、アプリパスワードを使用してください。これは小規模なプラットフォームや開発環境にのみ適しており、Gmailには送信制限があります。

プラットフォームのメール設定

トランスポートに加えて、同じページで送信者の識別情報を設定します：

設定項目	説明
すべてのメールをこの（組織の）名前で送信元として送信する	システムメールに関連付けられる表示名。
すべてのメールをこのメールアドレスから送信する	すべてのシステムメールの「送信元」アドレス。メールトランスポートで受け入れられる有効なアドレスである必要があります。自動送信メールへの無意味な返信を避けるため、[e-mail]のような「返信不要」アドレスを使用することをお勧めします。

メール配信のテスト

MAILER_DSNを設定した後、メールが配信されるかテストします：管理 > システム > メールテスターに移動し、受信者、件名、メール本文を指定してテストメールを送信をクリックします。

コマンドがエラーなく完了したがメールが届かない場合：

1. 受信者のスパム/ジャンクフォルダを確認してください。

2. 送信ドメインに適切なDNSレコード（SPF、DKIM、DMARC）があるか確認してください。

3. メールプロバイダの送信ログでバウンスや拒否がないか確認してください。

4. Chamiloのログvar/log/prod.logでメーラーエラーを確認してください。

5. メール設定でMail: Debugを有効にしてください（2.0では利用できませんが、近日中に利用可能になります）。

実験的：メールキュー（非同期配信）

デフォルトでは、メールはウェブリクエスト中に同期的に送信されます。パフォーマンスを向上させるために、Symfony Messengerを使用して非同期配信を設定できます：

# config/packages/messenger.yaml
framework:
    messenger:
        transports:
            async: '%env(MESSENGER_TRANSPORT_DSN)%'
        routing:
            'Symfony\Component\Mailer\Messenger\SendEmailMessage': async

非同期配信では、メールはキューに溜まり、バックグラウンドワーカーによって送信されます：

php bin/console messenger:consume async

これをシステムサービス（例：systemdやsupervisord経由）として実行し、常時稼働するようにしてください。

ヒント

• 本番環境のプラットフォームでは専用のメールサービス（SES、Mailjet、Brevo）を使用してください。独自のメールサーバーへの直接SMTPは、配信性の問題を避けるために慎重な設定が必要です。

• 送信ドメインのSPF、DKIM、DMARC DNSレコードを設定して、配信率を最大化し、メールがスパムとしてマークされるのを防ぎます。メール設定ページからDKIMヘッダーも設定できます。

• 数十人以上のアクティブユーザーがいるプラットフォームでは非同期配信を使用してください。同期的なメール送信はウェブリクエストを顕著に遅くする可能性があります。