数据缓存是指将一些 PHP 变量存储到缓存中,使用时再从缓存中取回。 它也是更高级缓存特性的基础,例如查询缓存 和内容缓存。
如下代码是一个典型的数据缓存使用模式。
其中 $cache
指向缓存组件:
// 尝试从缓存中取回 $data
$data = $cache->get($key);
if ($data === false) {
// $data 在缓存中没有找到,则重新计算它的值
// 将 $data 存放到缓存供下次使用
$cache->set($key, $data);
}
// 这儿 $data 可以使用了。
从 2.0.11 版本开始, 缓存组件 提供了 getOrSet() 方法来简化数据的取回、计算和存储。 下面的代码逻辑和上一个例子是完全一样的:
$data = $cache->getOrSet($key, function () {
return $this->calculateSomething();
});
当缓存中有关联 $key 的数据时,将返回这个缓存的值。 否则就执行匿名函数来计算出将要缓存的数据并返回它。
如果匿名函数需要作用域外的数据时,可以使用 use
语句把这些数据传递到匿名函数中。
例如:
$user_id = 42;
$data = $cache->getOrSet($key, function () use ($user_id) {
return $this->calculateSomething($user_id);
});
注意: getOrSet() 方法也支持缓存持续性和缓存依赖。 请看缓存过期 和 缓存依赖 来了解详细信息。
数据缓存需要缓存组件提供支持,它代表各种缓存存储器, 例如内存,文件,数据库。
缓存组件通常注册为应用程序组件,这样它们就可以
在全局进行配置与访问。如下代码演示了如何配置应用程序组件
cache
使用两个 memcached
服务器:
'components' => [
'cache' => [
'class' => 'yii\caching\MemCache',
'servers' => [
[
'host' => 'server1',
'port' => 11211,
'weight' => 100,
],
[
'host' => 'server2',
'port' => 11211,
'weight' => 50,
],
],
],
],
然后就可以通过 Yii::$app->cache
访问上面的缓存组件了。
由于所有缓存组件都支持同样的一系列 API ,并不需要修改使用缓存的业务代码 就能直接替换为其他底层缓存组件,只需在应用配置中重新配置一下就可以。 例如,你可以将上述配置修改为使用 APC cache:
'components' => [
'cache' => [
'class' => 'yii\caching\ApcCache',
],
],
提示: 你可以注册多个缓存组件,很多依赖缓存的类默认调用 名为
cache
的组件(例如 yii\web\UrlManager)。
Yii 支持一系列缓存存储器,概况如下:
false
来禁用已存储数据的序列化。Yii::$app->cache->get($key)
尝试从缓存中取回数据而不用担心
Yii::$app->cache
可能是 null
。提示: 你可以在同一个应用程序中使用不同的缓存存储器。一个常见的策略是使用基于内存的缓存存储器 存储小而常用的数据(例如:统计数据),使用基于文件或数据库的缓存存储器 存储大而不太常用的数据(例如:网页内容)。
所有缓存组件都有同样的基类 yii\caching\Cache ,因此都支持如下 API:
注意: 千万别直接用
false
布尔值当做数据项缓存,因为 get() 方法用false
作为返回值来表名对应的缓存项不存在。 你可以把false
放到一个数组里然后缓存这个数组来避免上述的混淆问题。
有些缓存存储器如 MemCache,APC 支持以批量模式取回缓存值,这样可以节省取回缓存数据的开支。 multiGet() 和 multiAdd() API提供对该特性的支持。 如果底层缓存存储器不支持该特性,Yii 也会模拟实现。
由于 yii\caching\Cache 实现了 PHP ArrayAccess
接口,
缓存组件也可以像数组那样使用,下面是几个例子:
$cache['var1'] = $value1; // 等价于: $cache->set('var1', $value1);
$value2 = $cache['var2']; // 等价于: $value2 = $cache->get('var2');
存储在缓存中的每项数据都通过键作唯一识别。 当你在缓存中存储一项数据时,必须为它指定一个键, 稍后从缓存中取回数据时,也需要提供相应的键。
你可以使用一个字符串或者任意值作为一个缓存键。当键不是一个字符串时, 它将会自动被序列化为一个字符串。
定义一个缓存键常见的一个策略就是在一个数组中包含所有的决定性因素。 例如,yii\db\Schema 使用如下键存储一个数据表的结构信息。
[
__CLASS__, // 结构类名
$this->db->dsn, // 数据源名称
$this->db->username, // 数据库登录用户名
$name, // 表名
];
如你所见,该键包含了可唯一指定一个数据库表所需的所有必要信息。
注意: 通过 multiSet() 或者 multiAdd() 方法缓存的数据项的键,它的类型只能是字符串或整型, 如果你想使用较为复杂的键,可以通过 set() 或者 add() 方法来存储。
当同一个缓存存储器被用于多个不同的应用时,应该为每个应用指定一个唯一的缓存键前缀以避免缓存键冲突。 可以通过配置 yii\caching\Cache::$keyPrefix 属性实现。 例如,在应用配置中可以编写如下代码:
'components' => [
'cache' => [
'class' => 'yii\caching\ApcCache',
'keyPrefix' => 'myapp', // 唯一键前缀
],
],
为了确保互通性,此处只能使用字母和数字。
默认情况下,缓存中的数据会永久存留,除非它被某些缓存策略强制移除(例如:缓存空间已满,最老的数据会被移除)。 要改变此特性,你可以在调用 set() 存储一项数据时提供一个过期时间参数。 该参数代表这项数据在缓存中可保持有效多少秒。 当你调用 get() 取回数据时, 如果它已经过了超时时间,该方法将返回 false,表明在缓存中找不到这项数据。 例如:
// 将数据在缓存中保留 45 秒
$cache->set($key, $data, 45);
sleep(50);
$data = $cache->get($key);
if ($data === false) {
// $data 已过期,或者在缓存中找不到
}
从 2.0.11 开始,如果想自定义缓存的持续时间,你可以在缓存组件配置中设置 defaultDuration 成员属性的值。
这样设置会覆盖默认的缓存持续时间,且在使用 set()
方法时不必每次都传递 $duration
参数。
除了超时设置,缓存数据还可能受到缓存依赖的影响而失效。 例如,yii\caching\FileDependency 代表对一个文件修改时间的依赖。 这个依赖条件发生变化也就意味着相应的文件已经被修改。 因此,缓存中任何过期的文件内容都应该被置为失效状态, 对 get() 的调用都应该返回 false。
缓存依赖用 yii\caching\Dependency 的派生类所表示。 当调用 set() 在缓存中存储一项数据时, 可以同时传递一个关联的缓存依赖对象。例如:
// 创建一个对 example.txt 文件修改时间的缓存依赖
$dependency = new \yii\caching\FileDependency(['fileName' => 'example.txt']);
// 缓存数据将在30秒后超时
// 如果 example.txt 被修改,它也可能被更早地置为失效状态。
$cache->set($key, $data, 30, $dependency);
// 缓存会检查数据是否已超时。
// 它还会检查关联的依赖是否已变化。
// 符合任何一个条件时都会返回 false。
$data = $cache->get($key);
下面是可用的缓存依赖的概况:
注意: 避免对带有缓存依赖的缓存项使用 exists() 方法, 因为它不检测缓存依赖(如果有的话)是否有效,所以调用 get() 可能返回
false
而调用 exists() 却返回true
。
查询缓存是一个建立在数据缓存之上的特殊缓存特性。 它用于缓存数据库查询的结果。
查询缓存需要一个 数据库连接 和一个有效的 cache
应用组件。
查询缓存的基本用法如下,假设 $db
是一个 yii\db\Connection 实例:
$result = $db->cache(function ($db) {
// SQL 查询的结果将从缓存中提供
// 如果启用查询缓存并且在缓存中找到查询结果
return $db->createCommand('SELECT * FROM customer WHERE id=1')->queryOne();
});
查询缓存可以用在DAO和ActiveRecord上:
$result = Customer::getDb()->cache(function ($db) {
return Customer::find()->where(['id' => 1])->one();
});
信息: 有些 DBMS (例如:MySQL) 也支持数据库服务器端的查询缓存。 你可以选择使用任一查询缓存机制。 上文所述的查询缓存的好处在于你可以指定更灵活的缓存依赖因此可能更加高效。
自 2.0.14 以后,您可以使用以下快捷方法:
(new Query())->cache(7200)->all();
// and
User::find()->cache(7200)->all();
查询缓存通过 yii\db\Connection 有三个全局可配置选项:
true
。 请注意,要有效打开查询缓存,
您还需要有一个由 queryCache 所指定的有效缓存。'cache'
。
只有在设置了一个有效的缓存应用组件时,查询缓存才会有效。如果您有多个需要利用查询缓存的 SQL 查询,则可以使用 yii\db\Connection::cache()。 用法如下,
$duration = 60; // 缓存查询结果 60 秒。
$dependency = ...; // 可选的依赖关系
$result = $db->cache(function ($db) {
// ... 在这里执行 SQL 查询 ...
return $result;
}, $duration, $dependency);
在匿名函数里的任何一个 SQL 查询都将使用指定的依赖项缓存指定的持续时间
如果一个 SQL 查询的结果在缓存中有效,那么这个 SQl 语句将会被跳过而它的查询结果会直接从缓存中读取。
如果你没有指明 $duration
参数,
那么使用 queryCacheDuration 属性。
有时在cache()
里,你可能不想缓存某些特殊的查询,
这时你可以用yii\db\Connection::noCache()。
$result = $db->cache(function ($db) {
// 使用查询缓存的 SQL 查询
$db->noCache(function ($db) {
// 不使用查询缓存的 SQL 查询
});
// ...
return $result;
});
如果您只想为单个查询使用查询缓存,则可以在构建命令时调用 yii\db\Command::cache()。 例如,
// 使用查询缓存并将查询缓存持续时间设置为 60 秒
$customer = $db->createCommand('SELECT * FROM customer WHERE id=1')->cache(60)->queryOne();
您还可以使用 yii\db\Command::noCache() 禁用单个命令的查询缓存。例如,
$result = $db->cache(function ($db) {
// 使用查询缓存的 SQL 查询
// 对此命令不使用查询缓存
$customer = $db->createCommand('SELECT * FROM customer WHERE id=1')->noCache()->queryOne();
// ...
return $result;
});
当查询结果中含有资源句柄时,查询缓存无法使用。
例如,在有些 DBMS 中使用了 BLOB
列的时候,
缓存结果会为该数据列返回一个资源句柄。
有些缓存存储器有大小限制。例如,memcache 限制每条数据最大为 1MB。 因此,如果查询结果的大小超出了该限制, 则会导致缓存失败。
当你想让所有的缓存数据失效时,可以调用 yii\caching\Cache::flush()。
冲刷缓存数据,你还可以从控制台调用 yii cache/flush
。
yii cache
:列出应用中可用的缓存组件yii cache/flush cache1 cache2
:刷新缓存组件cache1
,cache2
(可以传递多个用空格分开的缓存组件)yii cache/flush-all
:刷新应用中所有的缓存组件yii cache/flush-schema db
:清除给定连接组件的数据库表结构缓存信息: 默认情况下,控制台应用使用独立的配置文件。 所以,为了上述命令发挥作用,请确保 Web 应用和控制台应用配置相同的缓存组件。
Found a typo or you think this page needs improvement?
Edit it on github !
Signup or Login in order to comment.