BraidPHP

<?php

declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

use dvictorjhg\braidphp\Core\App;
use dvictorjhg\braidphp\Core\Attributes\Module;
use dvictorjhg\braidphp\Router\Attributes\Get;
use dvictorjhg\braidphp\Router\Attributes\Route;
use dvictorjhg\braidphp\Router\Http\HttpMethod;
use dvictorjhg\braidphp\Router\Http\Request;
use dvictorjhg\braidphp\Router\Http\Response;
use dvictorjhg\braidphp\Router\HttpModule;
use PHPInjector\DI\Attributes\Inject;

final class Profiles
{
    public function __construct(#[Inject('env')] private string $environment)
    {
    }

    public function response(string $name): Response
    {
        return new Response(
            headers: ['Content-Type' => 'application/json'],
            body: json_encode(['name' => $name, 'env' => $this->environment], JSON_THROW_ON_ERROR),
        );
    }
}

#[Route(path: '/api')]
final class ProfilesController
{
    public function __construct(private Profiles $profiles)
    {
    }

    #[Get('/users/:name', pathMatch: 'full')]
    public function user(Request $request): Response
    {
        return $this->profiles->response($request->getRouteParam('name') ?? '');
    }

    #[Get('/users', pathMatch: 'full')]
    public function query(Request $request): Response
    {
        $name = $request->getQueryParams()['name'] ?? null;
        if (!is_string($name) || $name === '') {
            return new Response(400, ['Content-Type' => 'application/json'], '{"error":"name is required"}');
        }
        return $this->profiles->response($name);
    }

    #[Get('/fail', pathMatch: 'full')]
    public function fail(): never
    {
        throw new RuntimeException('demo failure');
    }
}

#[Module(
    imports: [HttpModule::class],
    providers: [Profiles::class, 'env' => 'test'],
    controllers: [ProfilesController::class],
)]
final class ProfilesModule
{
}

$app = new App();
$app->bootstrapModule(new ProfilesModule());
$request = new Request(method: HttpMethod::GET, uri: '/api/users/Ada%20Lovelace');
$response = $app->handleRequest($request);
echo $response->getStatusCode() . ' ' . (string) $response->getBody() . PHP_EOL;
echo $response->getHeaderLine('Content-Type') . PHP_EOL;
var_dump($request->getRouteParams());

foreach (['/api/users?name=', '/api/users/Ada/extra', '/missing'] as $uri) {
    $response = $app->handleRequest(new Request(method: HttpMethod::GET, uri: $uri));
    echo $response->getStatusCode() . ' ' . (string) $response->getBody() . PHP_EOL;
}

try {
    $app->handleRequest(new Request(method: HttpMethod::GET, uri: '/api/fail'));
} catch (RuntimeException $exception) {
    echo $exception->getMessage();
}

200 {"name":"Ada Lovelace","env":"test"}
application/json
array(0) {
}
400 {"error":"name is required"}
404 Not Found
404 Not Found
demo failure