redis 在 php 中的应用(Hash篇)
本文为我阅读了 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(哈希)
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' }
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 同时存在才会设置失败。
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)
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 同时存在的时候才可以返回数据
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)
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)
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 ,忽略
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
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
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 , 字符串会出现错误
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 , 字符串会出现错误
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
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