cicada/cicada

Tiny PHP framework for quickly creating webapps, inspired by Rubys Sinatra

Tuesday, May 9, 2017
by ihabunek
Repository
2 Watchers
8 Stars
5,239 Installations

PHP
0 Dependents
0 Suggesters
5 Forks
3 Open issues
20 Versions
3 % Grown

The README.md

Cicada

A micro framework for creating traditional or REST-like web applications., _(*1)

, _(*2)

Installation

Add Cicada as a requirement for your project via Composer:, _(*3)

composer require "cicada/cicada=@stable"

Usage

Minimal application:, _(*4)

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., _(*5)

The callback function should return a Response object. If it returns a string, it will implicitly be converted into a Response., _(*6)

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., _(*7)

For example, if you want to catch a custom NotImplementedException and return a custom error message:, _(*8)

$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., _(*9)

It's possible to specify multiple exception handlers and they will be tried in order in which they were specified:, _(*10)

$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);
});

The Versions

09/05 2017

dev-master

9999999-dev https://github.com/cicada/cicada

Tiny PHP framework for quickly creating webapps, inspired by Rubys Sinatra

library cicada

Tiny PHP framework for quickly creating webapps, inspired by Rubys Sinatra

cicada/cicada

The README.md

Cicada

Installation

Usage

Handling exceptions

The Versions

dev-master

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.5.1

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

dev-develop

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.5.0

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.12

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.11

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.10

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.9

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.8

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.7

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.6

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.5

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.4

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.3

The Requires

The Development Requires

by Ivan Habunek

by Christian Grobmeier

0.4.2