README

Description

A minimal, highly performant middleware PSR-15 microframework built with as little complexity as possible, aimed primarily at those developers who want to understand all the vendors they use.

• Basic Coding Standard (1)
• Coding Style Guide (2)
• Logger Interface (3)
• Autoloading Standard (4)
• HTTP Message Interface (7)
• Container Interface (11)
• HTTP Handlers (15)
• HTTP Factories (17)

Requirements

• php: ^8.3
• chubbyphp/chubbyphp-http-exception: ^1.2
• psr/container: ^1.1.2|^2.0.2
• psr/http-factory-implementation: ^1.0
• psr/http-factory: ^1.1
• psr/http-message-implementation: ^1.0|^2.0
• psr/http-message: ^1.1|^2.0
• psr/http-server-handler: ^1.0.2
• psr/http-server-middleware: ^1.0.2
• psr/log: ^2.0|^3.0.2

Suggest

Router

Any Router which implements Chubbyphp\Framework\Router\RouteMatcherInterface can be used.

• chubbyphp/chubbyphp-framework-router-fastroute: ^2.3
• chubbyphp/chubbyphp-framework-router-symfony: ^2.3

PSR 7 / PSR 17

• guzzlehttp/psr7: ^2.7 (with http-interop/http-factory-guzzle: ^1.2)
• laminas/laminas-diactoros: ^3.5
• nyholm/psr7: ^1.8.2
• slim/psr7: ^1.7
• sunrise/http-message: ^3.2

Installation

Through Composer as chubbyphp/chubbyphp-framework.

composer require chubbyphp/chubbyphp-framework "^6.0" \ chubbyphp/chubbyphp-framework-router-fastroute "^2.3" \ slim/psr7 "^1.7"

Usage

<?php declare(strict_types=1); namespace App; use Chubbyphp\Framework\Application; use Chubbyphp\Framework\Middleware\ExceptionMiddleware; use Chubbyphp\Framework\Middleware\RouteMatcherMiddleware; use Chubbyphp\Framework\RequestHandler\CallbackRequestHandler; use Chubbyphp\Framework\Router\FastRoute\RouteMatcher; use Chubbyphp\Framework\Router\Route; use Chubbyphp\Framework\Router\RoutesByName; use Psr\Http\Message\ServerRequestInterface; use Slim\Psr7\Factory\ResponseFactory; use Slim\Psr7\Factory\ServerRequestFactory; require __DIR__.'/vendor/autoload.php'; $responseFactory = new ResponseFactory(); $app = new Application([ new ExceptionMiddleware($responseFactory, true), new RouteMatcherMiddleware(new RouteMatcher(new RoutesByName([ Route::get('/hello/{name:[a-z]+}', 'hello', new CallbackRequestHandler( static function (ServerRequestInterface $request) use ($responseFactory) { $response = $responseFactory->createResponse(); $response->getBody()->write(sprintf('Hello, %s', $request->getAttribute('name'))); return $response; } )) ]))), ]); $app->emit($app->handle((new ServerRequestFactory())->createFromGlobals()));

Emitter

• Emitter

Middleware

• CallbackMiddleware
• ExceptionMiddleware
• LazyMiddleware
• PipeMiddleware
• RouteMatcherMiddleware
• SlimCallbackMiddleware
• SlimLazyMiddleware

RequestHandler

• CallbackRequestHandler
• LazyRequestHandler
• RouteRequestHandler
• SlimCallbackRequestHandler
• SlimLazyRequestHandler

Router

• Group
• Route

Server

• Builtin (development only)
• Nginx
• ReactPHP
• Roadrunner
• Swoole
• Workerman

Skeleton

• chubbyphp/chubbyphp-framework-skeleton
• chubbyphp/petstore

Migration

• 5.x to 6.x
• 4.x to 5.x
• 3.x to 4.x
• 2.x to 3.x
• 1.x to 2.x
• Slim to Chubbyphp

Copyright

2025 Dominik Zogg