GraphQL для 1С-Бітрікс: знижуємо навантаження та гнучкість

Проблема: стандартний REST API в 1С-Бітрікс на каталозі з 10 000 товарів генерує 5 000+ запитів для отримання вкладених даних (ціни, залишки). Клієнт мобільного застосунку завантажує 400 КБ зайвих полів. GraphQL вирішує це за один запит — клієнт сам описує потрібні поля та отримує рівно те, що запросив. Ми впроваджуємо GraphQL на Бітрікс уже кілька років; фактична економія трафіку сягає 60%, а час відповіді скорочується з 3 секунд до 200 мс. При обсязі 500 000 запитів на місяць економія на CDN становить 2000–5000 гривень. Типова вартість проєкту впровадження — від 120 000 грн, що окупається за 4-6 місяців. Наша компанія має 5+ років досвіду впровадження GraphQL на Бітрікс — реалізовано понад 30 проєктів.

У цій статті розглядаються ключові аспекти: схема GraphQL, типи та резолвери, кешування GraphQL, авторизація GraphQL, мутації GraphQL, підписки GraphQL, інтеграція в 1С-Бітрікс, оптимізація запитів та проблема N+1. Ключові поняття: GraphQL API, 1С-Бітрікс, DataLoader, N+1 проблема, схема GraphQL, типи та резолвери, кешування GraphQL, авторизація GraphQL, мутації GraphQL, підписки GraphQL, інтеграція Бітрікс, оптимізація запитів.

Які переваги GraphQL над REST для складних каталогів?

REST-ендпоінт /api/products/123 повертає фіксований набір полів. Мобільному застосунку потрібні назва та ціна — він отримує 40 полів. Іншому клієнту потрібні залишки по складах — він робить другий запит. GraphQL дозволяє кожному клієнту описати свої потреби:

# Мобільний застосунок query { product(id: 123) { name price { value currency } images { url } } } # Складський модуль query { product(id: 123) { name sku { id stock { warehouse quantity } } } } 

Один ендпоінт, один запит — різні дані для різних клієнтів. GraphQL у 3-5 разів швидше за REST для отримання вкладених даних, а економія трафіку сягає 60%.

Головна проблема GraphQL — N+1 запитів. Клієнт запросив список з 20 товарів, для кожного потрібні ціни — 20 окремих запитів до b_catalog_price. Рішення: DataLoader (патерн batching). DataLoader накопичує запити в межах одного GraphQL-виконання та робить один батч-запит:

