Schema缓存必须启用,否则每次请求都重新解析数据库结构拖慢性能;查询缓存可选且需显式调用cache()方法才生效。

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批量管理


















