Конструктор запитів

DocStore та SegmentedLog надають query(). DocStore може використовувати вторинні індекси; SegmentedLog застосовує ті самі умови до потокових записів.

$records = $docs
    ->query()
    ->where('kind')->eq('page')
    ->where('status')->in(['draft', 'published'])
    ->where('publishedAt')->between($from, $until)
    ->orderBy('publishedAt', 'desc')
    ->limit(50)
    ->get();

Корисні методи для завершення запиту:

$docs->query()->where('slug')->eq('home')->first();
$docs->query()->where('kind')->eq('page')->count();
$docs->query()->cursor($lastId)->page(100)->get();
$docs->query()->where('slug')->eq('home')->explain();

У DocStore дві умови eq для неунікальних полів із індексацією за точною відповідністю можуть використовувати автоматичний складений кошик. Окремі умови точної відповідності, in та оператори діапазону й надалі використовують налаштовані індекси полів.

Оператори:

• eq, neq
• in, notIn
• gt, gte, lt, lte, between
• exists, missing
• prefix
• andWhere, orWhere
• orderBy, limit, cursor, page

andWhere та orWhere використовують функції зворотного виклику, оскільки and та or зарезервовані PHP ключові слова:

$docs->query()
    ->where('kind')->eq('page')
    ->orWhere(fn ($q) => $q->where('kind')->eq('post')->where('featured')->eq(true))
    ->get();

Послідовні виклики where() поєднуються оператором AND; кожна гілка orWhere() додає альтернативу.

Як виконується обробка

Кожна умова працює з будь-якою колекцією; індекси лише впливають на швидкість. У DocStore eq та in використовують індекси точної відповідності, оператори діапазону та prefix — індекси діапазонів, а orderBy з limit для поля з індексом діапазону читає дані в порядку індексу. В усіх інших випадках фільтрація виконується під час сканування записів. Якщо планувальник не може обслужити orderBy за індексом поля, відповідні записи сортуються в PHP, тож для великих колекцій додавайте до нього умови з індексами. Для DocStore count() використовує кількість записів в індексі, а для SegmentedLog — лічильники в пам’яті, якщо фільтр містить лише одну умову точної відповідності.

cursor($id) обмежує результати записами після цього ідентифікатора. Разом із page() це забезпечує стабільну пагінацію за ідентифікаторами записів. Про прості потокові фільтри без конструктора див. Запити.