grobmeier / cicada
Tiny PHP framework for quickly creating webapps, inspired by Rubys Sinatra
Requires
- php: >=5.4.0
- evenement/evenement: ~2.0.0
- pimple/pimple: ~3.0.0
- symfony/http-foundation: ~2.6.0
- symfony/http-kernel: ~2.6.0
Requires (Dev)
- mockery/mockery: ~0.9.3
- phpunit/phpunit: 4.*
- satooshi/php-coveralls: *
README
A micro framework for creating traditional or REST-like web applications.
Installation
Add Cicada as a requirement for your project via Composer:
composer require "cicada/cicada=@stable"
Usage
Minimal application:
require '../vendor/autoload.php'; use Cicada\Application; use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Response; $app = new Application(); // Add a route $app->get('/hello/{name}', function (Application $app, Request $request, $name) { return new Response("Hello $name"); }); $app->run();
This application has one route which will match GET requests starting with
/hello/
and will forward the matched {name}
into the callback function as
$name
.
The callback function should return a Response object. If it returns a string, it will implicitly be converted into a Response.
Handling exceptions
It is possible that route callbacks throw an exception. By default, Cicada will in this case return a HTTP 500 response (Internal Server Error). However, it is possible to add exception handlers which will intercept specific exceptions and return an appropriate response.
For example, if you want to catch a custom NotImplementedException and return a custom error message:
$app->exception(function (NotImplementedException $ex) { $msg = "Dreadfully sorry, old chap, but tis' not implemented yet."; return new Response($msg, Response::HTTP_INTERNAL_SERVER_ERROR); });
The callback function passed to $app->exception()
must have a single argument
and that argument must have a class type hint which denotes the exception class
which it will handle.
It's possible to specify multiple exception handlers and they will be tried in order in which they were specified:
$app->exception(function (SomeException $ex) { return new Response("Arrrghhhhh", Response::HTTP_INTERNAL_SERVER_ERROR); }); $app->exception(function (OtherException $ex) { return new Response("FFFFUUUUUUU...", Response::HTTP_INTERNAL_SERVER_ERROR); }); // If all else fails, this will catch any exceptions $app->exception(function (Exception $ex) { $msg ="Something went wrong. The incident has been logged and our code monkeys are on it."; return new Response($msg, Response::HTTP_INTERNAL_SERVER_ERROR); });