spajak/flow

Simple PHP application base

dev-master 2021-03-13 10:27 UTC

This package is auto-updated.

Last update: 2022-05-13 13:04:10 UTC


README

Simple PHP HTTP application base using:

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):

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

Register routes (using: nikic/fast-route):

$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):

$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:

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

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

At the end of the script, simply run the Application:

$app->run();

Try it from terminal:

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

TODO

  • Some kind of helper to simplify creation of the responses.
  • Add logging capabilities.

License

MIT