Redis 哈希(Hash)
Redis hash 是一个string类型的field和value的映射表,hash特别适合用于存储对象。
Redis 中每个 hash 可以存储 232 - 1 键值对(40多亿)。
实例:
127.0.0.1:6379> HMSET runoobkey name "redis tutorial" description "redis basic commands for caching" likes 20 visitors 23000
OK
127.0.0.1:6379> HGETALL runoobkey
1) "name"
2) "redis tutorial"
3) "description"
4) "redis basic commands for caching"
5) "likes"
6) "20"
7) "visitors"
8) "23000"
1.hset
描述:
将哈希表key中的域field的值设为value。
如果key不存在,一个新的哈希表被创建并进行HSET操作。
如果域field已经存在于哈希表中,旧值将被覆盖。
参数:key field value
返回值:
如果field是哈希表中的一个新建域,并且值设置成功,返回1。
如果哈希表中域field已经存在且旧值已被新值覆盖,返回0。
$redis->hSet('h', 'key1', 'hello');
2.hSetNx
描述:
将哈希表key中的域field的值设置为value,当且仅当域field不存在。
若域field已经存在,该操作无效。如果key不存在,一个新哈希表被创建并执行HSETNX命令。
参数:key field value
返回值:
设置成功,返回1。如果给定域已经存在且没有操作被执行,返回0。
如果key不存在,一个新的哈希表被创建并进行HSET操作。成功返回1
如果域field已经存在于哈希表中,旧值将被覆盖。成功返回0
将哈希表key中的域field的值设置为value,当且仅当域field不存在。设置成功返回1
若域field已经存在,该操作无效。返回0
$redis->hSetNx('h', 'key1', 'hello');
3.hGet
描述:给定域的值。
参数:key
返回值:当给定域不存在或是给定key不存在时,返回nil。
$redis->hGet('h', 'key1');
4.hLen
描述:返回哈希表key中域的数量。
参数:key
返回值:哈希表中域的数量。当key不存在时,返回0。
$redis->hSet('h', 'key1', 'hello');
$redis->hSet('h', 'key2', 'plop');
$redis->hLen('h'); /* returns 2 */
5.hDel
描述:删除哈希表key中的一个或多个指定域,不存在的域将被忽略。
参数:key field [field …]
返回值:被成功移除的域的数量,不包括被忽略的域。
$redis->delete('h')
6.hKeys
描述:
返回哈希表key中的所有域
一个包含哈希表中所有域的表。
当key不存在时,返回一个空表。
参数:key
返回值:一个包含哈希表中所有域的表。当key不存在时,返回一个空表。
$redis->hSet('h', 'a', 'x');
$redis->hSet('h', 'b', 'y');
$redis->hSet('h', 'c', 'z');
$redis->hSet('h', 'd', 't');
var_dump($redis->hKeys('h'));
array(4) {
[0]=>
string(1) "a"
[1]=>
string(1) "b"
[2]=>
string(1) "c"
[3]=>
string(1) "d"
}
7.hVals
描述:
返回哈希表key中的所有值。
一个包含哈希表中所有值的表。
返回值:当key不存在时,返回一个空表。
$redis->hSet('h', 'a', 'x');
$redis->hSet('h', 'b', 'y');
$redis->hSet('h', 'c', 'z');
$redis->hSet('h', 'd', 't');
var_dump($redis->hVals('h'));
array(4) {
[0]=>
string(1) "x"
[1]=>
string(1) "y"
[2]=>
string(1) "z"
[3]=>
string(1) "t"
}
8.hGetAll
描述:
返回哈希表key中,所有的域和值。
在返回值里,紧跟每个域名(field name)之后是域的值(value),所以返回值的长度是哈希表大小的两倍。
参数:key
返回值:以列表形式返回哈希表的域和域的值。 若key不存在,返回空列表。
$redis->delete('h');
$redis->hSet('h', 'a', 'x');
$redis->hSet('h', 'b', 'y');
$redis->hSet('h', 'c', 'z');
$redis->hSet('h', 'd', 't');
var_dump($redis->hGetAll('h'));
array(4) {
["a"]=>
string(1) "x"
["b"]=>
string(1) "y"
["c"]=>
string(1) "z"
["d"]=>
string(1) "t"
}
9.hExists
描述:查看哈希表key中,给定域field是否存在。
参数:key field
返回值:如果哈希表含有给定域,返回1。如果哈希表不含有给定域,或key不存在,返回0。
$redis->hSet('h', 'a', 'x');
$redis->hExists('h', 'a'); /* TRUE */
$redis->hExists('h', 'NonExistingKey'); /* FALSE */
10.hIncrBy
描述:
为哈希表key中的域field的值加上增量increment。
增量也可以为负数,相当于对给定域进行减法操作。
如果key不存在,一个新的哈希表被创建并执行HINCRBY命令。
如果域field不存在,那么在执行命令前,域的值被初始化为0。
对一个储存字符串值的域field执行HINCRBY命令将造成一个错误
参数:key field increment
返回值:执行HINCRBY命令之后,哈希表key中域field的值。
$redis->hIncrBy('h', 'x', 2); /* returns 2: h[x] = 2 now. */
$redis->hIncrBy('h', 'x', 1); /* h[x] ← 2 + 1. Returns 3 */
11.hIncrByFloat
根据HASH表的KEY,为KEY对应的VALUE自增参数VALUE。浮点型Parameters
$redis->hIncrByFloat('h','x', 1.5); /* returns 1.5: h[x] = 1.5 now */
$redis->hIncrByFLoat('h', 'x', 1.5); /* returns 3.0: h[x] = 3.0 now */
$redis->hIncrByFloat('h', 'x', -3.0); /* returns 0.0: h[x] = 0.0 now */
12.hMset
描述:
返回哈希表key中的所有值。
同时将多个field - value(域-值)对设置到哈希表key中。
此命令会覆盖哈希表中已存在的域。
如果key不存在,一个空哈希表被创建并执行HMSET操作。
如果命令执行成功,返回OK。
当key不是哈希表(hash)类型时,返回一个错误。
参数:key
返回值:一个包含哈希表中所有值的表。当key不存在时,返回一个空表。
$redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000));
$redis->hIncrBy('user:1', 'salary', 100); // Joe earns 100 more now.
13.hMGet
描述:
返回哈希表key中,一个或多个给定域的值。
如果给定的域不存在于哈希表,那么返回一个nil值。
因为不存在的key被当作一个空哈希表来处理,所以对一个不存在的key进行HMGET操作将返回一个只带有nil值的表。 参数:key field [field …] 返回值:一个包含多个给定域的关联值的表,表值的排列顺序和给定域参数的请求顺序一样。
$redis->hSet('h', 'field1', 'value1');
$redis->hSet('h', 'field2', 'value2');
$redis->hmGet('h', array('field1', 'field2')); /* returns array('field1' => 'value1', 'field2' => 'value2') */
示例:
$redis->delete('test');
$redis->hset('test', 'key1', 'hello');//将哈希表key中的域field的值设为value。
echo $redis->hget('test', 'key1'); //结果:hello//返回哈希表key中给定域field的值。
echo "<br>";
$redis->hSetNx('test', 'key1', 'world');
//将哈希表key中的域field的值设置为value,当且仅当域field不存在。若域field已经存在,该操作无效。
echo $redis->hget('test', 'key1'); //结果:hello
$redis->delete('test');
$redis->hSetNx('test', 'key1', 'world');
echo "<br>";
echo $redis->hget('test', 'key1'); //结果:world
echo "<br>";
echo $redis->hlen('test'); //结果:1 //返回哈希表key中域的数量。
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');
//将哈希表 test 中的域 c 的值设为 z 。
print_r($redis->hkeys('test'));
//结果:Array ( [0] => a [1] => b [2] => c )
//返回哈希表key中的所有域。
print_r($redis->hvals('test'));
//结果:Array ( [0] => x [1] => y [2] => z )
//返回哈希表key中的所有值。
print_r($redis->hgetall('test'));
//结果:Array ( [a] => x [b] => y [c] => z )
//返回哈希表key中,所有的域和值。
var_dump($redis->hExists('test', 'a'));
//结果:bool(true)
//查看哈希表key中,给定域field是否存在。
$redis->delete('test');
echo $redis->hIncrBy('test', 'a', 3); //结果:3
echo $redis->hIncrBy('test', 'a', 1); //结果:4
//为哈希表key中的域field的值加上增量increment。
//增量也可以为负数,相当于对给定域进行减法操作。
//如果key不存在,一个新的哈希表被创建并执行HINCRBY命令。
//如果域field不存在,那么在执行命令前,域的值被初始化为0。
//对一个储存字符串值的域field执行HINCRBY命令将造成一个错误。
//本操作的值限制在64位(bit)有符号数字表示之内。
$redis->delete('test');
var_dump($redis->hmset('test', array('name' => 'tank', 'sex' => "man")));
//结果:bool(true)
//同时将多个field - value(域-值)对设置到哈希表key中。此命令会覆盖哈希表中已存在的域。
print_r($redis->hmget('test', array('name', 'sex')));
//结果:Array ( [name] => tank [sex] => man )
//返回哈希表key中,一个或多个给定域的值.如果给定的域不存在于哈希表,那么返回一个nil值。