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

Use Case(s)

The HVALS command in Redis is often used when you need to retrieve all the values associated with a specific hash key. This can be particularly useful in situations where you have stored data in a hash structure, and you want to quickly extract all the values without knowing their specific field names.

Code Examples

You need the Predis library to work with Redis in PHP. You can install it via composer: composer require predis/predis.

Here's an example of how you might use the HVALS command in PHP using the Predis client:

<?php require 'vendor/autoload.php'; $client = new Predis\Client(); // Add some data to a hash $client->hmset('hash', [ 'field1' => 'value1', 'field2' => 'value2', 'field3' => 'value3', ]); // Get all values from the hash $values = $client->hvals('hash'); print_r($values); ?>

In this script, we first add three fields to a hash named 'hash'. We then use the hvals function to retrieve all the values from the hash. The result would be an array containing the values ['value1', 'value2', 'value3'].

Best Practices

  • While HVALS provides a quick way to get all values in a hash, be aware that it doesn't return any associated keys. If you need both keys and values, consider using the HGETALL command instead.
  • Be cautious when using HVALS on large hashes. As it returns all values in the hash, it could consume significant memory or network bandwidth.

Common Mistakes

  • One common mistake is to confuse HVALS with HKEYS. HVALS returns all the values of a hash, whereas HKEYS returns all the keys.
  • A misuse of HVALS could be attempting to use it on non-hash types. Remember that HVALS can only be used with hashes.


Q: Can I use HVALS on a key that is not a hash? A: No, HVALS only works on hash keys. If you try to use it on a key associated with another data type, Redis will return an error.

Q: Does HVALS maintain the order of the values? A: Yes, HVALS retrieves values in the order they were added to the hash.

Was this content helpful?

Start building today

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