概要#

Laravel学習で自分がつまずいた部分を備忘録としてまとめています。
今回はフォームからの画像保存と表示方法に関する記事です。

つまずいたポイント#

食べログ風のアプリを作成しようとした所、投稿の画像表示につまづきました。
具体的には、
①画像をstorage/app/publicに保存
②storage/app/publicに保存した画像の表示
に苦戦しました。。

苦戦の末、下記の手順で解決出来たので記事にしてみました。

①画像をstorage/app/publicに保存####

②シンボリックリンクを作成####

③assetヘルパを用いて表示####

書いて見ると非常にシンプルですね。。
以下、記事内容です！

画像の保存#

画像の保存と画像の表示は切り分けて考えます。

保存方法から記述していきます。
まずテーブルと追加用フォームを用意。

imagesテーブル

      public function up()
    {
        Schema::create('images', function (Blueprint $table) {
            $table->increments('id');
            $table->string('shop_name');
            $table->string('path');
            $table->string('spot');
            $table->timestamps();
        });
    }

今回はpathカラムに画像名を代入し、それをビューで表示します。

フォームはこんな感じ。

■コントローラ###

フォームから飛んだ画像データを、コントローラで保存します。

ImageController

     public function add(Request $request){
　　　　　　　①画像データを変数$pathに代入＋storage/app/publicに保存
            $path = $request->path->store('public');
            
　　　　　　　②変数$imageのpathカラムに$pathのbasenameを代入
            $image = [
            'shop_name' => $request->shop_name,
            'spot'  => $request->spot,
            'path'  => basename($path)
            ];
            \DB::table('images')->insert($image);

            $images = \App\Image::all();
            return view('user.home',compact('images'));
    }

①Requestから受け取った画像データを変数pathに代入。同時に,storeメソッドを使って保存します。画像の保存先ですが、storage/app/public 内に保存します。storeメソッドの引数には('public')を指定します。

②変数imageを作成。pathカラムに、画像データのbasenameと言う値を代入して保存。テーブルに追加してビューに渡します。

上記がフォームから来た画像の保存処理です。画像データをstorage/app/publicに保存。そして画像のbasenameを投稿の'path'カラムに代入しました。後述しますがビュー上で、このbasenameを参照して画像を表示させます。

失敗例###

storeメソッドを用いた保存について、自分の失敗例を挙げておきます。

ImageController

     public function add(Request $request){
　　　　　　　
            $path = $request->path->store('storage/app/public');
            
    }

storage/app/publicに画像を保存したいために、storeメソッドの引数に('storage/app/public')を設定していました。
結果は下記の通りです。

storage/appの下に、更にstorage/app/publicが出来ています。
これは、storeメソッドのデフォルト名前空間が('storage/app')になっているために起きた失敗でした。デフォルトの('storage/app')の下に、更に('storage/app/public')が追加された感じですね。
なので, storeメソッドを用いてstorage/app/publicに保存したい場合, 引数をstore('public')とします。

次に保存した画像の表示方法です。

画像の表示(シンボリックリンク)#

先ほどstorage/app/publicに保存した画像をビュー上で表示していきます。
ただし、storageフォルダに保存した画像には直接アクセス出来ません。Laravelで作ったアプリケーションが公開されるとき、アクセス出来るフォルダはpublicフォルダの中身のみだからです。
そこで登場するのがシンボリックリンクです。
下記コマンドで実行します。

ターミナル

    php artisan storage:link

これにより、publicの中にstorageフォルダが生成されます。(シンボリックリンク)
これは、storageフォルダへのショートカットキーのようなものです。
storage/app/public内に画像が保存されたら、このシンボリックリンクの中身にも反映されます。publicフォルダの中にあるので、アクセス可能と言う訳ですね。
このシンボリックリンクを用いて、ビュー上で画像を表示していきます。

後はビュー上でassetヘルパを使い、シンボリックリンク内の画像を表示します。
assetヘルパを使う事でpublicフォルダ内にアクセス出来ます。

<img src="{{ asset( 'storage/'.$image->path )}}"　>

【表示結果】

こうですね。無事に画像表示出来ました。

まとめ##

以上、Laravelにおけるフォームからの画像保存と表示でした。
①storeメソッドを用いてstorage/app/pulicに画像保存
②publicフォルダ内にシンボリックリンクを生成
③assetヘルパを用いて画像表示。
という流れですね。

最後まで読んで頂きありがとうございました！