Download the PHP package vjeantet/silex-simple-rest-swagger without Composer
On this page you can find all versions of the php package vjeantet/silex-simple-rest-swagger. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package silex-simple-rest-swagger
Silex Simple REST with its auto generated documentation with Swagger
A simple silex skeleton application for writing RESTful API. Based on the silex-simple-rest github repo from Alessandro Arnodo. silex-simple-rest-swagger is a fork, which add a swagger REST API Documentation, auto generated.
This project wants to be a starting point to writing scalable and maintainable REST api with Silex PHP micro-framework
Continuous Integration is provided by Travis-CI.
How do I run it?
From this folder run the following commands to install the php and bower dependencies, import some data, and run a local php server.
You need at least php **5.4.* with SQLite extension enabled and Composer**
composer install
sqlite3 app.db < resources/sql/schema.sql
php -S 0:9001 -t web/
You can install the project also as a composer project
composer create-project vjeantet/silex-simple-rest-swagger
Your api is now available at http://localhost:9001/api/v1.
You can visualise your api documentation going to : http://localhost:9001/swagger-ui//
- your swagger specification (json) is available at http://localhost:9001/api/api-docs.
Run tests
Some tests were written, and all CRUD operations are fully tested :)
From the root folder run the following command to run tests.
vendor/bin/phpunit
What you will get
The api will respond to
GET -> http://localhost:9001/api/v1/notes
POST -> http://localhost:9001/api/v1/notes
POST -> http://localhost:9001/api/v1/notes/{id}
DELETE -> http://localhost:9001/api/v1/notes/{id}
Your request should have 'Content-Type: application/json' header. Your api is CORS compliant out of the box, so it's capable of cross-domain communication.
Try with curl:
#GET
curl http://localhost:9001/api/v1/notes -H 'Content-Type: application/json' -w "\n"
#POST (insert)
curl -X POST http://localhost:9001/api/v1/notes -d '{"note":"Hello World!"}' -H 'Content-Type: application/json' -w "\n"
#POST (update)
curl -X POST http://localhost:9001/api/v1/notes/1 -d '{"note":"Uhauuuuuuu!"}' -H 'Content-Type: application/json' -w "\n"
#DELETE
curl -X DELETE http://localhost:9001/api/v1/notes/1 -H 'Content-Type: application/json' -w "\n"
What's under the hood
Take a look at the source code, it's self explanatory :) More documentation and info about the code will be available soon.
Under the resources folder you can find a .htaccess file to put the api in production.
Contributing
Fell free to contribute, fork, pull request, hack. Thanks!
Author
License
see LICENSE file.
All versions of silex-simple-rest-swagger with dependencies
silex/silex Version ~1.1
monolog/monolog Version ~1.6
twig/twig Version ~1.14
doctrine/dbal Version ~2.4
nesbot/carbon Version ~1.6
zircote/swagger-php Version ~0.9
jdesrosiers/silex-swagger-provider Version ~1.0