redis 在 php 中的应用(Hash篇)
本文為我閱讀了redis參考手冊之后結合博友的博客編寫,注意 php_redis 和 redis-cli 的區(qū)別(主要是返回值類型和參數(shù)用法)
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)如果哈希表不存在,一個新的哈希表被創(chuàng)建并進行 HSET 操作。
(2)如果字段已經(jīng)存在于哈希表中,舊值將被覆蓋。
語法:
redis 127.0.0.1:6379>HSETKEY_NAME FIELD VALUE
返回值:如果字段是哈希表中的一個新建字段,并且值設置成功,返回 1 。 如果哈希表中域字段已經(jīng)存在且舊值已被新值覆蓋,返回 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)如果哈希表不存在,一個新的哈希表被創(chuàng)建并進行 HSET 操作。
(2)如果字段已經(jīng)存在于哈希表中,操作無效。
(3)如果 key 不存在,一個新哈希表被創(chuàng)建并執(zhí)行 HSETNX 命令。
語法:
redis 127.0.0.1:6379>HSETNXKEY_NAME FIELD VALUE
返回值:設置成功,返回 1 。 如果給定字段已經(jīng)存在且沒有操作被執(zhí)行,返回 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)如果哈希表不存在,會創(chuàng)建一個空哈希表,并執(zhí)行 HMSET 操作。
語法:
redis 127.0.0.1:6379>HMSETKEY_NAME FIELD1 VALUE1 ...FIELDN VALUEN
返回值:如果命令執(zhí)行成功,返回 OK 。
可用版本:>= 2.0.0
時間復雜度:O(N),N為field-value對的數(shù)量。
具體實例:
<?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>HGETKEY_NAME FIELD_NAME
返回值:返回給定字段的值。如果給定的字段或 key 不存在時,返回 nil 。
可用版本:>= 2.0.0
時間復雜度:O(N),N為給定域的數(shù)量。
具體實例:
<?php
$redis = new redis();
$redis -> connect('127.0.0.1',6379);
$redis -> flushAll();
// This first case: hash 表存在 , key 也存在,獲取數(shù)據(jù)成功
$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 同時存在的時候才可以返回數(shù)據(jù)
5、HMGET
Redis Hmget 命令用于返回哈希表中,一個或多個給定字段的值。如果指定的字段不存在于哈希表,那么返回一個 nil 值。
語法:
redis 127.0.0.1:6379>HMGETKEY_NAME FIELD1...FIELDN
返回值:一個包含多個給定字段關聯(lián)值的表,表值的排列順序和指定字段的請求順序一樣。
可用版本:>= 2.0.0
時間復雜度:O(N),N為給定域的數(shù)量。
具體實例:
<?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>HGETALLKEY_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>HDELKEY_NAME FIELD1.. FIELDN
返回值:被成功刪除字段的數(shù)量,不包括被忽略的字段。
可用版本:>= 2.0.0
時間復雜度:O(N),N為要刪除的域的數(shù)量。
具體實例:
<?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 命令用于獲取哈希表中字段的數(shù)量。
語法:
redis 127.0.0.1:6379> HLEN KEY_NAME
返回值:哈希表中字段的數(shù)量。 當 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>HEXISTSKEY_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 命令用于為哈希表中的字段值加上指定增量值。增量也可以為負數(shù),相當于對指定字段進行減法操作。
(1)如果哈希表的 key 不存在,一個新的哈希表被創(chuàng)建并執(zhí)行 HINCRBY 命令。
(2)如果指定的字段不存在,那么在執(zhí)行命令前,字段的值被初始化為 0 。
(3)對一個儲存字符串值的字段執(zhí)行 HINCRBY 命令將造成一個錯誤。
(4)本操作的值被限制在 64 位(bit)有符號數(shù)字表示之內。
語法:
redis 127.0.0.1:6379>HINCRBYKEY_NAME FIELD_NAME INCR_BY_NUMBER
返回值:執(zhí)行 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, 正數(shù)相當于增
var_dump($redis -> hIncrBy('myhash','number',-5)); // int 5, 負數(shù)相當于減
var_dump($redis -> hIncrBy('myhash','number_not_exist',2)); // int 2, 不存在的 key 初始化為 0
var_dump($redis -> hIncrBy('myhash','fruit',5)); // boolean false , 字符串會出現(xiàn)錯誤
11、HINCRBYFLOAT
Redis Hincrbyfloat 命令用于為哈希表中的字段值加上指定浮點數(shù)增量值。如果指定的字段不存在,那么在執(zhí)行命令前,字段的值被初始化為 0 。
語法:
redis 127.0.0.1:6379>HINCRBYFLOATKEY_NAME FIELD_NAME INCR_BY_NUMBER
返回值:執(zhí)行 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, 正數(shù)相當于增
var_dump($redis -> hIncrByFloat('myhash','number',-0.3)); // int 10.2, hIncrByFloat 不能用于負數(shù)
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 , 字符串會出現(xiàn)錯誤
12、HKEYS
Redis Hkeys 命令用于獲取哈希表中的所有字段名。
語法:
redis 127.0.0.1:6379>HKEYSKEY_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>HVALSKEY_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 中的应用(Hash篇)的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: strconv:各种数据类型和字符串之间
- 下一篇: 从整数裂项说开去