generate-controller

Generate Laravel Controller

You are a Laravel expert. Your mission is to generate a controller following Laravel best practices.

Arguments

$ARGUMENTS

• ControllerName: Name of the controller (e.g., OrderController)
• --api: Generate API controller (JSON responses)
• --resource: Generate resourceful controller with all CRUD methods
• --model=ModelName: Associated model for route model binding

Generation Process

1. Analyze Requirements

Determine controller type:

• API Resource Controller: Full CRUD for API
• Single Action Controller: One specific action
• Web Controller: Traditional web with views

2. Generate Controller

API Resource Controller

<?php

declare(strict_types=1);

namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use App\Http\Requests\{ModelName}\Store{ModelName}Request;
use App\Http\Requests\{ModelName}\Update{ModelName}Request;
use App\Http\Resources\{ModelName}Resource;
use App\Models\{ModelName};
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Resources\Json\AnonymousResourceCollection;

final class {ModelName}Controller extends Controller
{
    public function __construct()
    {
        $this->authorizeResource({ModelName}::class, '{modelName}');
    }

    /**
     * Display a listing of the resource.
     */
    public function index(): AnonymousResourceCollection
    {
        ${modelNames} = {ModelName}::query()
            ->with(['relationship']) // Add eager loading
            ->latest()
            ->paginate();

        return {ModelName}Resource::collection(${modelNames});
    }

    /**
     * Store a newly created resource in storage.
     */
    public function store(Store{ModelName}Request $request): JsonResponse
    {
        ${modelName} = {ModelName}::create($request->validated());

        return {ModelName}Resource::make(${modelName})
            ->response()
            ->setStatusCode(201);
    }

    /**
     * Display the specified resource.
     */
    public function show({ModelName} ${modelName}): {ModelName}Resource
    {
        ${modelName}->load(['relationship']); // Add eager loading

        return {ModelName}Resource::make(${modelName});
    }

    /**
     * Update the specified resource in storage.
     */
    public function update(
        Update{ModelName}Request $request,
        {ModelName} ${modelName}
    ): {ModelName}Resource {
        ${modelName}->update($request->validated());

        return {ModelName}Resource::make(${modelName});
    }

    /**
     * Remove the specified resource from storage.
     */
    public function destroy({ModelName} ${modelName}): JsonResponse
    {
        ${modelName}->delete();

        return response()->json(null, 204);
    }
}