PHP使用Redis实战实录2：Redis扩展方法和PHP连接Redis的多种方案

k***81722025-12-01 12:10

PHP使用Redis实战实录系列

Redis扩展方法和PHP连接Redis的多种方案

PHP 中使用 Redis 前， 我们需要确保已经安装了 redis 服务及 PHP redis 驱动，且你的机器上能正常使用 PHP:

复制代码 
echo phpinfo();

出现上面提示，代表可以正常使用PHP操作Redis。

一、Redis扩展方法

Redis扩展提供了一系列方法用于与Redis服务器进行交互。以下是一些常用的$redis对象可用的方法：

  1. 连接和关闭连接：

    • connect($host, $port, $timeout): 连接到Redis服务器。
    • close(): 关闭Redis连接。

  2. 数据操作：

    • set($key, $value): 设置指定键的值。
    • get($key): 获取指定键的值。
    • del($key1, $key2, ...): 删除一个或多个键。
    • incr($key): 增加键对应的值。
    • decr($key): 减少键对应的值。
    • exists($key): 检查键是否存在。
    • 其他诸如append、strlen、mset、mget等等。

  3. 列表操作：

    • lpush($key, $value1, $value2, ...): 在列表左侧插入一个或多个值。
    • rpush($key, $value1, $value2, ...): 在列表右侧插入一个或多个值。
    • lpop($key): 弹出列表左侧的值。
    • rpop($key): 弹出列表右侧的值。
    • llen($key): 获取列表长度。
    • 其他诸如lindex、lrange、ltrim等等。

  4. 哈希操作：

    • hset($key, $field, $value): 设置哈希中指定字段的值。
    • hget($key, $field): 获取哈希中指定字段的值。
    • hdel($key, $field1, $field2, ...): 删除一个或多个哈希字段。
    • hgetall($key): 获取哈希中所有字段和对应的值。
    • 其他诸如hincrby、hkeys、hvals等等。

  5. 集合操作：

    • sadd($key, $member1, $member2, ...): 向集合添加一个或多个成员。
    • srem($key, $member1, $member2, ...): 从集合中移除一个或多个成员。
    • smembers($key): 获取集合的所有成员。
    • sismember($key, $member): 检查成员是否存在于集合中。
    • 其他诸如sinter、sunion、sdiff等等。

这只是Redis提供的一些常见操作方法的示例列表，还有更多其他方法可供使用。具体可以参考Redis扩展的文档或官方网站来了解更多关于Redis操作的详细信息。

二、php操作Redis语法

在PHP中，可以使用Redis扩展来操作Redis服务器。下面是一些常用的PHP操作Redis的语法示例：

  1. 连接到Redis服务器：

    $redis = new Redis();

    $redis->connect('127.0.0.1', 6379);

    // 或者使用连接池连接

    $redis = new Redis();

    $redis->pconnect('127.0.0.1', 6379);

  2. 设置和获取键值对：

    // 设置键的值

    $redis->set('key', 'value');

    // 获取键的值

    value = redis->get('key');

  3. 删除键：

    $redis->del('key');

  4. 判断键是否存在：

    if ($redis->exists('key')) {

    // 键存在的处理逻辑

    } else {

    // 键不存在的处理逻辑

    }

  5. 进行哈希操作：

    // 设置哈希表字段的值

    $redis->hset('hash_key', 'field', 'value');

    // 获取哈希表字段的值

    value = redis->hget('hash_key', 'field');

    // 删除哈希表字段

    $redis->hdel('hash_key', 'field');

  6. 进行列表操作：

    // 在列表左侧插入值

    $redis->lpush('list_key', 'value1', 'value2');

    // 在列表右侧插入值

    $redis->rpush('list_key', 'value3', 'value4');

    // 弹出列表左侧的值

    value = redis->lpop('list_key');

    // 弹出列表右侧的值

    value = redis->rpop('list_key');

  7. 进行集合操作：

    // 向集合添加成员

    $redis->sadd('set_key', 'member1', 'member2');

    // 从集合中移除成员

    $redis->srem('set_key', 'member1');

    // 检查成员是否存在于集合中

    if ($redis->sismember('set_key', 'member1')) {

    // 成员存在的处理逻辑

    } else {

    // 成员不存在的处理逻辑

    }

  8. 键设置过期时间

    在Redis中，你可以使用EXPIRE命令为一个键设置过期时间，从而控制该键的有效期。以下是一些在Redis中设置键的有效期的方法：

  9. EXPIRE key seconds：设置key的过期时间为seconds秒。当seconds秒钟过去后，键将会自动过期并被删除。

