redis 在 php 中的應用（Hash篇）

上一篇：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'); 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

下一篇：redis 在 php 中的應用（List篇）