Zend Stratigility 使用教程

Zend Stratigility 使用教程

zend-stratigilityMiddleware for PHP built on top of PSR-7 and PSR-15项目地址:https://gitcode.com/gh_mirrors/ze/zend-stratigility

项目介绍

Zend Stratigility 是一个基于 PSR-7 和 PSR-15 的 PHP 中间件框架，允许开发者构建和调度中间件管道。它最初是 Sencha Connect 的一个端口，旨在帮助开发者通过中间件层来构建应用程序。该项目已经被迁移到 Laminas 项目下，继续维护和更新。

项目快速启动

以下是一个简单的快速启动示例，展示如何使用 Zend Stratigility 创建一个基本的中间件应用程序。

安装

首先，确保你已经安装了 Composer，然后运行以下命令来安装 Zend Stratigility：

composer require laminas/laminas-stratigility

创建中间件应用

创建一个名为 public/index.php 的文件，并添加以下代码：

<?php

use Laminas\Stratigility\Middleware\NotFoundHandler;
use Laminas\Stratigility\MiddlewarePipe;
use Laminas\Diactoros\Response\HtmlResponse;
use Laminas\Diactoros\ServerRequestFactory;
use Laminas\HttpHandlerRunner\Emitter\SapiEmitter;
use Laminas\HttpHandlerRunner\RequestHandlerRunner;

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

$app = new MiddlewarePipe();

$app->pipe(new NotFoundHandler(function () {
    return new HtmlResponse('Not Found', 404);
}));

$server = new RequestHandlerRunner(
    $app,
    new SapiEmitter(),
    static function () {
        return ServerRequestFactory::fromGlobals();
    },
    static function (\Throwable $e) {
        $response = (new HtmlResponse('Error', 500))->withHeader('Content-Type', 'text/html');
        return $response;
    }
);

$server->run();

运行应用

在终端中运行以下命令来启动 PHP 内置服务器：

php -S localhost:8080 -t public

现在，你可以通过访问 http://localhost:8080 来查看你的中间件应用。

应用案例和最佳实践

Zend Stratigility 可以用于构建复杂的应用程序，以下是一些应用案例和最佳实践：

路由和中间件

结合使用路由器和中间件可以创建一个灵活的应用结构。例如，使用 Laminas\Router 来定义路由，并将每个路由关联到一个特定的中间件。

use Laminas\Router\Http\Literal;
use Laminas\Router\RouteCollector;

$router = new RouteCollector();
$router->addRoute(new Literal('/home', new HomeMiddleware()));
$router->addRoute(new Literal('/about', new AboutMiddleware()));

$app->pipe($router);

错误处理

通过自定义错误处理中间件，可以捕获和处理应用程序中的异常。

$app->pipe(function ($request, $handler) {
    try {
        return $handler->handle($request);
    } catch (\Throwable $e) {
        return new HtmlResponse('Error: ' . $e->getMessage(), 500);
    }
});

典型生态项目

Zend Stratigility 是 Laminas 项目的一部分，与许多其他 Laminas 组件兼容，例如：

• Laminas MVC: 一个基于中间件的 MVC 框架，可以与 Stratigility 结合使用。
• Mezzio: 一个微框架，基于 Stratigility，提供了一个简洁的方式来构建中间件应用程序。
• Laminas Router: 一个灵活的路由组件，可以与 Stratigility 一起使用来定义应用程序的路由。

通过结合这些组件，开发者可以构建出功能强大且灵活的 PHP 应用程序。

zend-stratigilityMiddleware for PHP built on top of PSR-7 and PSR-15项目地址:https://gitcode.com/gh_mirrors/ze/zend-stratigility