【第四弾】Laravel入門資料

ミドルウェアと権限管理

認証機能だけでは不十分です。誰が何をできるかを管理する権限管理（認可）が必要です。
この章では、ミドルウェアとロールを使った権限管理を学びます。

認証と認可の違い

前章で学んだのは認証（Authentication）です。
この章で学ぶのは認可（Authorization）です。

// 認証：ログインしているか確認
if (auth()->check()) {
    echo 'ログインしています';
}

// 誰がログインしているか
echo auth()->user()->name;  // 「田中太郎」

// 認可：管理者権限を持っているか確認
if (auth()->user()->isAdmin()) {
    echo '管理者です';
}

// 特定のロールを持っているか
if (auth()->user()->hasRole('admin')) {
    echo '管理者権限があります';
}

具体例で理解しよう

Webアプリケーションの例

✅ 認証と認可の違いが理解できました！

ミドルウェアの仕組み

ミドルウェアは、コントローラーが実行される前にチェックを行う「番人」のような仕組みです。

ミドルウェアファイルの構造

まず、ミドルウェアファイルがどう書かれているか見てみましょう。

// app/Http/Middleware/Authenticate.php (Laravel標準のミドルウェア)

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class Authenticate
{
    public function handle(Request $request, Closure $next)
    {
        // ログインしているかチェック
        if (!auth()->check()) {
            // ログインしていない → ログインページへリダイレクト
            return redirect('/login');
        }

        // ログインしている → 次の処理(コントローラー)へ進む
        return $next($request);
    }
}

$next($request) の意味

ユーザーがアクセス
   ↓
[ミドルウェアの handle() メソッドが実行される]
   ↓
条件チェック
   ↓
✅ OK → return $next($request);     ← コントローラーへ進む
❌ NG → return redirect('/login');  ← ここで処理を止める

具体例: 管理者チェックのミドルウェア

// app/Http/Middleware/IsAdmin.php

class IsAdmin
{
    public function handle(Request $request, Closure $next)
    {
        // 1. ログインしているかチェック
        if (!auth()->check()) {
            return redirect('/login');  // ← ここで止まる
        }

        // 2. 管理者かチェック
        if (!auth()->user()->isAdmin()) {
            return abort(403);  // ← ここで止まる
        }

        // 3. 両方OKならコントローラーへ
        return $next($request);  // ← コントローラー実行
    }
}

public function handle(Request $request, Closure $next)
{
    // リクエスト前の処理（今回使う）

    $response = $next($request);  // コントローラー実行

    // レスポンス後の処理（今回は使わない）
    // 例: Log::info('アクセスログ');

    return $response;
}

Laravelの標準ミドルウェア

authミドルウェアの使い方

// routes/web.php

// 方法1: 個別のルートに適用
Route::get('/dashboard', [DashboardController::class, 'index'])
    ->middleware('auth');

// 方法2: 複数のルートにまとめて適用
Route::middleware(['auth'])->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
    Route::get('/profile', [ProfileController::class, 'show']);
    Route::get('/settings', [SettingsController::class, 'index']);
});

// 方法3: コントローラーで適用
class DashboardController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth');
    }

    public function index()
    {
        return view('dashboard');
    }
}

✅ ミドルウェアの仕組みが理解できました！

ロールテーブルの設計

まずは、usersテーブルにroleカラムを追加するシンプルな方法を学びます。

ステップ1: マイグレーション作成

# マイグレーション作成
php artisan make:migration add_role_to_users_table

// database/migrations/xxxx_add_role_to_users_table.php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->enum('role', ['admin', 'user'])->default('user')->after('name');
        });
    }

    public function down(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('role');
        });
    }
};

# マイグレーション実行
php artisan migrate

ステップ2: Userモデルにメソッド追加

// app/Models/User.php

class User extends Authenticatable
{
    protected $fillable = [
        'name',
        'email',
        'password',
        'role',  // ← 追加
    ];

    /**
     * 管理者かどうか
     */
    public function isAdmin(): bool
    {
        return $this->role === 'admin';
    }

    /**
     * 特定のロールを持っているかチェック
     */
    public function hasRole(string $role): bool
    {
        return $this->role === $role;
    }

    /**
     * いずれかのロールを持っているかチェック
     */
    public function hasAnyRole(array $roles): bool
    {
        return in_array($this->role, $roles);
    }
}

ステップ3: Tinkerでロールを設定してみよう

# Tinkerを起動
php artisan tinker

// ユーザーを取得
$user = User::find(1);

