Як організувати видачу контенту через 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 | ProcessWire GraphQL |
|---|---|---|
| Складність реалізації | Середня (шаблон-роутер) | Низька (модуль + конфіг) |
| Швидкість розробки | 2–4 дні | 1–2 дні |
| Контроль над відповіддю | Повний | Обмежений налаштуваннями |
| Типізація | Немає | Є (через GraphQL schema) |
| Кешування на рівні | Endpoint | Запит (через persisted queries) |
REST краще, коли потрібна мінімальна відповідь і повний контроль. GraphQL — якщо клієнтам потрібна гнучкість вибірки полів.
Які переваги ProcessWire як Headless CMS?
На відміну від WordPress (де API — костиль) або Strapi (важкий), ProcessWire дає одне джерело даних для PHP-шаблонів та зовнішніх клієнтів. Ви пишете шаблони один раз, а JSON-вивід — просто другий шаблон із заголовками. Це знижує вартість підтримки на 30–40% за нашими оцінками. Налаштування ProcessWire API займає в 3 рази менше часу, ніж аналогічна інтеграція на Strapi.
документація підтверджує, що селектори працюють однаково в шаблонах та API.
Що входить у налаштування ProcessWire API
| Етап | Тривалість | Опис |
|---|---|---|
| Проектування | 0.5 дня | Схема endpoint-ів, типи даних |
| Реалізація REST | 1–2 дні | Шаблон-роутер, авторизація, CORS |
| Або GraphQL | 0.5–1 день | Модуль, конфіг, тести |
| Кешування | 0.5 дня | WireCache + Redis |
| Документація | 0.5 дня | Postman або Swagger |
| Тестування та деплой | 1 день | Навантажувальні тести, моніторинг |
Типові помилки: як їх уникнути?
- Неправильні заголовки CORS (не всі методи дозволено)
- Відсутність лімітів на запити (вразливість)
- Серіалізація всього об'єкта $page (витік зайвих даних, повільний response)
- Немає кешу — кожен запит навантажує БД
Ми все це враховуємо з першого дня.
Як ми це робимо: етапи
- Аналітика: вивчаємо структуру шаблонів та полів, визначаємо потрібні endpoint-и.
- Проектування: малюємо схему даних і вирішуємо, що віддаємо клієнту.
- Реалізація: пишемо шаблон-роутер або підключаємо GraphQL, налаштовуємо кеш.
- Тестування: перевіряємо всі endpoint-и, навантажувальне тестування (100 concurrent requests).
- Деплой: заливаємо на бойовий сервер, налаштовуємо моніторинг.
Гарантуємо результат: якщо через 4 дні API не працює — доводимо до ладу безкоштовно. Досвід — 30+ проєктів на ProcessWire.
REST API на ProcessWire розробляється в 2–3 рази швидше, ніж на WordPress з плагінами, завдяки єдиному синтаксису селекторів.
Наші переваги: 30+ проєктів ProcessWire API
Маємо 7+ років досвіду та 30+ реалізованих проєктів. За 7 років роботи з ProcessWire ми реалізували API для e-commerce-платформ, SaaS-сервісів та контентних порталів. Знаємо неочевидні обмеження: поведінку PermissionManager при headless-режимі, нюанси ProCache з Bearer-токенами, особливості fieldgroup при серіалізації вкладених об'єктів. Найнавантаженіша конфігурація з нашої практики обробляє 100 000 запитів на добу на сервері з 4 GB RAM без деградації. Готові взятися за проєкт будь-якої складності: від базового REST з п'ятьма endpoint-ами до GraphQL з персистентними запитами та real-time підпискою. ProcessWire SPA-застосунки отримують дані через API. Надішліть опис вашого завдання — запропонуємо оптимальний стек і оцінимо за 1 робочий день.
Отримайте консультацію по вашому проєкту — напишіть нам, оцінимо за 1 день. Зв'яжіться з нами в чаті або поштою.