10分钟上手Zend-Expressive：构建你的第一个中间件应用

10分钟上手Zend-Expressive：构建你的第一个中间件应用

【免费下载链接】zend-expressivePSR-15 middleware in minutes!项目地址: https://gitcode.com/gh_mirrors/ze/zend-expressive

Zend-Expressive是一款基于PSR-15标准的轻量级PHP中间件框架，让你能够快速构建灵活高效的Web应用。本文将带你在10分钟内完成从环境搭建到创建第一个中间件应用的全过程，即使是PHP新手也能轻松掌握！

🚀 准备工作：安装Zend-Expressive

在开始之前，请确保你的环境已安装PHP 7.1+和Composer。使用以下命令通过官方骨架项目快速创建应用：

composer create-project zendframework/zend-expressive-skeleton expressive

执行命令后，安装程序会引导你完成配置选择，包括项目结构、依赖注入容器、路由器、模板引擎和错误处理器。推荐保持默认选项（FastRoute路由器、Zend ServiceManager容器、Plates模板引擎和Whoops错误处理器），这些组合能提供最佳开发体验。

Zend-Expressive安装程序提供交互式配置选项，帮助你快速搭建项目基础架构

🏃‍♂️ 启动开发服务器

项目创建完成后，进入应用目录并启动内置Web服务器：

cd expressive composer run --timeout=0 serve

打开浏览器访问 http://localhost:8080，你将看到Zend-Expressive的欢迎页面，这表示你的应用已成功运行！

🔍 理解中间件架构

Zend-Expressive基于中间件架构设计，请求和响应通过一系列中间件按特定顺序处理。核心架构分为四个主要层次：

Zend-Expressive中间件管道结构展示了请求从进入到响应返回的完整流程

1. 高优先级管道中间件：始终优先执行的通用中间件（如错误处理、日志记录）
2. 路由中间件：负责匹配请求URI到相应处理程序
3. 调度中间件：执行路由匹配到的具体中间件或处理程序
4. 低优先级管道中间件：处理404/400等错误情况的后备中间件

✨ 创建你的第一个中间件

使用Zend-Expressive提供的工具快速生成中间件：

composer expressive middleware:create "App\XClacksOverheadMiddleware"

编辑生成的中间件文件（通常位于src/App/XClacksOverheadMiddleware.php），修改process()方法添加自定义响应头：

public function process(ServerRequestInterface $request, RequestHandlerInterface $handler) : ResponseInterface { $response = $handler->handle($request); return $response->withHeader('X-Clacks-Overhead', 'GNU Terry Pratchett'); }

将新创建的中间件添加到管道配置中（config/pipeline.php）：

$app->pipe(ErrorHandler::class); $app->pipe(App\XClacksOverheadMiddleware::class); // 添加这行 $app->pipe(ServerUrlMiddleware::class);

现在访问应用并检查响应头，你将看到自定义的X-Clacks-Overhead头信息，这表明中间件已成功生效！

🛠️ 创建请求处理程序

请求处理程序负责处理特定路由并生成响应。使用工具创建一个"Hello"处理程序：

composer expressive handler:create "App\Handler\HelloHandler"

编辑处理程序文件（src/App/Handler/HelloHandler.php），实现简单的问候逻辑：

public function handle(ServerRequestInterface $request) : ResponseInterface { $target = $request->getQueryParams()['target'] ?? 'World'; $target = htmlspecialchars($target, ENT_HTML5, 'UTF-8'); return new HtmlResponse($this->renderer->render( 'app::hello', ['target' => $target] )); }

编辑模板文件（templates/app/hello.phtml）添加HTML内容：

<h1>Hello <?= $this->e($target) ?></h1>

最后在路由配置中添加新路由（config/routes.php）：

$app->get('/hello', App\Handler\HelloHandler::class, 'hello');

访问 http://localhost:8080/hello 或 http://localhost:8080/hello?target=Expressive，你将看到动态生成的问候页面！

📚 深入学习资源

恭喜你已成功创建第一个Zend-Expressive应用！要进一步学习，可以参考以下官方资源：

• 核心功能文档：docs/book/features/
• 中间件开发指南：docs/book/v3/cookbook/
• 路由配置参考：docs/book/features/router/

Zend-Expressive的模块化设计和丰富的生态系统让它成为构建现代PHP应用的理想选择。无论是小型API还是复杂Web应用，它都能提供卓越的灵活性和性能。现在就开始你的中间件开发之旅吧！

Zend-Expressive生态系统提供了丰富的组件和工具，助力构建各种规模的PHP应用

【免费下载链接】zend-expressivePSR-15 middleware in minutes!项目地址: https://gitcode.com/gh_mirrors/ze/zend-expressive