Sử dụng Transformers trong Laravel

Khi tạo REST API ta thường trả về dữ liệu dưới dạng JSON. Trong Laravel ta có nhiều cách để trả về  JSON.

How We Usually Do It

Thông thường, khi chúng ta tạo ra một JSON Response trong Laravel, chúng ta sẽ sử dụng Model.

class User
    {
        protected $fillable = [
            'name', 'email', 'address',
        ];

        protected $hidden = [
            'password', 'remember_token',
        ];
    }

Giả sử chúng ta muốn lấy User đầu tiên dạng JSON, thì có lẽ chúng ta sẽ sử dụng một cách nào đó như sau.

$user = User::find(1);
return $user;

Boom! Bạn nhận JSON response của user đầu đã đăng ký. Nhưng nếu Model thay đổi trong tương lai (ví dụ: đổi address thành user_address) => JSON response cũng thay đổi. Các bên sử dụng API của bạn cũng phải thay đổi theo. Do vậy ta cần một cách khác phù hợp hơn, câu trả lời đó là dùng Transformer.

Transformers

Về cơ bản transformers cho bạn tạo định JSON response một cách linh động. Ngoài ra ta còn có thể phân trang kết quả, lồng các quan hệ/dữ liệu. Nếu bạn sử dụng Dingo API thì Fractal Transformers được tích hợp sẵn.
Giả sử mình chỉ muốn trả về name và email mà không có address.

class UserTransformer extends TransformerAbstract
{
    public function transformWithoutAddress(User $user)
    {
        return [
            'id'            => (int) $user->id,
            'name'          => (string) $user->name,
            'email'         => (string) $user->email,
        ];
    }
}

Sử dụng:

$user = User::find(1);
return (new UserTransformer)->transformWithoutAddress($user);

OK, mọi thứ đều ổn. Nhưng nếu ta muốn trả lại cả address thì sao? Chỉ cần tạo thêm một transformer nữa trong UserTransformer

public function transformWithAddress(User $user)
{
    $data = ['address' => (string) $user->address];
    return array_merge($data, $this->transformWithoutAddress($user));
}

Great! Nếu bây giờ bạn thay đổi thuộc tính của User từ address thành user_address thì ta chỉ việc thay đổi trong Transformer và các bên sử dụng API của ta không bị ảnh hưởng gì cả.

Conclusion

Trong bài viết này mình đã đề cập đến tạo JSON response từ Transformer. Một trong những tính linh hoạt của việc sử dụng transformer là nó không phải là trực tiếp bắt nguồn từ các models. Do đó, phiên bản API hoặc tạo transformer cho cùng một model với các mục đích khác nhau sẽ dễ dàng hơn.
Thanks for reading.