Download the PHP package zored/speech without Composer

Speech

JSON-RPC 2.0 for PHP

Bundle for JSON-RPC 2.0. You can use as standalone library. Or with Symfony.

Features

• Validation. Based on Symfony Validator component.
• Deserialization. Based on JMS.
• Customization. Change your rules for JSON-RPC 2.0.

Use

Symfony

• Install package: composer require zored/speech.
• Add bundle new Zored\SpeechBundle\ZoredSpeechBundle() to your Symfony kernel app/AppKernel.php.

• Add route to default endpoint: routing.yml:

• Add service with your JSON-RPC methods in services.yml:

• Allow this service to run in default controller via parameters.yml:

• Clear caches.
• Test:

Standalone library

• See example in web/index.php
• Run there server with php -S 127.0.0.1:8080
• Test:

What's next?

• See default controller if you need multiple JSON-RPC endpoints.
• See tests to know how it works.

Inside

• Your request JSON string goes to endpoint which handles it and returns Symfony response.
• Endpoint chooses which request passer can pass JSON string to request handler.
  • There are batch for [{},{}] passers enabled by default.
• Request passer also deserializes JSON to object and validates it.
• Request passer passes request object to request handler that pushes request somewhere to get response.
  • Now service handler is used to:
    • Deserialize request params if set with parameter converter.
    • Call public method of service with these params. Services are restricted with ServiceContext. For default controller see zored.speech.controller.context parameter.
    • Wait for array or AbstractResponse.
• Request then passed back and serialized to array.

Events

You can see available events here.