Controller ใน Laravel คืออะไร?

Question

Accepted Answer

**Controller** จัดกลุ่มตรรกะการจัดการ request ที่เกี่ยวข้องกันไว้ในคลาส แทนที่จะใส่ตรรกะทั้งหมดไว้ใน route closure controller จะจัดระเบียบ action ต่าง ๆ ของแอปพลิเคชัน (เช่น การดำเนินการที่เกี่ยวกับ user ทั้งหมด) ไว้ใน method ต่าง ๆ ทำให้ route สะอาดและโค้ดเป็นระเบียบ

## Controller พื้นฐาน

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // list users
    }
    public function show(User $user) {   // route model binding — auto-fetch by id
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // create
    }
}
```

สร้าง controller ด้วย Artisan: `php artisan make:controller UserController` แต่ละ method จัดการกับหนึ่ง action และ route จะชี้ไปยัง method เหล่านั้น

## Resource controller (RESTful CRUD)

```php
// generate a controller with all 7 RESTful methods stubbed
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // maps routes to the methods:
// index() create() store() show() edit() update() destroy()
```

**Resource controller** มี method CRUD มาตรฐาน ซึ่งใช้คู่กับ `Route::resource` เพื่อทำ RESTful routing ตาม convention โดยมี boilerplate น้อยที่สุดสำหรับ resource แบบ CRUD ทั่วไป

## Dependency injection ใน controller

```php
class OrderController extends Controller {
    // type-hinted dependencies are AUTO-INJECTED by Laravel's service container
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // method injection too
        // $request and $mailer are resolved & injected automatically
    }
}
```

Service container ของ Laravel จะ **inject โดยอัตโนมัติ** สำหรับ dependency ที่ระบุ type-hint เข้าไปใน constructor และ method ของ controller (รวมถึง `Request` ด้วย) ทำให้ได้โค้ดที่สะอาดและทดสอบได้ง่าย

## ทำให้ controller บาง

```text
✓ Controllers should handle HTTP concerns (validate input, call services, return responses)
✗ Business logic belongs in SERVICES/models, not bloated controllers ("thin controllers")
```

## ทำไมจึงสำคัญ

Controller เป็นองค์ประกอบหลักของ Laravel เพราะมันจัดระเบียบตรรกะการจัดการ request ไว้ในคลาสที่เกาะเกี่ยวกัน ซึ่งจำเป็นสำหรับแอปพลิเคชันใด ๆ ที่เกินกว่า route แบบง่าย ๆ

การเข้าใจวิธีสร้าง controller การจับคู่ route เข้ากับ method และโดยเฉพาะการใช้ **resource controller** กับ `Route::resource` (สำหรับ RESTful CRUD ตาม convention โดยมี boilerplate น้อยที่สุด) เป็นความรู้ที่ใช้ในชีวิตประจำวันสำหรับการสร้างแอป Laravel

ฟีเจอร์สำคัญของ Laravel คือ **dependency injection อัตโนมัติ** เข้าสู่ controller ผ่าน service container โดย dependency ที่ระบุ type-hint (service, request, mailer) จะถูก resolve และ inject โดยอัตโนมัติ ทำให้ได้โค้ดที่สะอาด ทดสอบได้ และ coupling ต่ำ

ที่สำคัญพอ ๆ กันคือแนวปฏิบัติที่ดีในการทำให้ controller **บาง** กล่าวคือจัดการเฉพาะเรื่อง HTTP (การ validate การเรียก service การ return response) และมอบหมาย business logic ให้กับ service/model ซึ่งช่วยให้โค้ดดูแลรักษาและทดสอบได้ง่าย

Controller ร่วมกับ routing และ model เป็นกระดูกสันหลังของการจัดการ request ใน Laravel ทำให้เป็นพื้นฐานสำหรับการสร้างแอปพลิเคชัน Laravel ระดับมืออาชีพที่จัดระเบียบดี