Laravel 5.5でファイルアップロードしファイル名、保存先を指定して保存したい

Question

Laravel 5.5 でファイルアップロードをしようとしています。
ドキュメントの
https://readouble.com/laravel/5.5/ja/filesystem.html
を参考にしているのですが、
https://readouble.com/laravel/5.5/ja/requests.html
という情報もあったりで、悩んでいます。
上のリンクの「ファイルアップロード」という項目が相当すると思い
ためしてみようとしているのですが、

$path = $request->file('avatar')->store('avatars');

の[avater]や[avatars]の部分が何を指しているのかが分かりません。
どこに保存されるのか？など、よくわからない点が多く前に進みません。

また下側のリンクのほうを試してみたら、

$file = $request->file('photo');
$file = $request->photo;

このphoto という部分はname属性なのでしょうか？
このマニュアルの理解が進まない状況で・・・という段階です。

namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;


class UploadController extends Controller
{
	//view
	public function index(){
		return view('index');
	}

	//postした後の処理
	public function add(Request $request){
		$this->validate($request, [
			'file' => 'required|image|max:10000000',
		]);
		if ($request->file('file')->isValid()){
			//アップロード成功時の処理
			$path = $request->file('file')->storeAs('files', $request->user()->id);
			return view('upload_success');
		}
	}
}

こんな感じで作ろうとしていますが一行に前に進めずにいます。
お恥ずかしい段階ですが、保存先とファイルの指定の方法などを教えてください。
宜しくお願いいたします。

Answer 1

お恥ずかしい段階ですが、保存先とファイルの指定の方法などを教えてください。

ファイル名の指定がしたい場合は既に書かれている通りstoreAsメソッドを使用します。
保存先ディレクトリも変更することは可能ですが、特別な理由がない限りはstorage/appディレクトリ配下にしておいたほうが良いと思います。（Laravelはそのように設計されているため

深読みし過ぎかもしれませんが、コードを見るともしかして画像をアップロードしてそれをブラウザから見れるようにもしたい感じですかね？
もしそうだったら、
https://readouble.com/laravel/5.5/ja/filesystem.html
にもある程度書かれていますが、パブリックディスクへ保存すると実現できます。以下のようにすると出来ると思います。

コマンドラインで次のコマンドを実行（http://yourdomain/storage/ 配下へのアクセスをstorage/app/public配下へ流すためのsymlinkを貼る

php artisan storage:link

ファイルアップロード時は以下のメソッドで保存する（第3引数の'public'はstorage/app/public配下へファイルを保存する指定

$path = $request->file('avatar')->storeAs(
    'avatars', 'your_filename', 'public'
);

ブラウザから以下のようなURLでアクセスしてみる（ファイル拡張子はアップロードしたファイル次第）

http://yourdomain/storage/avatars/your_filename.png

Answer 2

簡単なサンプルを元に説明してみます。

blade(一部抜粋)

    <form action="{{ route('hogehoge') }}" method="post" class="form-horizontal" style="margin-top: 50px;" enctype="multipart/form-data">
        {{ csrf_field() }}

        <div class="form-group">
            <label class="col-sm-3 control-label" for="avatar">ファイル</label>
            <div class="col-sm-9">
                <input type="file" name="avatar" class="form-control" placeholder="ファイル！">
            </div>
        </div>
        <div class="form-group">
            <div class="col-sm-offset-3 col-sm-9">
                <button type="submit" class="btn btn-primary btn-block">新規登録</button>
            </div>
        </div>
    </form>

Controller

    public function post(Request $request){
        $path = $request->file('avatar')->store('avatars');
        echo $path;
        return View ('fugafuga');
    }

上記の動作をすると、view上には

avatars/2K79bued7oHcR9mY09FP3OpAHiVR61wrDbI53b7P.txt

という文字が表示されます。

1つずつ説明していきましょう。

まずは、

[avater]や[avatars]の部分が何を指しているのかが分かりません

という事ですが、avatarはbladeに指定されているname属性を指しています。次にavatarsはアップロードされたファイルのフォルダ名を示しています。

上記の処理を実行すると、storage/app/avatarsというフォルダが作成されて、そのフォルダの下にはlaravelが自動的に一意の名前を付与したファイルが保存されることとなります。例でいうところの2K79bued7oHcR9mY09FP3OpAHiVR61wrDbI53b7P.txtという文字列です。
もし、ファイル名を自分でコントロールしたい場合はstoreAsを使いましょう。

以下、readoubleより抜粋

$path = $request->file('avatar')->storeAs(
    'avatars', $request->user()->id
);

この場合のファイルの保存先は、strage/app/avatars/ログインユーザーのidとなります。