CakePHP中间件：实现文件上传和下载功能

随着互联网的发展，文件上传和下载功能越来越常见。在开发Web应用程序时，我们经常需要实现文件上传和下载。而在使用CakePHP框架开发应用程序时，中间件是一个非常有用的工具，可以帮助我们简化代码并实现文件上传和下载功能。接下来，我将介绍如何使用CakePHP中间件来实现文件上传和下载功能。

首先，我们需要创建一个新的中间件类，在src/Middleware目录下创建一个名为FileHandlerMiddleware.php的文件，并添加以下代码：

<?php

namespace AppMiddleware;

use CakeUtilityText;
use CakeHttpResponse;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
use CakeHttpServerRequest;

class FileHandlerMiddleware
{
    public function __invoke(ServerRequestInterface $request, ResponseInterface $response, $next)
    {
        $path = WWW_ROOT . 'uploads' . DS;
        
        // 处理文件上传
        if ($request->getMethod() === 'POST' && $request->getData('file')) {
            $file = $request->getData('file');
            $fileName = Text::uuid() . '-' . $file->getClientFilename();
            $file->moveTo($path . $fileName);
            
            $response = new Response();
            $response = $response->withAddedHeader('Content-Type', 'application/json');
            $response->getBody()->write(json_encode(['success' => true, 'message' => '文件上传成功！']));
            
            return $response;
        }
        
        // 处理文件下载
        $params = $request->getAttribute('params');
        if (isset($params['file'])) {
            $fileName = $params['file'];
            $filePath = $path . $fileName;
            
            if (file_exists($filePath)) {
                $stream = fopen($filePath, 'r');
                
                $response = new Response();
                $response = $response->withAddedHeader('Content-Disposition', 'attachment; filename="' . $fileName . '"');
                
                $response->withBody(new SlimHttpStream($stream));
                
                return $response;
            }
        }
        
        return $next($request, $response);
    }
}

在上述代码中，FileHandlerMiddleware是一个用于文件上传和下载的中间件类。当收到POST请求并且请求中包含名为file的数据时，中间件将把文件保存到uploads文件夹下，并返回一个成功的JSON响应。当收到带有file参数的请求时，中间件将按照文件名返回文件内容作为响应。

接下来，我们需要将中间件注册到应用程序中。打开src/Application.php文件，并在Application类的middleware方法中注册中间件。代码如下：

use AppMiddlewareFileHandlerMiddleware;

// ...

public function middleware($middlewareQueue)
{
    $middlewareQueue
        ->add(new FileHandlerMiddleware())
        // 其它中间件
        // ...
        ->add(new ErrorHandlerMiddleware(Configure::read('Error')))
        ->add(new AssetMiddleware())
        ->add(new RoutingMiddleware($this));

    return $middlewareQueue;
}

在上述代码中，我们使用add方法将FileHandlerMiddleware中间件注册到中间件队列中。使用中间件队列可以按顺序处理多个中间件，并且在执行控制器动作之前执行注册的中间件。

现在，我们可以使用文件上传和下载功能了。假设我们有一个控制器方法来处理文件上传：

public function upload()
{
    // 显示上传表单
}
然后，在对应的视图文件中添加如下的表单代码：

<form method="POST" action="/upload" enctype="multipart/form-data">
    <input type="file" name="file" />
    <button type="submit">上传</button>
</form>