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.