Вступление
Если у вас есть несколько моделей в Laravel с одним nullable полем, создание мутатора для этого поля — процесс достаточно тривиальный:
public function setNicknameAttribute($nickname)
{
$this->attributes['nickname'] = trim($nickname) == '' ? null : trim($nickname);
}
Здесь мы проверяем входные данные, в данном случае — $nickname
, на пустоту. Если$nickname
пуст, то мы ставим атрибуту значение null
, иначе — trim($nickname)
.
Почему я использую trim
вместо empty
? Функция trim
убирает пробельные символы из начала и конца строки, и сравнение результата её выполнения с пустой строкой проверяет, действительно ли входные данные пусты. Это даёт нам возможность убедиться в том, что никто не пытается вставить в базу данных пустую строку. А empty
считает любое количество пробельных символов непустой строкой.
Но при наличии нескольких моделей с полями такого типа в базе данных появляется дублирование кода; в каждой такой модели нужно ставить мутатор проверки на пустоту. Действительно ли это — лучший способ действий? Я вижу два способа убрать дублирование кода в этом случае, использование каждого из которых зависит от вашего окружения (сервера).
Использование базовой модели
Если у вас есть несколько методов в Laravel с повторяющейся логикой в моделях, вы можете вынести её (эту логику) в базовую модель, от которой другие модели будут расширяться. Это полезно, если в каждой вашей модели будет использоваться метод nullIfEmpty
(в нашем случае). Но расширение модели без использования её методов может добавлять ненужное дополнительное потребление ресурсов.
<?php namespace App;
use Illuminate\Database\Eloquent\Model;
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 App\Traits;
trait NullableFields {
protected function nullIfEmpty($input)
{
return trim($input) == '' ? null : trim($input);
}
}
Этот трейт можно использовать в модели так:
<?php namespace App;
use App\Traits\NullableFields;
use Illuminate\Database\Eloquent\Model;
class UserModel extends Model {
use NullableFields;
public function setNicknameAttribute($nickname)
{
$this->attributes['nickname'] = $this->nullIfEmpty($nickname);
}
}
Вывод
Лично я не считаю какой-то из методов более быстрым, также они оба просты в использовании. Поэтому выбор за вами в любом случае. Использование трейтов в Laravel более декларативно, так как вы видите NullableFields
сразу в классе и вам не нужно искать, откуда пришёл метод.
Но, как по мне, использование трейтов более предпочтительно, потому что вы не загружаете базовую модель методами обработки входящих данных или любыми другими методами, которые непосредственно к ней не относятся. Перегружать класс — не лучшая идея.