中小企業のためのオープンソース実務ガイド

Mautic OSSのインストールと初期設定|7.2.2でフォーム・メール配信を試す

Mauticの管理画面にログインできたら、次はフォームから連絡先を登録し、メールが届き、配信停止が反映されるところまで確かめます。キャンペーンを動かすには、サーバー側の定期処理も設定します。

この記事では、Mautic Community 7.2.2をLinuxのサーバーに新規インストールする手順を解説します。公式の配布ZIPとWebインストーラーを使い、サブドメインに設置する例です。

Mautic 7.2.2の動作要件と準備

2026年11月13日時点で公式が案内する安定版は7.2.2です。最初に、サーバーで利用できるPHPとデータベースのバージョンを確認します。

新規インストールの前に用意するもの
項目確認する内容
PHP8.2〜8.5。Web用とCLI用を両方確認し、pdo_mysql、mbstring、curl、zipなど必要な拡張を有効にします。
データベースMySQL 8.4以上、またはMariaDB 10.11.0以上。InnoDBを利用し、Mautic専用の空のDBと専用ユーザーを用意します。
URL・証明書例として https://ma.example.com を用意し、DNSの設定、HTTPS証明書、公開ディレクトリを確認します。
定期処理と配信サーバーでcronを登録できること、配信サービスのSMTP等を使えること、送信元ドメインのDNSを設定できることを確認します。

VtigerCRMと同じサーバーを使う場合

MySQLの表示が「8.0.x」なら、Mautic 7.2.2の公式要件である8.4以上を満たしません。cPanelのPHP切り替えで変えられるのはPHPです。既存CRMへの影響を調べたうえで、Mautic用に対応DBを備えた別環境を用意する方法も検討できます。

公式ZIPを使い、Webインストーラーでセットアップする

  1. サブドメインを作る。 Mautic専用の公開ディレクトリを割り当て、対象ドメインのPHPとHTTPSを設定します。cPanelでは、契約先の画面に表示されるドメイン設定とPHP設定を使います。
  2. 専用DBとユーザーを作る。 cPanelの「Database Wizard」などで、空のDBとMautic専用ユーザーを作り、そのDB内でテーブルの作成・変更やデータの読み書きに必要な権限を、そのDBに限って割り当てます。接頭辞を含む実際のDB名とユーザー名、ホスト、ポートを控えます。
  3. 公式のインストール用ZIPを展開する。 公式のダウンロードページまたはGitHubリリースから、実行に必要なファイルがそろった配布パッケージを入手します。GitHubの自動生成アーカイブ「Source code (zip)」と区別してください。公開ディレクトリに展開し、対象URLで index.php が参照される配置にします。ZIPファイルは公開領域から移します。
  4. HTTPSで開き、インストーラーを進める。 環境チェックでエラーがあれば、PHPのバージョン・拡張・書き込み権限などを修正します。DBの接続情報を入力し、管理者のメールアドレスと固有のパスワードを設定します。DBホストは契約先の指定値を使います。同一サーバーで localhost を指定する構成もあります。
  5. 管理画面にログインする。 インストール中にメール設定が表示される場合は、用意した検証に使う配信基盤の接続情報を入力します。ログイン後も設定画面で見直せます。

プラグインと依存ライブラリを継続的に管理する環境では、Mautic公式はComposerを推奨しています。mautic/recommended-project を使う構成では、Webサーバーの公開ルートをプロジェクト内の docroot/ に設定します。以下のcronに渡す bin/console のパスも、実際の配置に合わせます。

サイトURL・日本語表示・メール配信を設定する

システム設定でURL・言語・タイムゾーンを合わせる

管理画面右上の歯車から「Configuration」を開きます。「System Settings」の「Site URL」には、アクセスに使う正式なHTTPS URLを設定します。埋め込んだフォームがMauticへアクセスするURLや、メール内のリンクの生成にも使われます。タイムゾーンは Asia/Tokyo、既定の言語は選択肢の日本語を選び、必要に応じてログイン中のユーザーのプロフィールも設定します。

別ドメインのWebサイトにフォームを埋め込む場合は、CORS設定の「Valid Domains」に必要なサイトのURLをHTTPS付きで登録し、対象ページで表示と送信を試します。