// 現在のロールを確認
$user->role;
// => "user"（デフォルト）

// 管理者に昇格
$user->role = 'admin';
$user->save();

// 管理者かどうか確認
$user->isAdmin();
// => true

$user->hasRole('admin');
// => true

// 一般ユーザーを作成
$normalUser = User::create([
    'name' => '一般ユーザー',
    'email' => 'user@example.com',
    'password' => 'password',
    'role' => 'user',  // デフォルトは'user'なので省略可
]);

$normalUser->isAdmin();
// => false

$normalUser->hasRole('user');
// => true

✅ シンプルなロール管理が実装できました！

カスタムミドルウェアの作成

管理者のみアクセス可能なページを作るため、カスタムミドルウェアを作成します。

ステップ1: ミドルウェア作成

# ミドルウェア作成
php artisan make:middleware IsAdmin

// app/Http/Middleware/IsAdmin.php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class IsAdmin
{
    /**
     * Handle an incoming request.
     */
    public function handle(Request $request, Closure $next): Response
    {
        // ログインしているか確認
        if (!auth()->check()) {
            return redirect('/login');
        }

        // 管理者かどうか確認
        if (!auth()->user()->isAdmin()) {
            abort(403, 'このページにアクセスする権限がありません。');
        }

        // 管理者なら次の処理へ
        return $next($request);
    }
}

ステップ2: ミドルウェアを登録

// bootstrap/app.php (Laravel 12)

use App\Http\Middleware\IsAdmin;
use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware): void {
        // ミドルウェアのエイリアスを登録
        $middleware->alias([
            'admin' => IsAdmin::class,
        ]);
    })
    ->withExceptions(function (Exceptions $exceptions): void {
        //
    })->create();

ステップ3: ルートに適用

認証セクションで作成した dashboard ルートを管理者専用に改修します。

// routes/web.php

// 管理者専用ページ (adminミドルウェアでグループ化)
Route::middleware(['admin'])->group(function () {
    Route::get('/dashboard', function () {
        return view('dashboard');
    })->name('dashboard');
});

// 複数のミドルウェアを適用する例
Route::middleware(['auth', 'verified', 'admin'])->group(function () {
    // このグループ内のルートは3つのミドルウェアを通過する
});

実践: 実際にアクセスしてテストしてみよう

ステップ1: Tinkerでユーザーを作成

php artisan tinker

// 管理者を作成
User::create([
    'name' => '管理者',
    'email' => 'admin@example.com',
    'password' => bcrypt('password'),
    'role' => 'admin',
]);

// 一般ユーザーを作成
User::create([
    'name' => '一般ユーザー',
    'email' => 'user@example.com',
    'password' => bcrypt('password'),
    'role' => 'user',
]);

ステップ2: ブラウザでアクセスして確認

✅ カスタムミドルウェアで権限管理ができました！

一般ユーザー用の画面を作成

管理者以外の一般ユーザーもログイン後にアクセスできる画面を作成しましょう。

ステップ1: 一般ユーザー用ビューの作成

<!-- resources/views/home.blade.php -->
<h1>ホーム画面</h1>
<p>ようこそ、{{ auth()->user()->name }}さん</p>
<p>あなたは一般ユーザーです。</p>

ステップ2: ルートの追加

// routes/web.php

// 管理者専用ページ
Route::middleware(['admin'])->group(function () {
    Route::get('/dashboard', function () {
        return view('dashboard');
    })->name('dashboard');
});

// 一般ユーザー用ページ (認証のみ必要)
Route::middleware(['auth'])->group(function () {
    Route::get('/home', function () {
        return view('home');
    })->name('home');
});

ステップ3: ログイン後の振り分け

ログイン後に役割に応じて適切な画面へリダイレクトするように、LoginControllerを修正します。

// app/Http/Controllers/Auth/LoginController.php

public function login(Request $request)
{
    $credentials = $request->validate([
        'email' => 'required|email',
        'password' => 'required',
    ]);

    if (Auth::attempt($credentials)) {
        $request->session()->regenerate();

        // 管理者なら /dashboard へ、一般ユーザーなら /home へ
        if (auth()->user()->isAdmin()) {
            return redirect()->route('dashboard');
        }

        return redirect()->route('home');
    }

    return back()->withErrors([
        'email' => 'メールアドレスまたはパスワードが正しくありません。',
    ])->onlyInput('email');
}

実践: 動作確認

✅ 役割に応じた画面の振り分けが実装できました！

まとめ

🎉 ミドルウェアによる権限管理が完璧に理解できました！