Laravel ローカルにアップロードした画像をダウンロードする

# 目次

- Macのローカルで作成したLaravelアプリで画像ファイルアップロードしたものを、ダウンロードするボタンを設置する方法をまとめる

# 実施環境

- ハードウェア環境

| 項目 | 情報 |
| --- | --- |
| OS | macOS Catalina(10.15.5) |
| ハードウェア | MacBook Pro (13-inch, 2020, Four Thunderbolt 3 ports) |
| プロセッサ | 2 GHz クアッドコアIntel Core i5 |
| メモリ | 32 GB 3733 MHz LPDDR4 |
| グラフィックス | Intel Iris Plus Graphics 1536 MB |

- ソフトウェア環境

| 項目 | 情報 | 備考 |
| --- | --- | --- |
| PHP バージョン | 7.4.8 | Homebrewを用いてこちらの方法で導入→[Mac HomebrewでPHPをインストールする](https://qiita.com/miriwo/items/cd54077aad7e139cf518) |
| Laravel バージョン | 6.X | commposerを用いてこちらの方法で導入→[Mac Laravelの環境構築を行う](https://qiita.com/miriwo/items/adaaaeecae69d6392e08) |
| MySQLバージョン | 8.0.19 for osx10.13 on x86_64 | Homwbrewを用いてこちらの方法で導入→[Mac HomebrewでMySQLをインストールする](https://qiita.com/miriwo/items/ef6a064bc545fbea29d9) |

# 前提条件

- 下記記事の作業が実行できていること
    - [Laravel ローカルに画像をアップロードし表示する]()

# 前提情報

- 本記事はMacのローカルで作成されたLaravelアプリにアップロードされたファイルをダウンロードするボタンを作成する。
- 本記事の作業完了したソースは下記にアップしてある。
    - [https://github.com/miriwo0104/laravel6_image/tree/image_download_local/master](https://github.com/miriwo0104/laravel6_image/tree/image_download_local/master)

# 概要

1. ルーティングファイルの記載
1. コントローラファイルの記載
1. ビューファイルの作成と記載
1. 確認

# 詳細

- 下記の説明で実行するコマンドはすべてMacのローカルのターミナルで実行するものとし、実行場所はアプリ名ディレクトリであるlaravel6_imageディレクトリとする。

1. ルーティングファイルの記載（本作業完了後のソースコードはこちら→[https://github.com/miriwo0104/laravel6_image/tree/image_download_local/01_route](https://github.com/miriwo0104/laravel6_image/tree/image_download_local/01_route)）
    1. 下記コマンドを実行してルーティングファイルを開く。
        ```terminal
        $ vi routes/web.php
        ```
    1. 下記のルーティング情報を記載する。

        ```laravel6_image/routes/web.php
        // ダウンロード用
        Route::post('/download', 'ImageController@download')->name('download');
        ```
    1. 記載後のルーティングファイルの全内容を下記に記載する。

        ```laravel6_image/routes/web.php
        <?php
        
        /*
        |--------------------------------------------------------------------------
        | Web Routes
        |--------------------------------------------------------------------------
        |
        | Here is where you can register web routes for your application. These
        | routes are loaded by the RouteServiceProvider within a group which
        | contains the "web" middleware group. Now create something great!
        |
        */
        
        Route::get('/', function () {
            return view('welcome');
        });
        // 画像アップロードページ用
        Route::get('/input', 'ImageController@input')->name('input');
        
        // 画像アップロード処理用
        Route::post('/upload', 'ImageController@upload')->name('upload');
        
        // 画像一覧ページ用
        Route::get('/output', 'ImageController@output')->name('output');
        
        // 画像詳細ページ用
        Route::get('/detail/{images_id}', 'ImageController@detail')->name('detail');
        
        // 画像表示ページ用
        Route::get('/display/{images_id}', 'ImageController@display')->name('display');
        
        // 下記を追記
        // ダウンロード用
        Route::post('/download', 'ImageController@download')->name('download');
        ```
1. コントローラファイルの記載（本作業完了後のソースコードはこちら→[https://github.com/miriwo0104/laravel6_image/tree/image_download_local/02_controller](https://github.com/miriwo0104/laravel6_image/tree/image_download_local/02_controller)）
    1. 下記コマンドを実行して作成したコントローラファイルを開く。

        ```terminal
        $ vi app/Http/Controllers/ImageController.php 
        ```
    1. 下記のようにコントローラファイルの内容を追記修正する。追記修正後のコントローラファイルの全体の内容を下記に記載する。

        ```laravel6_image/app/Http/Controllers/ImageController.php
        <?php
        
        namespace App\Http\Controllers;
        
        use Illuminate\Http\Request;
        use App\Models\Image;
        use Illuminate\Support\Facades\Storage;
        
        class ImageController extends Controller
        {
            public function input()
            {
                return view('images/input');
            }
        
            public function upload(Request $request)
            {
        
                $this->validate($request, [
                    'file' => [
                        // 空でないこと
                        'required',
                        // アップロードされたファイルであること
                        'file',
                        // 画像ファイルであること
                        'image',
                        // MIMEタイプを指定
                        'mimes:jpeg,png',
                    ]
                ]);
        
                if ($request->file('file')->isValid([])) {
                
                    $file_name= $request->file('file')->getClientOriginalName(); // オリジナルファイルのファイル名の取得
                    $file_path= Storage::putFile('/images', $request->file('file'), 'public'); // ファイルのアップロードとアップロードパスの取得
        
                    $image_info = new Image();
                    $image_info->file_path = $file_path;
                    $image_info->file_name = $file_name;
                    $image_info->save();
        
                    return redirect('/');
                }else{
                    return redirect(route('input'));
                }
        
            }
        
            public function output()
            {
                $image_infos = Image::select('*')->get();
                return view('images.output', ['image_infos' => $image_infos]);
            }
        
            public function detail($image_id)
            {
                $image_info = Image::find($image_id);
                return view('images.detail', ['image_info' => $image_info]);
            }
        
            public function display($image_id)
            {
                $image_info = Image::find($image_id);
                return Storage::response($image_info['file_path'], $image_info['file_name']);
            }
        
            // 下記を追記
            public function download(Request $request)
            {
                $image_info = Image::find($request['id']);
                return Storage::download($image_info['file_path']);
            }
            // 上記までを追記する
        }
        ```
1. ビューファイルの作成と記載（本作業完了後のソースコードはこちら→[https://github.com/miriwo0104/laravel6_image/tree/image_download_local/03_view](https://github.com/miriwo0104/laravel6_image/tree/image_download_local/03_view)）
    1. 下記コマンドを実行してビューファイルを作成して開く。

        ```terminal
        $ vi resources/views/images/output.blade.php
        ```
    1. 下記のようにビューファイルを修正する

        ```laravel6_image/resources/views/images/input.blade.php
        <h1>アップロードされた画像一覧</h1>
        
        @foreach ($image_infos as $image_info)
            <hr>
            <img src="{{asset('storage/' . $image_info['file_path'])}}" alt="{{asset('storage/' . $image_info['file_path'])}}">
            <br>
            <a href="{{route('detail', ['images_id' => $image_info['id']])}}">
                <button type="submit">詳細</button>
            </a>
            <br>
            <a href="{{route('display', ['images_id' => $image_info['id']])}}">
                <button type="submit">表示</button>
            </a>
            {{-- 下記を追記 --}}
            <br>
            <a href="{{route('download')}}">
                <button type="submit">ダウンロード</button>
            </a>
            {{-- 上記までを追記 --}}
        @endforeach
        ```
    1. 下記コマンドを実行してビューファイルを作成して開く。

        ```terminal
        $ vi resources/views/images/detail.blade.php
        ```
    1. 下記の内容をビューファイルに記載する。

        ```laravel6_image/resources/views/images/detail.blade.php
        <h1>画像の詳細</h1>
        
        <img src="{{asset('storage/' . $image_info['file_path'])}}" alt="{{asset('storage/' . $image_info['file_path'])}}">
        <br>
        <a href="{{route('display', ['images_id' => $image_info['id']])}}">
            <button type="submit">表示</button>
        </a>
        {{-- 下記を追記 --}}
        <br>
        <a href="{{route('download')}}">
            <button type="submit">ダウンロード</button>
        </a>
        {{-- 上記までを追記 --}}
        <ul>
            <li>ID: {{$image_info['id']}}</li>
            <li>アップロード日: {{$image_info['created_at']}}</li>
        </ul>
        ```
1. 確認
    1. 下記コマンドを実行してローカルサーバを起動する。

        ```terminal
        $ php artisan serve 
        ```
    1. 下記にアクセスする。
        - [http://127.0.0.1:8000/output](http://127.0.0.1:8000/output)
    1. 登録してある画像が表示されることを確認する。

        ![127_0_0_1_8000_output-5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/306417/3c469cb0-94bb-260e-9620-7f12b0a5ee53.png)

    1. 画像下部の「ダウンロード」をクリックする。

        ![127_0_0_1_8000_output-4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/306417/3e04dc39-3ca5-09e5-cf14-a4ec58720166.png)

    1. 自分のPCにアップロードしたファイルがアップロード時のファイル名でダウンロードできることを確認する。
    1. 画像下部の「詳細」をクリックする。

        ![127_0_0_1_8000_output-5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/306417/0add22ad-8685-5401-144a-6da206e26947.png)

    1. 画像下部の「ダウンロード」をクリックする。

        ![127_0_0_1_8000_detail_1-2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/306417/6d8a550b-0127-4409-a044-fd64d87b4df0.png)

    1. 自分のPCにアップロードしたファイルがアップロード時のファイル名でダウンロードできることを確認する。

# 参考文献

- [LaravelでStorageを使ったファイルおよびディレクトリの操作をまとめてみた](https://qiita.com/George_love_game/items/50081988363cf2fa1bca)
- [https://readouble.com/laravel/6.x/ja/filesystem.html](https://readouble.com/laravel/6.x/ja/filesystem.html)
- [Laravel 6.x ファイルストレージ](https://readouble.com/laravel/6.x/ja/filesystem.html)