当前位置：首页 > news >正文

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

news 2025/11/3 15:17:02

PHP使用Redis实战实录系列

PHP使用Redis实战实录1：宝塔环境搭建、6379端口配置、Redis服务启动失败解决方案
PHP使用Redis实战实录2：Redis扩展方法和PHP连接Redis的多种方案

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

一、Redis扩展方法
二、php操作Redis语法
三、PHP连接Redis
- 1.PHP中使用带密码的连接Redis
- 2.PHP连接Redis抛出异常
- 3.PHP连接Redis：$redis->ping()
- 4.PHP连接Redis 条件语句写法
四、避坑指南
- NOAUTH Authentication required 错误

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

echo phpinfo();

在这里插入图片描述
出现上面提示，代表可以正常使用PHP操作Redis。

一、Redis扩展方法

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

连接和关闭连接：
- connect($host, $port, $timeout): 连接到Redis服务器。
- close(): 关闭Redis连接。
数据操作：
- set($key, $value): 设置指定键的值。
- get($key): 获取指定键的值。
- del($key1, $key2, ...): 删除一个或多个键。
- incr($key): 增加键对应的值。
- decr($key): 减少键对应的值。
- exists($key): 检查键是否存在。
- 其他诸如append、strlen、mset、mget等等。
列表操作：
- lpush($key, $value1, $value2, ...): 在列表左侧插入一个或多个值。
- rpush($key, $value1, $value2, ...): 在列表右侧插入一个或多个值。
- lpop($key): 弹出列表左侧的值。
- rpop($key): 弹出列表右侧的值。
- llen($key): 获取列表长度。
- 其他诸如lindex、lrange、ltrim等等。
哈希操作：
- hset($key, $field, $value): 设置哈希中指定字段的值。
- hget($key, $field): 获取哈希中指定字段的值。
- hdel($key, $field1, $field2, ...): 删除一个或多个哈希字段。
- hgetall($key): 获取哈希中所有字段和对应的值。
- 其他诸如hincrby、hkeys、hvals等等。
集合操作：
- 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的语法示例：

连接到Redis服务器：

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);// 或者使用连接池连接
$redis = new Redis();
$redis->pconnect('127.0.0.1', 6379);

设置和获取键值对：

// 设置键的值
$redis->set('key', 'value');// 获取键的值
$value = $redis->get('key');

删除键：

$redis->del('key');

判断键是否存在：

if ($redis->exists('key')) {// 键存在的处理逻辑
} else {// 键不存在的处理逻辑
}

进行哈希操作：

// 设置哈希表字段的值
$redis->hset('hash_key', 'field', 'value');// 获取哈希表字段的值
$value = $redis->hget('hash_key', 'field');// 删除哈希表字段
$redis->hdel('hash_key', 'field');

进行列表操作：

// 在列表左侧插入值
$redis->lpush('list_key', 'value1', 'value2');// 在列表右侧插入值
$redis->rpush('list_key', 'value3', 'value4');// 弹出列表左侧的值
$value = $redis->lpop('list_key');// 弹出列表右侧的值
$value = $redis->rpop('list_key');

进行集合操作：

// 向集合添加成员
$redis->sadd('set_key', 'member1', 'member2');// 从集合中移除成员
$redis->srem('set_key', 'member1');// 检查成员是否存在于集合中
if ($redis->sismember('set_key', 'member1')) {// 成员存在的处理逻辑
} else {// 成员不存在的处理逻辑
}

键设置过期时间
在Redis中，你可以使用EXPIRE命令为一个键设置过期时间，从而控制该键的有效期。以下是一些在Redis中设置键的有效期的方法：
EXPIRE key seconds：设置key的过期时间为seconds秒。当seconds秒钟过去后，键将会自动过期并被删除。

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

$redis->expire('mykey', 60);

PEXPIRE key milliseconds：类似于EXPIRE命令，但时间以毫秒为单位。

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

$redis->pexpire('mykey', 3000);

EXPIREAT key timestamp：设置key的过期时间戳，以秒为单位。timestamp参数是一个UNIX时间戳，表示键的过期时间点。

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

$redis->expireat('mykey', 1612266625);

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');

@漏刻有时