当使用 `phpredis` 的 `hscan` 命令时，如果遇到返回空结果而 `redis-cli` 却能正常工作的情况，这通常是由于 redis 数据库选择不当造成的。本教程将深入分析 `hscan` 在 php 中可能返回空结果的原因，并提供核心解决方案——在执行 `hscan` 命令前，明确选择正确的 redis 数据库，确保数据能够被成功检索。
理解 Redis 数据库与 `hscan` 命令
Redis 是一个高性能的键值存储系统，它支持多个逻辑数据库，默认情况下有 0 到 15 个数据库。这些数据库是相互独立的，每个数据库都有自己独立的键空间。当您连接到 Redis 服务器时，如果未明确指定，客户端通常会默认连接到数据库 0。
`hscan` 命令是 Redis 提供的一种迭代哈希表（Hash）中所有元素的方式，它通过游标（cursor）机制避免了一次性加载大量数据到内存，适用于大型数据集。在 `phpredis` 扩展中，`hscan` 的用法与 `redis-cli` 类似，需要指定哈希表的键、游标和可选的匹配模式。
常见问题：`phpredis` `hscan` 返回空结果
许多开发者在使用 `phpredis` 的 `hscan` 命令时，可能会遇到一个困惑：在 `redis-cli` 中使用相同的命令和参数能够正常返回数据，但在 PHP 脚本中执行 `hscan` 却得到空结果。这通常不是 `hscan` 命令本身的问题，而是 PHP 脚本与 Redis 服务器交互时，默认数据库选择与数据实际存储位置不一致导致的。
问题示例代码
以下是一个典型的 PHP 代码片段，它可能在数据存储于非默认数据库时返回空结果：
立即学习“PHP免费学习笔记（深入）”；
<?php
$it = null; // 游标初始化
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
// 假设 'products:search2' 这个哈希表的数据存储在数据库 1
// 但此处没有明确选择数据库，phpredis 默认连接到数据库 0
$results = $redis->hscan('products:search2', $it, '*word*');
var_dump($results); // 输出可能为 array(0) {} 或 null
?>
在此示例中，如果 `products:search2` 这个哈希表的数据实际上存储在 Redis 的数据库 1 中，那么在数据库 0 中执行 `hscan` 自然无法找到任何匹配的键值对，从而返回空结果。
解决方案：明确选择 Redis 数据库
解决这个问题的关键在于，在执行任何数据操作（包括 `hscan`）之前，确保 `phpredis` 客户端已连接到存储您数据的正确数据库。这可以通过 `Redis::select()` 方法来实现。
修正后的代码示例
只需在连接 Redis 服务器后，执行 `select()` 方法切换到正确的数据库即可：
<?php
$it = null; // 游标初始化
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
// 关键一步：选择包含数据的数据库
// 假设数据存储在数据库 1
$redis->select(1);
// 现在在正确的数据库中执行 hscan
$results = $redis->hscan('products:search2', $it, '*word*');
var_dump($results); // 应该能正常返回数据了
?>
通过添加 `$redis->select(1);` 这一行，我们明确告诉 `phpredis` 客户端，接下来的操作应该在数据库 1 上执行。这样，`hscan` 命令就能在正确的数据库中查找并返回数据了。
注意事项与最佳实践
- 数据库索引的一致性： 始终确保您的应用程序代码与 Redis 数据的实际存储数据库索引保持一致。在开发、测试和生产环境中，这一点尤为重要。
- 避免硬编码： 数据库索引通常应该作为配置项，而不是硬编码在代码中，以便于环境切换和维护。
- 默认数据库： 记住 `phpredis` 默认连接到数据库 0。如果您希望使用其他数据库，务必显式调用 `select()`。
- 错误处理： `select()` 方法如果传入无效的数据库索引（例如负数或超出 Redis 配置的最大数据库索引），可能会抛出异常或返回 `false`。在实际应用中，可以考虑添加错误处理逻辑。
总结
`phpredis` `hscan` 命令返回空结果的问题，最常见的原因是 PHP 脚本连接到了错误的 Redis 数据库。通过在执行数据操作前，使用 `$redis->select(database_index);` 方法明确选择正确的数据库，可以轻松解决这一问题。理解 Redis 的多数据库特性并养成良好的数据库选择习惯，是使用 `phpredis` 进行高效开发的基石。
