PHP操作Redis KEY,String 的相关命令 (二)

PHP操作Redis LIST ,SET, HASH 的相关命令 (一)

PHP操作Redis 有序集(Sorted Set) 的相关命令 (三)

1.PHP操作Redis之KEY

1、DEL()

移除给定的一个或多个key。如果key不存在，则忽略该命令。
返回值：
被移除key的数量。

$redis->set('myname','ikodota');
echo $redis->get('myname').'<br>'; # 返回:ikodota
$redis->del('myname');# 返回 TRUE(1)
var_dump($redis->get('myname')); # 返回 bool(false)

#删除多个key值

$array_mset=array('first_key'=>'first_val','second_key'=>'second_val','third_key'=>'third_val');
$redis->mset($array_mset); #用MSET一次储存多个值
$array_mget=array('first_key','second_key','third_key');
var_dump($redis->mget($array_mget)); #一次返回多个值 //array(3) { [0]=> string(9) "first_val" [1]=> string(10)"second_val" [2]=> string(9) "third_val" }
$redis->del($array_mget); #同时删除多个key
var_dump($redis->mget($array_mget)); #返回 array(3) { [0]=> bool(false) [1]=> bool(false) [2]=> bool(false) }

2、KEYS()
查找符合给定模式的key。
KEYS *命中数据库中所有key。
KEYS h?llo命中hello， hallo and hxllo等。
KEYS h*llo命中hllo和heeeeello等。
KEYS h[ae]llo命中hello和hallo，但不命中hillo。
特殊符号用"\"隔开

#$redis->FLUSHALL();
$array_mset_keys=array('one'=>'1',
          'two'=>'2',
          'three '=>'3',
          'four'=>'4');
$redis->mset($array_mset_keys); #用MSET一次储存多个值
var_dump($redis->keys('*o*')); //array(3) { [0]=> string(4) "four" [1]=> string(3) "two" [2]=> string(3) "one" }
var_dump($redis->keys('t??')); //array(1) { [0]=> string(3) "two" }
var_dump($redis->keys('t[w]*')); //array(1) { [0]=> string(3) "two" }
print_r($redis->keys('*')); //Array ( [0] => four [1] => three [2] => two [3] => one )

3、RANDOMKEY()
从当前数据库中随机返回(不删除)一个key。
返回值：
当数据库不为空时，返回一个key。
当数据库为空时，返回nil。

//RANDOMKEY
$redis->FLUSHALL();
# 情况1：数据库不为空
$array_mset_randomkey=array('fruit'=>'apple',
                'drink'=>'beer',
                'food'=>'cookis');
$redis->mset($array_mset_randomkey);
echo $redis->randomkey(); 
print_r($redis->keys('*')); # 查看数据库内所有key，证明RANDOMKEY并不删除key//Array ( [0] => food [1] => drink [2] => fruit )

# 情况2：数据库为空

$redis->flushdb();  # 删除当前数据库所有key
var_dump($redis-> randomkey()); //bool(false)

4、TTL()
返回给定key的剩余生存时间(time to live)(以秒为单位)。
返回值：
key的剩余生存时间(以秒为单位)。
当key不存在或没有设置生存时间时，返回-1。
# 情况1：带TTL的key

$redis->flushdb();
//$redis->set('name','ikodota'); # 设置一个key
$redis->expire('name',30);  # 设置生存时间为30秒 //return (integer) 1
echo $redis->get('name'); //return ikodota
echo $redis->ttl('name'); //(integer) 25

5、EXISTS()
检查给定key是否存在。
返回值：
若key存在，返回1，否则返回0。

//EXISTS
echo '<br>EXISTS<br>';
$redis->set('db',"redis"); //bool(true) 
var_dump($redis->exists('db'));  # key存在 //bool(true) 
$redis->del('db');   # 删除key //int(1)
var_dump($redis->exists('db'))  # key不存在 //bool(false)

6、MOVE()
将当前数据库(默认为0)的key移动到给定的数据库db当中。
如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定key，或者key不存在于当前数据库，那么MOVE没有任何效果。
因此，也可以利用这一特性，将MOVE当作锁(locking)原语。
返回值：
移动成功返回1，失败则返回0。
//MOVE
echo '<br><br>MOVE<br>';
#情况1：key存在于当前数据库

