Redis使用hash(哈希)和zset(有序集合)

旧城等待， 2022-03-21 04:55 396阅读 0赞

**1,hset**

描述：将哈希表key中的域field的值设为value。如果key不存在，一个新的哈希表被创建并进行HSET操作。如果域field已经存在于哈希表中，旧值将被覆盖。  
参数：key field value  
返回值：如果field是哈希表中的一个新建域，并且值设置成功，返回1。如果哈希表中域field已经存在且旧值已被新值覆盖，返回0。

**2，hsetnx**

描述：将哈希表key中的域field的值设置为value，当且仅当域field不存在。若域field已经存在，该操作无效。如果key不存在，一个新哈希表被创建并执行HSETNX命令。  
参数：key field value  
返回值：设置成功，返回1。如果给定域已经存在且没有操作被执行，返回0。

**3，hget**

描述：返回哈希表key中给定域field的值。  
参数：key field  
返回值：给定域的值。当给定域不存在或是给定key不存在时，返回nil。

**4,hmset**

描述：同时将多个field - value(域-值)对设置到哈希表key中。此命令会覆盖哈希表中已存在的域。如果key不存在，一个空哈希表被创建并执行HMSET操作。  
参数：key field value \[field value ...\]  
返回值：如果命令执行成功，返回OK。当key不是哈希表(hash)类型时，返回一个错误。

**5,hmget**

描述:返回哈希表key中，一个或多个给定域的值。如果给定的域不存在于哈希表，那么返回一个nil值。因为不存在的key被当作一个空哈希表来处理，所以对一个不存在的key进行HMGET操作将返回一个只带有nil值的表。  
参数：key field \[field ...\]  
返回值：一个包含多个给定域的关联值的表，表值的排列顺序和给定域参数的请求顺序一样。

**6,hgetall**

描述:返回哈希表key中，所有的域和值。在返回值里，紧跟每个域名(field name)之后是域的值(value)，所以返回值的长度是哈希表大小的两倍。  
参数：key  
返回值:以列表形式返回哈希表的域和域的值。 若key不存在，返回空列表。

**7,hdel**

描述:删除哈希表key中的一个或多个指定域，不存在的域将被忽略。  
参数：key field \[field ...\]  
返回值:被成功移除的域的数量，不包括被忽略的域。

**8,hlen**

描述:返回哈希表key中域的数量。  
参数：key  
返回值：哈希表中域的数量。当key不存在时，返回0。

**9,hexists**

描述:查看哈希表key中，给定域field是否存在。  
参数：key field  
返回值：如果哈希表含有给定域，返回1。如果哈希表不含有给定域，或key不存在，返回0。

**10,hincrby**

描述:为哈希表key中的域field的值加上增量increment。增量也可以为负数，相当于对给定域进行减法操作。  
参数：key field increment  
返回值：执行HINCRBY命令之后，哈希表key中域field的值。

**11,hkeys**

描述:返回哈希表key中的所有域。  
参数：key  
返回值：一个包含哈希表中所有域的表。当key不存在时，返回一个空表。

**12,hvals**

描述:返回哈希表key中的所有值。  
参数：key  
返回值：一个包含哈希表中所有值的表。当key不存在时，返回一个空表。

<?php 
 $redis = new redis(); 
 $redis->connect('182.92.196.241', 6379); 
 $auth = $redis->auth('wehealthgene');
 $redis->delete('test'); 
 
 $redis->hset('test', 'key1', 'hello'); 
 echo $redis->hget('test', 'key1'); //结果：hello 
 
 echo " "; 
 $redis->hSetNx('test', 'key1', 'world'); 
 echo $redis->hget('test', 'key1'); //结果：hello 
 
 $redis->delete('test'); 
 $redis->hSetNx('test', 'key1', 'world'); 
 echo " "; 
 echo $redis->hget('test', 'key1'); //结果：world 
 
 echo $redis->hlen('test'); //结果：1 
 var_dump($redis->hdel('test','key1')); //结果：bool(true) 
 
 $redis->delete('test'); 
 $redis->hSet('test', 'a', 'x'); 
 $redis->hSet('test', 'b', 'y'); 
 $redis->hSet('test', 'c', 'z'); 
 print_r($redis->hkeys('test')); //结果：Array ( [0] => a [1] => b [2] => c ) 
 
 print_r($redis->hvals('test')); //结果：Array ( [0] => x [1] => y [2] => z ) 
 
 print_r($redis->hgetall('test')); //结果：Array ( [a] => x [b] => y [c] => z ) 
 
 var_dump($redis->hExists('test', 'a')); //结果：bool(true) 
 
 $redis->delete('test'); 
 echo $redis->hIncrBy('test', 'a', 3); //结果：3 
 echo $redis->hIncrBy('test', 'a', 1); //结果：4 
 
 $redis->delete('test'); 
 var_dump($redis->hmset('test', array('name' =>'tank', 'sex'=>"man"))); //结果：bool(true) 
 print_r($redis->hmget('test', array('name', 'sex'))); //结果：Array ( [name] => tank [sex] => man ) 
 ?>

