Laravel コントローラー入門 — 生成 / resource / invokable / DI / バリデーション

コントローラーの生成

# 基本
php artisan make:controller PostController

# CRUD 7 メソッド入りのリソースコントローラ
php artisan make:controller PostController --resource

# API リソース（create/edit 無し、5 メソッド）
php artisan make:controller Api/PostController --api

# モデルと連携（型ヒント自動）
php artisan make:controller PostController --resource --model=Post

# シングルアクション（__invoke のみ）
php artisan make:controller SendWelcomeMail --invokable

基本的なコントローラ

namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    // 一覧
    public function index()
    {
        $posts = Post::latest()->paginate(20);
        return view('posts.index', compact('posts'));
    }

    // 詳細
    public function show(Post $post)             // ← Route Model Binding
    {
        return view('posts.show', compact('post'));
    }

    // フォーム
    public function create()
    {
        return view('posts.create');
    }

    // 保存
    public function store(Request $request)
    {
        $data = $request->validate([
            'title' => 'required|string|max:255',
            'body'  => 'required|string',
        ]);
        $post = Post::create($data + ['user_id' => $request->user()->id]);
        return redirect()->route('posts.show', $post)
            ->with('status', '保存しました');
    }

    // 更新
    public function update(Request $request, Post $post)
    {
        $this->authorize('update', $post);
        $post->update($request->validate([
            'title' => 'required|string|max:255',
            'body'  => 'required|string',
        ]));
        return redirect()->route('posts.show', $post);
    }

    // 削除
    public function destroy(Post $post)
    {
        $this->authorize('delete', $post);
        $post->delete();
        return redirect()->route('posts.index');
    }
}

リソースルートとコントローラの対応

シングルアクションコントローラ

// php artisan make:controller SendWelcomeMail --invokable

class SendWelcomeMail extends Controller
{
    public function __invoke(Request $request, User $user)
    {
        Mail::to($user)->send(new Welcome($user));
        return back()->with('status', 'sent');
    }
}

// ルート定義
Route::post('/users/{user}/welcome', SendWelcomeMail::class);

依存性注入（DI）

// メソッド DI（HTTP リクエストごとに解決）
public function store(Request $request, PostService $service)
{
    $post = $service->create($request->validated());
    return redirect()->route('posts.show', $post);
}

// コンストラクタ DI
class PostController extends Controller
{
    public function __construct(private PostService $service) {}

    public function index()
    {
        return $this->service->latest();
    }
}

バリデーション（3 通り）

// 方法 A: コントローラ内 (簡単)
public function store(Request $request)
{
    $data = $request->validate([
        'title' => 'required|string|max:255',
        'tags'  => 'array',
        'tags.*'=> 'string|max:50',
    ]);
}

// 方法 B: FormRequest クラスに切り出し (推奨)
// php artisan make:request StorePostRequest
class StorePostRequest extends FormRequest
{
    public function authorize(): bool { return true; }
    public function rules(): array
    {
        return [
            'title' => 'required|string|max:255',
            'body'  => 'required|string',
        ];
    }
    public function messages(): array
    {
        return ['title.required' => 'タイトルは必須です'];
    }
}
public function store(StorePostRequest $request) {
    $post = Post::create($request->validated());
}

// 方法 C: Validator ファサード（細かい制御）
$validator = Validator::make($request->all(), [...]);
if ($validator->fails()) {
    return back()->withErrors($validator)->withInput();
}

ミドルウェアの適用

class PostController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth');
        $this->middleware('verified')->only(['store', 'update', 'destroy']);
        $this->middleware('can:update,post')->except(['index', 'show']);
    }
}

// あるいはルート定義側で
Route::resource('posts', PostController::class)
    ->middleware(['auth', 'verified']);

レスポンスのバリエーション

// ビュー
return view('posts.show', compact('post'));

// JSON
return response()->json(['ok' => true, 'data' => $post]);

// API Resource
return new PostResource($post);
return PostResource::collection($posts);

// ステータスコード
return response()->json([...], 201);
abort(404, 'Post not found');
abort_if(! $user->is_admin, 403);

// リダイレクト
return redirect('/dashboard');
return redirect()->route('posts.show', $post);
return back()->withInput()->withErrors(['title' => 'NG']);

// ファイルダウンロード
return response()->download(storage_path('app/report.pdf'));
return response()->streamDownload(fn () => print($csv), 'report.csv');

ページネーション

public function index()
{
    $posts = Post::with('user')->latest()->paginate(20);
    return view('posts.index', compact('posts'));
}

@foreach ($posts as $post)
  <article>
    <h2>{{ $post->title }}</h2>
  </article>
@endforeach

{{ $posts->links() }}   {{-- ページネーション UI --}}
{{ $posts->total() }}   {{-- 合計件数 --}}
{{ $posts->currentPage() }}

FAQ

Q: コントローラを名前空間で分けたい
A: App\Http\Controllers\Admin\UserController 等。make:controller Admin/UserController でフォルダ付きで生成。

Q: 単体テストでコントローラをテストしたい
A: HTTP テスト機能で $this->get('/posts')->assertStatus(200)。コントローラ単体ではなくルート経由でテストするのが Laravel 流。

Q: API と Web で同じコントローラを使い回したい
A: アクション内で $request->wantsJson() や $request->is('api/*') で分岐、または別コントローラに分けるのが推奨。