在Laravel项目开发中，我们经常会遇到需要缓存动态内容的场景，比如根据用户权限返回不同的列表数据、根据时间区间展示不同的统计结果等。这类内容因为查询参数或业务规则不同，不能直接用固定键缓存，需要设计对应的条件缓存逻辑。
条件缓存的核心设计思路
动态内容的条件缓存本质是根据内容的变动规则，把影响内容结果的因素作为缓存判断的依据，核心包含三个部分：缓存键生成、缓存条件判断、缓存失效触发。
1. 缓存键生成规则
缓存键需要覆盖所有影响动态内容结果的因素，比如用户ID、查询参数、业务版本标识等。如果这些因素有任意一个变化，就需要生成不同的缓存键，避免缓存串用。
我们可以用数组收集所有影响因素，然后拼接成字符串作为缓存键，示例如下：
<?php
// 生成动态内容的缓存键
function buildDynamicCacheKey(array $params, int $userId): string {
// 收集所有影响内容的因素：用户ID、查询参数、业务版本
$factors = [
'user_id' => $userId,
'params' => $params,
'version' => 'v1' // 业务规则变动时可以升级版本让旧缓存失效
];
// 序列化后生成唯一键
return 'dynamic_content_' . md5(serialize($factors));
}
2. 缓存条件判断逻辑
不是所有动态内容都适合缓存，我们需要先判断当前请求是否符合缓存条件。比如用户未登录的公开内容可以缓存，登录用户的私有内容需要验证权限后再决定是否缓存；或者查询参数符合特定规则时才启用缓存。
下面是一个判断缓存条件的示例：
<?php
// 判断当前请求是否符合缓存条件
function shouldCacheDynamicContent(array $params, ?int $userId): bool {
// 情况1：没有查询参数时，公开内容可以缓存
if (empty($params) && is_null($userId)) {
return true;
}
// 情况2：查询参数只有分页参数，且是公开内容时可以缓存
$allowParams = ['page', 'page_size'];
$paramKeys = array_keys($params);
if (empty(array_diff($paramKeys, $allowParams)) && is_null($userId)) {
return true;
}
// 其他情况不缓存
return false;
}
3. 缓存读取与写入实现
Laravel提供了remember方法可以简化缓存的读取和写入逻辑，我们可以在条件满足时调用该方法，不满足时直接查询数据库返回结果。
完整的动态内容条件缓存实现示例如下：
<?php
use IlluminateSupportFacadesCache;
// 获取动态内容的主方法
function getDynamicContent(array $params, ?int $userId = null) {
// 先判断是否符合缓存条件
if (!shouldCacheDynamicContent($params, $userId)) {
// 不符合条件，直接查询数据库返回
return queryDynamicContentFromDb($params, $userId);
}
// 生成缓存键
$cacheKey = buildDynamicCacheKey($params, $userId ?? 0);
// 缓存时间设置为10分钟
$cacheTtl = 600;
// 使用remember方法，缓存存在则直接返回，不存在则查询后缓存
return Cache::remember($cacheKey, $cacheTtl, function () use ($params, $userId) {
return queryDynamicContentFromDb($params, $userId);
});
}
// 模拟从数据库查询动态内容的方法
function queryDynamicContentFromDb(array $params, ?int $userId): array {
// 这里实际是数据库查询逻辑，根据参数和用户信息返回对应内容
$baseData = ['id' => 1, 'title' => '测试动态内容'];
if ($userId) {
$baseData['user_specific'] = '用户' . $userId . '的专属内容';
}
return $baseData;
}
缓存失效的处理方式
动态内容对应的业务数据发生变动时，需要及时清除对应的缓存，避免返回旧数据。我们可以根据业务变动的范围，清除对应的缓存键。
如果业务变动影响所有动态内容，可以清除所有前缀为dynamic_content_的缓存；如果只影响特定用户的内容，可以只清除对应用户的缓存键。示例如下：
<?php
use IlluminateSupportFacadesCache;
// 清除特定用户的所有动态内容缓存
function clearUserDynamicCache(int $userId): void {
$cacheKey = 'dynamic_content_' . md5(serialize(['user_id' => $userId, 'params' => [], 'version' => 'v1']));
Cache::forget($cacheKey);
// 如果有更多相关缓存键，可以批量清除，或者使用缓存标签功能
}
// 清除所有动态内容缓存（业务规则升级时使用）
function clearAllDynamicCache(): void {
// 如果使用缓存标签，可以直接清除标签下所有缓存
// Cache::tags('dynamic_content')->flush();
}
注意事项
- 缓存键的生成要尽可能覆盖所有影响内容的因素，避免出现不同条件返回相同缓存的问题
- 缓存时间不要设置过长，动态内容的变动频率越高，缓存时间应该越短
- 如果动态内容涉及敏感数据，缓存时要注意数据权限，避免不同用户串用缓存数据
- 缓存条件判断逻辑要和业务的变动规则保持一致，避免无效缓存或者缓存不一致的问题