$redis->SELECT(0);  # redis默认使用数据库0，为了清晰起见，这里再显式指定一次。//OK
$redis->SET('song',"secret base - Zone"); //OK
var_dump ($redis->MOVE('song',1));  # 将song移动到数据库1 //bool(true)

#情况2：当key不存在的时候

$redis->SELECT(1);
var_dump ($redis->EXISTS('fake_key'));//bool(false);
var_dump($redis->MOVE('fake_key', 0));  # 试图从数据库1移动一个不存在的key到数据库0，失败) //bool(false)
$redis->SELECT(0);  # 使用数据库0
var_dump($redis->EXISTS('fake_key'));  # 证实fake_key不存在 //bool(false)

#情况3：当源数据库和目标数据库有相同的key时

$redis->SELECT(0);  # 使用数据库0
$redis->SET('favorite_fruit',"banana");
$redis->SELECT(1);  # 使用数据库1
$redis->SET('favorite_fruit',"apple");
$redis->SELECT(0);  # 使用数据库0，并试图将favorite_fruit移动到数据库1
var_dump($redis->MOVE('favorite_fruit',1));  # 因为两个数据库有相同的key，MOVE失败 //return bool(false)
echo $redis->GET('favorite_fruit');  # 数据库0的favorite_fruit没变 //return banana
$redis->SELECT(1);
echo $redis->GET('favorite_fruit');   # 数据库1的favorite_fruit也是 //return apple

7、RENAME()
将key改名为newkey。
当key和newkey相同或者key不存在时，返回一个错误。
echo '<br><br>RENAME<br>';
# 情况1：key存在且newkey不存在

$redis->SET('message',"hello world");
var_dump($redis->RENAME('message','greeting'));  //bool(true)
var_dump($redis->EXISTS('message'));  #message不复存在 //bool(false)
var_dump($redis->EXISTS('greeting'));   #greeting取而代之 //bool(true)

# 情况2：当key不存在时，返回错误 ,php返回false;

var_dump($redis->RENAME('fake_key','never_exists'));  //bool(false)

# 情况3：newkey已存在时，RENAME会覆盖旧newkey

$redis->SET('pc',"lenovo");
$redis->SET('personal_computer',"dell"); 
var_dump($redis->RENAME('pc','personal_computer')); //bool(true)
var_dump($redis->GET('pc')); //(nil)   bool(false)
var_dump($redis->GET('personal_computer'));  # dell"没有"了 //string(6) "lenovo"

8、EXPIRE()
为给定key设置生存时间。
当key过期时，它会被自动删除。
在Redis中，带有生存时间的key被称作"易失的"(volatile)。

//EXPIRE
$redis->select(7);
//$redis->flushdb();
echo '<br><br>EXPIRE<br>';
$redis->SET('cache_page',"www.cnblogs.com/ikodota");
$redis->EXPIRE('cache_page', 30);  # 设置30秒后过期
sleep(6);
echo $redis->TTL('cache_page').'<br>';   # 查看给定key的剩余生存时间 //(integer) 24
$redis->EXPIRE('cache_page', 3000);  # 更新生存时间，3000秒
sleep(4);
echo $redis->TTL('cache_page').'<br>';   //(integer) 2996

9、EXPIREAT()
EXPIREAT的作用和EXPIRE一样，都用于为key设置生存时间。
不同在于EXPIREAT命令接受的时间参数是UNIX时间戳(unix timestamp)。
//EXPIREAT

echo '<br><br>EXPIREAT<br>';
$redis->SET('cache','www.google.com');
echo $redis->EXPIREAT('cache','1355292000'); # 这个key将在2012.12.12过期
echo ($redis->TTL('cache')); //return 124345085

10、PERSIST()
移除给定key的生存时间。
当生存时间移除成功时，返回1.
如果key不存在或key没有设置生存时间，返回0。

echo '<br><br>PERSIST<br>';
$redis->SET('time_to_say_goodbye',"886...");
$redis->EXPIRE('time_to_say_goodbye', 300);
sleep(3);
echo $redis->TTL('time_to_say_goodbye'); # (int) 297
echo '<br>';
$redis->PERSIST('time_to_say_goodbye');  # 移除生存时间
echo $redis->TTL('time_to_say_goodbye');  # 移除成功  //int(-1)

11、SORT()
排序，分页等
参数

