← Заметки и статьи о Laravel PHP

4 июня 2015 перевод

Работа с nullable полями в Eloquent

Если у вас есть несколько моделей с одним nullable полем, создание мутатора для этого поля — процесс достаточно тривиальный:

public function setNicknameAttribute($nickname)
{
    $this->attributes['nickname'] = trim($nickname) == '' ? null : trim($nickname);
}

Здесь мы проверяем входные данные, в данном случае — $nickname, на пустоту. Если $nickname пуст, то мы ставим атрибуту значение null, иначе — trim($nickname).

Почему я использую trim вместо empty? Функция trim убирает пробельные символы из начала и конца строки, и сравнение результата её выполнения с пустой строкой проверяет, действительно ли входные данные пусты. Это даёт нам возможность убедиться в том, что никто не пытается вставить в базу данных пустую строку. А empty считает любое количество пробельных символов непустой строкой.

Но при наличии нескольких моделей с полями такого типа в базе данных появляется дублирование кода; в каждой такой модели нужно ставить мутатор проверки на пустоту. Действительно ли это — лучший способ действий? Я вижу два способа убрать дублирование кода в этом случае, использование каждого из которых зависит от вашего окружения (сервера).

Использование базовой модели

Если у вас есть несколько методов с повторяющейся логикой в моделях, вы можете вынести её (эту логику) в базовую модель, от которой другие модели будут расширяться. Это полезно, если в каждой вашей модели будет использоваться метод nullIfEmpty (в нашем случае). Но расширение модели без использования её методов может добавлять ненужное дополнительное потребление ресурсов.

<?php namespace App;

use IlluminateDatabaseEloquentModel;

class BaseModel extends Model {

    public function __construct(array $attributes = array())
    {
        parent::__construct($attributes);
    }

    protected function nullIfEmpty($input)
    {
        return trim($input) == '' ? null : trim($input);
    }

}

Функция nullIfEmpty будет доступна в каждой модели, расширяющей BaseModel:

<?php namespace App;

class UserModel extends BaseModel {

    public function setNicknameAttribute($nickname)
    {
        $this->attributes['nickname'] = $this->nullIfEmpty($nickname);
    }

}

Этот способ работает, но не сразу понятно, откуда приходит метод nullIfEmpty. Понадобится немного времени на выяснение, откуда он появился. Тем не менее, этой непонятности можно избежать.

Но для тех, у кого версия PHP < 5.4.0, этот способ, наверное, будет единственным.

Использование трейтов

Если вы используете версию PHP >= 5.4.0, трейты помогут вам красивым декларативным способом добавить нужную функциональность в модели.

<?php namespace AppTraits;

trait NullableFields {

    protected function nullIfEmpty($input)
    {
        return trim($input) == '' ? null : trim($input);
    }

}

Этот трейт можно использовать в модели так:

<?php namespace App;

use AppTraitsNullableFields;
use IlluminateDatabaseEloquentModel;

class UserModel extends Model {

    use NullableFields;

    public function setNicknameAttribute($nickname)
    {
        $this->attributes['nickname'] = $this->nullIfEmpty($nickname);
    }

}

Вывод

Лично я не считаю какой-то из методов более быстрым, также они оба просты в использовании. Поэтому выбор за вами в любом случае. Использование трейтов более декларативно, так как вы видите NullableFields сразу в классе и вам не нужно искать, откуда пришёл метод.

Но, как по мне, использование трейтов более предпочтительно, потому что вы не загружаете базовую модель методами обработки входящих данных или любыми другими методами, которые непосредственно к ней не относятся. Перегружать класс — не лучшая идея.

Источник: https://iatstuti.net/blog/working-with-nullable-fields-in-eloquent-models

Плюсануть
Поделиться
Отправить