ufo-tech / rpc-objects

3.8.1 2026-09-25 14:47 UTC

Requires

• php: >=8.3
• ext-intl: *
• symfony/http-client: *
• symfony/property-access: *
• symfony/property-info: ^7.2|^8.0
• symfony/serializer: ^7.2|^8.0
• symfony/validator: ^7.2|^8.0
• ufo-tech/dto-transformer: ^3.1
• ufo-tech/rpc-exceptions: ^2.0.1

Requires (Dev)

• phpunit/phpunit: ^11.5
• symfony/cache: ^7.2|^8.0
• symfony/lock: ^7.2|^8.0

MIT

• Alex Maistrenko
• Valik Nikolaev

Published on Packagist.org on 2026-09-25 14:48 UTC

README

Component for UFO-Tech RPC Library 🇺🇦

This package provides structured DTO handling for use in RPC-oriented systems, including:

• Attribute-based validation (Assertions)
• Recursive transformation into nested DTOs (DTO, ResultAsDTO)
• Conversion from/to arrays (IArrayConstructible, IArrayConvertible)
• Clean and extensible architecture compatible with Symfony Validator

Installation

composer require ufo-tech/rpc-objects

Requests and notifications

Use Ufo\RpcObject\Factory\RpcRequestFactory to parse incoming messages:

use Ufo\RpcObject\Factory\RpcRequestFactory;
use Ufo\RpcObject\RpcNotificationRequest;

$request = RpcRequestFactory::fromArray([
    'jsonrpc' => '2.0',
    'id' => 0,
    'method' => 'users.find',
    'params' => ['name' => 'Ada'],
]); // RpcRequest, id remains 0

$notification = RpcRequestFactory::fromJson(
    '{"jsonrpc":"2.0","method":"users.refresh"}',
    apiVersion: 'v2',
); // RpcNotificationRequest

Only the absence of the id key selects a notification. An explicit null or invalid ID remains an ordinary request with a validation error under the existing ID rules. Invalid messages retain their errors in hasError() / getError().

RpcRequest::fromArray() and RpcRequest::fromJson() delegate construction to the factory; parsing a batch uses the same selection for each entry. Calls made on an explicit subclass retain that subclass.

Notifications keep an internal generated ID for queue bookkeeping, but toArray() and refreshRawJson() omit the top-level id field. The request handler must use instanceof RpcNotificationRequest to suppress outgoing responses, including in batches; response dispatch remains the responsibility of the consuming application.

Development and tests

Requires PHP >=8.3 and development dependencies:

composer install
composer test
composer test:coverage

The coverage command requires Xdebug and generates build/coverage/index.html. See tests/README.md for Docker commands, test scope, and known limitations.