ProcessWire як Headless CMS: налаштування REST та GraphQL API

Як організувати видачу контенту через ProcessWire API

Проєкт на ProcessWire живе кілька років, накопичилися десятки шаблонів, а тут приходить задача: зробити SPA на React або мобільний застосунок. Стандартний PHP-рендеринг не підходить — клієнту потрібен чистий JSON. Можна нагородити костилів через прямий доступ до БД, але це ламає всю логіку прав доступу та кешування ProcessWire API. Правильне рішення — підняти ProcessWire API поверх існуючих шаблонів. Ми робимо це за 2–4 дні, використовуючи штатні засоби: шаблон-роутер або модуль GraphQL. Нічого не переписуємо — тільки додаємо новий endpoint.

На рахунку більше 30 таких проєктів. Найнавантаженіша конфігурація витримує до 100 000 запитів на добу на бюджетному VPS. API працює без збоїв вже два роки. Нижче розберемо, які є варіанти реалізації.

Які переваги ProcessWire API?

ProcessWire API налаштовується в 3 рази швидше за Strapi. ProcessWire headless CMS — ідеальне рішення для сучасних проєктів. ProcessWire JSON API дозволяє легко інтегруватися з будь-яким клієнтом. За нашими тестами, ProcessWire API працює в 2 рази швидше за WordPress REST API при однаковому навантаженні.

Вбудований PHP API

ProcessWire використовує $pages, $page, $user, $config як глобальні змінні в шаблонах:

// templates/blog.php // Вибірка з фільтрами та пагінацією $limit = 12; $start = ($input->pageNum - 1) * $limit; $posts = $pages->find("template=blog-post, status=published, sort=-date, limit=$limit, start=$start"); $totalPosts = $pages->count("template=blog-post, status=published"); // Вибірка з умовами по полях $featuredPosts = $pages->find(" template=blog-post, featured=1, date>=today, category.name%=Web Development, sort=-date, limit=3 "); // Один елемент $post = $pages->get("template=blog-post, slug=my-post-slug"); if (!$post->id) wire404(); 

Selector String — мова запитів

ProcessWire selector string — це потужна мова запитів для вибірки сторінок:

// Текстовий пошук $pages->find("template=product, title*=laptop, sort=title"); // Числові умови $pages->find("template=product, price>=1000, price<=5000"); // Дата $pages->find("template=event, event_date>=today, sort=event_date"); // OR-умови $pages->find("template=post, (category=tech|category=science)"); // Пов'язані сторінки $pages->find("template=product, categories.id={$category->id}"); // Повнотекстовий пошук $pages->find("title|body~=search query, template=post"); // Сортування за кастомним полем $pages->find("template=product, sort=-rating, sort=title"); 

REST API через ProCache або кастомний модуль

ProcessWire не має вбудованого REST API. Створюємо через шаблон-роутер. Для створення кастомного REST endpoint використовуйте шаблон-роутер. ProcessWire шаблони API — це звичайні PHP-шаблони з JSON-відповіддю.

// site/templates/api.php // URL: /api/blog/?page=1&limit=10 header('Content-Type: application/json'); header('Access-Control-Allow-Origin: ' . $config->httpHost); // Проста авторизація по ключу $apiKey = $input->get->text('key'); if ($apiKey !== $config->apiKey) { http_response_code(401); echo json_encode(['error' => 'Unauthorized']); return; } $page_num = (int) $input->get->int('page') ?: 1; $limit = min((int) $input->get->int('limit') ?: 10, 100); $start = ($page_num - 1) * $limit; $posts = $pages->find(" template=blog-post, status=published, sort=-date, limit=$limit, start=$start "); $result = [ 'data' => array_map(fn($post) => [ 'id' => $post->id, 'title' => $post->title, 'slug' => $post->name, 'url' => $post->url, 'date' => $post->date->format('Y-m-d'), 'excerpt' => $post->excerpt, 'image' => $post->image ? [ 'url' => $post->image->width(800)->url, 'width' => 800, 'height' => (int) round(800 / $post->image->ratio), ] : null, ], $posts->getArray()), 'total' => $posts->getTotal(), 'page' => $page_num, 'limit' => $limit, ]; echo json_encode($result); 

Модуль ProcessWire GraphQL

Установка через модулі ProcessWire. Скачати з GraphQL модуль і в config.php додати налаштування:

$config->graphql = [ 'templateFilters' => ['blog-post', 'product', 'category'], 'fieldFilters' => ['title', 'body', 'date', 'image', 'category'], 'maxLimit' => 100, ]; query { blogPost(s: "status=published, sort=-date, limit=10") { list { id title date body image { url(width: 800) } category { title url } } total } } 

Кешування відповідей

// Кеш через WireCache $cacheKey = "api_posts_page{$page_num}"; $cached = $cache->get($cacheKey); if ($cached) { echo $cached; return; } // ... формування $result ... $json = json_encode($result); $cache->save($cacheKey, $json, 3600); // 1 година echo $json; 

Створення базового REST API на ProcessWire (5–7 endpoint-ів) — 2–4 дні. Стоимость базового REST API — от 20 000 ₽, GraphQL з кешем — от 35 000 ₽.

Порівняння REST і GraphQL для ProcessWire

REST краще, коли потрібна мінімальна відповідь і повний контроль. GraphQL — якщо клієнтам потрібна гнучкість вибірки полів.

Які переваги ProcessWire як Headless CMS?

На відміну від WordPress (де API — костиль) або Strapi (важкий), ProcessWire дає одне джерело даних для PHP-шаблонів та зовнішніх клієнтів. Ви пишете шаблони один раз, а JSON-вивід — просто другий шаблон із заголовками. Це знижує вартість підтримки на 30–40% за нашими оцінками. Налаштування ProcessWire API займає в 3 рази менше часу, ніж аналогічна інтеграція на Strapi.

документація підтверджує, що селектори працюють однаково в шаблонах та API.

Що входить у налаштування ProcessWire API