chunkById() - безпечна пакетна обробка

Tips 03 серпня 2026

chunkById() - безпечна пакетна обробка

Обробляєте таблицю через chunk() і одночасно змінюєте колонку, за якою фільтруєте? Частина записів буде пропущена.

chunk() гортає сторінки через OFFSET. Якщо запис випадає з вибірки під час обробки, решта зсувається - і цілий пакет ви не побачите.

Як працює chunkById():

Замість OFFSET використовує where('id', '>', $lastId). Зсув вибірки більше не ламає ітерацію.

Коли обов'язково chunkById():

Оновлюєте поле, за яким фільтруєте
Видаляєте записи під час обходу
Будь-яка міграція даних із записом у ту саму таблицю

Порада: сортування задає сам chunkById() - не додавайте власний orderBy(), він його перезапише.

#Laravel #Eloquent #Масові операції #Бекенд

Олексій Бабінцев

// НЕБЕЗПЕЧНО: пропустить половину записів
User::where('notified', false)
  ->chunk(100, function ($users) {
    foreach ($users as $user) {
      $user->update(['notified' => true]);
      // Вибірка "з'їдається", OFFSET перестрибує записи
    }
  });

// БЕЗПЕЧНО: курсор по первинному ключу
User::where('notified', false)
  ->chunkById(100, function ($users) {
    foreach ($users as $user) {
      $user->update(['notified' => true]);
    }
  });

// Видалення під час обходу - тільки chunkById()
Log::where('created_at', '<', now()->subYear())
  ->chunkById(500, function ($logs) {
    $logs->each->delete();
  });

// Власна колонка-курсор (наприклад, UUID-таблиця)
Order::where('status', 'pending')
  ->chunkById(200, function ($orders) {
    $orders->each->process();
  }, column: 'uuid');

// Читання без змін - звичайний chunk() достатній
Product::chunk(1000, function ($products) {
  foreach ($products as $product) {
    $this->exportToCsv($product);
  }
});

// each() - те саме, але по одному запису
User::where('active', true)->eachById(function ($user) {
  $user->recalculateStats();
}, 200);

Коментарі

Увійдіть, щоб залишити коментар

Будьте першим, хто залишить коментар!

Інші поради

Tips 31 липня 2026

firstOrFail() - чиста обробка 404

Перевіряєте на існування моделі перед використанням? Багато шаблонного коду.

firstOrFail() кидає виняток, який Laravel перетворює на 404.

Переваги:

Менше boilerplate
Автоматична обробка помилок
REST-friendly

Схожі методи: findOrFail($id), sole().

#Laravel #Eloquent #Обробка Помилок #Бекенд

Олексій Бабінцев

// ПОГАНО
public function show($id)
{
  $post = Post::find($id);

  if (!$post) {
    abort(404);
  }

  return view('posts.show', compact('post'));
}

// ДОБРЕ
public function show($id)
{
  $post = Post::findOrFail($id);

  return view('posts.show', compact('post'));
}

// За slug
public function showBySlug($slug)
{
  $post = Post::where('slug', $slug)->firstOrFail();

  return view('posts.show', compact('post'));
}

Tips 30 липня 2026

Глобальні скоупи - умови за замовчуванням

Одна й та сама where-умова в кожному запиті? Це не DRY.

Global Scopes додають умову автоматично.

Типові кейси:

Multi-tenancy
Soft deletes (вже реалізовано через глобальний скоуп)
published = true
Архівні записи

Можна прибрати через withoutGlobalScope().

#Laravel #Eloquent #Scopes #Бекенд

Олексій Бабінцев

// Окремий клас скоупу
class PublishedScope implements Scope
{
  public function apply(Builder $builder, Model $model)
  {
    $builder->where('published', true);
  }
}

// Підключення до моделі
class Post extends Model
{
  protected static function booted()
  {
    static::addGlobalScope(new PublishedScope);
  }
}

// Всі запити - тепер тільки published
$posts = Post::all();
$post = Post::find(1);

Tips 29 липня 2026

Subquery Selects - уникаємо N+1 без eager loading

Потрібен останній пост користувача? Eager loading витягне ВСІ пости.

Subquery-select дозволяє додати обчислювану колонку без завантаження зв'язку.

Коли використовувати:

Останній/перший пов'язаний запис
count/sum/max/min по зв'язку
Коли не потрібні повні дані зв'язку

Продуктивність:

Один запит. Ніякого N+1. Немає зайвих даних.

#Laravel #Eloquent #Продуктивність #Бекенд

Тарас Сірко

// ПОГАНО: вантажимо всі пости, щоб узяти останній
$users = User::with('posts')->get();
foreach ($users as $user) {
  echo $user->posts
    ->sortByDesc('created_at')->first()->title;
}

// ДОБРЕ: subquery - тільки заголовок останнього поста
$users = User::select('users.*')
  ->addSelect(['last_post_title' => Post::select('title')
    ->whereColumn('user_id', 'users.id')
    ->latest()
    ->limit(1)
  ])->get();

echo $users[0]->last_post_title;

// Сортування по subquery - без завантаження постів
$users = User::orderByDesc(
  Post::select('created_at')
    ->whereColumn('user_id', 'users.id')
    ->latest()
    ->limit(1)
)->get();

Tips 28 липня 2026

whereHas() проти has() - фільтр за зв'язками

Треба знайти користувачів, у яких є пости? Або тільки з опублікованими постами?

has() перевіряє факт наявності зв'язку. whereHas() дозволяє додати умови до зв'язку.

Різниця:

has('posts') - користувачі з будь-якими постами
whereHas('posts', fn($q) => ...) - користувачі з конкретними постами

Порада по продуктивності:

Використовуйте has(), коли немає додаткових умов - він простіший.

#Laravel #Eloquent #Зв'язки #Бекенд

Оксана Ковальчук

// Користувачі з будь-якими постами
$users = User::has('posts')->get();

// Користувачі з мінімум 5 постами
$users = User::has('posts', '>=', 5)->get();

// Користувачі тільки з опублікованими постами
$users = User::whereHas('posts', function ($query) {
  $query->where('published', true);
})->get();

// Більш складні умови
$users = User::whereHas('posts', function ($query) {
  $query->where('published', true)
    ->where('views', '>', 1000);
})->get();

// Користувачі без постів
$users = User::doesntHave('posts')->get();

// Комбінування кількох зв'язків
$users = User::has('posts')
  ->whereHas('comments', fn($q) => $q->where('spam', false))
  ->get();

Tips 27 липня 2026

touch() - автооновлення timestamps у батьків

Додали коментар до поста, а updated_at у поста не змінився. Кеш не оновився.

touch() дозволяє автоматично оновлювати час оновлення батьківської моделі.

Як працює:

У дочірній моделі вказуємо $touches. Коли вона зберігається - оновлюється updated_at у батьків.

Де корисно:

Інвалідація кешу за timestamp
"Остання активність"
Відстеження змін контенту

Працює з будь-якими зв'язками.

#Laravel #Eloquent #Timestamps #Бекенд

Олексій Бабінцев

class Comment extends Model
{
  // Авто-touch для поста
  protected $touches = ['post'];

  public function post()
  {
    return $this->belongsTo(Post::class);
  }
}

// Тепер при створенні/оновленні коментаря
$comment = new Comment(['body' => 'Great post!']);
$comment->post()->associate($post);
$comment->save();
// updated_at у Post буде оновлено

// Ручне оновлення timestamps
$post->touch();

// Touch кількох зв'язків
class Comment extends Model
{
  protected $touches = ['post', 'author'];
}

Завантаження...