Метод updateOrCreate у Laravel – nodejs українською

Метод updateOrCreate у Laravel є потужним інструментом для роботи з базою даних, який дозволяє виконати дві операції в одному виклику: оновити існуючий запис або створити новий, якщо такого запису немає. Цей метод часто використовують для скорочення коду, коли потрібно або створити новий запис, або оновити наявний на основі певних умов.

Синтаксис

Model::updateOrCreate(
    ['умови для пошуку існуючого запису'],
    ['дані для оновлення або створення']
);

Model::updateOrCreate(

['умови для пошуку існуючого запису'],

['дані для оновлення або створення']

);

Приклад використання

$user = User::updateOrCreate(
    ['email' => 'user@example.com'], // Умови для пошуку
    ['name' => 'John Doe', 'password' => bcrypt('secret')] // Дані для оновлення/створення
);

$user = User::updateOrCreate(

['email' => 'user@example.com'], // Умови для пошуку

['name' => 'John Doe', 'password' => bcrypt('secret')] // Дані для оновлення/створення

);

Приховані можливості та варіації використання

1. Пошук за декількома умовами

Якщо потрібно знайти запис за кількома полями, ви можете передати масив умов у першому параметрі:

$product = Product::updateOrCreate(
    ['name' => 'Laptop', 'category_id' => 1],
    ['price' => 1200, 'stock' => 10]
);

$product = Product::updateOrCreate(

['name' => 'Laptop', 'category_id' => 1],

['price' => 1200, 'stock' => 10]

);

Тут метод буде шукати продукт із назвою ‘Laptop’ і категорією з ID = 1. Якщо він існує, буде оновлено його ціну та кількість на складі.

2. Використання при зв’язках (Relations)

updateOrCreate також можна використовувати в контексті відносин між моделями. Наприклад, у відношенні “один до одного” ви можете створити або оновити зв’язаний запис:

$user = User::find(1);
$user->profile()->updateOrCreate(
    ['user_id' => $user->id],
    ['bio' => 'New bio description']
);

$user = User::find(1);

$user->profile()->updateOrCreate(

['user_id' => $user->id],

['bio' => 'New bio description']

);

Це оновить або створить новий профіль для користувача.

3. Обробка поверненого значення

Метод updateOrCreate повертає екземпляр моделі, яка була створена або оновлена. Це дає вам можливість виконувати додаткові дії після виконання запиту:

$post = Post::updateOrCreate(
    ['slug' => 'new-post'],
    ['title' => 'My New Post', 'content' => 'Post content']
);

if ($post->wasRecentlyCreated) {
    // Дія, якщо пост був створений
} else {
    // Дія, якщо пост був оновлений
}

$post = Post::updateOrCreate(

['slug' => 'new-post'],

['title' => 'My New Post', 'content' => 'Post content']

);

if ($post->wasRecentlyCreated) {

// Дія, якщо пост був створений

} else {

// Дія, якщо пост був оновлений

}

4. Комбінування з іншими методами

updateOrCreate можна комбінувати з іншими методами Eloquent для більш складних операцій. Наприклад, ви можете використовувати методи firstOrNew або firstOrCreate для ще більшої гнучкості.

firstOrNew: знаходить запис або повертає новий екземпляр, але не зберігає його до бази даних, доки ви не викличете метод save.

$user = User::firstOrNew(
    ['email' => 'user@example.com'],
    ['name' => 'John Doe']
);
// Після виклику save запис збережеться
$user->save();

$user = User::firstOrNew(

['email' => 'user@example.com'],

['name' => 'John Doe']

);

// Після виклику save запис збережеться

$user->save();

firstOrCreate: працює подібно до updateOrCreate, але не оновлює запис, якщо він існує — лише створює новий запис, якщо не знайде збіг.

$category = Category::firstOrCreate(
    ['name' => 'Laravel'],
    ['description' => 'Framework for PHP']
);

$category = Category::firstOrCreate(

['name' => 'Laravel'],

['description' => 'Framework for PHP']

);

5. Застосування транзакцій

Якщо ви працюєте з критичними операціями бази даних, де важлива атомарність, можна використовувати транзакції разом з updateOrCreate:

DB::transaction(function () use ($data) {
    User::updateOrCreate(
        ['email' => $data['email']],
        ['name' => $data['name']]
    );
});

DB::transaction(function () use ($data) {

User::updateOrCreate(

['email' => $data['email']],

['name' => $data['name']]

);

});

Це забезпечить, що операція виконується цілком або не виконується взагалі, у випадку помилки.

Висновок

Метод updateOrCreate — це ефективний інструмент для спрощення запитів до бази даних і зменшення кількості ручного коду при оновленні або створенні записів. Він дозволяє мінімізувати кількість перевірок на наявність запису та робить код більш зрозумілим. Використовуйте його разом із іншими інструментами Eloquent для побудови гнучких та продуктивних додатків на Laravel.