Form Request class คืออะไร?

Question

Accepted Answer

**Form Request** class คือคลาส request แบบ custom ที่ **ห่อหุ้มตรรกะ validation (และ authorization)** สำหรับ request หนึ่ง ๆ พวกมันย้ายกฎ validation ออกจาก controller ไปยังคลาสที่นำกลับมาใช้ใหม่ได้โดยเฉพาะ ช่วยให้ controller บางและ validation เป็นระเบียบ

## การสร้างและใช้ Form Request

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // AUTHORIZATION check
    }

public function rules(): array {
        return [                                              // VALIDATION rules
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // custom messages
    }
}
```

```php
// type-hint the Form Request in the controller — validation runs AUTOMATICALLY
public function store(StoreUserRequest $request) {
    // if we reach here, validation AND authorization already PASSED
    User::create($request->validated());   // get the validated data
}
```

เมื่อคุณระบุ type-hint ของ Form Request ใน method ของ controller Laravel จะ **รัน authorization และ validation ของมันโดยอัตโนมัติก่อนที่ method จะทำงาน** หากอย่างใดอย่างหนึ่งล้มเหลว request จะถูกปฏิเสธ (403 สำหรับ authorization, 422/redirect สำหรับ validation) และ method ของคุณจะไม่ทำงานเลย ดังนั้นภายใน method คุณจึงรู้ว่าข้อมูลถูกต้องและ action ได้รับอนุญาตแล้ว

## ประโยชน์

```text
✓ Thin controllers — validation/authorization logic lives in the Form Request, not the controller
✓ Reusable — use the same request class across multiple endpoints
✓ Organized — rules, messages, and authorization for a request are in one place
✓ Combines validation AND authorization — both checked automatically before the controller
✓ Access prepared/validated data cleanly via $request->validated()
```

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

Form Request class เป็นแนวปฏิบัติที่ดีของ Laravel สำหรับการจัดระเบียบ validation และ authorization อย่างสะอาด พวกมันเป็นวิธีที่แนะนำสำหรับ validation ใด ๆ ที่เกินกว่าแบบธรรมดา ดังนั้นการเข้าใจมันจึงมีค่าสำหรับการเขียนแอปพลิเคชัน Laravel ที่ดูแลรักษาง่าย

ประโยชน์สำคัญของพวกมันคือการทำให้ **controller บาง**: โดยการย้ายกฎ validation และตรรกะ authorization ไปยังคลาสที่อุทิศไว้โดยเฉพาะ (ที่ Laravel รันโดยอัตโนมัติก่อน method ของ controller) controller จึงโฟกัสที่ตรรกะหลักของมัน โดยมั่นใจได้ว่าข้อมูลถูก validate แล้วและ action ได้รับอนุญาตแล้วเมื่อมันทำงาน

การแยกนี้ทำให้โค้ด **เป็นระเบียบมากขึ้น** (กฎทั้งหมด, custom message และ authorization สำหรับ request อยู่ในที่เดียวที่เกาะเกี่ยวกัน), **นำกลับมาใช้ใหม่ได้** (Form Request เดียวกันสามารถใช้ได้ในหลาย endpoint) และสะอาดขึ้น

การรวม **validation และ authorization** ในคลาสเดียวโดยอัตโนมัติ โดยทั้งสองถูกตรวจสอบก่อนที่ controller จะทำงาน ปฏิเสธ request ที่ไม่ถูกต้องหรือไม่ได้รับอนุญาตโดยอัตโนมัติ เป็นสิ่งที่สง่างามและลด boilerplate

การเข้าใจ Form Request วิธีที่มันรันโดยอัตโนมัติ และประโยชน์ของการแยก validation/authorization ออกจาก controller สะท้อนถึงแนวปฏิบัติ Laravel ที่เป็นผู้ใหญ่ และมีความสำคัญสำหรับการสร้างแอปพลิเคชันที่มีโครงสร้างดี เนื่องจาก validation และ authorization เป็นเรื่องที่พบทั่วไป และ Form Request เป็นวิธีที่สะอาดและเป็น idiom ของ Laravel ในการจัดการกับมันสำหรับกรณีที่ไม่ธรรมดา ซึ่งเป็นเครื่องหมายของโค้ด Laravel ระดับมืออาชีพที่ดูแลรักษาง่าย