mirror of
https://github.com/zhamao-robot/zhamao-framework.git
synced 2026-03-18 05:04:51 +08:00
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
# Redis
|
||
|
||
炸毛框架内置了 Redis 连接池，供开发者使用。使用前需要先安装 `redis` 扩展：
|
||
|
||
```bash
|
||
pecl install redis
|
||
```
|
||
|
||
> 如果是 Docker 环境，则默认已安装。
|
||
|
||
## 配置
|
||
|
||
配置文件在 `config/global.php` 的全局配置文件下，详情见 [配置](/guide/basic-config/#redis_config)。
|
||
|
||
示例配置（假设 Redis Server 开到了本地）：
|
||
|
||
```php
|
||
/** Redis连接信息，host留空则启动时不创建Redis连接池 */
|
||
$config['redis_config'] = [
|
||
'host' => '127.0.0.1',
|
||
'port' => 6379,
|
||
'timeout' => 1,
|
||
'db_index' => 0,
|
||
'auth' => ''
|
||
];
|
||
```
|
||
|
||
## 使用
|
||
|
||
当写好配置文件后，不可以使用 reload 进行重载，因为连接池需要在主进程中声明配置，才可以应用到多个工作进程中。所以必须输入 `stop` 或 Ctrl+C 停止后再启动框架。
|
||
|
||
定义：`ZM\Store\Redis\ZMRedis`
|
||
|
||
因为使用的是连接池，所以每次使用完一个连接需要归还连接给连接池。框架封装了两种方式自动归还，你可以选择下面其中的任意一种。
|
||
|
||
以下的方式获取的 `$redis` 都是 `redis` 扩展的对象 `\Redis`，关于 redis 扩展的方法文档，详情见：[Redis 文档](https://www.php.cn/course/49.html)。
|
||
|
||
### 对象模式
|
||
|
||
```php
|
||
$obj = new ZMRedis();
|
||
$redis = $obj->get();
|
||
ctx()->reply($redis->ping("123"));
|
||
```
|
||
|
||
### 回调模式
|
||
|
||
```php
|
||
// 前面的代码
|
||
ZMRedis::call(function($redis) {
|
||
$redis->set("key1", "hello world");
|
||
$result = $redis->get("key1");
|
||
ctx()->reply($result);
|
||
});
|
||
// 后面的代码
|
||
```
|
||
|
||
### 二者的区别
|
||
|
||
选一个喜欢的就好。硬要是说区别的话，对象模式是在 PHP 自动回收这个 `ZMRedis` 对象时会归还连接，也可以通过手动 `unset($obj)` 进行回收，否则就会执行到函数结尾自动回收。切记不可将 `$obj` 对象持久化存到静态或全局变量等。
|
||
|
||
回调模式看似是回调，但是是同步执行的，不会发生顺序错乱。也就是说到了 `ZMRedis::call()` 方法里面的时候，后面的代码不会提前执行，是顺序执行的。回调的作用仅仅是用作自动回收连接对象。
|