例如，下面的代码将名为mykey的键设置为过期时间为60秒：

复制代码 
$redis->expire('mykey', 60);
  1. PEXPIRE key milliseconds：类似于EXPIRE命令，但时间以毫秒为单位。

例如，下面的代码将名为mykey的键设置为过期时间为3000毫秒（即3秒）：

复制代码 
$redis->pexpire('mykey', 3000);
  1. EXPIREAT key timestamp：设置key的过期时间戳，以秒为单位。timestamp参数是一个UNIX时间戳，表示键的过期时间点。

例如，下面的代码将名为mykey的键设置为在1612266625秒之后过期：

复制代码 
$redis->expireat('mykey', 1612266625);
  1. PEXPIREAT key milliseconds-timestamp：类似于EXPIREAT命令，但时间戳以毫秒为单位。

例如，下面的代码将名为mykey的键设置为在1654123456789毫秒之后过期：

复制代码 
$redis->pexpireat('mykey', 1654123456789);

这些命令可用于设置Redis中键的过期时间。一旦过期时间到达，键将被自动删除。注意，只有在键被设置为字符串、哈希表、列表等类型时，过期设置才有效。

另外，如果你想获取键的剩余过期时间，你可以使用TTL命令或PTTL命令。如ttl('mykey')返回键mykey的剩余过期时间（以秒为单位），pttl('mykey')返回键mykey的剩余过期时间（以毫秒为单位）。如果键已过期或不存在，这些命令返回负数。

这些是一些常用的Redis操作示例，你可以根据具体的业务需求，使用相应的方法来进行操作。记得在操作完成后，及时关闭Redis连接，以释放资源。

三、PHP连接Redis

1.PHP中使用带密码的连接Redis

若要在PHP中使用带密码的连接Redis，你可以使用Redis扩展的auth方法进行身份验证。以下是设置密码并连接到Redis服务器的示例代码：

复制代码 
<?php
$redis = new Redis();

// 连接到Redis服务器
$redis->connect('127.0.0.1', 6379);

// 身份验证
$redis->auth('your_password');

// 执行一些操作
$redis->set('key', 'value');
$value = $redis->get('key');

echo $value; // 输出 'value'
?>

在上述代码中，your_password是在Redis服务器上设置的密码。使用auth方法将密码传递给Redis实例进行身份验证。如果密码不正确或与服务器配置不匹配，将会引发REDIS_AUTH异常。因此，确保提供正确的密码以及与服务器配置相匹配的密码。

同样地，如果在使用Laravel框架，你可以在config/database.php文件中配置Redis连接的密码。在对应的'redis'配置数组中添加'password' => 'your_password'以设置密码。

记得使用适当的安全措施来保护Redis密码，如避免将密码明文存储在代码中或通过不安全的方式传输密码。

2.PHP连接Redis抛出异常

复制代码 
try {
    $redis = new Redis();

    // 连接到Redis服务器
    $redis->connect('127.0.0.1', 6379);

    // 身份验证
    $redis->auth('kYABzc8u3zNs7cq');

    // 执行一些操作
    $redis->set('key', 'lockdata');
    $value = $redis->get('key');

    echo $value; // 输出 'value'

    // 关闭Redis连接
    $redis->close();
} catch (RedisException $e) {
    echo "连接Redis时发生异常：" . $e->getMessage();
}

3.PHP连接Redis：$redis->ping()

$redis->ping()是Redis扩展提供的一个方法，用于检测与Redis服务器的连接是否存活。

它的使用很简单，只需要调用$redis->ping()方法即可。若连接正常且服务器可响应，则该方法返回字符串PONG。若连接异常或服务器未响应，则会抛出RedisException异常。

以下是一个示例：

复制代码 
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

try {
    $response = $redis->ping();

    if ($response === 'PONG') {
        echo "Redis连接正常";
    } else {
        echo "Redis连接异常或服务器未响应";
    }
} catch (RedisException $e) {
    echo "Redis连接异常：" . $e->getMessage();
}