**13,zadd**

描述：  
增加一个或多个元素，如果该元素已经存在，更新它的socre值  
虽然有序集合有序，但它也是集合，不能重复元素，添加重复元素只会  
更新原有元素的score值

参数：  
key  
score : double  
value: string

返回值：1 or 0

**14，zrange**

描述：取得特定范围内的排序元素,0代表第一个元素,1代表第二个[以此类推][Link 1]。-1代表最后一个,-2代表倒数第二个...

参数：  
key  
start: long  
end: long  
withscores: bool = false

返回值：数组

**15，zdelete, zrem**

描述：从有序集合中删除指定的成员。

参数：  
key  
member

返回值：1 or 0

**16，zrevrange**

描述：返回key对应的有序集合中指定区间的所有元素。这些元素按照score从高到低的顺序进行排列。对于具有相同的score的元素而言，将会按照递减的字典顺序进行排列。该命令与ZRANGE类似，只是该命令中元素的排列顺序与前者不同。

参数：  
key  
start: long  
end: long  
withscores: bool = false

返回值：数组

**17，zrangebyscore, zrevrangebyscore**

描述：返回key对应的有序集合中score介于min和max之间的所有元素（包哈score等于min或者max的元素）。元素按照score从低到高的顺序排列。如果元素具有相同的score，那么会按照字典顺序排列。  
可选的选项LIMIT可以用来获取一定范围内的匹配元素。如果偏移值较大，有序集合需要在获得将要返回的元素之前进行遍历，因此会增加O(N)的时间复杂度。可选的选项WITHSCORES可以使得在返回元素的同时返回元素的score，该选项自从Redis 2.0版本后可用。

参数：  
key  
start: string  
end: string  
options: array

返回值：数组

**18，zcount**

描述：返回key对应的有序集合中介于min和max间的元素的个数。

参数：  
key  
start: string  
end: string

返回值：数组长度

**19，zremrangebyscore, zreleterangebyscore**

描述：移除key对应的有序集合中scroe位于min和max（包含端点）之间的所哟元素。从2.1.6版本后开始，区间端点min和max可以被排除在外，这和ZRANGEBYSCORE的语法一样。

参数：  
key  
start: double or "+inf" or "-inf" string  
end: double or "+inf" or "-inf" string

返回值：删除元素个数

**20，zremrangebyrank, zdeleterangebyrank**

描述：移除key对应的有序集合中rank值介于start和stop之间的所有元素。start和stop均是从0开始的，并且两者均可以是负值。当索引值为负值时，表明偏移值从有序集合中score值最高的元素开始。例如：-1表示具有最高score的元素，而-2表示具有次高score的元素，以此类推。

参数：  
key  
start: LONG  
end: LONG

返回值：删除元素个数

**21，zsize, zcard**

描述：返回存储在key对应的有序集合中的元素的个数。  
参数：key  
返回值：元素个数

**22，zscore**

描述：返回key对应的有序集合中member的score值。如果member在有序集合中不存在，那么将会返回null。  
参数：key member

**23,zrank, zrevrank**

描述：返回key对应的有序集合中member元素的索引值，元素按照score从低到高进行排列。rank值（或index）是从0开始的，这意味着具有最低score值的元素的rank值为0。使用ZREVRANK可以获得从高到低排列的元素的rank（或index）。  
参数：key member  
返回值：数字

**24，zincrby**

将key对应的有序集合中member元素的scroe加上increment。如果指定的member不存在，那么将会添加该元素，并且其score的初始值为increment。如果key不存在，那么将会创建一个新的有序列表，其中包含member这一唯一的元素。如果key对应的值不是有序列表，那么将会发生错误。指定的score的值应该是能够转换为数字值的字符串，并且接收双精度浮点数。同时，你也可用提供一个负值，这样将减少score的值。  
参数：key value member  
返回值：字符型数据

