Redis HKEYS in PHP (Detailed Guide w/ Code Examples)

Use Case(s)

The HKEYS command in Redis is commonly used to retrieve all the keys of a hash stored at a specified key. This is particularly useful in situations when you need to iterate over all the keys in a hash, for example for debugging, administrative tasks, or any time you need to observe data structures.

Code Examples

Here's an example of using the hKeys method in the PHP Redis extension. This code retrieves all keys from a hash:

$redis = new Redis(); $redis->connect('', 6379); // Adding values to a Redis hash $hashKey = "user:1"; $redis->hSet($hashKey, 'name', 'John'); $redis->hSet($hashKey, 'age', '25'); // Retrieving all keys from the hash $keys = $redis->hKeys($hashKey); print_r($keys);

In this example, we first connect to the Redis server, then set up a hash with two fields ('name' and 'age') using hSet. We then call hKeys on the hash to get an array of its keys. The output should be something like:

Array ( [0] => name [1] => age )

Best Practices

  • While using HKEYS, remember that it may block your redis instance for a while if the hash contains many keys because it's a blocking command. In these cases, consider whether iterating over the hash incrementally with HSCAN would better suit your needs.

Common Mistakes

  • One common mistake is not checking if the redis key actually holds a hash before invoking HKEYS. If it's not a hash, Redis will return an error. Always ensure the type of data stored in a key before making operations specific to a certain data type.


1. What does HKEYS do in Redis?

HKEYS retrieves all the field names (keys) in a hash stored at a specified key in Redis.

2. What if HKEYS is used on a large hash in Redis?

HKEYS can block your server for some time if used on a large hash because it fetches all keys in one go. If your hash contains numerous keys and you are concerned about performance issues, consider using HSCAN instead.

Was this content helpful?

Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.