$redis->close();

在上述示例中，我们首先创建一个Redis对象，然后使用connect()方法连接到Redis服务器。接下来，我们调用ping()方法来检测连接状态，并通过返回的响应值进行判断。如果返回值为PONG，则表示连接正常；如果返回值为其他内容，或抛出了异常，则表示连接异常或服务器未响应。

记得在使用ping()方法前确保已经成功建立了与Redis服务器的连接，并在使用完成后及时关闭连接以释放资源。

4.PHP连接Redis 条件语句写法

如果你不想使用try语句来捕获异常，你可以通过检查连接和操作返回的结果来判断是否发生了异常。以下是一个示例代码：

复制代码 
$redis = new Redis();

// 连接到Redis服务器
$connected = $redis->connect('127.0.0.1', 6379);

if ($connected === false) {
    echo "无法连接到Redis服务器";
} else {
    // 执行一些操作
    $setResult = $redis->set('key', 'value');
    if ($setResult === false) {
        echo "设置键值对发生了异常";
    } else {
        $value = $redis->get('key');
        if ($value === false) {
            echo "获取键值对发生了异常";
        } else {
            echo $value; // 输出 'value'
        }
    }
    // 关闭Redis连接
    $redis->close();
}

在上述示例中，我们首先检查$redis->connect()方法的返回值来确定是否成功连接到Redis服务器。如果连接失败，我们可以输出相应的错误信息。如果连接成功，我们再执行一些操作，如$redis->set()、$redis->get()等，并检查每个操作的返回结果来判断是否发生了异常。

使用这种写法，你可以根据返回结果进行逻辑判断和处理，而无需使用try和catch块来捕获异常。这种写法相对简单，但在处理多个操作和嵌套逻辑时可能会导致代码变得复杂。

记得在代码中适当处理连接和操作过程中的异常，确保你的程序具备健壮性并能正确处理错误情况。

四、避坑指南

NOAUTH Authentication required 错误

Fatal error: Uncaught exception 'RedisException' with message 'NOAUTH Authentication required.' in /www/wwwroot/redis.lockdata.cn/index.php:12 Stack trace: #0 /www/wwwroot/redis.lockdata.cn/index.php(12): Redis->set('key1', 'value1') #1 {main} thrown in /www/wwwroot/redis.lockdata.cn/index.php on line 12

**原因：**未配置Redis密码导致。

复制代码 
// 身份验证
$redis->auth('kYABzc8u3zNs7cq');

@漏刻有时

相关推荐
JaguarJack16 小时前
推荐 PHP 属性(Attributes) 简洁读取 API 扩展包
后端·php·服务端
BingoGo17 小时前
推荐 PHP 属性(Attributes) 简洁读取 API 扩展包
php
JaguarJack2 天前
告别 Laravel 缓慢的 Blade！Livewire Blaze 来了，为你的 Laravel 性能提速
后端·php·laravel
郑州光合科技余经理2 天前
代码展示：PHP搭建海外版外卖系统源码解析
java·开发语言·前端·后端·系统架构·uni-app·php
feifeigo1232 天前
matlab画图工具
开发语言·matlab
dustcell.2 天前
haproxy七层代理
java·开发语言·前端
norlan_jame2 天前
C-PHY与D-PHY差异
c语言·开发语言
多恩Stone2 天前
【C++入门扫盲1】C++ 与 Python：类型、编译器/解释器与 CPU 的关系
开发语言·c++·人工智能·python·算法·3d·aigc
QQ4022054962 天前
Python+django+vue3预制菜半成品配菜平台
开发语言·python·django
QQ5110082852 天前
python+springboot+django/flask的校园资料分享系统
spring boot·python·django·flask·node.js·php
热门推荐
01GitHub 镜像站点02【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆03OpenClaw 使用和管理 MCP 完全指南04Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤05OpenClaw + 飞书（Feishu）环境搭建指南06Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services07Window 10部署openclaw报错node.exe : npm error code 12808AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南09AI Agent 平台横评：ZeroClaw vs OpenClaw vs Nanobot10OpenClaw优化飞书API 额度已耗尽问题