Yii数据字典缓存设置详解

在 Yii 框架中，合理配置数据字典缓存（Schema Cache）是提升应用性能的关键一步——它通过缓存数据库表结构、索引、外键等元信息，避免每次请求重复解析 schema，显著减少 I/O 开销和启动延迟；而查询缓存则需显式调用 `->cache()` 才生效，且对非确定性 SQL 存在风险。本文详解了为何 Schema 缓存必须优先启用、如何正确绑定缓存组件（关键在于 `schemaCache` 字符串引用 + `enableSchemaCache => true`）、生产环境推荐 Redis/APCu 而非文件缓存，并揭示了表结构变更后缓存不自动刷新、手写 SQL 缓存失效等极易被忽视却致命的细节，帮你避开性能优化路上的“隐形坑”。

Schema 缓存必须启用，否则每次请求都会重新解析数据库结构，拖慢整个应用启动和查询流程；而查询缓存（即数据结果缓存）是可选的，需按业务场景谨慎开启。

为什么 Schema 缓存比查询缓存更优先配

Yii 在构建 ActiveRecord 查询、生成 SQL、验证字段类型时，会反复读取数据库元信息（如表结构、索引、外键）。不启用 schemaCache，这些元数据每次请求都走 PDO::getMetaData() 或执行 SHOW CREATE TABLE 类语句，I/O 开销大且无法规避。

• 默认情况下 schemaCache 是关闭的，即使你配了 cache 组件也不会自动生效
• 必须显式在 db 组件中绑定缓存实例：'schemaCache' => 'cache'
• 推荐用 Redis 或 APCu，避免 FileCache 在多进程下锁竞争和过期不一致
• 开发环境可设 'schemaCacheDuration' => 0（禁用），但上线前务必打开并设合理过期时间（如 3600 秒）

配置 schemaCache 的实际写法（web.php / main.php）

不是单独加个 cache 就完事——关键是要让 db 知道该用哪个缓存实例存 schema。下面这段是生产可用的最小配置：

'components' => [
    'cache' => [
        'class' => 'yii\redis\Cache',
        'redis' => ['hostname' => '127.0.0.1', 'port' => 6379, 'database' => 1],
    ],
    'db' => [
        'class' => 'yii\db\Connection',
        'dsn' => 'mysql:host=localhost;dbname=myapp',
        'username' => 'root',
        'password' => '',
        'charset' => 'utf8mb4',
        'schemaCache' => 'cache',           // ← 必须指向已定义的 cache 实例名
        'schemaCacheDuration' => 3600,      // ← 单位秒，0 表示永不过期（不推荐）
        'enableSchemaCache' => true,        // ← 必须为 true，否则 schemaCache 字段被忽略
    ],
],

注意：schemaCache 值是字符串（缓存组件 ID），不是对象或类名；enableSchemaCache 默认是 false，这点极易漏配。

查询缓存（Query Cache）不是开开关关就有效

所谓“查询缓存”，是指对 Command::queryAll()、ActiveRecord::find()->all() 这类结果集做缓存，它依赖 db 组件的 queryCache 配置，且只对显式调用 cache() 方法的查询生效。

• 没加 ->cache() 的查询，哪怕开了 queryCache 也完全不走缓存
• queryCache 默认值是 'cache'，但如果你的 cache 组件不可用（比如 Redis 挂了），查询会静默降级为不缓存，无报错
• 带参数绑定的查询（如 where(['status' => $status])）会被自动哈希成不同 key，安全但 key 爆炸风险高
• 慎用于含 NOW()、RAND()、用户态变量的 SQL —— Yii 不会识别这些非确定性函数，缓存可能返回过期/错误结果

典型用法：

// 控制器里
$users = User::find()
    ->where(['status' => 1])
    ->cache(7200)  // ← 必须显式调用，单位秒
    ->all();

容易被忽略的两个破坏性细节

Schema 缓存和查询缓存都依赖底层缓存驱动的稳定性，但有两处 Yii 不会主动提醒、却会导致缓存彻底失效：

• 数据库表结构变更（如加字段、改类型）后，schema 缓存不会自动刷新 —— 必须手动清空缓存（php yii cache/flush-schema）或等过期，否则 ActiveRecord 可能报 Unknown property
• 使用 createCommand() 手写 SQL 时，->cache() 只对 queryAll() 等读操作生效；execute() 写操作不会触发缓存，但也不会自动清除关联的查询缓存 —— 你需要手动 $cache->delete('user_list') 或用 tag 批量管理

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~