zored/speech

JSON-RPC 2.0 for PHP. With Symfony 2.0 to 3.0 support.

Speech

JSON-RPC 2.0 for PHP

, _(*1)

Bundle for JSON-RPC 2.0. You can use as standalone library. Or with Symfony., _(*2)

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: yaml json_rpc: defaults: { _controller: ZoredSpeechBundle:Default:jsonRpc } methods: [POST] # Or GET for Zored RPC. path: /json-rpc
• Add service with your JSON-RPC methods in services.yml: yaml services: your.service: # Replace with your own class: class: 'Zored\SpeechBundle\Test\JsonRpc\Greeter'
• Allow this service to run in default controller via parameters.yml: yaml parameters: zored.speech.controller.context.service_ids: ['your.service']
• Clear caches.
• Test: bash curl http://example.com/json-rpc/ \ --data '{"id":"1", "method":"your.service:greet", "params":{"person":{"name":"bob","age":19}},"jsonrpc":"2.0"}'

Standalone library

• See example in web/index.php
• Run there server with php -S 127.0.0.1:8080
• Test: bash curl http://127.0.0.1:8080 \ --data '{"id":"1", "method":"your.service:greet", "params":{"person":{"name":"bob","age":19}},"jsonrpc":"2.0"}'

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 single for {} and 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., _(*3)