README

提供以 Yii 风格熟悉的对象导向方式访问 Redis。当您向 Redis 实体（列表、集合、有序集合、散列表）添加或删除项目时，更改将立即推送到服务器，这在您的应用程序需要跨多个请求提供信息时很有用。

此包依赖于 https://github.com/nicolasff/phpredis PHP 扩展，请在继续之前确保已安装。

使用方法

配置 Redis 连接

将以下内容添加到您的应用程序配置中

[
"components" => array(
	"redis" => array(
		"class" => "packages.redis.ARedisConnection",
		"hostname" => "localhost",
		"port" => 6379,
		"database" => 1,
		"prefix" => "Yii.redis."
	),
	...
)];

存储和检索简单键

存储简单值到键并读取回来

Yii::app()->redis->getClient()->set("myKey", "Your Value");
echo Yii::app()->redis->getClient()->get("myKey"); // outputs "Your Value"
Yii::app()->redis->getClient()->del("myKey"); // deletes the key

使用列表

Redis 列表是按添加项目的顺序保持的简单值列表

$list = new ARedisList("aNameForYourListGoesHere");
$list->add("cats");
$list->add("dogs");
$list->add("fish");
foreach($list as $i => $val) {
	echo $val."<br />";
}
$list->clear(); // delete the list

使用集合

Redis 集合是无序的非重复值列表

$set = new ARedisSet("aNameForYourSet");
$set->add(1);
$set->add(2);
$set->add(3);
echo $set->getCount(); // outputs 3
$set->add(3);
echo $set->getCount(); // still 3, cannot add the same value more than once
foreach($set as $val) {
	echo $val."<br />";
}

使用有序集合

Redis 有序集合是非重复值的列表，每个值都与一个分数相关联，该分数影响结果的顺序

$sortedSet = new ARedisSortedSet("aNameForYourSortedSet");
$sortedSet->add("myValue", 0.4);
$sortedSet->add("myOtherValue", 0.8);
$sortedSet->add("myOtherOtherValue", 0.9);
foreach($sortedSet as $key => $score) {
	echo $key.": ".$score."<br />";
}

使用散列表

Redis 散列表是字符串字段与字符串值之间的映射，因此它们是表示对象（例如：具有姓名、姓氏、年龄等字段的用户）的完美数据类型。

$hash = new ARedisHash("myHashNameHere");
$hash->whatever = "someValue";
$hash->greeting = "hello world";

echo $hash->getCount(); // outputs 2

使用 Pub/Sub

Redis 允许我们订阅频道并向它们发布消息。

$channel = new ARedisChannel("myChan");
$channel->onReceiveMessage = function($redis, $channel, $message) {
	echo "Message Received: ".$message."\n";
};
$channel->publish("hello world"); // sends a messsage to the channel
$channel->subscribe(); // subscribes to the channel and listens to messages, blocks the process

使用 Redis 作为计数器

我们经常需要为特定数据库表或行存储计数器，使用 YiiRedis 这既快又简单。

$counter = new ARedisCounter("totalPageViews");
$counter->increment();
echo $counter->getValue();

使用 Redis 作为互斥锁

互斥锁有助于确保一次只有一个客户端可以访问特定的资源。

$mutex = new ARedisMutex("someOperation");
$mutex->block(); // blocks execution until the resource becomes available
// do something
$mutex->unlock(); // release the lock

使用 Redis 作为缓存

由于速度相当且数据持久化，Redis 是 memcached 的良好缓存替代品。

在您的应用程序配置中

[
"components" => array(
	"cache" => array(
		"class" => "packages.redis.ARedisCache"
	),
	...
),];

使用 Redis 作为 Active Record 后端

可以使用 ARedisRecord 在 Redis 中存储类似于 active record 的结构。

注意：这是实验性功能，可能随时更改

$record = ARedisRecord::model()->findByPk(1); // loads a record with a unique id of 1
$record->name = "a test name"; // sets the name attribute on the record
$record->somethingElse = "some other value";
$record->save(); // saves the record to redis
$record->delete(); // deletes the record from redis

todo 测试channel

修复ARedisEntity->expire()的语法错误 删除过时的方法 如redis->delete,redis-lsize

修复ARedisList->copyFrom()方法中的语法错误 修复ARedisSet->copyFrom()方法中的语法错误

解决ARedisHash中类销毁时会自动设置过期时间为10天的bug