nice

A nice PHP microframework.

This microframework integrates nikic's FastRoute router with the Symfony 2 HttpKernel.

<?php

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use TylerSommer\Nice\Application;

require __DIR__ . '/../vendor/autoload.php';

$app = new Application(function (FastRoute\RouteCollector $r) {
       $r->addRoute('GET', '/', function (Request $request) {
               return new Response('Hello, world');
           });
   });
$app->run();

Further improvements to come:

• Some kind of dependency injection solution
• Production/development environments
• Caching of some kind

Installation

The recommended way to install Nice is through Composer. Just create a composer.json file in your project directory and run the php composer.phar require command to install it:

php composer.phar require tyler-sommer/nice:dev-master nikic/fast-route:dev-master

Usage

In your web directory, create index.php and add:

<?php

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use TylerSommer\Nice\Application;

require __DIR__ . '/../vendor/autoload.php';

// Enable Symfony debug error handlers
Symfony\Component\Debug\Debug::enable();

// Configure your RouteFactory to create any routes and controllers
$routeFactory = function (FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/', function (Request $request) {
            return new Response('Hello, world');
        });

    $r->addRoute('GET', '/hello/{name}', function (Request $request, $name) {
            return new Response('Hello, ' . $name . '!');
        });
};

// Handle the Request and send a Response
$app = new Application($routeFactory);
$app->run();

Visit index.php in your browser and you should be greeted with "Hello, world".

Visit index.php/hello/Tyler and you will be greeted with "Hello, Tyler".

Use with stack middlewares

Add your favorite middlewares to your project:

php composer.phar require stack/builder:dev-master stack/run:dev-master

Then, in your front controller:

<?php

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\HttpCache\HttpCache;
use Symfony\Component\HttpKernel\HttpCache\Store;
use TylerSommer\Nice\Application;

require __DIR__ . '/../vendor/autoload.php';

// Configure your RouteFactory to create any routes and controllers
$routeFactory = function (FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/', function (Request $request) {
            return new Response('Hello, world');
        });
};

// Create your app, and then the stack
$app = new Application($routeFactory);
$stack = new Stack\Builder();
$stack->push(function ($app) {
        $cache = new HttpCache($app, new Store(__DIR__.'/cache'));
        return $cache;
    });

$app = $stack->resolve($app);

// Run the app
Stack\run($app);