Predis for PHP：完整指南与示例

什么是 Predis 以及为什么需要它

\n\n

Predis 是一个用 PHP 语言编写的、功能完整的 Redis（远程字典服务器）客户端。Redis 是一个高性能的键值存储数据库，常用于缓存、会话管理、消息队列和实时应用。Predis 允许 PHP 应用程序与 Redis 服务器交互，发送命令并接收响应。

\n\n

为什么要使用 Predis？与其他客户端（例如 phpredis）不同，Predis 完全用 PHP 编写，无需安装额外的 C 扩展。这使其成为无法控制扩展安装环境（例如共享主机）的理想选择。Predis 支持 Redis 的所有主要功能：字符串、哈希、列表、集合、事务、发布/订阅、集群等。

\n\n

主要使用场景：

\n

\n
• 缓存 — 通过将频繁请求的数据存储在内存中来加速网站运行。
\n
• 会话管理 — 将会话数据存储在 Redis 中，以实现快速访问和扩展。
\n
• 任务队列 — 利用 Redis 列表组织后台任务处理。
\n
• 排行榜与计数器 — 使用有序集合构建排行榜。
\n
• 发布/订阅 — 实现实时消息交换系统。
\n

\n\n

安装 Predis

\n\n

Predis 通过 Composer（PHP 的标准包管理器）分发。请确保您已安装 Composer。如果没有，请从 getcomposer.org 下载。

\n\n

要安装 Predis，请在项目根目录下执行以下命令：

\n\n

composer require predis/predis

\n\n

安装后，您的项目中会出现 vendor 文件夹和 composer.json 文件。要使用 Predis，请引入 Composer 的自动加载器：

\n\n

require 'vendor/autoload.php';

\n\n

最低要求：PHP 7.2 或更高版本。Predis 不需要安装 PHP 的 Redis 扩展，因为它用纯 PHP 实现了 Redis 协议。

\n\n

快速入门及代码示例

\n\n

让我们编写一个简单的脚本，连接到 Redis，保存一个值并读取它。

\n\n

<?php\nrequire 'vendor/autoload.php';\n\nuse Predis\\Client;\n\n// 创建 Redis 客户端（默认连接到 localhost:6379）\n$client = new Client();\n\n// 设置值\n$client->set('greeting', 'Hello, Redis!');\n\n// 获取值\n$value = $client->get('greeting');\necho $value; // 输出：Hello, Redis!\n\n// 检查键是否存在\nif ($client->exists('greeting')) {\n    echo "键存在！";\n}\n\n// 删除键\n$client->del(['greeting']);\n?>

\n\n

这段代码执行以下操作：

\n

\n
1. 连接到 localhost（端口 6379）上的 Redis 服务器。
\n
2. 将字符串 "Hello, Redis!" 存储在键 "greeting" 下。
\n
3. 读取该值并输出。
\n
4. 检查键是否存在。
\n
5. 删除该键。
\n

\n\n

如果 Redis 运行在其他主机或端口上，请传递连接参数：

\n\n

$client = new Client([\n    'scheme' => 'tcp',\n    'host'   => '192.168.1.100',\n    'port'   => 6379,\n]);

\n\n

Predis 的主要方法

\n\n

Predis 为所有 Redis 命令提供了便捷的接口。让我们通过详细示例介绍 10 个最常用的方法。

\n\n

1. set — 设置值

\n

功能： 为指定键设置值。如果键已存在，其值将被覆盖。

\n

参数：

\n

\n
• $key (string) — 键名。
\n