awsem / framework

dev-main 2026-09-23 12:03 UTC

Requires

• php: >=8.2
• nyholm/psr7: ^1.8
• psr/clock: ^1.0
• psr/container: ^2.0
• psr/event-dispatcher: ^1.0
• psr/http-factory: ^1.1
• psr/http-message: ^2.0
• psr/http-server-handler: ^1.0
• psr/http-server-middleware: ^1.0
• psr/log: ^3.0
• psr/simple-cache: ^3.0

Requires (Dev)

• nyholm/psr7-server: ^1.1
• phpunit/phpunit: ^11.0
• spiral/roadrunner-http: ^4.1

MIT

• Awsem Team

• framework
• database
• php
• router
• middleware
• minimalist
• psr-7
• psr-15

Published on Packagist.org on 2026-09-23 12:04 UTC

README

Simple, elegant, minimalist, and modular PHP framework leveraging PSR standards.

Features

• PSR-7 & PSR-15: Built upon standard interfaces for HTTP messages and middleware.
• Routing: Powerful and simple attribute-based and programmatic routing.
• Dependency Injection: PSR-11 compliant container.
• Minimalist Core: Designed to be lightweight but easily extensible.
• Components: Includes Router, Database, Console, Events, Logging, Caching, and more.

Requirements

• PHP 8.2 or higher
• Composer

Installation

Install the framework via Composer:

composer require awsem/framework nyholm/psr7 nyholm/psr7-server

Quick Start

Create a new Awsem application and start building routes:

<?php

use Awsem\Framework\Kernel;
use Nyholm\Psr7\Factory\Psr17Factory;
use Nyholm\Psr7Server\ServerRequestCreator;

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

$kernel = new Kernel(__DIR__);
$container = $kernel->boot();

// Create PSR-7 request
$psr17Factory = new Psr17Factory();
$creator = new ServerRequestCreator($psr17Factory, $psr17Factory, $psr17Factory, $psr17Factory);
$request = $creator->fromGlobals();

// Handle the request
$response = $kernel->handle($request);

// Emit the response (using a standard PSR-7 emitter)
// ...

Documentation

Documentation is available in the docs/ directory and at github.com/awsem/framework.

Testing

Run the test suite with PHPUnit from a source checkout:

composer install
composer test

(Or ./vendor/bin/phpunit)

License

This project is licensed under the MIT License. See LICENSE for details.