360i/sonno

Sonno is a lightweight PHP framework based loosely on Jersey, a Java ReST framework reference implementation of the JAX-RS specification.

Tuesday, February 26, 2013
by davehauenstein
Repository
4 Watchers
15 Stars
24 Installations

PHP
0 Dependents
0 Suggesters
3 Forks
4 Open issues
2 Versions
0 % Grown

, _(*1)

Sonno - A RESTful PHP Framework!

Sonno is a lightweight PHP framework based loosely on Jersey, a Java ReST framework reference implementation of the JAX-RS specification., _(*2)

Plain-Old-PHP objects are configured with a set of annotations describing a set of Resources., _(*3)

``` php, _(*4)

<?php, _(*5)

namespace Sonno\Example\Resource;, _(*6)

use Sonno\Http\Response\Response, Sonno\Annotation\Path, Sonno\Annotation\GET, Sonno\Annotation\POST, Sonno\Annotation\Context, Sonno\Annotation\Produces, Sonno\Annotation\Consumes, Sonno\Annotation\PathParam, Sonno\Example\Representation\User\Collection as UserCollection;, _(*7)

/** * @Path("/") */ class HelloResource { /** * @Context("Request") */ protected $_request;, _(*8)

/**
 * @GET
 * @Produces({"text/plain"})
 */
public function getHelloWorld()
{
    return 'Hello ReSTful World!';
}

/**
 * @GET
 * @Path("/users")
 * @Produces({"application/xml"})
 */
public function getUserCollection()
{
    return new UserCollection('application/xml');
}

/**
 * @POST
 * @Path("/users")
 * @Consumes({"application/xml"})
 */
public function saveUserXml()
{
    // Retrieve the request body.
    $data = $this->_request->getRequestBody();

    // ... Do some processing of $data, then save it...

    $response = new Response();
    return $response->setCreated('http://example.sonno.dev/users/10');
}

}, _(*9)


License
-------

Sonno is licensed under the New BSD license. A copy can be
found here:
[http://sonno.360i.com/LICENSE.txt](http://sonno.360i.com/LICENSE.txt)

Dependencies
------------

The current version of Sonno supports configuring a ReSTful web application
via annotations. Rather than reinvent the wheel and develop our own annotation
reader, we've provided interfaces and adapters. The adapter that ships with
this version uses Doctrine-Common version >= 2.1.1. That's not to say that any
developer couldn't implement their own annotation reader, then build an adapter
that implements Sonno\Annotation\Reader\ReaderInterface.

Here's an example of how a Sonno application can be configured using Doctrine's
annotation reader:

``` php
<?php

use Sonno\Configuration\Driver\AnnotationDriver,
    Sonno\Annotation\Reader\DoctrineReader,
    Doctrine\Common\Annotations\AnnotationReader,
    Doctrine\Common\Annotations\AnnotationRegistry;

$doctrineReader = new AnnotationReader();
AnnotationRegistry::registerAutoloadNamespace(
    'Sonno\Annotation',
    realpath('path/to/Sonno/src')
);

$annotationReader = new DoctrineReader($doctrineReader);
$resources = array(
    'FQNS\To\SomeResource',
    'FQNS\To\SomeOtherResource',
);

$driver = new AnnotationDriver($resources, $annotationReader);
$config = $driver->parseConfig();

Summary of Annotations

Annotation	Target	Description
@Path	Class, Method	Specifies a relative path for a resource. When used on a class this annotation identifies that class as a root resource. When used on a method this annotation identifies a sub-resource method or locator.
@Consumes	Class, Method	Specifies a list of media types that can be consumed.
@Produces	Class, Method	Specifies a list of media types that can be produced.
@Context	Property	Identifies an injection target for a Request object.
@DELETE	Method	Specifies that the annotated method handles HTTP DELETE requests.
@GET	Method	Specifies that the annotated method handles HTTP GET requests.
@HEAD	Method	Specifies that the annotated method handles HTTP HEAD requests.
@OPTIONS	Method	Specifies that the annotated method handles HTTP OPTIONS requests.
@POST	Method	Specifies that the annotated method handles HTTP POST requests.
@PUT	Method	Specifies that the annotated method handles HTTP PUT requests.
@PathParam	Method	Specifies that the value of a method parameter is to be extracted from the request URI path. The value of the annotation identifies the name of a URI template parameter.
@QueryParam	Method	Specifies that the value of a method parameter is to be extracted from a URI query parameter. The value of the annotation identifies the name of a query parameter.
@CookieParam	Method	Specifies that the value of a method parameter is to be extracted from a HTTP cookie. The value of the annotation identifies the name of a the cookie.
@FormParam	Method	Specifies that the value of a method parameter is to be extracted from a form parameter in a request entity body. The value of the annotation identifies the name of a form parameter. Note that whilst the annotation target allows use on fields and methods, the specification only requires support for use on resource method parameters.
@HeaderParam	Method	Specifies that the value of a method parameter is to be extracted from a HTTP header. The value of the annotation identifies the name of a HTTP header.

Contribution Guidelines

Coding Standard

We strictly adhere to the Zend Framework coding standard. Before pushing to the origin, you should run PHP_CodeSniffer: $ phpcs --standard=zend src. All errors and warnings should be cleaned up before making a pull request., _(*10)

Add Test Cases

We try to keep our Code Coverage high and our CRAP index low. Before submitting a pull request, run the PHPUnit test suite and ensure that all tests pass. If you add functionality or fix a bug, please include test cases to cover the code you've sumitted., _(*11)