redis 在 php 中的应用（Hash篇）

ybaidukuai

　　上一篇：redis 在 php 中的应用（string篇）
　　本文为我阅读了redis参考手册 之后结合 博友的博客 编写，注意 php_redis 和 redis-cli 的区别（主要是返回值类型和参数用法）
　　Redis hash 是一个string类型的field和value的映射表，hash特别适合用于存储对象。
　　目录：

hash（哈希表）
HSET
HSETNX
HMSET
HGET
HMGET
HGETALL
HDEL
HLEN
HEXISTS
HINCRBY
HINCRBYFLOAT
HKEYS
HVALS
　　HASH（哈希）
　　1、HSET
　　Redis Hset 命令用于为哈希表中的字段赋值 。
　　（1）如果哈希表不存在，一个新的哈希表被创建并进行 HSET 操作。
　　（2）如果字段已经存在于哈希表中，旧值将被覆盖。
　　语法：
　　redis 127.0.0.1:6379> HSET KEY_NAME FIELD VALUE
　　返回值： 如果字段是哈希表中的一个新建字段，并且值设置成功，返回 1 。 如果哈希表中域字段已经存在且旧值已被新值覆盖，返回 0 。
　　可用版本： >= 2.0.0
　　时间复杂度：O(1)
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

// This first case: hash 值不存在　　
$redis -> hSet('myhash','favorite_fruit','cherry');
　　

($redis -> hGet('myhash','favorite_fruit'));    // string 'cherry'　　

　　
// This second case: hash 值存在, 替换
　　
if($redis -> exists('myhash'))
　　
{
　　$redis -> hSet('myhash','favorite_fruit','pineapple');
　　($redis -> hGet('myhash','favorite_fruit'));    // string 'pineapple'
　　
}
　　

　　2、HSETNX
　　Redis Hsetnx 命令用于为哈希表中不存在的的字段赋值 。
　　（1）如果哈希表不存在，一个新的哈希表被创建并进行 HSET 操作。
　　（2）如果字段已经存在于哈希表中，操作无效。
　　（3）如果 key 不存在，一个新哈希表被创建并执行 HSETNX 命令。
　　语法：
　　redis 127.0.0.1:6379> HSETNX KEY_NAME FIELD VALUE
　　返回值：设置成功，返回 1 。 如果给定字段已经存在且没有操作被执行，返回 0 。
　　可用版本： >= 2.0.0
　　时间复杂度：O(1)
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

// This first case: hash 值不存在 ，key 也不存在 ， 设置成功　　
$redis -> hSetNx('myhash','favorite_fruit','cherry');
　　

($redis -> hGet('myhash','favorite_fruit'));    // string 'cherry'　　

　　
// This second case: hash 值不存在, key 存在 ，设置成功
　　
if(! $redis -> exists('test_hash')) {
　　($redis->hSetNx('test_hash', 'favorite_fruit', 'apple'));  // boolean true
　　($redis->hGet('test_hash', 'favorite_fruit'));    // string 'apple'
　　
}
　　

　　
// This third case: hash 值存在, key 不存在 ，设置成功
　　
if($redis -> exists('myhash'))
　　
{
　　($redis -> hSetNx('myhash','job','programmer'));  // boolean true
　　($redis -> hGet('myhash','job'));    // string 'programmer'
　　
}
　　

　　
// This fourth case: hash 值存在, key 也存在 ，设置不成功
　　
if($redis -> exists('myhash'))
　　
{
　　($redis -> hSetNx('myhash','favorite_fruit','pineapple'));  // boolean false
　　($redis -> hGet('myhash','favorite_fruit'));    // string 'cherry'
　　
}
　　
//总之：只要 hash 不存在就可以设置成功，只有 hash 和 key 同时存在才会设置失败。
　　

　　3、HMSET
　　Redis Hmset 命令用于同时将多个 field-value (字段-值)对设置到哈希表中。（此命令会覆盖哈希表中已存在的字段）。
　　（1）如果哈希表不存在，会创建一个空哈希表，并执行 HMSET 操作。
　　语法：
　　redis 127.0.0.1:6379> HMSET KEY_NAME FIELD1 VALUE1 ...FIELDN VALUEN
　　返回值：如果命令执行成功，返回 OK 。
　　可用版本： >= 2.0.0
　　时间复杂度：O(N)，N为field - value对的数量。
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

// This first case: hash 表不存在 ,设置成功　　
$array_hmset = array(
'pats' => 'dog',　　'fruit' => 'cherry',
　　'job' => 'programmer'
　　
);
　　
$redis -> hMset('myhash',$array_hmset);
　　
$array_hmget = array('pats','fruit','job');
　　
($redis -> hMget('myhash',$array_hmget));
　　
//  array (size=3)
　　
//      'pats' => string 'dog' (length=3)
　　
//      'fruit' => string 'cherry' (length=6)
　　
//      'job' => string 'programmer' (length=10)
　　

　　
// This second case: hash 表已存在, hash 表被覆盖
　　
if($redis -> exists('myhash')) {
　　$array_hmset_date = array(
　　'year' => 2017,
　　'month' => 5,
　　'day' => 11
　　);
　　$redis -> hMset('myhash',$array_hmset_date);
　　$array_hmset_date = array('year','month','day');
　　($redis -> hMget('myhash',$array_hmset_date));
　　
}
　　
//  array (size=3)
　　
//      'year' => string '2017' (length=4)
　　
//      'month' => string '5' (length=1)
　　
//      'day' => string '11' (length=2)
　　

