empress-php/empress

Empress is a flexible microframework for creating async web applications in PHP 8.

0.5.0 2022-06-30 18:22 UTC

Requires

• php: ^8.1
• ext-mbstring: *
• amphp/amp: ^2.6
• amphp/byte-stream: ^1.8
• amphp/file: ^1.0
• amphp/http-server: ^2.1
• amphp/http-server-form-parser: ^1.1
• amphp/http-server-session: ^1.0
• amphp/http-server-static-content: ^1.0
• amphp/log: ^1.1
• amphp/socket: ^1.2
• cash/lrucache: ^1.0
• monolog/monolog: ^1.24

Requires (Dev)

• amphp/http-client: ^4.5
• amphp/http-client-cookies: ^1.1
• amphp/phpunit-util: ^1.1
• php-coveralls/php-coveralls: ^2.2
• phpunit/phpunit: ^9.5.4
• psy/psysh: ^0.9.9
• symplify/easy-coding-standard: ^11.0
• vimeo/psalm: ^4.7

MIT

README

Work in progress ⚡

Empress is a flexible PHP 8.1 microframework for creating async web applications. It's based on amphp/http-server. The name is a portmanteau of Express and Amp as Empress's simplicity was first inspired by Express.js. Later, many useful ideas were incorporated from Spark and Javalin. Ultimately it's also the name of one of the cards from major arcana, part of the tarot deck.

Documentation

Read the Wiki for more information and make sure to check out the Getting Started tutorial.

Taste it

<?php
// app.php

use Empress\Application;
use Empress\Context;
use Empress\Routing\RouteCollector\AnnotatedRouteCollectorTrait;
use Empress\Routing\RouteCollector\Attribute\Group;
use Empress\Routing\RouteCollector\Attribute\Route;

#[Group('/hello')]
class IndexController
{
    use AnnotatedRouteCollectorTrait;

    #[Route('GET', '/')]
    public function index(Context $ctx)
    {
        $ctx->response('<h1>Hello!</h1>');
    }
}

$app = Application::create(9010);
$app->routes(new IndexController());

return $app;

// Run it:
// vendor/bin/empress app.php