Redis-PHP-Hash 表相关API

Hashes 相关

================================

hDel - 删除一个哈希 key

hExists - 检查哈希 key是否存在

hGet - 获得某哈希 key 的值

hGetAll - 获得一个哈希表中所有的 key 和 value

hIncrBy - 给哈希表中某 key 增加一个整数值

hIncrByFloat - 给哈希表中某 key 增加一个浮点数值

hKeys - 获得哈希表中所有的 key

hLen - 哈表中 key 的数量

hMGet - 获得哈希表中多个 key 的值

hMSet - 给哈希表设置多个 key 的值

hSet - 给哈希表中某个 key 设置值

hSetNx - 当哈希表中不存在某 key 时，给该 key 设置一个值

hVals - 获得哈希表中所有的值

 

hSet

-----------------------------------

给哈希表中某个 key 设置值.如果值已经存在, 返回 false

 

参数:

key 哈希表名

hashKey

value

 

返回值:

LONG 如果成功设置,返回 1, 如果 key 已经存在，会替换成新值，且返回 0。失败返回 0

 

示例:

$redis->delete('h')

$redis->hSet('h', 'key1', 'hello');

$redis->hGet('h', 'key1');

 

$redis->hSet('h', 'key1', 'plop');

$redis->hGet('h', 'key1');

 

hSetNx

-----------------------------------

当哈希表中不存在某 key 时，给该 key 设置一个值

 

参数:

key 哈希表名

hashKey

value

 

返回值:

BOOL: 成功返回 TRUE. 失败返回 FALSE.

 

示例:

$redis->delete('h')

$redis->hSetNx('h', 'key1', 'hello');

$redis->hSetNx('h', 'key1', 'world');

 

hGet

-----------------------------------

获得某哈希 key 的值.如果 hash 表不存在或对应的 key 不存在，返回 false

 

参数:

key

hashKey

 

返回值:

STRING ,如果 hash 表不存在或对应的 key 不存在，返回 false

 

示例:

$redis->delete('h')

$redis->hSet('h', 'key1', 'hello');

$redis->hGet('h', 'key1');

 

hLen

-----------------------------------

哈表中 key 的数量

 

参数:

key

 

返回值:

LONG 哈表中 key 的数量.如果 hash 表不存在，或者对应的 key 的值不是 hash 类型，返回 false

 

示例:

$redis->delete('h')

$redis->hSet('h', 'key1', 'hello');

$redis->hSet('h', 'key2', 'plop');

$redis->hLen('h');

 

hDel

-----------------------------------

删除一个哈希 key.如果 hash 表不存在或对应的 key 不存在，返回 false

 

参数:

key

hashKey

 

返回值:

BOOL: 成功返回 TRUE. 失败返回 FALSE.

 

示例:

$redis->delete('h')

$redis->hSet('h', 'key1', 'hello');

$redis->hSet('h', 'key2', 'plop');

$redis->hSet('h', 'key2');

 

hKeys

-----------------------------------

获得哈希表中所有的 key

 

参数:

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->hKeys('h'));

 

输出:

array(4) {

  [0]=>

  string(1) "a"

  [1]=>

  string(1) "b"

  [2]=>

  string(1) "c"

  [3]=>

  string(1) "d"

}

顺序是随机的

 

hVals

-----------------------------------

获得哈希表中所有的值

 

参数:

参数:

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->hVals('h'));

 

输出:

array(4) {

  [0]=>

  string(1) "x"

  [1]=>

  string(1) "y"

  [2]=>

  string(1) "z"

  [3]=>

  string(1) "t"

}

顺序是随机的

 

hGetAll

-----------------------------------

获得一个哈希表中所有的 key 和 value

 

示例:

$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"

}

顺序是随机的

 

hExists

-----------------------------------

检查哈希 key是否存在

 

参数:

key

memberKey

 

返回值:

BOOL: 存在返回 true, 不存在返回 false

 

示例:

$redis->hSet('h', 'a', 'x');

$redis->hExists('h', 'a');

$redis->hExists('h', 'NonExistingKey');

 

hIncrBy

-----------------------------------

给哈希表中某 key 增加一个整数值

 

参数:

key

member

value: (integer) 要增加的整数值

 

返回值:

LONG 增加后的值

 

示例:

$redis->delete('h');

$redis->hIncrBy('h', 'x', 2);

$redis->hIncrBy('h', 'x', 1);

 

hIncrByFloat

-----------------------------------

给哈希表中某 key 增加一个浮点数值

 

参数:

key

member

value: (float) 要增加的浮点数值

 

返回值:

FLOAT 增加后的值

 

示例:

$redis->delete('h');

$redis->hIncrByFloat('h','x', 1.5);

$redis->hIncrByFLoat('h', 'x', 1.5);

$redis->hIncrByFloat('h', 'x', -3.0);

 

hMSet

-----------------------------------

给哈希表设置多个 key 的值

 

参数:

key

members: key → value array

 

返回值:

BOOL

 

示例:

$redis->delete('user:1');

$redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000));

 

 

hMGet

-----------------------------------

获得哈希表中多个 key 的值

 

示例:

$redis->delete('h');

$redis->hSet('h', 'field1', 'value1');

$redis->hSet('h', 'field2', 'value2');

$redis->hmGet('h', array('field1', 'field2'));