odino/exphpress

The missing, elegant, productive microframework for PHP, inspired by ExpressJS.

Exphpress

, _(*1)

The missing, elegant, productive microframework for PHP, inspired by ExpressJS., _(*2)

Because PHP is cool too., _(*3)

Example

The very least you need:, _(*4)

``` php <?php, <sub>(*5)</sub>

$app = Exphpress\app();, <sub>(*6)</sub>

$app->listen(function($req, $res){ $date = new \DateTime();, <sub>(*7)</sub>

$res->setContent("Today is " . $date->format('l, jS \o\f F Y'));

});, <sub>(*8)</sub>

This will return, for every request, something like
`Today is Sunday, 13th of July 2014,`; if you want to see it in action
clone this repository and run `php -S localhost:4000 examples/simple.php`.

## Getting fancy

Matching a GET request is quite simple:

``` php
<?php

$app = Exphpress\app();

$app->get("/call-me-maybe/{name}", function($req, $res){
    $res->setContent("Hey, I just matched you, and this is crazy...");
});

The above route will be matched when we issue a GET request to our webserver that matches the path /call-me-maybe/{name}., <sub>(*9)</sub>

The same can be done for post and all other HTTP methods., <sub>(*10)</sub>

Write your own middleware

Middlewares play a big part in a microframework's architecture:, <sub>(*11)</sub>

``` php $app->uses(function($req, $res, $next){ if ($todayIsABadDay) { $res->setStatusCode(403); $res->setContent(null); } else { $next(); } });, <sub>(*12)</sub>

As you probably understood, the `$next` is a callback that invokes
the following middleware, which means that you concatenate them at
will (ie. look at [this test](https://github.com/odino/exphpress/blob/6e92cc453185199d2a878ae146b83c395e4bc19c/spec/Exphpress/AppSpec.php#L113-L138)).

## Installation

Exphpress is available through [composer](https://packagist.org/packages/odino/exphpress)
(how else?!?!).

## Tests

They run on travis through phpspec: if you want to contribute or
hack around exphpress simply clone this repository and check into
greenland with a:

./vendor/bin/phpspec run ```, <sub>(*13)</sub>

License

For those who care, exphpress is release under the MIT license., <sub>(*14)</sub>

The hell, why?

There's Silex, I know, but I couldn't resist., <sub>(*15)</sub>