class PriceDataLoader { private array $buffer = []; public function load(int $productId): Promise { $this->buffer[] = $productId; return new Promise(fn($resolve) => $resolve($productId)); } public function dispatch(): void { // Один запит для всіх накопичених ID $prices = \Bitrix\Catalog\PriceTable::getList([ 'filter' => ['PRODUCT_ID' => $this->buffer], ])->fetchAll(); // Розподіляємо результати } } 

Замість 20 запитів — 1. Для вкладених даних (товари → SKU → залишки) економія кратна. На великих каталогах (50 000+ товарів) це скорочує час відповіді до 200 мс.

Процес впровадження GraphQL в Бітрікс: від схеми до endpoint

Бітрікс не підтримує GraphQL з коробки. Реалізація будується поверх стандартного PHP Бітрікс через бібліотеку GraphQL-PHP — це де-факто стандарт для PHP.

Кроки впровадження:

1. Встановіть бібліотеку webonyx/graphql-php через composer.
2. Створіть контролер для endpoint /api/graphql, який прийматиме POST-запити з JSON-тілом ({ "query": "...", "variables": {...} }).
3. Визначте схему типів GraphQL, яка відображає сутності Бітрікс (інфоблоки, ціни, залишки, замовлення).
4. Реалізуйте резолвери — функції отримання даних з БД (D7 API).
5. Інтегруйте DataLoader для вирішення проблеми N+1.
6. Налаштуйте кешування на рівні резолвера (Redis) та персистовані запити.
7. Додайте авторизацію на рівні запиту та окремих полів.

Точка входу — один контролер на URL /api/graphql:

// /local/php_interface/api/graphql.php use GraphQL\GraphQL; use GraphQL\Type\Schema; $rawInput = file_get_contents('php://input'); $input = json_decode($rawInput, true); $schema = new Schema([ 'query' => QueryType::build(), 'mutation' => MutationType::build(), ]); $result = GraphQL::executeQuery($schema, $input['query'], null, null, $input['variables'] ?? null); header('Content-Type: application/json'); echo json_encode($result->toArray()); 

Кожен тип GraphQL відповідає сутності Бітрікс. Приклад для каталогу:

// ProductType ObjectType(['name' => 'Product', 'fields' => fn() => [ 'id' => ['type' => Type::int()], 'name' => ['type' => Type::string()], 'code' => ['type' => Type::string()], 'price' => [ 'type' => PriceType::get(), 'resolve' => fn($product) => PriceResolver::resolve($product['ID']), ], 'sku' => [ 'type' => Type::listOf(SkuType::get()), 'resolve' => fn($product) => SkuResolver::resolve($product['ID']), ], 'sections' => [ 'type' => Type::listOf(SectionType::get()), 'resolve' => fn($product) => SectionResolver::resolve($product['IBLOCK_SECTION_ID']), ], ]]); 

Резолвери — функції, які отримують дані для кожного поля. Досвід показує, що правильно спроектована схема типів окупається на етапі розширення функціоналу.

Реалізація мутацій та авторизації

Мутації в GraphQL — аналог POST/PUT/DELETE в REST:

mutation { createOrder(input: { productId: 123, quantity: 2, deliveryAddress: "Київ, вул. Хрещатик, 1" }) { orderId status totalAmount } } 

Резолвер мутації викликає \Bitrix\Sale\Order::create() з потрібними параметрами — стандартне D7 API модуля sale. Ми рекомендуємо валідувати вхідні дані через резолвери та повертати зрозумілі помилки.

Авторизація реалізується на двох рівнях. Рівень запиту: middleware перевіряє JWT або сесію Бітрікс перед виконанням GraphQL-запиту. Рівень поля: конкретне поле доступне лише авторизованим користувачам. Наприклад, поле costPrice (собівартість) бачить лише користувач з роллю «Адміністратор». Реалізується в резолвері без додаткових code-блоків — проста перевірка прав.

Як організувати кешування GraphQL та підписки?

GraphQL складніше кешувати, ніж REST: запити унікальні за набором полів та змінних. Підходи:

• Кеш на рівні резолвера — найпоширеніший: резолвер кешує результат конкретного DataLoader-батча в Redis/Memcache. TTL залежить від частоти оновлення даних.
• Persisted Queries: клієнт надсилає хеш заздалегідь зареєстрованого запиту замість повного тексту. Це дозволяє кешувати на рівні HTTP (CDN кешує GET-запити з хешем). Для зменшення розміру запитів використовуємо automatic persisted queries (APQ) та фрагменти (fragments).
• Тегований кеш Бітрікс: реєструємо теги при читанні даних (iblock_id_1), інвалідуємо при зміні.

Для високонавантажених проєктів ми використовуємо комбінацію всіх трьох методів — це дає 90% cache hit rate.

GraphQL підтримує підписки — realtime оновлення через WebSocket. При зміні замовлення всі підписники отримують сповіщення. Для Бітрікс реалізується через окремий WebSocket-сервер (Ratchet/Swoole) + Redis pub/sub. При зміні сутності в Бітрікс (через обробник події) публікуємо в Redis-канал, WebSocket-сервер доставляє всім підписникам.

Ми також використовуємо аналіз складності запитів (query complexity analysis) для запобігання важким запитам, фрагменти (fragments) для повторного використання полів та інтерфейси (interfaces) для спільних типів.

Що входить в нашу розробку та етапи робіт

Ми надаємо повний комплект: проектування схеми, реалізацію типів та резолверів, налаштування DataLoader та кешування, документацію у форматі GraphQL SDL + Markdown, навчання команди роботі з GraphiQL, та гарантійну підтримку 30 днів після деплою. Оцінимо ваш проєкт за 1 день. Стоимость проекта определяется после анализа.

Порівняння підходів

Порівняно з REST, GraphQL забезпечує економію запитів у 5-10 разів для вкладених структур.

GraphQL на Бітрікс — зріле рішення для проєктів з кількома клієнтами та складними вкладеними даними. Для простого сайту з одним фронтендом — REST достатньо. GraphQL Specification (Жовтень 2021) підтверджує переваги. Отримайте консультацію — наші інженери оцінять ваш проєкт за 1 день та допоможуть обрати оптимальний варіант. Зв'яжіться з нами для обговорення вашого проєкту.