spajak/flow

Micro PHP framework

Flow

Simple PHP HTTP application base using:, _(*1)

• PSR-7 HTTP Message / PSR-17 HTTP Factories: nyholm/psr7
• PSR-15 HTTP Handlers / Middleware: northwoods/broker
• PSR-11: Container: php-di/php-di
• Routing: nikic/fast-route
• Console: symfony/console

Rationale

• Basing on standardized interfaces and well tested components;
• Not being tied to any specific framework;
• Being able to make lightweight and customizable apps fast with just PHP's includes and anonymous functions.

Usage

$app = new Flow\Application;

Register services (using: php-di/php-di):, _(*2)

$services = [];
$services['hello'] = function() {
    return new class {
        public function sayHello($name) { return "Hello {$name}!"; }
    };
};
$app->getContainerBuilder()->addDefinitions($services);

Register routes (using: nikic/fast-route):, _(*3)

$app->getRouteCollector()->get('/hello[/{name}]', function($request, $name = 'World') use ($app) {
    $container = $app->getContainer();
    $response = $container->get('http_factory')->createResponse(200);
    $response->getBody()->write(
        $container->get('hello')->sayHello($name)
    );
    return $response;
});

Register console commands (using: symfony/console):, _(*4)

$app->getConsole()->register('hello')
    ->setDescription('Say hello')
    ->addArgument('name', null, 'Your name', 'World')
    ->setCode(function($input, $output) use ($app) {
        $service = $app->getContainer()->get('hello');
        $output->writeLn($service->sayHello($input->getArgument('name')));
    });

…or use factories to lazy-load commands:, _(*5)

use Flow\Command\RequestCommand;
use Flow\Emitter\ConsoleEmitter;

$commands = [];
$commands['request'] = function() use ($app) {
    return new RequestCommand(
        $app->getServerRequestCreator(),
        $app->getBroker(),
        new ConsoleEmitter
    );
}
$app->getCommandLoader()->addFactories($commands);

At the end of the script, simply run the application:, _(*6)

$app->run();

Try it from terminal:, _(*7)

$ php examples/application.php hello "Grim Reaper"
$ php examples/application.php request GET /hello

License

MIT, _(*8)