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->del('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值。