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不存在，一個新的哈希表被創(chuàng)建并進行HSET操作。

? 如果域field已經(jīng)存在于哈希表中，舊值將被覆蓋。

參數(shù)：key field value

返回值：

? 如果field是哈希表中的一個新建域，并且值設置成功，返回1。

? 如果哈希表中域field已經(jīng)存在且舊值已被新值覆蓋，返回0。

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

2.hSetNx

描述：

? 將哈希表key中的域field的值設置為value，當且僅當域field不存在。

? 若域field已經(jīng)存在，該操作無效。如果key不存在，一個新哈希表被創(chuàng)建并執(zhí)行HSETNX命令。

參數(shù)：key field value

返回值：

? 設置成功，返回1。如果給定域已經(jīng)存在且沒有操作被執(zhí)行，返回0。

? 如果key不存在，一個新的哈希表被創(chuàng)建并進行HSET操作。成功返回1

? 如果域field已經(jīng)存在于哈希表中，舊值將被覆蓋。成功返回0

? 將哈希表key中的域field的值設置為value，當且僅當域field不存在。設置成功返回1

? 若域field已經(jīng)存在，該操作無效。返回0

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

3.hGet

描述：給定域的值。

參數(shù)：key

返回值：當給定域不存在或是給定key不存在時，返回nil。

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

4.hLen

描述：返回哈希表key中域的數(shù)量。

參數(shù)：key

返回值：哈希表中域的數(shù)量。當key不存在時，返回0。

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

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

$redis->hLen('h'); /* returns 2 */

5.hDel

描述：刪除哈希表key中的一個或多個指定域，不存在的域?qū)⒈缓雎浴?/p>

參數(shù)：key field [field ...]

返回值：被成功移除的域的數(shù)量，不包括被忽略的域。

$redis->delete('h')

6.hKeys

描述:

? 返回哈希表key中的所有域

? 一個包含哈希表中所有域的表。

? 當key不存在時，返回一個空表。

參數(shù)：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)，所以返回值的長度是哈希表大小的兩倍。

參數(shù)：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是否存在。

參數(shù)：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。

? 增量也可以為負數(shù)，相當于對給定域進行減法操作。

? 如果key不存在，一個新的哈希表被創(chuàng)建并執(zhí)行HINCRBY命令。

? 如果域field不存在，那么在執(zhí)行命令前，域的值被初始化為0。

? 對一個儲存字符串值的域field執(zhí)行HINCRBY命令將造成一個錯誤

參數(shù)：key field increment

返回值：執(zhí)行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

根據(jù)HASH表的KEY，為KEY對應的VALUE自增參數(shù)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不存在，一個空哈希表被創(chuàng)建并執(zhí)行HMSET操作。

? 如果命令執(zhí)行成功，返回OK。

? 當key不是哈希表(hash)類型時，返回一個錯誤。

參數(shù)：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值的表。
參數(shù)：key field [field ...]
返回值：一個包含多個給定域的關聯(lián)值的表，表值的排列順序和給定域參數(shù)的請求順序一樣。

$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已經(jīng)存在，該操作無效。
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中域的數(shù)量。
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。
//增量也可以為負數(shù)，相當于對給定域進行減法操作。
//如果key不存在，一個新的哈希表被創(chuàng)建并執(zhí)行HINCRBY命令。
//如果域field不存在，那么在執(zhí)行命令前，域的值被初始化為0。
//對一個儲存字符串值的域field執(zhí)行HINCRBY命令將造成一個錯誤。
//本操作的值限制在64位(bit)有符號數(shù)字表示之內(nèi)。

$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值。