array(
'by' => 'some_pattern_*',
'limit' => array(0, 1),
'get' => 'some_other_pattern_*' or an array of patterns,
'sort' => 'asc' or 'desc',
'alpha' => TRUE,
'store' => 'external-key'
)

返回或保存给定列表、集合、有序集合key中经过排序的元素。
排序默认以数字作为对象，值被解释为双精度浮点数，然后进行比较。
一般SORT用法
最简单的SORT使用方法是SORT key。
# 将数据一一加入到列表中

$redis->LPUSH('today_cost', 30);
$redis->LPUSH('today_cost', 1.5);
$redis->LPUSH('today_cost', 10);
$redis->LPUSH('today_cost', 8);

# 排序
var_dump($redis->SORT('today_cost')); //array(4) { [0]=> string(3) "1.5" [1]=> string(1) "8" [2]=> string(2) "10" [3]=> string(2) "30" }
当数据集中保存的是字符串值时，你可以用ALPHA修饰符(modifier)进行排序。
# 将数据一一加入到列表中

$redis->LPUSH('website', "www.reddit.com");
$redis->LPUSH('website', "www.slashdot.com");
$redis->LPUSH('website', "www.moyouyouw.com");

# 默认排序

var_dump($redis->SORT('website'));//array(3) { [0]=> string(13) "www.infoq.com" [1]=> string(16) "www.slashdot.com" [2]=> string(14) "www.moyouyouw.com" }

# 按字符排序 ALPHA=true

var_dump($redis->SORT('website', array('ALPHA'=>TRUE))); //array(3) { [0]=> string(13) "www.moyouyouw.com" [1]=> string(14) "www.reddit.com" [2]=> string(16) "www.slashdot.com" }

排序之后返回的元素数量可以通过LIMIT修饰符进行限制。
LIMIT修饰符接受两个参数：offset和count。
offset指定要跳过的元素数量，count指定跳过offset个指定的元素之后，要返回多少个对象。
以下例子返回排序结果的前5个对象(offset为0表示没有元素被跳过)。
# 将数据一一加入到列表中

$redis->LPUSH('rank', 30); //(integer) 1
$redis->LPUSH('rank', 56); //(integer) 2
$redis->LPUSH('rank', 42); //(integer) 3
$redis->LPUSH('rank', 22); //(integer) 4
$redis->LPUSH('rank', 0);  //(integer) 5
$redis->LPUSH('rank', 11); //(integer) 6
$redis->LPUSH('rank', 32); //(integer) 7
$redis->LPUSH('rank', 67); //(integer) 8
$redis->LPUSH('rank', 50); //(integer) 9
$redis->LPUSH('rank', 44); //(integer) 10
$redis->LPUSH('rank', 55); //(integer) 11

# 排序

$redis_sort_option=array('LIMIT'=>array(0,5));
var_dump($redis->SORT('rank',$redis_sort_option));   # 返回排名前五的元素 // array(5) { [0]=> string(1) "0" [1]=> string(2) "11" [2]=> string(2) "22" [3]=> string(2) "30" [4]=> string(2) "32" }

修饰符可以组合使用。以下例子返回降序(从大到小)的前5个对象。

$redis_sort_option=array(
            'LIMIT'=>array(0,5),
            'SORT'=>'DESC'
            );
var_dump($redis->SORT('rank',$redis_sort_option)); //array(5) { [0]=> string(2) "67" [1]=> string(2) "56" [2]=> string(2) "55" [3]=> string(2) "50" [4]=> string(2) "44" }

2.PHP操作Redis之String
将字符串值value关联到key。
如果key已经持有其他值，SET就覆写旧值，无视类型。返回值：总是返回OK(TRUE)，因为SET不可能失败。
# 情况1：对字符串类型的key进行SET

$redis->SET('apple', 'www.apple.com');#OK  //bool(true)
$redis->GET('apple');//"www.apple.com"

# 情况2：对非字符串类型的key进行SET

$redis->LPUSH('greet_list', "hello");#建立一个列表 #(integer) 1 //int(1)
$redis->TYPE('greet_list');#list //int(3)
$redis->SET('greet_list', "yooooooooooooooooo");# 覆盖列表类型 #OK //bool(true)
$redis->TYPE('greet_list');#string //int(1)

2.SETNX() key不存在 设置value
将key的值设为value，当且仅当key不存在。若给定的key已经存在，则SETNX不做任何动作。
返回值：设置成功，返回1。设置失败，返回0。

