Railsバリデーション完全入門|format(正規表現)で入力チェックする方法(メール・電話番号・郵便番号)
生徒
「Railsで、メールアドレスや電話番号が正しいかどうかって、どうやってチェックするんですか?」
先生
「Railsでは、バリデーションという仕組みを使って、入力内容を自動でチェックできます。」
生徒
「バリデーションって、パソコンを触ったことがなくても使えるんですか?」
先生
「大丈夫です。今日は、format(正規表現)を使って、よくある入力チェックを一つずつ見ていきましょう。」
1. Railsのバリデーションとは何か
Railsのバリデーションとは、フォームなどから入力された値が「正しい形かどうか」を保存前に確認する仕組みです。たとえば、メールアドレスが空欄だったり、電話番号に文字が混ざっていたりすると、あとで大きなトラブルになります。Railsでは、モデルという場所にルールを書くことで、こうしたミスを防げます。
モデルは、データベースと直接やり取りする部品です。住所録や会員名簿のような役割を持ち、そこに変なデータが入らないよう門番をするのがバリデーションです。
2. format(正規表現)による入力チェックの考え方
formatは、「この形で入力してください」という決まりを作るためのバリデーションです。ここで使う正規表現とは、文字の並び方を表現する特別な書き方です。難しそうに見えますが、「この文字が来たら次はこれ」と並びを指定するだけです。
たとえるなら、郵便番号を書くときに「数字3文字、ハイフン、数字4文字」と決まっているようなものです。formatは、そのルールをRailsに教える役目をします。
3. メールアドレスをformatでチェックする例
まずは一番よく使われるメールアドレスの入力チェックです。@があり、前後に文字が入っているかを確認します。
class User < ApplicationRecord
validates :email,
presence: true,
format: { with: /\A[^@\s]+@[^@\s]+\z/ }
end
presenceは「空欄禁止」という意味です。formatの中のwithには、正規表現を書きます。この正規表現は「@が一つあり、空白が含まれない」という最低限のルールです。完璧ではありませんが、初心者向けには十分です。
4. 電話番号をformatでチェックする例
次は電話番号です。日本の電話番号は数字とハイフンで構成されることが多いので、それを前提にします。
class User < ApplicationRecord
validates :phone_number,
format: { with: /\A\d{2,4}-\d{2,4}-\d{4}\z/ }
end
\dは数字を意味します。{2,4}は「2文字から4文字まで」という意味です。これにより、03-1234-5678や090-1234-5678のような形だけを許可できます。
5. 郵便番号をformatでチェックする例
郵便番号も典型的な入力チェックの一つです。日本の郵便番号は「数字3桁-数字4桁」という決まりがあります。
class Address < ApplicationRecord
validates :postal_code,
format: { with: /\A\d{3}-\d{4}\z/ }
end
このように書くことで、123-4567の形以外は保存されません。数字だけや桁数が違う場合はエラーになります。
6. uniquenessと組み合わせた実用的な例
メールアドレスは、同じものを複数人が使えないことが多いです。その場合はuniquenessを組み合わせます。
class User < ApplicationRecord
validates :email,
presence: true,
uniqueness: true,
format: { with: /\A[^@\s]+@[^@\s]+\z/ }
end
uniquenessは「重複禁止」という意味です。これにより、形も正しく、他の人と同じメールアドレスも使えなくなります。
7. before_*コールバックと一緒に使う考え方
コールバックとは、保存の前後で自動的に動く処理です。before_validationは、バリデーションの前に処理を挟めます。
class User < ApplicationRecord
before_validation :normalize_email
validates :email,
format: { with: /\A[^@\s]+@[^@\s]+\z/ }
private
def normalize_email
self.email = email.to_s.downcase
end
end
ここでは、メールアドレスをすべて小文字にしてからチェックしています。これにより、大文字小文字の違いによるミスを防げます。
8. エラーが出たときに何が起きているか
バリデーションに失敗すると、データは保存されません。これは「壊れたデータを入れない」というRailsの安全設計です。ユーザーには「メールアドレスの形式が正しくありません」といったメッセージが表示されます。
パソコンが苦手な人でも、Railsが自動でチェックして止めてくれると考えると安心です。formatによる入力チェックは、初心者が最初に覚えるべきRailsバリデーションの基本です。