Railsでフォームから画像をアップロードする方法｜form_withとdirect_uploadの基本を超やさしく解説

1. Railsで画像アップロードをする全体の流れ

1. Railsで画像アップロードをする全体の流れ

Railsでフォームから画像をアップロードする場合、「画像ファイルを選ぶ」「サーバーに送る」「保存する」 という流れになります。初心者の方は、まず「画像も文字と同じようにフォームから送れる」と考えてください。 そのうえで、RailsではActive Storageという公式の仕組みを使うことで、 画像やファイルを安全に管理できます。

Active Storageは、「どこに保存するか」「どうやって取り出すか」をRailsがまとめて面倒を見てくれる存在です。 例えるなら、学校のロッカーのようなもので、誰の荷物かをきちんと管理してくれます。

2. Active Storageとは？初心者向けイメージ解説

2. Active Storageとは？初心者向けイメージ解説

Active Storageは、Railsに標準で用意されているファイル管理機能です。 画像だけでなく、PDFや音声ファイルなども扱えます。 保存先は、パソコンの中（ローカル）や、Amazon S3などの外部サービスにも対応しています。

難しい言葉に聞こえますが、「ファイルを保存して、あとで表示できるようにする仕組み」 と覚えれば十分です。自分でフォルダを作ったり、複雑な設定をしなくても使えるのが大きな特徴です。

3. モデルに画像を紐づける準備

3. モデルに画像を紐づける準備

画像アップロードでは、「どのデータに画像を持たせるか」を決めます。 例えば、Userモデルにプロフィール画像を持たせたい場合、Active Storageの has_one_attached を使います。

class User < ApplicationRecord
  has_one_attached :avatar
end

この1行で、「ユーザーは1枚の画像を持てる」という意味になります。 avatarという名前は自由に決められるので、imageやphotoでも問題ありません。

4. form_withで画像アップロード用フォームを作る

4. form_withで画像アップロード用フォームを作る

次に、画面側（ビュー）で画像を選択するフォームを作ります。 Railsではform_withを使うのが基本です。 ファイルを送る場合は、file_fieldを使います。

<%= form_with model: @user do |f| %>
  <div>
    <%= f.label :avatar, "プロフィール画像" %><br>
    <%= f.file_field :avatar %>
  </div>
  <%= f.submit "保存する" %>
<% end %>

これで「画像を選んで送信する」フォームが完成です。 file_fieldは、パソコンからファイルを選ぶための入力欄だと考えてください。

5. direct_uploadとは？大きな画像でも安心な仕組み

5. direct_uploadとは？大きな画像でも安心な仕組み

direct_uploadは、画像を直接保存先に送るための仕組みです。 通常のアップロードでは、いったんRailsサーバーを経由しますが、 direct_uploadを使うと負担を減らせます。

初心者の方は、「大きな画像でもエラーになりにくくなる便利機能」 くらいの理解で問題ありません。

<%= f.file_field :avatar, direct_upload: true %>

このオプションを付けるだけで、Railsが裏側の処理を自動で行ってくれます。

6. コントローラで画像を受け取る基本

6. コントローラで画像を受け取る基本

フォームから送られた画像は、コントローラで受け取ります。 文字のデータと同じように、Strong Parametersで許可します。

def user_params
  params.require(:user).permit(:name, :avatar)
end

avatarを許可しないと、画像は保存されません。 「受け取っていいデータの一覧に画像を追加する」と覚えてください。

7. アップロードした画像を画面に表示する

7. アップロードした画像を画面に表示する

保存した画像は、ビューで表示できます。 Active Storageでは、image_tagを使うのが基本です。

<% if @user.avatar.attached? %>
  <%= image_tag @user.avatar %>
<% end %>

attached?は、「画像があるかどうか」を確認するメソッドです。 画像がない状態で表示しようとしてエラーになるのを防げます。

8. 画像アップロードでよくある初心者のつまずき

8. 画像アップロードでよくある初心者のつまずき

初心者の方がよくつまずくポイントとして、「画像が保存されない」 「表示されない」といった問題があります。 多くの場合、Strong Parametersに画像が含まれていなかったり、 モデルにhas_one_attachedを書き忘れていることが原因です。

手順を一つずつ確認すれば、Railsの画像アップロードは決して難しくありません。 フォーム、モデル、コントローラの役割を意識して進めることが大切です。