redis 在 php 中的应用（Hash篇）

本文为我阅读了 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');
var_dump($redis -> hGet('myhash','favorite_fruit'));    // string 'cherry'

// This second case: hash 值存在, 替换
if($redis -> exists('myhash'))
{
    $redis -> hSet('myhash','favorite_fruit','pineapple');
    var_dump($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');
var_dump($redis -> hGet('myhash','favorite_fruit'));    // string 'cherry'

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

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

// This fourth case: hash 值存在, key 也存在 ，设置不成功
if($redis -> exists('myhash'))
{
    var_dump($redis -> hSetNx('myhash','favorite_fruit','pineapple'));  // boolean false
    var_dump($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');
var_dump($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');
    var_dump($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');
var_dump($redis -> hGet('myhash','job'));       // programmer

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

// This third case: hash 表不存在
var_dump($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');
var_dump($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);
var_dump($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');
var_dump($redis -> del('myhash','job'));            // int 1 成功删除
var_dump($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);
var_dump($redis -> hLen('myhash'));            // int 3
var_dump($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);
var_dump($redis -> hExists('myhash','fruit'));      // true
var_dump($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);
var_dump($redis -> hIncrBy('myhash','number',5));           // int 15，   正数相当于增
var_dump($redis -> hIncrBy('myhash','number',-5));          // int 5，    负数相当于减
var_dump($redis -> hIncrBy('myhash','number_not_exist',2)); // int 2，    不存在的 key 初始化为 0
var_dump($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);
var_dump($redis -> hIncrByFloat('myhash','number',0.3));           // int 10.5，   正数相当于增
var_dump($redis -> hIncrByFloat('myhash','number',-0.3));          // int 10.2，   hIncrByFloat 不能用于负数
var_dump($redis -> hIncrByFloat('myhash','number_not_exist',0.3)); // int 0.3，    不存在的 key 初始化为 0
var_dump($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);
var_dump($redis -> hKeys('myhash'));
//  array (size=3)
//      0 => string 'number' (length=6)
//      1 => string 'fruit' (length=5)
//      2 => string 'pats' (length=4)

var_dump($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);
var_dump($redis -> hVals('myhash'));
//  array (size=3)
//      0 => string '10' (length=2)
//      1 => string 'cherry' (length=6)
//      2 => string 'dog' (length=3)

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

如有转载，请注明出处：http://www.cnblogs.com/chrdai/p/6840000.html

posted @ 2019-04-26 19:48 dreamboycx 阅读(1966) 评论(0) 编辑收藏举报

刷新页面返回顶部

dreamboycx

经验不是年限而是积累。。。。

redis 在 php 中的应用（Hash篇）

公告