KEY(键)
Redis DEL 命令用于删除已存在的键。不存在的 key 会被忽略。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
// The first case 删除单独的 key
$redis->set('w3ckey','redis');
var_dump($redis->get('w3ckey')); // 返回 redis
$redis ->del('w3ckey'); // 删除该key,若需要获取返回值,则返回值为 int(1)
var_dump($redis->get('w3ckey')); // 返回 boolean(false)
// The second case 删除一个不存在的 key
if(!$redis->exists('fake_key'))
{
var_dump($redis->del('fake_key')); // 返回 int();
}
// The third case 同时删除多个 key
$array_mset = array(
'key1' => 'val1',
'key2' => 'val2',
'key3' => 'val3',
);
$redis->mset($array_mset); // 使用 mset 同时存储多个值
$array_mget = array('key1', 'key2', 'key3');
var_dump($redis->mget($array_mget)); // 返回 array (size=3)0 => string 'val1' (length=4) 1 => string 'val2' (length=4) 2 => string 'val3' (length=4)
$redis -> del($array_mget); // 同时删除多个值
var_dump($redis->mget($array_mget)); // 返回 array (size=3) 0 => boolean false 1 => boolean false 2 => boolean false
2、EXISTS
Redis EXISTS 命令用于检查给定 key 是否存在。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->set('w3ckey','redis');
var_dump($redis->exists('w3ckey')); // boolean true
$redis ->del('w3ckey');
var_dump($redis->exists('w3ckey')); // boolean(false)
3、EXPIRE
Redis Expire 命令用于设置 key 的过期时间。key 过期后将不再可用。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->set('w3ckey','redis');
$redis->expire('w3ckey',20); // 设置 w3ckey 的剩余生存时间为 20s
sleep(2);
var_dump($redis->TTL('w3ckey')); // 查看给定 key 的剩余生存时间,int 18
$redis->expire('w3ckey',30); // 更新 w3ckey 的剩余生存时间为 30s
sleep(3);
var_dump($redis->TTL('w3ckey')); // int 27
4、EXPIREAT
Redis Expireat 命令用于以 UNIX 时间戳(unix timestamp)格式设置 key 的过期时间。key 过期后将不再可用。EXPIREAT的作用和EXPIRE一样,都用于为key设置生存时间。不同在于EXPIREAT命令接受的时间参数是UNIX时间戳(unix timestamp)。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->set('w3ckey','redis');
$redis->expireAt('w3ckey',time()+10); // 设置 w3ckey 的剩余生存时间为 10s 后过期
sleep(3);
var_dump($redis->TTL('w3ckey')); // 查看给定 key 的剩余生存时间,int 7
5、KEYS
Redis Keys 命令用于查找所有符合给定模式 pattern 的 key 。
(1)KEYS * 命中数据库中所有key。
(2)KEYS h?llo 命中hello, hallo and hxllo等。
(3)KEYS h*llo 命中hllo和heeeeello等。
(4)KEYS h[ae]llo 命中hello和hallo,但不命中hillo。
(5)特殊符号用""隔开
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->flushAll();
$array_mset_keys = array(
'one' => 1,
'two' => 2,
'three' => 3,
'four' => 4,
);
$redis -> mset($array_mset_keys);
// KEYS * 命中数据库中所有key。
var_dump($redis -> keys('*'));
// array (size=4) 0 => string 'four' (length=4) 1 => string 'two' (length=3) 2 => string 'three' (length=5) 3 => string 'one' (length=3)
// KEYS *o* 命中所有包含 "o" 的key。
var_dump($redis -> keys('*o*'));
// array (size=4) 0 => string 'four' (length=4) 1 => string 'two' (length=3) 2 => string 'one' (length=3)
// KEYS 0?? 命中 "o" 后面有几个问号就命中几位数。
var_dump($redis->keys("o??"));
//array (size=1) 0 => string 'one' (length=3)
// KEYS t[wh]* 命中 "t" 后面跟了 "w" , "h" 或者 "wh" 的key。
var_dump($redis->keys("t[wh]*"));
//array (size=2) 0 => string 'two' (length=3) 1 => string 'three' (length=5)
6、MOVE
Redis Keys 命令用于将当前数据库(默认为0)的key移动到给定的数据库db当中。如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定key,或者key不存在于当前数据库,那么MOVE没有任何效果。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->flushAll();
// This first case: key 存在于当前数据库
$redis -> select(0); // redis 默认使用数据库0,这里在显示指定一次
$redis -> set('favorite_fruit','pineapple'); // 确保 key 值存在
if($redis -> move('favorite_fruit',1)){ // 将 favorite_fruit 移动到数据库 1 中, int 1
$redis -> select(1); // 选择数据库 1
var_dump($redis -> get('favorite_fruit')); // string pineapple
}
// This second case: key 不存在
$redis -> select(0);
if(! $redis->exists('fake_key')){ // key 不存在
$redis -> move('fake_key',1); // 将 favorite_fruit 移动到数据库 1 中, int 0
}
$redis -> select(1);
var_dump($redis->exists('fake_key')); // boolean (false)
// This third case: 源数据库和目标数据库有相同的 key
$redis -> select(0);
$redis -> set('favorite_singer','Jay Chou'); // db0 和 db1 有相同的 key : favorite_singer
$redis -> select(1);
$redis -> set('favorite_singer','Xu Wei');
$redis -> select(0);
$redis -> move('favorite_singer',1); // 将 favorite_fruit 移动到数据库 1 中, int 0
echo $redis -> get('favorite_singer'); // db0 的值没有发生改变,string Jay Chou
$redis -> select(1);
echo $redis -> get('favorite_singer'); // db1 的值没有发生改变,string Xu Wei
7、PERSIST
Redis PERSIST 命令用于移除给定 key 的过期时间,使得 key 永不过期。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->flushAll();
// This first case: key 存在且设置了过期时间
$redis -> set('favorite_fruit','pineapple');
$redis -> expire('favorite_fruit',20);
sleep(2);
echo $redis -> ttl('favorite_fruit')."</br>"; // 18
$redis -> persist('favorite_fruit'); // 移除过期时间
echo $redis -> ttl('favorite_fruit'); // -1 ,表示成功移除过期时间
// This second case: key 不存在
$redis -> select(0);
if(! $redis->exists('fake_key')){ // key 不存在
var_dump($redis -> persist('fake_key')); // boolean false
}
// This third case: key 存在但是没有设置过期时间
$redis -> select(0);
$redis -> set('favorite_singer','Jay Chou');
var_dump($redis -> persist('favorite_singer')); // boolean false
8、TTL
Redis TTL 命令以秒为单位返回 key 的剩余过期时间。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->flushAll();
// This first case: key 存在且设置了过期时间
$redis -> set('favorite_fruit','pineapple');
$redis -> expire('favorite_fruit',20);
sleep(2);
echo $redis -> ttl('favorite_fruit')."</br>"; // 18
// This second case: key 不存在
$redis -> select(0);
if(! $redis->exists('fake_key')){ // key 不存在
var_dump($redis -> ttl('fake_key')); // int -2
}
// This third case: key 存在但是没有设置过期时间
$redis -> select(0);
$redis -> set('favorite_singer','Jay Chou');
var_dump($redis -> ttl('favorite_singer')); // int -1
9、RANDOMKEY
Redis RANDOMKEY 命令从当前数据库中随机返回一个 key (不删除) 。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
// This first case: 数据库不为空
$array_mset_randomkey = array(
'fruit' => 'pineapple',
'food' => 'beef',
'drink' => 'beer'
);
$redis -> mset($array_mset_randomkey);
var_dump($redis -> randomKey()); // string 'food' ,随机返回一个 key
var_dump($redis -> keys('*')); // 查看数据库里所有的 key ,验证 randomKey 不删除任何 key
// This second case: 数据库为空
$redis->flushAll(); // 清空数据库里的数据
var_dump($redis -> randomKey()); // boolean false
10、RENAME
Redis Rename 命令用于修改 key 的名称 。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->flushAll();
// This first case: key 存在且 newkey 不存在 ,成功改名
$redis -> set('fruit','pineapple');
$redis -> rename('fruit','favorite_fruit'); // 重命名
var_dump($redis -> exists('fruit')); // boolean false, 原来的 key 已经不存在
var_dump($redis -> exists('favorite_fruit')); // boolean true, key 变成了 newkey
// This second case: key 不存在 ,返回错误
$redis->flushAll();
if(! $redis ->exists('fake_key'))
{
var_dump($redis -> rename('fake_key','never_exists')); // boolean false
}
// This third case: key 和 newkey 相同 ,返回错误
$redis -> set('favorite_singer','Jay Chou');
var_dump($redis -> rename('favorite_singer','favorite_singer')); // boolean false
// This fourth case: newkey 已经存在, 覆盖
$redis -> set('PC','SONY');
$redis -> set('personal_computer','lenovo');
var_dump($redis -> rename('PC','personal_computer')); // boolean true
var_dump($redis -> get('personal_computer')); // string SONY
11、RENAMENX
Redis Renamenx 命令用于在新的 key 不存在时修改 key 的名称 。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
$redis->flushAll();
// This first case: key 存在且 newkey 不存在 ,成功改名
$redis -> set('fruit','pineapple');
$redis -> renameNx('fruit','favorite_fruit'); // 重命名
var_dump($redis -> exists('fruit')); // boolean false, 原来的 key 已经不存在
var_dump($redis -> exists('favorite_fruit')); // boolean true, key 变成了 newkey
// This second case: newkey已经存在,改名失败
$redis -> set('PC','SONY');
$redis -> set('personal_computer','lenovo');
var_dump($redis -> renameNx('PC','personal_computer')); // boolean false
var_dump($redis -> get('PC')); // string SONY
var_dump($redis -> get('personal_computer')); // string lenovo
12、TYPE
Redis Type 命令用于返回 key 所储存的值的类型。
<?php
$redis = new redis();
$redis->connect('127.0.0.1',6379);
// This first case: key 不存在 ,返回 int(0)
$redis->flushAll();
var_dump($redis -> type('fake_key')); // int(0)
// This second case: 字符串类型 ,返回 int(1)
$redis -> set('favorite_fruit','banana');
var_dump($redis -> type('favorite_fruit')); // int(1)
// This third case: 集合类型 , 返回 int(2)
$redis -> sAdd('favorite_singer','Jay Chou');
var_dump($redis -> type('favorite_singer')); // int(2)
// This fourth case: 列表类型 , 返回 int(3)
$redis -> lPush('program','PHP');
var_dump($redis -> type('program')); // int(3)
// This fifth case: 有序类型 , 返回 int(4)
$redis -> zAdd('pats','0','dog');
$redis -> zAdd('pats','1','cat');
$redis -> zAdd('pats','1','pig');
$redis -> zAdd('pats','2','fox');
var_dump($redis -> zRange('pats',0,-1)); // array (size=4) 0 => string 'dog' (length=3) 1 => string 'cat' (length=3) 2 => string 'pig' (length=3) 3 => string 'fox' (length=3)
var_dump($redis -> type('pats')); // int(4)
// This sixth case: 哈希类型 , 返回 int(5)
$redis -> hSet('website','baidu','www.baidu.com');
var_dump($redis -> hGet('website','baidu')); // string www.baidu.com
var_dump($redis -> type('website')); // int(5)
13、sort
返回或保存给定列表、集合、有序集合 key 中经过排序的元素。
排序默认以数字作为对象,值被解释为双精度浮点数,然后进行比较。
1、sort key ,若保存的值是数字,返回列表值从小到大的结果
// sort key ,按从小到大进行排序
$redis -> flushAll();
$redis -> lPush('number',1.5);
$redis -> lPush('number',18);
$redis -> lPush('number',75);
$redis -> lPush('number',38);
var_dump($redis -> sort('number'));
// array (size=4)
// 0 => string '1.5' (length=3)
// 1 => string '18' (length=2)
// 2 => string '38' (length=2)
// 3 => string '75' (length=2)
2、 若保存的是字符串,使用sort(key,array('ALPHA'=>TRUE))进行排序(按字母表顺序)
<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
// 若保存的是字符串,使用sort(key,array('ALPHA'=>TRUE))进行排序(按字母表顺序)
$redis -> flushAll();
$redis -> lPush('website','www.baidu.com');
$redis -> lPush('website','www.google.com');
$redis -> lPush('website','www.tencent.com');
$redis -> lPush('website','www.firefox.com');
var_dump($redis -> sort('website', array('ALPHA'=>TRUE)));
// array (size=4)
// 0 => string 'www.baidu.com' (length=13)
// 1 => string 'www.firefox.com' (length=15)
// 2 => string 'www.google.com' (length=14)
// 3 => string 'www.tencent.com' (length=15)
3、排序之后返回的元素可以通过LIMIT修饰符进行限制
使用sort(key,array('LIMIT'=>array(offset,count)))
LIMIT修饰符接受两个参数:offset 和 count。
offset指定要跳过的元素数量,count指定跳过offset个指定的元素之后,要返回多少个对象。
(1)排序的值为数字:
<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
// 若排序之后返回的元素数量可以通过LIMIT修饰符进行限制,使用sort(key,array('LIMIT'=>array(offset,count)))
// LIMIT修饰符接受两个参数:offset和count。
// offset指定要跳过的元素数量,count指定跳过offset个指定的元素之后,要返回多少个对象。
$redis -> flushAll();
$redis -> lPush('rank',5); //1
$redis -> lPush('rank',55); //7
$redis -> lPush('rank',52); //6
$redis -> lPush('rank',25); //4
$redis -> lPush('rank',24); //3
$redis -> lPush('rank',37); //5
$redis -> lPush('rank',13); //2
$redis -> lPush('rank',87); //8
$redis_sort_option = array('LIMIT' => array(2,5)); // 正序排序,跳过 2 个元素,跳过之后返回 5 个元素
var_dump($redis -> sort('rank', $redis_sort_option));
// array (size=5)
// 0 => string '24' (length=2)
// 1 => string '25' (length=2)
// 2 => string '37' (length=2)
// 3 => string '52' (length=2)
// 4 => string '55' (length=2)
$redis_sort_desc = array('LIMIT' => array(2,5),'SORT'=>'desc'); // 逆序排序,跳过 2 个元素,跳过之后返回 5 个元素
var_dump($redis -> sort('rank', $redis_sort_desc));
// array (size=5)
// 0 => string '52' (length=2)
// 1 => string '37' (length=2)
// 2 => string '25' (length=2)
// 3 => string '24' (length=2)
// 4 => string '13' (length=2)
(2)排序的值为字符串
<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
// 若排序之后返回的元素数量可以通过LIMIT修饰符进行限制,使用sort(key,array('LIMIT'=>array(offset,count)))
// LIMIT修饰符接受两个参数:offset和count。
// offset指定要跳过的元素数量,count指定跳过offset个指定的元素之后,要返回多少个对象。
$redis -> flushAll();
$redis -> lPush('website','www.baidu.com'); //2
$redis -> lPush('website','www.tencent.com'); //7
$redis -> lPush('website','www.firefox.com'); //3
$redis -> lPush('website','www.wangyi.com'); //8
$redis -> lPush('website','www.google.com'); //4
$redis -> lPush('website','www.software.com'); //6
$redis -> lPush('website','www.12306.cn'); //1
$redis -> lPush('website','www.hao123.com'); //5
$redis_sort_option = array('LIMIT' => array(0,5),'ALPHA'=>TRUE); // 正序排序,如果是字符串的话需要加 "ALPHA"=>TRUE ,跳过 0 个元素,跳过之后返回 5 个元素
var_dump($redis -> sort('website', $redis_sort_option));
// array (size=5)
// 0 => string 'www.12306.cn' (length=12)
// 1 => string 'www.baidu.com' (length=13)
// 2 => string 'www.firefox.com' (length=15)
// 3 => string 'www.google.com' (length=14)
// 4 => string 'www.hao123.com' (length=14)
$redis_sort_desc = array('LIMIT' => array(0,5),'SORT'=>'desc','ALPHA'=>TRUE); // 逆序排序,跳过 0 个元素,跳过之后返回 5 个元素
var_dump($redis -> sort('website', $redis_sort_desc));
// array (size=5)
// 0 => string 'www.wangyi.com' (length=14)
// 1 => string 'www.tencent.com' (length=15)
// 2 => string 'www.software.com' (length=16)
// 3 => string 'www.hao123.com' (length=14)
// 4 => string 'www.google.com' (length=14)
4、使用外部 key 进行排序
有时候会希望使用外部的key作为权重来比较元素,代替默认的对比方法)。
假设现在有用户(user)数据如下:
id name password level
1 Kangkang Kangkang123 5
4 Michael Michael123 3
2 Jane Jane123 2
3 Maria Maria123 7
id 保存在 key 名为 user_id 的列表中;
name 保存在 username_{id} 的 key 中;
password 保存在 userpassword_{id} 的 key 中;
level 保存在 userlevel_{id} 的 key 中。
(1)首先将数据加入到数据库中
<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
// kangkang
$redis -> lPush('user_id',1);
$redis -> set('username_1','Kangkang');
$redis -> set('userpassword_1','Kangkang123');
$redis -> set('userlevel_1',5);
// Michael
$redis -> lPush('user_id',4);
$redis -> set('username_4','Michael');
$redis -> set('userpassword_4','Michael123');
$redis -> set('userlevel_4',3);
// Jane
$redis -> lPush('user_id',2);
$redis -> set('username_2','Jane');
$redis -> set('userpassword_2','Jane123');
$redis -> set('userlevel_2',2);
// Maria
$redis -> lPush('user_id',3);
$redis -> set('username_3','Maria');
$redis -> set('userpassword_3','Maria123');
$redis -> set('userlevel_3',7);
(2)如果希望按 level 从大到小的顺序排序,可以这样做:
// 按 level 从大到小排序 id
$array_sort_option = array(
'BY' => 'userlevel_*',
'SORT' => 'DESC',
);
var_dump($redis -> sort('user_id',$array_sort_option));
// array (size=4)
// 0 => string '3' (length=1)
// 1 => string '1' (length=1)
// 2 => string '4' (length=1)
// 3 => string '2' (length=1)
// 有时候只是返回相应的id没有什么用,你可能更希望排序后返回id对应的用户名,GET 可以帮忙实现
$array_sort_option = array(
'BY' => 'userlevel_*',
'SORT' => 'DESC',
'GET' => 'username_*'
);
var_dump($redis -> sort('user_id',$array_sort_option));
// array (size=4)
// 0 => string 'Maria' (length=5)
// 1 => string 'Kangkang' (length=8)
// 2 => string 'Michael' (length=7)
// 3 => string 'Jane' (length=4)
// 若不但希望获取用户名,还希望连用户的密码也一并列出,可以使用以下命令,可以多次地、有序地使用 GET 操作来获取更多外部 key
$array_sort_option = array(
'BY' => 'userlevel_*',
'SORT' => 'DESC',
'GET' => array('#','username_*','userpassword_*') // 注意GET操作是有序的,GET username_* GET userpassword_* 和 GET userpassword_* GET username_*返回的结果位置不同, '#',为当前元素
);
var_dump($redis -> sort('user_id',$array_sort_option));
// array (size=12)
// 0 => string '3' (length=1)
// 1 => string 'Maria' (length=5)
// 2 => string 'Maria123' (length=8)
// 3 => string '1' (length=1)
// 4 => string 'Kangkang' (length=8)
// 5 => string 'Kangkang123' (length=11)
// 6 => string '4' (length=1)
// 7 => string 'Michael' (length=7)
// 8 => string 'Michael123' (length=10)
// 9 => string '2' (length=1)
// 10 => string 'Jane' (length=4)
// 11 => string 'Jane123' (length=7)
(3)只获取对象而不排序(若希望获取外部对象而又不希望引起排序开销时使用,BY修饰符可以将一个不存在的key当作权重,让SORT跳过排序操作)。
// 此处无论是 ASC 还是 DESC 都无效,是按照先 lpush 的user_id 在走后,后 lpush 的user_id 在最前
if(!$redis -> exists('fake_key')){
$array_sort_option1 = array(
'BY' => 'fake_key',
'GET' => array('#','username_*','userpassword_*')
);
var_dump($redis -> sort('user_id',$array_sort_option1));
}
// array (size=12)
// 0 => string '3' (length=1)
// 1 => string 'Maria' (length=5)
// 2 => string 'Maria123' (length=8)
// 3 => string '2' (length=1)
// 4 => string 'Jane' (length=4)
// 5 => string 'Jane123' (length=7)
// 6 => string '4' (length=1)
// 7 => string 'Michael' (length=7)
// 8 => string 'Michael123' (length=10)
// 9 => string '1' (length=1)
// 10 => string 'Kangkang' (length=8)
// 11 => string 'Kangkang123' (length=11)
(4)保存排序结果
默认情况下,SORT操作只是简单地返回排序结果,如果你希望保存排序结果,可以给 STORE 选项指定一个key作为参数,排序结果将以列表的形式被保存到这个key上。(若指定key已存在,则覆盖。)
// 使用 STORE 之后,可以将结果以 list 的形式保存在 STORE 所定义的 key 中。
$array_sort_option = array(
'BY' => 'userlevel_*',
'SORT' => 'DESC',
'GET' => array('#','username_*','userpassword_*'),
'STORE' => 'userinfo_sort_by_level'
);
var_dump($redis -> sort('user_id',$array_sort_option)); // int 12
var_dump($redis -> lRange('userinfo_sort_by_level',0,-1));
// array (size=12)
// 0 => string '3' (length=1)
// 1 => string 'Maria' (length=5)
// 2 => string 'Maria123' (length=8)
// 3 => string '1' (length=1)
// 4 => string 'Kangkang' (length=8)
// 5 => string 'Kangkang123' (length=11)
// 6 => string '4' (length=1)
// 7 => string 'Michael' (length=7)
// 8 => string 'Michael123' (length=10)
// 9 => string '2' (length=1)
// 10 => string 'Jane' (length=4)
// 11 => string 'Jane123' (length=7)
一个有趣的用法是将SORT结果保存,用EXPIRE为结果集设置生存时间,这样结果集就成了SORT操作的一个缓存。这样就不必频繁地调用SORT操作了,只有当结果集过期时,才需要再调用一次SORT操作。
有时候为了正确实现这一用法,你可能需要加锁以避免多个客户端同时进行缓存重建(也就是多个客户端,同一时间进行SORT操作,并保存为结果集),具体参见SETNX命令。