Download the PHP package eden/server without Composer
On this page you can find all versions of the php package eden/server. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package server
Short Description Express style server
License MIT
Homepage http://eden-php.com
Informations about the package server
Eden Server
- Install
- Introduction
- API
- add
- all
- child
- delete
- error
- get
- getRequest
- getResponse
- getParent
- output
- post
- process
- put
- redirect
- render
- route
- setParent
- success
- Contributing
====
Install
composer install eden/server
====
Introduction
Eden Server is an Express style web service. It allows all kinds of webframeworks to be developed because heavily relies on external middleware. A quick example of this usage is found below.
There are 3 kinds of middleware it accepts and are called during specific times during the response process.
Global Middleware
Global Middleware are called before any response is generated. Some examples of global middleware can be
- Security - like CSRF checking, Captcha, CORS, HTPASSWD, etc.
- API - like Facebook Login, Paypal, etc.
- Utility - like geoip, localization, internationalization, etc.
You can simply add global middleware in this fashion.
Route Middleware
Route Middleware are called when the request is formed right after the Global Middleware. To make a route available you will need the request method, desired route path and the callback handler.
You can simply add route middleware in this fashion.
Routes can accept dynamic variables denoted as *
, described in the example route /some/path/*/foo
. These variables are accessable by calling $id = $request->get('variables', 0);
in your route handler callback. If your route is using a common request method like POST
, GET
, PUT
, DELETE
, there are wrapper methods recommended to use instead.
For all the above methods you can also set the response by returning the string like below.
Error Middleware
Error Middleware are called when either the Global or the Route Middleware throws an Exception. You can simply add an error middleware in this fashion.
====
API
====
add
Adds global middleware
Usage
Parameters
function $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
all
Adds routing middleware for all methods
Usage
Parameters
string $path
- The route pathfunction $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
child
Returns a new instance with the same configuration
Usage
Parameters
Returns Eden\Server\Index
====
delete
Adds routing middleware for delete method
Usage
Parameters
string $path
- The route pathfunction $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
error
Adds error middleware
Usage
Parameters
function $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
get
Adds routing middleware for get method
Usage
Parameters
string $path
- The route pathfunction $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
getRequest
Returns a request object
Usage
Parameters
Returns Eden\Registry\Index
====
getResponse
Returns a response object
Usage
Parameters
Returns Eden\Registry\Index
====
getParent
Returns the parent server
Usage
Parameters
Returns Eden\Server\Index
====
output
Evaluates the response in order to determine the output. Then of course, output it
Usage
Parameters
Eden\Registry\Index $response
- The response object to evaluate
Returns Eden\Server\Index
Example
====
post
Adds routing middleware for post method
Usage
Parameters
string $path
- The route pathfunction $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
process
Starts to process the request
Usage
Parameters
Returns array
- with request and response inside
====
put
Adds routing middleware for put method
Usage
Parameters
string $path
- The route pathfunction $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
redirect
Browser redirect
Usage
Parameters
string $path
- Where to redirect to
Returns mixed
Example
====
render
Process and output
Usage
Parameters
Returns Eden\Server\Index
====
route
Adds routing middleware
Usage
Parameters
string $method
- The request methodstring $path
- The route pathfunction $callback
- The middleware handler
Returns Eden\Server\Index
Example
====
setParent
Returns if we were able to output something
Usage
Parameters
Eden\Server\Index $parent
- The parent server
Returns Eden\Server\Index
Example
====
success
Returns if we were able to output something
Usage
Parameters
Returns bool
====
Contributing to Eden
Contributions to Eden are following the Github work flow. Please read up before contributing.
Setting up your machine with the Eden repository and your fork
- Fork the repository
- Fire up your local terminal create a new branch from the
v4
branch of your fork with a branch name describing what your changes are. Possible branch name types:- bugfix
- feature
- improvement
- Make your changes. Always make sure to sign-off (-s) on all commits made (git commit -s -m "Commit message")
Making pull requests
- Please ensure to run
phpunit
before making a pull request. - Push your code to your remote forked version.
- Go back to your forked version on GitHub and submit a pull request.
- An Eden developer will review your code and merge it in when it has been classified as suitable.
All versions of server with dependencies
eden/core Version 4.*
eden/string Version 4.*
eden/array Version 4.*
eden/registry Version 4.*