echo '<br><br>SETNX<br>';
$redis->EXISTS('job');  # job不存在 //bool(false);
$redis->SETNX('job', "programmer");  # job设置成功 //bool(true)
$redis->SETNX('job', "code-farmer");  # job设置失败 //bool(false)
echo $redis->GET('job');  # 没有被覆盖 //"programmer"

3.SETEX() 设置key-vaule 缓存时间
将值value关联到key，并将key的生存时间设为seconds(以秒为单位)。如果key 已经存在，SETEX命令将覆写旧值。
# 情况1：key不存在

$redis->SETEX('cache_user_id', 60,10086);//bool(true)
echo $redis->GET('cache_user_id');  # 值 //"10086"
sleep(4);
echo $redis->TTL('cache_user_id');  # 剩余生存时间 //int(56)

# 情况2：key已经存在，key被覆写

$redis->SET('cd', "timeless"); //bool(true);
$redis->SETEX('cd', 3000,"goodbye my love"); //bool(true);
echo $redis->GET('cd');//"goodbye my love"

4.MSET () 设置一个或多个key-value对
同时设置一个或多个key-value对。
当发现同名的key存在时，MSET会用新值覆盖旧值，如果你不希望覆盖同名key，请使用MSETNX命令。

echo '<br><br>MSET<br>';
$redis->select(0);
$redis->flushdb();
$array_mset=array('date'=>'2012.3.5',
        'time'=>'9.09a.m.',
        'weather'=>'sunny'
        );
$redis->MSET($array_mset); //bool(true)
var_dump($redis->KEYS('*'));   # 确保指定的三个key-value对被插入 //array(3) { [0]=> string(4) "time" [1]=> string(7) "weather" [2]=> string(4) "date" }

# MSET覆盖旧值的例子 但是经过测试覆盖不了

var_dump($redis->SET('google', "google.cn"));   //bool(true)
var_dump($redis->MSET('google',"google.hk")); //bool(false)
echo $redis->GET('google'); //google.cn  与redis手册的示例结果不符

5.MSETNX() key不存在时 设置多个 key-value
同时设置一个或多个key-value对，当且仅当key不存在。
# 情况1：对不存在的key进行MSETNX

$array_mset=array('rmdbs'=>'MySQL',
        'nosql'=>'MongoDB',
        'key-value-store'=>'redis'
);
$redis->MSETNX($array_mset);//bool(true)

# 情况2：对已存在的key进行MSETNX

$array_mset=array('rmdbs'=>'Sqlite',
        'language'=>'python'
);
var_dump($redis->MSETNX($array_mset));  # rmdbs键已经存在，操作失败 //bool(false)
var_dump($redis->EXISTS('language'));  # 因为操作是原子性的，language没有被设置  bool(false)
echo $redis->GET('rmdbs');  # rmdbs没有被修改 //"MySQL"
$array_mset_keys=array( 'rmdbs', 'nosql', 'key-value-store');
print_r($redis->MGET($array_mset_keys)); //Array ( [0] => MySQL [1] => MongoDB [2] => redis )

6.APPEND() 将value追加 key原来值之后
如果key已经存在并且是一个字符串，APPEND命令将value追加到key原来的值之后。
如果key不存在，APPEND就简单地将给定key设为value，就像执行SET key value一样。
# 情况1：对不存在的key执行APPEND

$redis->EXISTS('myphone');  # 确保myphone不存在 //bool(false)
$redis->APPEND('myphone',"nokia");  # 对不存在的key进行APPEND，等同于SET myphone "nokia" //int(5) # 字符长度

# 情况2：对字符串进行APPEND

$redis->APPEND('myphone', " - 1110");# 长度从5个字符增加到12个字符 //int(12)
echo $redis->GET('myphone');  # 查看整个字符串 //"nokia - 1110"

7.GET() 获取key值
返回key所关联的字符串值。如果key不存在则返回特殊值nil。
假如key储存的值不是字符串类型，返回一个错误，因为GET只能用于处理字符串值。

var_dump($redis->GET('fake_key')); #(nil) //return bool(false)
$redis->SET('animate', "anohana"); //return bool(true)
var_dump($redis->GET('animate')); //return string(7) "anohana"

8.MGET() 获取多个key的值
返回所有(一个或多个)给定key的值。
如果某个指定key不存在，那么返回特殊值nil。因此，该命令永不失败。
//MGET

