docs: rewrite JsonRpcBundle docs, add SDK docs, move them under docs/api
uk/docs/api/json-rpc-bundle/change_log/README.md
новий файл +28
−0
Історія змін
<include>(latest.md)
<include>(10.3.1.md)
<include>(10.2.3.md)
<include>(10.1.0.md)
<include>(10.0.0.md)
<include>(9.2.1.md)
<include>(9.1.5.md)
<include>(8.1.14.md)
<include>(7.6.0.md)
<include>(7.0.0.md)
<include>(6.4.0.md)
<include>(5.2.0.md)
<include>(4.5.2.md)
Повний опис кожного релізу з прикладами — у теці releases репозиторію бандла.
uk/docs/api/json-rpc-bundle/change_log/latest.md
новий файл +1
−0
<include>(10.4.2.md)
uk/docs/api/json-rpc-bundle/change_log/10.4.2.md
новий файл +17
−0
Версія 10.4
Ключові зміни
- Переклади для груп API:
translations/rpc/<group>.<locale>.yaml; група важливіша за мову. - Переклади з розширень (
translations.paths), публічний сервісRpcLocaleNegotiator. - 10.4.1:
IApiRouteImport— маршрути адаптера можна підключити окремо для кожної групи API. - 10.4.2:
RpcExecutor— єдина точка входу для адаптерів (REST, MCP);rpc.post_responseзапускається для будь-якого джерела запиту і для кожного виконаного елемента batch.
Що врахувати
- Частковий базовий переклад: відсутній
descriptionбереться з базового перекладу мовоюkernel.default_locale, а не з атрибута / PHPDoc. - REST-виклики тепер отримують
rpc.post_response: для них запрацюють зв'язки кешу й async/notification-лістенери.
Зміни оточення
- Без змін відносно 10.3.
uk/docs/api/json-rpc-bundle/change_log/10.3.1.md
новий файл +28
−0
Версія 10.3
Ключові зміни
- У 2,4–4,2 раза більше запитів за секунду для звичайних викликів і документації.
- Налаштування batch:
enabled, inline-режим, ліміт паралельних процесівprocess_count. - Notifications у batch за специфікацією: без відповіді, batch лише з notifications —
204. - Від'єднане виконання notifications (
notification.process). - Переклад назв і описів методів за
Accept-Language, кеш документації зETag. cache.pool— власний пул кешу; ключ кешу відповідей містить реалізацію методу й версію API.- Токен і тіло запиту більше не передаються в командному рядку дочірніх процесів.
10.3.1
- Знову виконуються XHR-запити (
X-Requested-With: XMLHttpRequest). - Знову працює
#[Autowire]в аргументах RPC-методу. - Знову застосовується
#[RPC\Info(concat: …)]— перевірте клієнтів, якщо заданоconcat. - Застарілі методи знову позначаються в OpenRPC.
Що врахувати
batch.process_countза замовчуванням 2 — великі batch у процесному режимі стали повільнішими.- Terminate-лістенери застосунку тепер виконуються після RPC-запитів.
- Змінились конструктори кількох сервісів (лише при ручному створенні чи успадкуванні);
DocSecurityListenerвидалено.
Зміни оточення
ufo-tech/rpc-objects:^3.9.1.
uk/docs/api/json-rpc-bundle/change_log/10.2.3.md
новий файл +18
−0
Версія 10.2
Ключові зміни
- Групи API: кілька точок входу (public, internal, BFF) з власними методами, версіями й документацією; атрибут
#[RPC\APIGroups]. - Перевірка токенів для кожної групи через
security.providers(сервіс-валідатор або окремий список токенів). - Завантажувачі маршрутів
ApiYamlFileLoader/RpcYamlFileLoaderдля адаптерів. --api-groupдля консолі,apiGroupдля Messenger.- Batch на версійну адресу виконує елементи в цій версії.
Що врахувати
- Назви маршрутів отримали префікс групи (
general_ufo_rpc_api_server); старі назви лишаються аліасами дляgeneral. - Конструктор
SimpleTokenValidator:(RpcMainConfig $rpcConfig)->(array $tokens = []).
Зміни оточення
PHP:>=8.4.ufo-tech/rpc-objects:^3.9.
uk/docs/api/json-rpc-bundle/change_log/10.1.0.md
новий файл +14
−0
Версія 10.1
Ключові зміни
- Підтримка Symfony 8 (
^7.2|^8.0). - JSON-RPC notifications: запит без
idотримує204і виконується після відповіді. - Сувора перевірка JSON-RPC 2.0:
jsonrpc≠"2.0"і порожній batch відхиляються з-32600. - Єдиний формат помилок параметрів: усі проблеми по кожному параметру в
error.data.
Зміни оточення
PHP:>=8.3->>=8.4.Symfony:^7.2->^7.2|^8.0;symfony/messengerстав явною залежністю.ufo-tech/rpc-exceptions:^1.3->^2;ufo-tech/rpc-objects:^3.8;ufo-tech/dto-transformer:^3.1.