**25，zunion**

描述：keys对应的numkeys个有序集合计算合集，并将结果存储在destination中  
参数：keyOutput arrayZSetKeys arrayWeights aggregateFunction  
返回值：并集数组

**26，zinter**

描述：keys对应的numkeys个有序集合计算交集，并将结果存储在destination中  
参数：keyOutput arrayZSetKeys arrayWeights aggregateFunction  
返回值：交集数组

<?php 
 $redis = new redis(); 
 $redis->connect('182.92.196.241', 6379); 
 $auth = $redis->auth('wehealthgene');
 
 $redis->delete('test'); 
 $redis->zadd('test', 1, 'val1'); 
 $redis->zadd('test', 0, 'val2'); 
 $redis->zadd('test', 3, 'val3'); 
 
 print_r($redis->zrange('test', 0, -1)); //结果：Array ( [0] => val2 [1] => val1 [2] => val3 ) 
 
 echo " "; 
 $redis->zdelete('test', 'val2'); 
 print_r($redis->zrange('test', 0, -1)); //结果：Array ( [0] => val1 [1] => val3 ) 
 
 echo " "; 
 $redis->zadd('test',4, 'val0'); 
 print_r($redis->zrevrange('test', 0, -1)); //结果：Array ( [0] => val0 [1] => val3 [2] => val1 ) 
 
 echo " "; 
 print_r($redis->zrevrange('test', 0, -1,true)); //结果：Array ( [val0] => 4 [val3] => 3 [val1] => 1 ) 
 
 echo " "; 
 $redis->zadd('key', 0, 'val0'); 
 $redis->zadd('key', 2, 'val2'); 
 $redis->zadd('key', 10, 'val10'); 
 
 print_r($redis->zrangebyscore('key', 0, 3, array('limit' => array(1, 1),'withscores' => TRUE))); //结果：Array ( [val2] => 2 ) 
 
 echo " asdfasdfasdf"; 
 print_r($redis->zrangebyscore('key', 0, 3, array('limit' => array(1, 2)))); //结果：Array ( [0] => val2 ) 
 
 echo $redis->zcount('key', 0, 3); //结果：3 
 // print_r($redis->zrange('key', 0, -1, TRUE)); //结果：Array ( [0] => val10 ) 
 
 $redis->zremrangebyscore('key', 0, 3); 
 print_r($redis->zrange('key', 0, -1)); //结果：Array ( [0] => val10 ) 
 
 echo " "; 
 
 echo $redis->zsize('key'); //结果：1 
 
 $redis->zadd('key', 2.5, 'aaaa'); 
 $redis->zadd('key', 3.5, 'bbb'); 
 echo $redis->zscore('key', 'aaaa'); //结果：2.5 
 
 echo $redis->zrank('key', 'aaaa'); //结果：0 
 echo $redis->zrevrank('key', 'aaaa'); //结果：1 
 
 $redis->delete('key'); 
 
 echo $redis->zincrby('key', 2, 'aaaa'); //结果：2 
 echo $redis->zincrby('key', 1, 'aaaa'); //结果：3 
 
 $redis->delete('key'); 
 $redis->delete('test'); 
 
 $redis->zadd('key', 0, 'val0'); 
 $redis->zadd('key', 1, 'val1'); 
 $redis->zadd('key', 4, 'val2'); 
 $redis->zadd('test', 2, 'val2'); 
 $redis->zadd('test', 3, 'val3'); 
 $redis->zunion('k01', array('key', 'test')); 
 print_r($redis->zrange('k01',0, -1)); //结果：Array ( [0] => val0 [1] => val1 [2] => val3 [3] => val2 ) 
 
 echo " "; 
 $redis->zunion('k03', array('key', 'test'), array(5, 1)); 
 print_r($redis->zrange('k03',0, -1)); //结果：Array ( [0] => val0 [1] => val3 [2] => val1 [3] => val2 ) 
 
 echo " "; 
 $redis->zinter('k02', array('key', 'test')); 
 print_r($redis->zrange('k02',0, -1)); //结果：Array ( [0] => val2 )

[Link 1]: https://www.baidu.com/s?wd=%E4%BB%A5%E6%AD%A4%E7%B1%BB%E6%8E%A8&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd