spajak/flow

Simple PHP application base

0.9.0 2025-02-23 13:46 UTC

Requires

• php: >=8.2
• nikic/fast-route: ^1.3
• northwoods/broker: ^3.0
• nyholm/psr7: ^1.8
• nyholm/psr7-server: ^1.1
• php-di/invoker: ^2.3
• php-di/php-di: ^7.0
• symfony/console: ^7.2

Requires (Dev)

• mockery/mockery: ^1.6
• phpunit/phpunit: ^11.0

MIT

• Sebastian Pająk

README

Simple PHP HTTP application base using:

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

$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->getCommandLoader()->addFactories($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

License

MIT