缓存配置

配置 Redis 缓存和性能优化设置。

🎯 缓存概述

Drubase One 使用 Redis 作为缓存后端,显著提升 API 响应速度和数据库性能。

📝 Redis 配置

Docker 环境配置

编辑 docker/.env:


REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=your_secure_password

Drupal 缓存配置

编辑 web/sites/default/settings.php:


// Redis 缓存配置
$settings['redis.connection']['interface'] = 'PhpRedis';
$settings['redis.connection']['host'] = getenv('REDIS_HOST') ?: 'redis';
$settings['redis.connection']['port'] = getenv('REDIS_PORT') ?: 6379;
$settings['redis.connection']['password'] = getenv('REDIS_PASSWORD');
 
$settings['cache']['default'] = 'cache.backend.redis';
$settings['cache_prefix'] = 'drubase_';

📊 缓存类型

缓存类型	生命周期	适用场景
页面缓存	1 小时	静态页面
渲染缓存	永久	视图和块
数据缓存	自定义	API 响应
实体缓存	永久	实体数据

🧪 测试 Redis 连接


# 进入 Redis 容器
docker exec -it redis redis-cli
 
# 测试连接
PING
# 应返回: PONG
 
# 查看缓存键
KEYS drubase_*
 
# 查看内存使用
INFO memory
 
# 退出
exit

🔍 监控缓存性能


# 查看 Redis 统计
docker exec -it redis redis-cli INFO stats
 
# 查看缓存命中率
docker exec -it redis redis-cli INFO stats | grep keyspace
 
# 实时监控
docker exec -it redis redis-cli MONITOR

⚡ 环境配置建议

开发环境


cache:
  page:
    max_age: 0          # 禁用页面缓存
css:
  preprocess: false     # 禁用 CSS 聚合
js:
  preprocess: false     # 禁用 JS 聚合

生产环境


cache:
  page:
    max_age: 3600       # 启用页面缓存 (1 小时)
css:
  preprocess: true      # 启用 CSS 聚合
  gzip: true
js:
  preprocess: true      # 启用 JS 聚合
  gzip: true

⚠️ 注意事项

开发时: 建议禁用缓存或设置短时间,便于调试
生产时: 启用所有缓存和聚合,提升性能
配置变更: 修改配置后需要重启相关服务
Redis 密码: 生产环境必须设置强密码

📖 相关文档

参考 Drupal 官方文档和 Redis 模块文档