innmind / rest-bundle
This Bundle wraps the innmind rest server library
Installs: 22 308
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Type:symfony-bundle
Requires
- php: >=5.5
- guzzlehttp/guzzle: ~5.0
- innmind/rest-client: ~2
- innmind/rest-server: ~2
- innmind/url-resolver: ^1.0
- symfony/config: ~2.7|~3.0
- symfony/console: ~2.7|~3.0
- symfony/dependency-injection: ~2.7|~3.0
- symfony/filesystem: ~2.7|~3.0
- symfony/framework-bundle: ~2.7|~3.0
- symfony/http-kernel: ~2.7|~3.0
Requires (Dev)
- innmind/neo4j-onm: ~1.0
README
Wrapper for the innmind/rest-server
library allowing you to easily expose a REST L3 API.
This bundle offer a complete integration of the library in a symfony project. It also add a new feature called server capabilities; put simply, it expose a route OPTIONS *
that will output the list of routes exposed via this bundle. The goal being to allow client discovery, you could imagine a REST client that could prefetch all the resources definitions so it could know in advance if the resources it will try to send match the definitions.
Installation
composer require innmind/rest-bundle
Enable the bundle by adding the following line in your app/AppKernel.php
of your project:
// app/AppKernel.php // ... class AppKernel extends Kernel { public function registerBundles() { $bundles = array( // ... new Innmind\RestBundle\InnmindRestBundle, ); // ... } // ... }
Then specify your resources in the configuration under:
innmind_rest: server: collections: [] #same configuration as the rest server library prefix: /api/prefix #optional
Server
Storage
To define a storage you can create a service having either innmind_rest.server.storage.abstract.doctrine
or innmind_rest.server.storage.abstract.neo4j
as parent. Then you need to specify the first argument to construct the service, being an instance of an entity manager (a doctrine or neo4j one); and flag the service with the tag innmind_rest.server.storage
, the bundle will look for the attribute alias
on this tag to use as reference afterward (name used to specify storage on your resources).
Formats
As allowed formats are handled via encoders, you declare new ones with a tag on the encoder service you want to add.
Example of the built-in json
format:
innmind_rest.server.serializer.encoder.json: class: Innmind\Rest\Server\Serializer\Encoder\JsonEncoder tags: - { name: serializer.encoder } - { name: innmind_rest.server.format, format: json, mime: application/json, priority: 10 }
Events
In most cases the only event you'll want to alter will be KernelEvents::RESPONSE
or Events::{STORAGE}_READ_QUERY_BUILDER
(STORAGE
can be DOCTRINE
or NEO4J
) to add restriction on the query like for example the user being connected.
You can look at Events.php
to review all the events you have at your disposition.
Client
To consume an API you need to use the innmind_rest.client
service. Examples of usages:
use Innmind\Rest\Client\HttpResource; $client = $container->get('innmind_rest.client'); $resources = $client->getServer('http://example.com')->read('some_resource'); $resource = $client->getServer('http://example.com')->read('some_resource', 42); $toCreate = new HttpResource; $toCreate->set('someProperty', 'value'); $client->getServer('http://example.com')->create('some_resource', $toCreate); $toUpdate = new HttpResource; $toUpdate ->set('all', 'properties') ->set('must', 'be set'); $client->getServer('http://example.com')->update('some_resource', 42, $toUpdate); $client->getServer('http://example.com')->remove('some_resource', 42);
You can use $server->getResources()
to view all the resources exposed by the server API; it will return an associative array with the names as keys and the definitions as values.