メール設定で送信元とSMTPを設定する

「Email Settings」で送信元名、送信元アドレス、返信先、SMTPなどの接続情報を設定します。接続先・ポート・暗号化・認証情報は配信サービスの指定値を使います。フォームに入力すると接続情報(DSN)が組み立てられます。送信元ドメインのSPF・DKIM・DMARCも確認し、受信メールのヘッダーや配信サービスのログで認証結果を確かめます。

画面のメール一覧または詳細画面の「Send example」で、まず社内アドレスへの到着と日本語の表示を確認します。配信停止リンクのテストでは、後述のようにテスト用の連絡先に配信します。

cronでセグメント更新とキャンペーン処理を動かす

SSHまたはcPanelのターミナルが使える場合は、定期実行に使うPHPで /path/to/php -v を実行し、続けて /path/to/php /path/to/mautic/bin/console list が動くか確認します。Web側とCLI側で別のPHPが選ばれる環境では、cronにも動作確認済みのPHPの絶対パスを指定します。

0,15,30,45 * * * * /path/to/php /path/to/mautic/bin/console mautic:segments:update
5,20,35,50 * * * * /path/to/php /path/to/mautic/bin/console mautic:campaigns:update
10,25,40,55 * * * * /path/to/php /path/to/mautic/bin/console mautic:campaigns:trigger

15分ごとに実行する例です。上から、セグメントを更新、キャンペーン対象者を更新、キャンペーンの処理を実行します。パスは実環境の値に置き換えてください。cPanelでは「Cron Jobs」で「Minute」欄に左端の数値を、他の時刻欄に * を、コマンド欄にPHPのパスから後ろを入力します。処理時間とサーバー側の実行間隔の制約に応じて調整します。

利用する機能に応じて追加する処理
用途コマンド
連絡先・企業のカスタム項目の列を反映mautic:custom-field:create-column / mautic:custom-field:delete-column
セグメントメールの予約配信mautic:broadcasts:send
メールキューを有効にした場合messenger:consume email --time-limit=160 など。cronで起動する場合は実行時間や処理件数に上限を設けます。
配信頻度ルールで保留したメールmautic:messages:send

新規インストール時のメールキューは既定で無効です。キューを有効にする場合は、ワーカーが稼働していることまで確認します。公開日時を設定したセグメントメールでは、後からセグメントに追加された連絡先にも予約処理が適用され得ます。対象と公開終了日時を配信前に確認します。

フォーム受付・テスト配信・配信停止を確認する

  1. フォームから連絡先を作る。 メールアドレスを連絡先のメール項目に割り当てたフォームを公開し、テストページから社内アドレスで送信します。フォームの送信結果と「Contacts」の両方で確認します。
  2. テスト対象だけをセグメントに入れる。 テストアドレスを含むセグメントを作ります。条件による抽出を使う場合は、cronの実行後に対象件数とアドレスを照合します。
  3. テスト対象にメールを配信する。 セグメントメールに配信停止リンク({unsubscribe_text} など)を追加してテスト対象へ送り、差し込み項目、リンク先、メールの到着を確認します。キャンペーンを使う場合は、テスト用セグメントを起点にし、対象者の追加とメール送信の処理を確認します。
  4. 配信停止後の状態を確かめる。 届いたメールから全メールの配信停止を選び、連絡先がメールの配信停止状態になったことを確認します。別のテスト用マーケティングメールでも、停止済みの宛先が配信から除外されるかを確かめます。「Send example」では配信停止リンクの挙動が異なるため、テスト用の連絡先へ実際に送って確認します。

動かない場合は、止まった段階を確認する

フォームに登録されない場合は、メール項目の割り当てと埋め込み元のURLを確認します。連絡先はあるのに対象に入らない場合は、セグメント条件とcronを調べます。送信処理が進まない場合は、キャンペーンの実行状況、キューの有無、配信サービスのログを順に見ます。

本番配信前に、運用を引き継げるようにする

配信テストが終わったら、DB・設定・添付や画像などの保存対象を記録し、バックアップと復元の手順を確認します。cronの実行結果、配信エラー、Mautic本体の更新を誰が確認するかも決めてから、本番の配信対象を登録します。