はじめに

Laravel の開発中に、AuthController に関するエラー（"Class "App\Http\Controllers\AuthController" does not exist"）が発生したので、原因と対処方法を備忘録としてまとめておきます。

個人の備忘録程度の走り書きとなっておりますが、温かい目で見守っていただければ幸いです。

書こうと思ったきっかけ

個人的に PHP のキャッチアップを目的として Laravel を学習しており、その過程でよくあるエラーに遭遇しました。Laravel 初学者として、後から振り返れるように記録しておきます。

内容

エラー内容は次の通りです：

Illuminate\Contracts\Container\BindingResolutionException
Target class [App\Http\Controllers\AuthController] does not exist.

このエラーは Laravel が AuthController クラスを認識できていないときに発生します。

実際につまづいた画面

実際にはファイルが存在しているにもかかわらず、以下のような原因が考えられました。

対処ステップまとめ

1. `AuthController.php` の中身が正しいか確認

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Hash;

class AuthController extends Controller
{
    public function showRegisterForm()
    {
        return view('auth.register');
    }

    public function register(Request $request)
    {
        $validated = $request->validate([
            'name' => 'required|max:255',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:6|confirmed',
        ]);

        User::create([
            'name' => $validated['name'],
            'email' => $validated['email'],
            'password' => Hash::make($validated['password']),
        ]);

        return redirect('/register')->with('success', 'ユーザー登録が完了しました');
    }
}

※ 同じファイルに namespace や class が重複定義されていないかも確認すること。

2. ファイル名の確認（大文字小文字も）

ls -l src/app/Http/Controllers/AuthController.php

3. オートロード再生成とキャッシュ削除

docker compose exec php-app composer dump-autoload
docker compose exec php-app php artisan config:clear
docker compose exec php-app php artisan route:clear
docker compose exec php-app php artisan view:clear

4. ルート確認

docker compose exec php-app php artisan route:list

ここで /register が表示されていれば、Laravel 側でルートが認識されていることになります。

実際の画面

 ~/Desktop/moromoro/php-docker  (git)-[main]-  docker compose exec php-app php artisan route:list

WARN[0000] /Users/hondaakiratarou/Desktop/moromoro/php-docker/docker-compose.yml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion 

  GET|HEAD   / .................................................................. 
  GET|HEAD   hello ........................................ HelloController@index
  POST       hello ......................................... HelloController@post
  GET|HEAD   message ................................... MessageController@create
  POST       message .................................... MessageController@store
  GET|HEAD   register ........................... AuthController@showRegisterForm
  POST       register ................................... AuthController@register
  GET|HEAD   storage/{path} ....................................... storage.local
  GET|HEAD   up ................................................................. 

                                                               Showing [9] routes

まとめ

Laravel のエラーは、構文ミスやファイル認識のズレから起きることが多いです。

特に、クラス名とファイル名、名前空間の整合性、キャッシュのリセットは重要なチェックポイントです。

Laravel 初学者の方の参考になれば幸いです...！