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

Use Case(s)

The XTRIM command in Redis is used to trim the number of elements in a stream to a maximum specified limit. In PHP, this command can be especially useful when managing streams within Redis to ensure they do not grow indefinitely and use up too much memory.

Code Examples

Example 1: Trimming a Stream with Approximate Limiting

$redis = new Redis(); $redis->connect('', 6379); // Trimming the stream to approximately 1000 entries. // It uses '~' for efficient trimming making sure that the operation is performed quickly even if it means going over or under the limit slightly. $redis->xTrim('mystream', 1000, true);

In this example, we connect to Redis and use xTrim to trim the 'mystream' stream to around 1000 entries. The third argument set to true enables approximate trimming.

Example 2: Trimming a Stream without Approximate Limiting

$redis = new Redis(); $redis->connect('', 6379); // Trimming the stream strictly to 1000 entries. // Without using '~', Redis will make sure the stream has exactly or fewer than the maximum specified entries after the operation. $redis->xTrim('mystream', 1000);

Here, the xTrim command trims the 'mystream' to exactly (or fewer than) 1000 entries. Since the approximate flag is not set, Redis may take longer to execute the command, as it ensures the count is exact.

Best Practices

  • When using XTRIM, consider whether you need strict trimming. If approximate trimming is acceptable, use the ~ flag as it can significantly improve command performance.
  • Make sure to handle exceptions when working with Redis commands to prevent unhandled errors from interrupting your application flow.

Common Mistakes

  • Not using approximate trimming when exact entry counts are not required can lead to unnecessary performance overhead.
  • Failing to catch connection issues or command execution errors during interactions with Redis can cause runtime issues in your application.


Q: What version of Redis introduced the XTRIM command?

A: The XTRIM command was introduced in Redis 5.0.

Q: Is it mandatory to use the ~ symbol when trimming streams?

A: No, the ~ symbol is optional and provides a way to perform the trimming operation more efficiently at the cost of precise accuracy.

Was this content helpful?

Start building today

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