| 包 | system.caching |
|---|---|
| 继承 | class CEAcceleratorCache » CCache » CApplicationComponent » CComponent |
| 实现 | ArrayAccess, ICache, IApplicationComponent |
| 版本 | $Id: CEAcceleratorCache.php 3515 2011-12-28 12:29:24Z mdomba $ |
| 源码 |
CEAcceleratorCache基于eaccelerator实现缓存应用模块。
PHP扩展eAccelerator必须加载以使用这个应用程序组件。
查看CCache操作手册以了解CEAccelerator支持的常用缓存操作。
请注意，eAccelerator自v0.9.6版起不再支持数据缓存。 就是说如果你仍然要用这个组件，eAccelerator应版本不高于0.9.5.x。
PHP扩展eAccelerator必须加载以使用这个应用程序组件。
查看CCache操作手册以了解CEAccelerator支持的常用缓存操作。
请注意，eAccelerator自v0.9.6版起不再支持数据缓存。 就是说如果你仍然要用这个组件，eAccelerator应版本不高于0.9.5.x。
公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| behaviors | array | 这个应用组件附加的行为。 这此行为将在应用组件调用init时附加在应用组件上。 请参照CModel::behaviors如何指定此属性值。 | CApplicationComponent |
| isInitialized | boolean | 检查应用组件是否已经初始化。 | CApplicationComponent |
| keyPrefix | string | 加在每个缓存键名前的字符串以保证键名是唯一的。默认值是application ID。 | CCache |
公共方法
受保护方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| addValue() | 仅仅在甄别缓存值的键名不存在的情况下，往缓存中存储值。 | CEAcceleratorCache |
| deleteValue() | 从缓存中删除指定键名对应的值 | CEAcceleratorCache |
| flushValues() | 删除所有缓存值。 | CEAcceleratorCache |
| generateUniqueKey() | CCache | |
| getValue() | 从缓存中检索一个匹配指定键名的值。 | CEAcceleratorCache |
| getValues() | 从缓存中检索出多个匹配指定键名的值。 | CCache |
| setValue() | 往缓存中存储一个用键名区分的值。 | CEAcceleratorCache |
方法详细
addValue()
方法
|
protected boolean addValue(string $key, string $value, integer $expire)
| ||
| $key | string | 用以甄别缓存值的键名 |
| $value | string | 要缓存的值 |
| $expire | integer | 以秒为单位的数值，表示缓存的过期时间。为0则永不过期。 |
| {return} | boolean | 成功存储到缓存中则返回true，否则返回false |
protected function addValue($key,$value,$expire)
{
return (NULL === eaccelerator_get($key)) ? $this->setValue($key,$value,$expire) : false;
}
仅仅在甄别缓存值的键名不存在的情况下，往缓存中存储值。 这是在父类中定义的方法的具体实现。
deleteValue()
方法
|
protected boolean deleteValue(string $key)
| ||
| $key | string | 要删除值的键名 |
| {return} | boolean | 如果删除期间没有发生错误 |
protected function deleteValue($key)
{
return eaccelerator_rm($key);
}
从缓存中删除指定键名对应的值 这是在父类中定义的方法的具体实现。
flushValues()
方法
（可用自 v1.1.5）
|
protected boolean flushValues()
| ||
| {return} | boolean | 如果清空操作成功执行。 |
protected function flushValues()
{
// first, remove expired content from cache
eaccelerator_gc();
// now, remove leftover cache-keys
$keys = eaccelerator_list_keys();
foreach($keys as $key)
$this->deleteValue(substr($key['name'], 1));
return true;
}
删除所有缓存值。 这是在父类中定义的方法的具体实现。
getValue()
方法
|
protected string getValue(string $key)
| ||
| $key | string | 用以甄别缓存值的唯一键名 |
| {return} | string | 缓存中存储的值，如果该值不存在或者已过期则返回false。 |
protected function getValue($key)
{
$result = eaccelerator_get($key);
return $result !== NULL ? $result : false;
}
从缓存中检索一个匹配指定键名的值。 这是在父类中定义的方法的具体实现。
init()
方法
|
public void init()
|
public function init()
{
parent::init();
if(!function_exists('eaccelerator_get'))
throw new CException(Yii::t('yii','CEAcceleratorCache requires PHP eAccelerator extension to be loaded, enabled or compiled with the "--with-eaccelerator-shared-memory" option.'));
}
初始化这个应用程序组件。 该方法在接口IApplicationComponent中有要求。 它会检查eAccelerator是否可用。
setValue()
方法
|
protected boolean setValue(string $key, string $value, integer $expire)
| ||
| $key | string | 用以甄别缓存值的键名 |
| $value | string | 要缓存的值 |
| $expire | integer | 以秒为单位的数值，表示缓存的过期时间。为0则永不过期。 |
| {return} | boolean | 成功存储到缓存中则返回true，否则返回false |
protected function setValue($key,$value,$expire)
{
return eaccelerator_put($key,$value,$expire);
}
往缓存中存储一个用键名区分的值。 这是在父类中定义的方法的具体实现。