README

Virtus is a composer create-project scaffold for building HTTP APIs with the Meritum ecosystem. It ships a pre-wired meritum/http kernel with a clean structure ready to build on.

Requirements

• PHP 8.4+
• Composer

Getting Started

composer create-project meritum/virtus my-app
cd my-app

Copy .env.example to .env and adjust as needed:

APP_ENV=local
APP_DEBUG=true

Dev Environment

Virtus ships with a devenv.nix for devenv. Entering the shell starts the PHP built-in server on port 8000:

devenv shell

Adding a Handler

Create a PSR-15 handler in src/Handler/:

namespace App\Handler;

use Laminas\Diactoros\Response\JsonResponse;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\RequestHandlerInterface;

final class HomeHandler implements RequestHandlerInterface
{
    public function handle(ServerRequestInterface $request): ResponseInterface
    {
        return new JsonResponse(['message' => 'Hello, world!']);
    }
}

Register the handler and its route in AppModule::register():

use Meritum\Http\HttpKernelInterface;

public function register(KernelInterface $kernel): void
{
    assert($kernel instanceof HttpKernelInterface);

    // $kernel->addMiddleware(Middleware\CorsMiddleware::class);

    $kernel->define(Handler\HomeHandler::class, fn() => new Handler\HomeHandler());

    $kernel->addRoute('GET', '/', Handler\HomeHandler::class);
}

Structure

www/index.php             Entry point
src/
  ModuleRepository.php    Register application modules
  AppModule.php           Register handlers, routes, and application config
tests/
devenv.nix                Dev environment

Testing

composer test

Further Reading

• meritum/http — HTTP kernel, routing, middleware
• georgeff/kernel — DI, modules, service tagging