Eloquent ORM кажется простой, но под капотом существует много полускрытых функций и менее известных способов. В этой статье я покажу вам несколько трюков.
1. Инкрементация и декрементация
Вместо этого:
$article = Article::find($article_id);
$article->read_count++;
$article->save();
Вы можете сделать так:
$article = Article::find($article_id);
$article->increment('read_count');
Так тоже будет работать:
Article::find($article_id)->increment('read_count');
Article::find($article_id)->increment('read_count', 10); // +10
Product::find($produce_id)->decrement('stock'); // -1
2. X или Y методы
Eloquent есть несколько функций, которые объединяют два метода, например “пожалуйста, сделай X, иначе сделай Y”.
Пример 1 – findOrFail()
:
Вместо этого:
$user = User::find($id);
if (!$user) { abort (404); }
Делаем это:
$user = User::findOrFail($id);
Пример 2 – firstOrCreate()
:
Вместо этого:
$user = User::where('email', $email)->first();
if (!$user) {
User::create([
'email' => $email
]);
}
Делаем это:
$user = User::firstOrCreate(['email' => $email]);
3. Метод boot() модели
В модели Eloquent есть волшебный метод boot()
, где вы можете переопределить поведение по умолчанию:
class User extends Model
{
public static function boot()
{
parent::boot();
static::updating(function($model)
{
// выполнить какую-нибудь логику
// переопределить какое-нибудь свойство, например $model->something = transform($something);
});
}
}
Вероятно, одним из наиболее популярных примеров является установка значения поля на момент создания объекта модели. Предположим, вы хотите сгенерировать поле UUID в этот момент.
public static function boot()
{
parent::boot();
self::creating(function ($model) {
$model->uuid = (string)Uuid::generate();
});
}
4. Отношения с условием и сортировкой
Это типичный способ определения отношений:
public function users() {
return $this->hasMany('App\User');
}
Но знаете ли вы, что сюда мы можем добавить where
или orderBy
?
Например, если вам нужно специальное отношения для некоторых типов пользователей, упорядоченное по электронной почте, вы можете сделать это:
public function approvedUsers() {
return $this->hasMany('App\User')->where('approved', 1)->orderBy('email');
}
5. Свойства модели: timestamps, appends и тд.
Существует несколько «параметров» Eloquent модели в виде свойств класса. Самые популярные из них, вероятно, следующие:
class User extends Model {
protected $table = 'users';
protected $fillable = ['email', 'password']; // какие поля могут быть заполнены выполняя User::create()
protected $dates = ['created_at', 'deleted_at']; // какие поля будут типа Carbon
protected $appends = ['field1', 'field2']; // доп значения возвращаемые в JSON
}
Но подождите, есть еще:
protected $primaryKey = 'uuid'; // не должно быть "id"
public $incrementing = false; // и не должно быть автоинкрементом
protected $perPage = 25; // Да, вы можете переопределить число записей пагинации (по умолчанию 15)
const CREATED_AT = 'created_at';
const UPDATED_AT = 'updated_at'; // Да, даже эти названия также могут быть переопределены
public $timestamps = false; // или не использоваться совсем
И есть еще больше, я перечислил наиболее интересные из них, для более подробной информации ознакомьтесь с кодом по умолчанию abstract Model class и посмомотрите все используемые трэйты.
6. Поиск нескольких записей
Всем известен метод find ()
, правда?
$user = User::find(1);
Я был удивлен, как мало кто знает о том, что он может принимать несколько IDшников в виде массива:
$users = User::find([1,2,3]);
7. WhereX
Есть элегантный способ превратить это:
$users = User::where('approved', 1)->get();
В это:
$users = User::whereApproved(1)->get();
Да, вы можете изменить имя любого поля и добавить его как суффикс в “where”, и оно будет работать как по волшебству.
Также в Eloquent ORM есть предустановленные методы, связанные с датой и временем:
User::whereDate('created_at', date('Y-m-d'));
User::whereDay('created_at', date('d'));
User::whereMonth('created_at', date('m'));
User::whereYear('created_at', date('Y'));
8. Сортировка с отношениями
Немного больше чем "трюк". Что делать если у вас есть темы форума, но вы хотите их отсортировать, по их последним постам? Довольно популярное требование в форумах с последними обновленными темами вверху, правда?
Сначала опишите отдельную связь для последнего поста в теме:
public function latestPost()
{
return $this->hasOne(\App\Post::class)->latest();
}
И после, в вашем контроллере, вы можете выполнить такую "магию":
$users = Topic::with('latestPost')->get()->sortByDesc('latestPost.created_at');
9. Eloquent::when() – без “if-else”
Многие из нас пишут условные запросы с «if-else», что-то вроде этого:
if (request('filter_by') == 'likes') {
$query->where('likes', '>', request('likes_amount', 0));
}
if (request('filter_by') == 'date') {
$query->orderBy('created_at', request('ordering_rule', 'desc'));
}
Но лучший способ — использовать when()
:
$query = Author::query();
$query->when(request('filter_by') == 'likes', function ($q) {
return $q->where('likes', '>', request('likes_amount', 0));
});
$query->when(request('filter_by') == 'date', function ($q) {
return $q->orderBy('created_at', request('ordering_rule', 'desc'));
});
Этот пример может показаться не короче или элегантнее, но правильнее будет пробрасывать параметры:
$query = User::query();
$query->when(request('role', false), function ($q, $role) {
return $q->where('role_id', $role);
});
$authors = $query->get();
10. Модель по умолчанию для отношений
Допустим, у вас есть пост, принадлежащий автору, и Blade код:
Но что, если автор удален или не установлен по какой-либо причине? Вы получите ошибку на подобии "property of non-object".
Конечно, вы можете предотвратить это следующим образом:
Но вы можете сделать это на уровне Eloquent отношений:
public function author()
{
return $this->belongsTo('App\Author')->withDefault();
}
В этом примере отношение author()
возвращает пустую модель App\Author
, если автор не прикреплен к посту.
Кроме того, мы можем присвоить значениям свойств по умолчанию для этой модели.
public function author()
{
return $this->belongsTo('App\Author')->withDefault([
'name' => 'Guest Author'
]);
}
11. Сортировка по преобразователю
Представьте что у вас есть такой преобразователь:
function getFullNameAttribute()
{
return $this->attributes['first_name'] . ' ' . $this->attributes['last_name'];
}
Вам нужно отсортировать записи по полю full_name
? Такое решение работать не будет:
$clients = Client::orderBy('full_name')->get(); // не работает
Решение довольно простое. Нам нужно отсортировать записи после того как мы их получили.
$clients = Client::get()->sortBy('full_name'); // работает!
Обратите внимание что название функций отличается — это не orderBy, это sortBy.
12. Сортировка по умолчанию
Что делать, если вы хотите, чтобы User::all()
всегда сортировался по полю name
? Вы можете назначить глобальную заготовку (Global Scope). Вернемся к методу boot ()
, о котором мы уже говорили выше.
protected static function boot()
{
parent::boot();
// Сортировка по полю name в алфавитном порядке
static::addGlobalScope('order', function (Builder $builder) {
$builder->orderBy('name', 'asc');
});
}
13. Сырые выражения
Иногда нам нужно добавить сырые выражения в наш Eloquent запрос.
К счастью, для этого есть функции.
// whereRaw
$orders = DB::table('orders')
->whereRaw('price > IF(state = "TX", ?, 100)', [200])
->get();
// havingRaw
Product::groupBy('category_id')->havingRaw('COUNT(*) > 1')->get();
// orderByRaw
User::where('created_at', '>', '2016-01-01')
->orderByRaw('(updated_at - created_at) desc')
->get();
14. Репликация: сделать копию записи
Без глубоких объяснений, вот лучший способ сделать копию записи в базе данных:
$task = Tasks::find(1);
$newTask = $task->replicate();
$newTask->save();
15. Chunk() метод для больших таблиц
Не совсем о Eloquent, это скорее о коллекциях, но все же мощный метод — для обработки больших наборов данных. Вы можете разбить их на кусочки.
Вместо этого:
$users = User::all();
foreach ($users as $user) {
// ...
Вы можете сделать это:
User::chunk(100, function ($users) {
foreach ($users as $user) {
// ...
}
});
16. Создание дополнительных файлов при создании модели
Мы все знаем Artisan команду:
php artisan make:model Company
Но знаете ли вы, что есть три полезных флага для создания дополнительных файлов модели?
php artisan make:model Company -mcr
17. Перезапись updated_at во время сохранения
Знаете ли вы, что метод ->save()
может принимать параметры? Как результат мы можем “игнорировать” updated_at
функциональность, которая по умолчанию должна была установить текущую метку времени.
Посмотрите на следующий пример:
$product = Product::find($id);
$product->updated_at = '2019-01-01 10:00:00';
$product->save(['timestamps' => false]);
Здесь мы переписали updated_at
нашем предустановленным значением.
18. Что является результатом метода update()?
Вы когда-нибудь задумывались над тем, что этот код возвращает?
$result = $products->whereNull('category_id')->update(['category_id' => 2]);
Я имею в виду, что обновление выполняется в базе данных, но что будет содержать этот $result
?
Ответ: затронутые строки. Поэтому, если вам нужно проверить, сколько строк было затронуто, вам не нужно ничего вызывать — метод update()
вернет это число для вас.
19. Преобразуем скобки в Eloquent запрос
Что делать если у вас есть AND и OR в вашем SQL запросе, как здесь:
... WHERE (gender = 'Male' and age >= 18) or (gender = 'Female' and age >= 65)
Как преобразовать этот запрос в Eloquent запрос? Это неправильный способ:
$q->where('gender', 'Male');
$q->orWhere('age', '>=', 18);
$q->where('gender', 'Female');
$q->orWhere('age', '>=', 65);
Порядок будет неправильным. Правильный способ немного сложнее, используя замыкания в качестве подзапросов:
$q->where(function ($query) {
$query->where('gender', 'Male')
->where('age', '>=', 18);
})->orWhere(function($query) {
$query->where('gender', 'Female')
->where('age', '>=', 65);
})
20. orWhere с несколькими параметрами
Вы можете передать массив параметров в orWhere()
.
“Обычный” способ:
$q->where('a', 1);
$q->orWhere('b', 2);
$q->orWhere('c', 3);
Вы можете сделать это так:
$q->where('a', 1);
$q->orWhere(['b' => 2, 'c' => 3]);
Комментариев нет:
Отправить комментарий