echo '<br><br>MGET<br>';
$redis_mget_data_array=array('name'=>'ikodota','blog'=>'cnblogs.com/ikodota');
$redis->MSET($redis_mget_data_array);#用MSET一次储存多个值 
$redis_mget_key_array=array('name','blog');
var_dump($redis->MGET($redis_mget_key_array)); //array(2) { [0]=> string(7) "ikodota" [1]=> string(19) "cnblogs.com/ikodota" }
$redis->EXISTS('fake_key'); //bool(false)
$redis_mget_key_array=array('name','fake_key');
var_dump($redis->MGET($redis_mget_key_array));  # 当MGET中有不存在key的情况   //array(2) { [0]=> string(7) "ikodota" [1]=> bool(false) }

9.GETRANGE() 字符串截取
返回key中字符串值的子字符串，字符串的截取范围由start和end两个偏移量决定(包括start和end在内)。
负数偏移量表示从字符串最后开始计数，-1表示最后一个字符，-2表示倒数第二个，以此类推。

echo '<br><br>GETRANGE<br>';
$redis->SET('greeting', "hello, my friend");
echo $redis->GETRANGE('greeting', 0, 4).'<br>';  # 返回索引0-4的字符，包括4。 //"hello"
echo $redis->GETRANGE('greeting', -1 ,-5).'<br>';  # 不支持回绕操作  //""
echo $redis->GETRANGE('greeting', -3 ,-1).'<br>';  # 负数索引 //"end"
echo $redis->GETRANGE('greeting', 0, -1).'<br>';  # 从第一个到最后一个 //"hello, my friend"
echo $redis->GETRANGE('greeting', 0, 1008611).'<br>';  # 值域范围不超过实际字符串，超过部分自动被符略 //"hello, my friend"

10.GETSET()
将给定key的值设为value，并返回key的旧值。当key存在但不是字符串类型时，返回一个错误。

echo '<br><br>GETSET<br>';
var_dump($redis->EXISTS('mail'));//return bool(false);
var_dump($redis->GETSET('mail','xxx@google.com'));  # 因为mail之前不存在，没有旧值，返回nil ,#(nil)   //bool(false)
var_dump($redis->GETSET('mail','xxx@yahoo.com'));  # mail被更新，旧值被返回 //string(14) "xxx@google.com"

11.STRLEN() 字符串值的长度
返回key所储存的字符串值的长度。当key储存的不是字符串值时，返回一个错误。
当 key不存在时，返回0。

$redis->SET('mykey', "Hello world");
echo $redis->STRLEN('mykey'); //int(11)
echo $redis->STRLEN('nonexisting'); # 不存在的key长度视为0  //int(0)

12.INCR()/DECR() 数字值 增/减 一
将key中储存的数字值增一。
如果key不存在，以0为key的初始值，然后执行INCR操作。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在64位(bit)有符号数字表示之内。
返回值：
执行INCR命令之后key的值。
注解:这是一个针对字符串的操作，因为Redis没有专用的整数类型，所以key内储存的字符串被解释为十进制64位有符号整数来执行INCR操作。

$redis->SET('page_view', 20);
var_dump($redis->INCR('page_view')); //int(21) 
var_dump($redis->GET('page_view'));    # 数字值在Redis中以字符串的形式保存 //string(2) "21

13.INCRBY() /DECRBY() 增加/减 数值
将key所储存的值加上增量increment。
如果key不存在，以0为key的初始值，然后执行INCRBY命令。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在64位(bit)有符号数字表示之内。
返回值：
加上increment之后，key的值。
echo '<br><br>INCRBY<br>';
# 情况1：key存在且是数字值

$redis->SET('rank', 50);  # 设置rank为50
$redis->INCRBY('rank', 20);  # 给rank加上20
var_dump($redis->GET('rank')); #"70"   //string(2) "70"

# 情况2：key不存在

$redis->EXISTS('counter'); //bool(false)
$redis->INCRBY('counter'); #int 30  //bool(false)
var_dump($redis->GET('counter')); #30 //经测试 与手册上结果不一样，不能直接从bool型转为int型。 return bool(false) 

# 情况3：key不是数字值

$redis->SET('book', "long long ago...");
var_dump($redis->INCRBY('book', 200)); #(error) ERR value is not an integer or out of range   // bool(false)