Laravel use Illuminate\Http\Request が使えない。Authインポート時のエラー

Question

Laravelでtodoリストの作成をしています。バージョン最新
https://www.hypertextcandy.com/laravel-tutorial-authentication/
の記事を参考に進めているのですが、認証機能のコントローラーところで
エラーが発生しています。

<?php

namespace App\Http\Controllers;

use App\Http\Requests\CreateFolder;
use Illuminate\Http\Request;
use App\Models\Folder;
use Illuminate\Support\Facades\Auth;


class FolderController extends Controller
{
    public function showCreateForm()
    {
        return view('folders/create');
    }
    
    public function create(CreateFolder $request)
    {
    // フォルダモデルのインスタンスを作成する
    $folder = new Folder();
    // タイトルに入力値を代入する
    $folder->title = $request->title;
    // インスタンスの状態をデータベースに書き込む
    $folder->save();

    // ★ ユーザーに紐づけて保存
    Auth::user()->folders()->save($folder);

    return redirect()->route('tasks.index', [
        'id' => $folder->id,
    ]);
    }

}

folders()がundifinedとエラーが吐かれている状態です。
use Illuminate\Http\Request;に関してもis declared but not usedが起き、
use Illuminate\Support\Facades\Authを削除するとfolder()のエラーは解消します。

folder()はModelsのUser.phpは以下にあります。

<?php

namespace App\Models;

use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable;

    /**
     * The attributes that are mass assignable.
     *
     * @var string[]
     */
    protected $fillable = [
        'name',
        'email',
        'password',
    ];

    /**
     * The attributes that should be hidden for serialization.
     *
     * @var array
     */
    protected $hidden = [
        'password',
        'remember_token',
    ];

    /**
     * The attributes that should be cast.
     *
     * @var array
     */
    protected $casts = [
        'email_verified_at' => 'datetime',
    ];

    public function folders()
    {
        return $this->hasMany('App\Models\Folder');
    }


}

Authインポートでなぜこのようなエラーが起きるのでしょうか。

Answer 1

解説

この用法の use ステートメントは， PHP においては **「実際にファイルが存在するかどうか」を一切確認しません。**そのファイル内で短縮名を使えるようにするだけのものです。そのため，その記述それ自体は（PHPStan などの静的解析ツールを使わない限り）決してエラーを引き起こすことはありません。

• use ステートメントを消した状態で Auth::user()->folders()->save($folder); を実行すると，その Auth は同じ名前空間から計算されて App\Http\Controllers\Auth という名前を指すようになってしまいます。この存在しないクラスを App\Http\Controllers\Auth::user() として使ったら，当然別のエラーになるでしょう。
• もし use ステートメントも Auth::user() が含まれる文も消したのであれば正常に動くと思います。

更に根本的な原因について述べますと，チュートリアルの記事を読んだ限りでは

$ php artisan route:list

+--------+----------+-----------------------------------+------------------+------------------------------------------------------------------------+--------------+
| Domain | Method   | URI                               | Name             | Action                                                                 | Middleware   |
+--------+----------+-----------------------------------+------------------+------------------------------------------------------------------------+--------------+
|        | GET|HEAD | /                                 | home             | App\Http\Controllers\HomeController@index                              | web          |
|        | GET|HEAD | api/user                          |                  | Closure                                                                | api,auth:api |
|        | GET|HEAD | folders/create                    | folders.create   | App\Http\Controllers\FolderController@showCreateForm                   | web          |
|        | POST     | folders/create                    |                  | App\Http\Controllers\FolderController@create                           | web          |
|        | GET|HEAD | folders/{id}/tasks                | tasks.index      | App\Http\Controllers\TaskController@index                              | web          |
|        | GET|HEAD | folders/{id}/tasks/create         | tasks.create     | App\Http\Controllers\TaskController@showCreateForm                     | web          |
|        | POST     | folders/{id}/tasks/create         |                  | App\Http\Controllers\TaskController@create                             | web          |
|        | GET|HEAD | folders/{id}/tasks/{task_id}/edit | tasks.edit       | App\Http\Controllers\TaskController@showEditForm                       | web          |
|        | POST     | folders/{id}/tasks/{task_id}/edit |                  | App\Http\Controllers\TaskController@edit                               | web          |
|        | GET|HEAD | login                             | login            | App\Http\Controllers\Auth\LoginController@showLoginForm                | web,guest    |
|        | POST     | login                             |                  | App\Http\Controllers\Auth\LoginController@login                        | web,guest    |
|        | POST     | logout                            | logout           | App\Http\Controllers\Auth\LoginController@logout                       | web          |
|        | POST     | password/email                    | password.email   | App\Http\Controllers\Auth\ForgotPasswordController@sendResetLinkEmail  | web,guest    |
|        | GET|HEAD | password/reset                    | password.request | App\Http\Controllers\Auth\ForgotPasswordController@showLinkRequestForm | web,guest    |
|        | POST     | password/reset                    | password.update  | App\Http\Controllers\Auth\ResetPasswordController@reset                | web,guest    |
|        | GET|HEAD | password/reset/{token}            | password.reset   | App\Http\Controllers\Auth\ResetPasswordController@showResetForm        | web,guest    |
|        | GET|HEAD | register                          | register         | App\Http\Controllers\Auth\RegisterController@showRegistrationForm      | web,guest    |
|        | POST     | register                          |                  | App\Http\Controllers\Auth\RegisterController@register                  | web,guest    |
+--------+----------+-----------------------------------+------------------+------------------------------------------------------------------------+--------------+

からわかるとおり，該当ページには auth のミドルウェアが存在しません。そのため，認証していない状態でもアクセスできてしまいます。

また， Auth::user() は認証状態ではないときに使用すると** NULL を返します。**

よって，エラー原因は以下のように整理されます。

• チュートリアル記事に，認証が必須であるページに認証を要求する auth ミドルウェアを設定していない誤りがある。
• あなたがログインせずに /folders/create にアクセスしている。

対処

Route::get(/* ... */)->name(/* ... */);

↓

Route::middleware('auth')->group(function () {
    Route::get(/* ... */)->name(/* ... */);
});

こうすることで，この中に書いたものはすべて認証必須ということにできます。認証されていない状態でアクセスすると，強制的にログインページにリダイレクトされることになるかなと思います。