Ruby on Railsで画像のアップロードを実現する方法です。
今回はユーザーのアイコン画像登録を行います。
環境は以下の通りです。
・ruby ：2.5.3
・rails ：5.2.1
「画像を保存する」手順としては
- gemの「carrierwave」をインストール
- アップローダーの作成
- ユーザーモデルに画像のパスを格納するカラムの追加
- ユーザーモデルにアップローダーへマウントする記述を追加
- ビューでフォーム作成
- コントローラーで保存処理
という流れになります。
非常に簡単で、5分もあれば十分できると思いますので
サクっとやっていきましょう！
１．gemのcarrierwaveをインストール
Gemfileに以下の一文を追加して、bundle installをしましょう。
|
1 |
gem 'carrierwave' |
|
1 |
$bundle install |
インストールが完了すれば 1. は終わりです。
2．アップローダーの作成
ターミナルから以下のコマンドを入力し、アップローダーを作成します。
|
1 |
$rails g uploader image |
image部分は好きな名前にしてください。
これで 2. は終わりです。
3．ユーザーモデルに画像のパスを格納するカラムの追加
以下のコマンドを入力してカラムを追加しましょう。
|
1 |
$rails g migration AddImageToUsers image:string |
db/migrate/(日付)_add_image_to_users.rb というファイルができます。何も変更する必要はないですが、一応見ておくと、以下のようになっていると思います。
|
1 2 3 4 5 |
class AddImageToUsers < ActiveRecord::Migration[5.2] def change add_column :users, :image, :string end end |
これをデータベースに反映させるためにマイグレーションをしておきましょう。
|
1 |
$rails db:migrate |
これで 3. は完了です。
4．ユーザーモデルにアップローダーへマウントする記述を追加
次はmodelsのuser.rbファイルに以下の一文を追加します。
|
1 2 3 4 |
class User < ApplicationRecord ... mount_uploader :image, ImageUploader # これを追加 end |
これで 5. は完了です。これで画像を保存するために必要なものは揃いました。あとはコントローラーとビューで書いてやるだけです。
5．ビューでフォーム作成
ユーザーの画像を保存するのはユーザー情報の編集画面、editのアクションだと思いますので、editのビューでフォームの画像送信を追加します。以下に画像の変更だけのフォーム送信のサンプルをおいておきます。
|
1 2 3 4 5 6 7 8 9 |
<%= form_with(model: @user, url: user_path, method: :put, local: true) do |f| %> <% if @user.image? %> <%= image_tag @user.image.url %> <% else %> 画像が登録されていません。 <% end %> <%= f.file_field :image %> <%= f.submit '画像をアップロードする' %> <% end %> |
これで簡単な画像登録用のフォームができました。
（上の例では@userとあるようにログインしているユーザーの情報をコントローラーのeditアクションで@user変数に入れておかないとエラーになります。）
ここではフォームの送信先をuser_pathにしてput送信をしているので、ルーティングの情報を
|
1 |
$rails routes |
このコマンドで見ると以下のようになっていることから、
|
1 2 3 4 5 6 7 8 |
users GET /users(.:format) users#index POST /users(.:format) users#create new_user GET /users/new(.:format) users#new edit_user GET /users/:id/edit(.:format) users#edit user GET /users/:id(.:format) users#show PATCH /users/:id(.:format) users#update PUT /users/:id(.:format) users#update // ←これ DELETE /users/:id(.:format) users#destroy |
コントローラーのupdateアクションに保存処理を書いていけばよいことになります。
6．コントローラーで保存処理
それでは users_controller.rb の update アクションに保存処理を書いていきましょう。
まず先にストロングパラメーターにimageカラムを追加しておきます。
|
1 2 3 |
def user_params params.require(:user).permit(:email, :user_name, :password, :password_confirmation, :image) // :imageを追加 end |
それから保存処理を書きます。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
def update @user = User.find(params[:id]) # ログインしているユーザーかどうか判断 if current_user == @user if @user.update(user_params) flash[:success] = 'ユーザー情報を編集しました。' render :edit else flash.now[:danger] = 'ユーザー情報の編集に失敗しました。' render :edit end else redirect_to root_url end end |
これで完了です！
あとは実際に画面でアップロードをしてみましょう！
flashを書いているので成功すれば画面上部に「ユーザー情報を編集しました。」という文字が出ます。失敗すれば「ユーザー情報の編集に失敗しました。」という文字が出ます。
上手くいかないときは….？
もし画像登録が上手くいかないときは以下の点を確認してみるといいかもしれません。
・今回は画像をアップロードした際に、ユーザーのimageカラムのパスのみを更新していることになるので、更新時にパスワードなどのバリデーションが有効になっている場合はバリデーションにひっかかってしまい更新が出来ません。
・またファイル名が日本語の場合は上手くいかないかもしれないので英語に直してみましょう。
実際にやってみると以下のように表示されている画面から
ファイルを選択してアップロードしてみると、
同じ画面に帰ってきてアップロードした画像が表示されています。
ちなみに保存された画像は
public/uploads/user/image/(数字)のディレクトリに保存されているので確認しておきましょう！
