• Home
• io.swagger
• swagger-codegen
• 2.4.31
• source code
• README.md.mustache

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

ze-ph.README.md.mustache Maven / Gradle / Ivy

# Swagger generated server

Generated by the [swagger-codegen](https://github.com/swagger-api/swagger-codegen) project.

## Overview
This server stub aims to provide light, yet comprehensive structure for your API project using:

- PHP: 5.6 or 7.*
- [Zend Expressive](https://zendframework.github.io/zend-expressive): 2.1
- [Path Handler](https://github.com/Articus/PathHandler): 0.3

## How to use
All you have to do to start development is:

- install dependencies via [Composer](https://getcomposer.org/)
- create cache folder: `mkdir -p ./data/cache/ZendCache` (you will need it later for configuration and metadata caches - check comments in `./application/conig.yml`)
- start PHP development server: `php -S 0.0.0.0:8080 -t ./public` (or any other SAPI you prefer, just make sure that you configure webroot to `./public` and rewrites to `./public/index.php`)

After that you should be able to call all methods from your API spec. Most of the negative scenarios should be handled:

- `404 Not found` for unknown routes
- `406 Not acceptable` for invalid `Accept` header
- `415 Unsupported media type` for invalid `Content-Type` header
- `400 Malformed JSON` for unparsable JSON body
- `422 Unprocessable entity` for parsable JSON body that fails validation

But for obvious reason you will not get any `200 OK`, only `500 Not implemented`. So your next steps are:

- check all TODOs left in the stub code where generator was not smart enough and could not guarantee correct implementation
- implement your API security mechanism (either special attribute or separate middleware) - generator does not do anything about it yet
- implement your handlers - the most tricky part :)

## Enjoy!
Hopefully this stub will reduce the amount of boilerplate code you have to write manually. If you have any suggestions or questions about `ze-ph` generator, feel free to create issue either in [Path Handler repository](https://github.com/Articus/PathHandler/issues) or in [Swagger Codegen repository](https://github.com/swagger-api/swagger-codegen/issues).