【Rails】「mailcatcher」を使ってテストメールを送信/受信する

2021年3月12日 12:36

はじめに

Railsアプリでコンタクトフォームなどを自作している場合、開発段階でメールが送信されることを確認する必要があります。開発段階のテストのため、実際のメールサーバーを使うことや、実際のメールクライアントにテストメールが残ることを避けたいという場合があります。

本記事では、mailcatcherというGemを使ってテストメールサーバーを構築し、テストメールを送信する方法について説明します。

mailcatcherを使ってテストメールを送信/受信

mailcatcherのインストール

Railsアプリにmailcatcherをインストールするには、Gemfileに以下を追加し、bundle installを行います。mailcatcherは開発環境でのみ使用するので、developmentグループの中に追加します。

group :development do
  gem 'mailcatcher'
end

mailcatcherの設定

Railsアプリにmailcatcherを設定するには、config/environments/development.rbに以下を追記します。

  config.action_mailer.delivery_method = :smtp
  config.action_mailer.smtp_settings = { address: 'localhost', port: 1025 }

mailcatcherの実行

mailcatherを実行するには、コンソールで以下のコマンドを実行します。デフォルトではバックグラウンドで起動し、smtp://localhost:1025が使用されます。

$ mailcatcher

コマンド実行時、以下のオプションが設定できます。

オプション 説明
--ip IP smtp/httpサーバーのIPアドレスを設定
--smtp-ip IP smtpサーバーのIPアドレスを設定
--smtp-port PORT smtpサーバーのポート番号を設定
--http-ip IP httpサーバーのIPアドレスを設定
--http-port PORT httpサーバーのポート番号を設定
--[no-]growl メッセージを受信したらローカルマシンに通知
-f, --foreground フォアグラウンドで実行
-b, --browse ウェブブラウザを開く
-v, --verbose 詳細を表示
-h, --help ヘルプ情報を表示

テストメールを受信

開発環境のRailsアプリからテストメールを送信すると、mailcatcherでメールを受信します。メールボックスはhttp://localhost:1080で確認できます。

まとめ

開発環境でテストメールの確認ができるGemは他にletter_openerがありますが、mailcatcherのほうが導入も簡単ですし使い方も非常にシンプルなのでおすすめです。

本記事を参考にして、テストメールを送信/受信していただければと思います。

関連記事

【Rails】Webサーバー「Unicorn」の基本情報と実装方法
# はじめに Railsアプリを本番環境で稼働させるには、クライアントからのリクエストを捌くWebサーバーを導入する必要があります。WebサーバーはクライアントからのリクエストをRailsアプリに伝達し、Railsアプリで処理されたレスポンスをク [...]
2021年4月15日 12:17
【Rails】デプロイツール「Capistrano」の基本情報と実装方法
# はじめに アプリを本番環境にアップロードして誰でもアクセスできる状態にすることをデプロイと言います。デプロイで行うべきことは多岐にわたります。Railsアプリの場合で言えば、本番環境にアップロードすることはもちろんですが、Gemのインストール [...]
2021年4月14日 9:56
【Rails】Webpackerの基本情報と実装方法
# はじめに Rails 6からWebpackerが正式採用されました。Rails 5ではオプションで追加することができたWebpackerですが、Rails 6からは普通にアプリを作成するだけでWebpackerがインストールされ、必要な設定も [...]
2021年4月12日 14:36
【Rails】アセットパイプライン(Sprockets)の基本情報と実装方法
# はじめに Ruby on Railsにはアセットパイプラインという機能があります。アセットパイプラインは画像、CSS、JavaScriptといったアセットファイルを連結/圧縮することでRailsアプリを高速化します。また、より高級な言語で書か [...]
2021年4月11日 14:08
【Rails】Turbolinksの基本情報と実装方法
# はじめに Ruby on Railsにはページの遷移を高速化するTurbolinksという機能があります。Turbolinksは優れたJavaScriptライブラリですが、Rails 5からは標準で有効化されているため、Turbolinksを [...]
2021年4月10日 17:59