　　4、HGET
　　Redis Hget 命令用于返回哈希表中指定字段的值。
　　语法：
　　redis 127.0.0.1:6379> HGET KEY_NAME FIELD_NAME
　　返回值：返回给定字段的值。如果给定的字段或 key 不存在时，返回 nil 。
　　可用版本： >= 2.0.0
　　时间复杂度：O(N)，N为给定域的数量。
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

// This first case: hash 表存在 , key 也存在，获取数据成功　　
$redis -> hSet('myhash','job','programmer');
　　

($redis -> hGet('myhash','job'));       // programmer　　

　　
// This second case: hash表存在, key 不存在
　　
($redis -> hGet('myhash','pats'));      // boolean false
　　

　　
// This third case: hash 表不存在
　　
($redis -> hGet('hash_not_exists','job'));      // boolean false
　　
// 总之 ：只有 hash 表和 key 同时存在的时候才可以返回数据
　　

　　5、HMGET
　　Redis Hmget 命令用于返回哈希表中，一个或多个给定字段的值。如果指定的字段不存在于哈希表，那么返回一个 nil 值。
　　语法：
　　redis 127.0.0.1:6379> HMGET KEY_NAME FIELD1...FIELDN
　　返回值：一个包含多个给定字段关联值的表，表值的排列顺序和指定字段的请求顺序一样。
　　可用版本： >= 2.0.0
　　时间复杂度：O(N)，N为给定域的数量。
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$array_hmset = array('pats' => 'dog',　　'fruit' => 'cherry',
　　'job' => 'programmer'
　　
);
　　

$redis -> hMset('myhash',$array_hmset);　　

$array_hmget = array('pats','job');　　

($redis -> hMGet('myhash',$array_hmget));　　

//  array (size=2)　　
//      'pats' => string 'dog' (length=3)
　　
//      'job' => string 'programmer' (length=10)
　　

　　6、HGETALL
　　Redis Hgetall 命令用于返回哈希表中，所有的字段和值。(在返回值里，紧跟每个字段名(field name)之后是字段的值(value)，所以返回值的长度是哈希表大小的两倍)。
　　语法：
　　redis 127.0.0.1:6379> HGETALL KEY_NAME
　　返回值：以列表形式返回哈希表的字段及字段值。 若 key 不存在，返回空列表。
　　可用版本： >= 2.0.0
　　时间复杂度：O(N)，N为哈希表的大小。
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

// This first case: hash表 不存在 ,设置成功　　
$array_hmset = array(
'pats' => 'dog',　　'fruit' => 'cherry',
　　'job' => 'programmer'
　　
);
　　
$redis -> hMset('myhash',$array_hmset);
　　
($redis -> hGetAll('myhash'));
　　
//  array (size=3)
　　
//      'pats' => string 'dog' (length=3)
　　
//      'fruit' => string 'cherry' (length=6)
　　
//      'job' => string 'programmer' (length=10)
　　

　　7、HDEL
　　Redis Hdel 命令用于删除哈希表 key 中的一个或多个指定字段，不存在的字段将被忽略。
　　语法：
　　redis 127.0.0.1:6379> HDEL KEY_NAME FIELD1.. FIELDN
　　返回值：被成功删除字段的数量，不包括被忽略的字段。
　　可用版本： >= 2.0.0
　　时间复杂度：O(N)，N为要删除的域的数量。
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$redis -> hSet('myhash','job','programmer');　　

($redis -> del('myhash','job'));            // int 1 成功删除　　
($redis -> del('myhash','not_exists'));     // int 0 删除一个不存在的 key ，忽略
　　

　　8、HLEN
　　Redis Hlen 命令用于获取哈希表中字段的数量。
　　语法：
　　

redis 127.0.0.1:6379> HLEN KEY_NAME 　　

　　返回值：哈希表中字段的数量。 当 key 不存在时，返回 0 。
　　可用版本： >= 2.0.0
　　时间复杂度：O(1)
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$array_hmset = array('pats' => 'dog',　　'fruit' => 'cherry',
　　'job' => 'programmer'
　　
);
　　

$redis -> hMset('myhash',$array_hmset);　　

($redis -> hLen('myhash'));            // int 3　　
($redis -> hLen('hash_not_exists'));   // int 0 , 不存在的 hash 表返回 0
　　

　　9、HEXISTS
　　Redis Hexists 命令用于查看哈希表的指定字段是否存在。
　　语法：
　　redis 127.0.0.1:6379> HEXISTS KEY_NAME FIELD_NAME
　　返回值：如果哈希表含有给定字段，返回 1 。 如果哈希表不含有给定字段，或 key 不存在，返回 0
　　可用版本： >= 2.0.0
　　时间复杂度：O(1)
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$array_hmset = array('pats' => 'dog',　　'fruit' => 'cherry',
　　'job' => 'programmer'
　　
);
　　

