hSet
Description
Adds a value to the hash stored at key. If this value is already in the hash, FALSE is returned.
添加一个VALUE到HASH中。如果VALUE已经存在于HASH中,则返回FALSE。
Parameterskey
hashKey
value
LONG 1 if value didn't exist and was added successfully, 0 if the value was already present and was replaced, FALSE if there was an error.
Example$redis->delete('h') $redis->hSet('h', 'key1', 'hello'); /* 1, 'key1' => 'hello' in the hash at "h" */ $redis->hGet('h', 'key1'); /* returns "hello" */$redis->hSet('h', 'key1', 'plop'); /* 0, value was replaced. /
$redis->hGet('h', 'key1'); / returns "plop" */
hSetNx
Description
Adds a value to the hash stored at key only if this field isn't already in the hash.
添加一个VALUE到HASH STORE中,如果FIELD不存在。
Return valueBOOL TRUE if the field was set, FALSE if it was already present.
Example$redis->delete('h') $redis->hSetNx('h', 'key1', 'hello'); /* TRUE, 'key1' => 'hello' in the hash at "h" */ $redis->hSetNx('h', 'key1', 'world'); /* FALSE, 'key1' => 'hello' in the hash at "h". No change since the field wasn't replaced. */
hGet
Description
Gets a value from the hash stored at key. If the hash table doesn't exist, or the key doesn't exist, FALSE is returned.
取得HASH中的VALUE,如何HASH不存在,或者KEY不存在返回FLASE。
Parameterskey
hashKey
STRING The value, if the command executed successfully BOOL FALSE in case of failure
hLen
Description
Returns the length of a hash, in number of items
取得HASH表的长度。
Parameterskey
Return valueLONG the number of items in a hash, FALSE if the key doesn't exist or isn't a hash.
Example$redis->delete('h') $redis->hSet('h', 'key1', 'hello'); $redis->hSet('h', 'key2', 'plop'); $redis->hLen('h'); /* returns 2 */
hDel
Description
Removes a value from the hash stored at key. If the hash table doesn't exist, or the key doesn't exist, FALSE is returned.
删除指定的元素。
Parameterskey
hashKey
BOOL TRUE in case of success, FALSE in case of failure
hKeys
Description
Returns the keys in a hash, as an array of strings.
取得HASH表中的KEYS,以数组形式返回。
ParametersKey: key
Return valueAn array of elements, the keys of the hash. This works like php's array_keys().
Example$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->hKeys('h'));
Output:
array(4) { [0]=> string(1) "a" [1]=> string(1) "b" [2]=> string(1) "c" [3]=> string(1) "d" }
The order is random and corresponds to redis' own internal representation of the set structure.
hVals
Description
Returns the values in a hash, as an array of strings.
取得HASH表中所有的VALUE,以数组形式返回。
ParametersKey: key
Return valueAn array of elements, the values of the hash. This works like php's array_values().
Example$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->hVals('h'));
Output:
array(4) { [0]=> string(1) "x" [1]=> string(1) "y" [2]=> string(1) "z" [3]=> string(1) "t" }
The order is random and corresponds to redis' own internal representation of the set structure.
hGetAll
Description
Returns the whole hash, as an array of strings indexed by strings.
取得整个HASH表的信息,返回一个以KEY为索引VALUE为内容的数组。
ParametersKey: key
Return valueAn array of elements, the contents of the hash.
Example$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'));
Output:
array(4) { ["a"]=> string(1) "x" ["b"]=> string(1) "y" ["c"]=> string(1) "z" ["d"]=> string(1) "t" }
The order is random and corresponds to redis' own internal representation of the set structure.
hExists
Description
Verify if the specified member exists in a key.
验证HASH表中是否存在指定的KEY-VALUE
Parameterskey
memberKey
BOOL: If the member exists in the hash table, return TRUE, otherwise return FALSE.
Examples$redis->hSet('h', 'a', 'x'); $redis->hExists('h', 'a'); /* TRUE */ $redis->hExists('h', 'NonExistingKey'); /* FALSE */
hIncrBy
Description
Increments the value of a member from a hash by a given amount.
根据HASH表的KEY,为KEY对应的VALUE自增参数VALUE。
Parameterskey
member
value: (integer) value that will be added to the member's value
LONG the new value
Examples$redis->delete('h'); $redis->hIncrBy('h', 'x', 2); /* returns 2: h[x] = 2 now. */ $redis->hIncrBy('h', 'x', 1); /* h[x] ← 2 + 1. Returns 3 */
hIncrByFloat
Description
Increments the value of a hash member by the provided float value
根据HASH表的KEY,为KEY对应的VALUE自增参数VALUE。浮点型 Parameterskey
member
value: (float) value that will be added to the member's value
FLOAT the new value
Examples$redis->delete('h'); $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 */
hMset
Description
Fills in a whole hash. Non-string values are converted to string, using the standard (string) cast. NULL values are stored as empty strings.
批量填充HASH表。不是字符串类型的VALUE,自动转换成字符串类型。使用标准的值。NULL值将被储存为一个空的字符串。
Parameterskey
members: key → value array
BOOL
Examples$redis->delete('user:1'); $redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000)); $redis->hIncrBy('user:1', 'salary', 100); // Joe earns 100 more now.
hMGet
Description
Retrieve the values associated to the specified fields in the hash.
批量取得HASH表中的VALUE。
Parameterskey
memberKeys Array
Array An array of elements, the values of the specified fields in the hash, with the hash keys as array keys.
Examples$redis->delete('h'); $redis->hSet('h', 'field1', 'value1'); $redis->hSet('h', 'field2', 'value2'); $redis->hmGet('h', array('field1', 'field2')); /* returns array('field1' => 'value1', 'field2' => 'value2') */