README

描述

一个尽可能简单、高性能的中间件PSR-15微框架，主要面向希望了解他们所使用的所有供应商的开发者。

• 基本编码规范（1）
• 编码风格指南（2）
• 日志接口（3）
• 自动加载规范（4）
• HTTP消息接口（7）
• 容器接口（11）
• HTTP处理器（15）
• HTTP工厂（17）

要求

• php: ^8.1
• chubbyphp/chubbyphp-http-exception: ^1.1
• psr/container: ^1.1.2|^2.0.2
• psr/http-factory-implementation: ^1.0
• psr/http-factory: ^1.0.2
• 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

建议

路由器

任何实现了Chubbyphp\Framework\Router\RouteMatcherInterface的路由器都可以使用。

• chubbyphp/chubbyphp-framework-router-fastroute: ^2.1

PSR 7 / PSR 17

• guzzlehttp/psr7: ^2.6.1 (with http-interop/http-factory-guzzle: ^1.2)
• laminas/laminas-diactoros: ^3.3
• nyholm/psr7: ^1.8.1
• slim/psr7: ^1.6.1
• sunrise/http-message: ^3.0

安装

通过Composer安装chubbyphp/chubbyphp-framework。

composer require chubbyphp/chubbyphp-framework "^5.1" \
    chubbyphp/chubbyphp-framework-router-fastroute "^2.1" \
    slim/psr7 "^1.5"

用法

<?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()));

发射器

• 发射器

中间件

• 回调中间件
• 异常中间件
• 懒中间件
• 中间件分发器
• 路由匹配中间件
• Slim回调中间件
• Slim懒中间件

请求处理器

• 回调请求处理器
• 懒请求处理器
• 路由请求处理器
• Slim回调请求处理器
• Slim懒请求处理器

路由器

• 分组
• 路由

服务器

• 内置（仅开发使用）
• Nginx
• ReactPHP
• Roadrunner
• Swoole
• Workerman

骨架

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

迁移

• 4.x 到 5.x
• 3.x 到 4.x
• 2.x 到 3.x
• 1.x 到 2.x
• Slim 到 Chubbyphp

版权

2024 Dominik Zogg