$redis -> hMset('myhash',$array_hmset);　　

($redis -> hExists('myhash','fruit'));      // true　　
($redis -> hExists('myhash','fake_key'));   // false , key 不存在返回 false
　　

　　10、HINCRBY
　　Redis Hincrby 命令用于为哈希表中的字段值加上指定增量值。增量也可以为负数，相当于对指定字段进行减法操作。
　　（1）如果哈希表的 key 不存在，一个新的哈希表被创建并执行 HINCRBY 命令。
　　（2）如果指定的字段不存在，那么在执行命令前，字段的值被初始化为 0 。
　　（3）对一个储存字符串值的字段执行 HINCRBY 命令将造成一个错误。
　　（4）本操作的值被限制在 64 位(bit)有符号数字表示之内。
　　语法：
　　redis 127.0.0.1:6379> HINCRBY KEY_NAME FIELD_NAME INCR_BY_NUMBER
　　返回值：执行 HINCRBY 命令之后，哈希表中字段的值。
　　可用版本： >= 2.0.0
　　时间复杂度：O(1)
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$array_hmset = array('number' => 10,　　'fruit' => 'cherry'
　　
);
　　

$redis -> hMset('myhash',$array_hmset);　　

($redis -> hIncrBy('myhash','number',5));           // int 15，   正数相当于增　　
($redis -> hIncrBy('myhash','number',-5));          // int 5，    负数相当于减
　　
($redis -> hIncrBy('myhash','number_not_exist',2)); // int 2，    不存在的 key 初始化为 0
　　
($redis -> hIncrBy('myhash','fruit',5));            // boolean false ， 字符串会出现错误
　　

　　11、HINCRBYFLOAT
　　Redis Hincrbyfloat 命令用于为哈希表中的字段值加上指定浮点数增量值。如果指定的字段不存在，那么在执行命令前，字段的值被初始化为 0 。
　　语法：
　　redis 127.0.0.1:6379> HINCRBYFLOAT KEY_NAME FIELD_NAME INCR_BY_NUMBER
　　返回值：执行 Hincrbyfloat 命令之后，哈希表中字段的值。
　　可用版本： >= 2.6.0
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$array_hmset = array('number' => 10.2,　　'fruit' => 'cherry'
　　
);
　　

$redis -> hMset('myhash',$array_hmset);　　

($redis -> hIncrByFloat('myhash','number',0.3));           // int 10.5，   正数相当于增　　
($redis -> hIncrByFloat('myhash','number',-0.3));          // int 10.2，   hIncrByFloat 不能用于负数
　　
($redis -> hIncrByFloat('myhash','number_not_exist',0.3)); // int 0.3，    不存在的 key 初始化为 0
　　
($redis -> hIncrByFloat('myhash','fruit',0.3));            // boolean false ， 字符串会出现错误
　　

　　12、HKEYS
　　Redis Hkeys 命令用于获取哈希表中的所有字段名。
　　语法：
　　redis 127.0.0.1:6379> HKEYS KEY_NAME FIELD_NAME INCR_BY_NUMBER
　　返回值：包含哈希表中所有字段的列表。 当 key 不存在时，返回一个空列表。
　　可用版本： >= 2.0.0
　　时间复杂度：O(N)，N为哈希表的大小。
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$array_hmset = array('number' => 10,　　'fruit' => 'cherry',
　　'pats' => 'dog'
　　
);
　　

$redis -> hMset('myhash',$array_hmset);　　

($redis -> hKeys('myhash'));　　

//  array (size=3)　　
//      0 => string 'number' (length=6)
　　
//      1 => string 'fruit' (length=5)
　　
//      2 => string 'pats' (length=4)
　　

　　
($redis -> hKeys('hash_not_exists'));   //array (size=0) empty
　　

　　13、HVALS
　　Redis Hvals 命令返回哈希表所有字段的值。
　　语法：
　　redis 127.0.0.1:6379> HVALS KEY_NAME FIELD VALUE
　　返回值：一个包含哈希表中所有值的表。 当 key 不存在时，返回一个空表。
　　可用版本： >= 2.0.0
　　时间复杂度：O(N)，N为哈希表的大小。
　　具体实例：
　　

<?php　　

$redis = new redis();　　

$redis -> connect('127.0.0.1',6379);　　

$redis -> flushAll();　　

　　

$array_hmset = array('number' => 10,　　'fruit' => 'cherry',
　　'pats' => 'dog'
　　
);
　　

$redis -> hMset('myhash',$array_hmset);　　

($redis -> hVals('myhash'));　　

//  array (size=3)　　
//      0 => string '10' (length=2)
　　
//      1 => string 'cherry' (length=6)
　　
//      2 => string 'dog' (length=3)
　　

　　
($redis -> hVals('hash_not_exists'));   //array (size=0) empty
　　

　　如有转载，请注明出处：http://www.cnblogs.com/chrdai/p/6840000.html
　　下一篇：redis 在 php 中的应用（List篇）