README

以下缓存功能的中间件组件

• CachePrevention
• Expires
• Cache
• ClearSiteData

要求

• PHP >= 8.2
• PSR-7 http 库
• PSR-15 中间件分发器

安装

此软件包可以通过 Composer 以 middlewares/cache 方式安装和自动加载。

composer require middlewares/cache

CachePrevention

添加用于缓存预防的响应头。在开发环境中很有用

Dispatcher::run([
    new Middlewares\CachePrevention()
]);

Expires

此中间件将 Expires 和 Cache-Control: max-age 响应头添加到响应中。您可以配置每个 MIME 类型的缓存时长。如果没有定义，则使用默认值。

// Use the default configuration
$expires = new Middlewares\Expires();

// Custom durations
$expires = new Middlewares\Expires([
    'text/css' => '+1 year',
    'text/js' => '+1 week',
]);

defaultExpires

如果请求 MIME 类型未配置，则设置默认的过期值。默认为 1 个月。示例

//set 1 year lifetime to css and js
$durations = [
    'text/css' => '+1 year',
    'text/javascript' => '+1 year',
];

//and 1 hour to everything else
$default = '+1 hour';

$expires = (new Middlewares\Expires($durations))->defaultExpires($default);

Cache

将响应头保存到 PSR-6 缓存池，并在响应仍然有效时返回 304 响应（未修改）。这可以节省服务器资源和带宽，因为返回的内容为空。建议与 Expires 结合使用，以设置响应的有效期。

$cachePool = new Psr6CachePool();

Dispatcher::run([
    new Middlewares\Cache($cachePool),
    new Middlewares\Expires()
]);

可选地，您可以将 Psr\Http\Message\ResponseFactoryInterface 作为第二个参数提供，以创建 304 空响应。如果没有定义，将使用 Middleware\Utils\Factory 自动检测。

$cachePool = new Psr6CachePool();
$responseFactory = new MyOwnResponseFactory();

$cache = new Middlewares\Cache($cachePool, $responseFactory);

ClearSiteData

发送 Clear-Site-Data 头部以从客户端（缓存、Cookies、存储等）中删除所有站点数据

Dispatcher::run([
    new Middlewares\ClearSiteData()
]);

可选地，您可以提供要清除的数据类型列表。

$cache = new Middlewares\ClearSiteData('cache', 'cookies');

请参阅 CHANGELOG 了解有关最近更改的更多信息，以及有关 CONTRIBUTING 的详细信息。

MIT 许可证（MIT）。请参阅 LICENSE 了解更多信息。