ศูนย์รวมความรู้วิศวกรรมซอฟต์แวร์

การใช้ dto แทนการใ้ช้ array

การใช้ dto แทนการใ้ช้ array

• ความไม่แน่นอน (Lack of Structure): เราไม่รู้เลยว่าใน Array นั้นมี Key อะไรบ้าง ถ้าไม่ไปไล่ดู Code ต้นทาง
  
  
• ไม่มี Type Safety: ข้อมูลใน Array เป็นอะไรก็ได้ (String, Int, หรือ Null) ทำให้เสี่ยงต่อการเกิด Error ใน Runtime
  
  
• IDE เดาทางไม่ถูก: เมื่อส่ง Array เข้าไปใน Method ตัว IDE (อย่าง VS Code หรือ Cursor) จะไม่ช่วยทำ Autocomplete ให้
  
  
• ยากต่อการ Refactor: หากต้องการเปลี่ยนชื่อ Key หนึ่งที่ ต้องตามแก้กันทั้งโปรเจกต์เพราะค้นหา Reference ได้ยาก
  
  

public function store(array $data) {
    // เราไม่รู้เลยว่า $data['user_name'] หรือ $data['username'] กันแน่?
    // และมันอาจจะเป็น null จนทำให้ระบบพังได้
    return User::create([
        'name' => $data['name'],
        'email' => $data['email'],
    ]);
}

readonly class UserRegistrationDTO {
    public function __construct(
        public string $name,
        public string $email,
        public ?string $phoneNumber = null, // บอกชัดเจนว่าเป็น Optional
    ) {}

    public static function fromRequest(Request $request): self {
        return new self(
            name: $request->validated('name'),
            email: $request->validated('email'),
            phoneNumber: $request->validated('phone'),
        );
    }
}

// การใช้งานใน Service/Action
public function execute(UserRegistrationDTO $data) {
    // IDE จะรู้ทันทีว่า $data มี property อะไรบ้าง
    return User::create([
        'name' => $data->name,
        'email' => $data->email,
    ]);
}

• Controller: รับ Request -> แปลงเป็น DTO
  
  
• Action/Service: รับ DTO -> ประมวลผล Business Logic
  
  
• Query: รับ DTO -> คัดกรองข้อมูลจาก Database
  
  

• Array เหมาะกับข้อมูลชั่วคราวภายใน Function สั้นๆ
  
  
• DTO เหมาะกับการส่งข้อมูลข้าม Class หรือข้าม Layer
  
  
• การใช้ DTO ช่วยลดเวลาการ Debug เพราะ Error จะฟ้องตั้งแต่ขั้นตอนการเขียน (ถ้าใช้ Static Analysis เช่น PHPStan)
  
  
• แม้จะดูเหมือนต้องเขียน Code เพิ่มขึ้น (Boilerplate) แต่ในระยะยาว DTO ช่วยลด Technical Debt ได้มหาศาล
  
  

Tip สำหรับการเขียนบทความ: คุณอาจจะตั้งชื่อตอนว่า "บอกลา Array Hell สู่โลกที่ปลอดภัยด้วย DTO" เพื่อดึงดูดกลุ่ม Developer ที่กำลังเจอปัญหาเรื่องการ Maintain Code ครับ!