willgarcia/silex-api-boilerplate

Silex application for getting started with your API.

README

, _(*1)

silex-api-boilerplate

A starting point for building your RESTful API within a Silex application., _(*2)

Prerequisites

• PHP >=5.4
• Grunt-cli >= 0.1.6

Components

This project uses the following components:, _(*3)

• Silex application
• HATEOAS API
• [API key authentication]
• Monolog as a service provider
• Functional tests with Behat 3

API

The provided API stands as an example, and supports the HAL format., _(*4)

API Endpoints (see app/routing.php) :, _(*5)

/api                                # API entry point               ; secured route
/api/errors                         # API errors list               ; secured route
/api/errors/{code}                  # API error description         ; secured route
/api/customers                      # Customers list                ; secured route
/api/customers/{cid}                # Customer informations         ; secured route
/api/customers/{cid}/licenses       # Customer's licenses list      ; secured route
/api/customers/{cid}/licenses/{lid} # Customer license informations ; secured route

Installation

$ composer create-project willgarcia/silex-api-boilerplate my-new-api -s dev
$ npm install
$ grunt

Development

For development purposes only, you can serve the API by starting a PHP built-in web server:, _(*6)

$ cp app/env_dev.php-dist app/env_dev.php
$ API_ENV=dev php -S 0.0.0.0:4000 web/index.php

See http://php.net/manual/en/features.commandline.webserver.php, _(*7)

From here, you can access to this URL: http://localhost:4000, _(*8)

Tests

$ bin/behat tests/functional/features/

License

Silex-api-boilerplate is released under the MIT License. See the bundled LICENSE file for details., _(*9)