README

###What is it?

A quick and dirty way to get a php REST backend running with two lines of code. Not to be used on production. I use it mainly to test client side javascript / mobile apps during development.

###Installation

composer require zulfajuniadi/tinyrest:0.*

###Usage

Let's say my little app has two restful endpoints:

/projects
/tasks

By instantiating TinyREST like so:

new Tinyrest\Handle(['projects', 'todos']);

I now have a fully functional backend for my app that handles these routes:

Projects Routes:

Todos Routes:

###Examples

View the index.php file in the examples folder.

###Event Listeners

TinyREST exposes the on method that enables you to bind to events on an endpoint. Let's say I were to log all data created on the projects, I would do so like:

    $TinyRest = new Tinyrest\Handle(['projects', 'todos'], '../data/');
    $projects = $TinyRest->router('projects');
    
    // Do something when a new project is created
    $listener_id = $projects->on('create', function($new_data){
        // Log $new_data creation
    });
    
    // To stop listening to the event
    $projects->off('create', $listener_id);

Events fired:

###Data Persistance

TinyREST stores each endpoint data inside it's own .json file in the public directory. To change the directory, provide a second argument to point to your preferred data directory as per example below:

new Tinyrest\Handle(['projects', 'todos'], '../data/');

###Contributions Welcome

You contributions are very much appreciated mainly in these areas:

Providing unit tests
Bug reporting and fixing
Documentations

Please fork this repository and create a pull request for it to be merged.

###License

ISC

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

zulfajuniadi / tinyrest

Maintainers

Details

README