Redis

webman/redis는 illuminate/redis를 기반으로 연결 풀 기능을 추가한 것으로, 협程 및 비협程 환경을 지원하며 사용법은 laravel과 동일합니다.

illuminate/redis를 사용하기 전에 php-cli에 redis 확장을 설치해야 합니다.

주의
현재 매뉴얼은 webman v2 버전입니다. webman v1 버전을 사용 중인 경우 v1 버전 매뉴얼를 참조하세요.
이 구성 요소는 redis 확장을 설치해야 하며, php -m | grep redis 명령어를 사용하여 php-cli에 redis 확장이 설치되었는지 확인하세요.

설치

composer require -W webman/redis illuminate/events

설치 후에는 restart로 재시작해야 하며(reload는 무효입니다)

구성

redis 구성 파일은 config/redis.php에 있습니다.

return [
    'default' => [
        'host'     => '127.0.0.1',
        'password' => null,
        'port'     => 6379,
        'database' => 0,
        'pool' => [ // 연결 풀 구성
            'max_connections' => 10,     // 연결 풀 최대 연결 수
            'min_connections' => 1,      // 연결 풀 최소 연결 수
            'wait_timeout' => 3,         // 연결 풀에서 연결을 가져올 때 최대 대기 시간
            'idle_timeout' => 50,        // 연결 풀이 비어 있는 경우 연결이 회수되는 시간 초과, 이 시간을 초과하면 종료됩니다. 최소 연결 수인 min_connections에 도달할 때까지
            'heartbeat_interval' => 50,  // 하트비트 검사 간격, 60초를 초과하지 않도록 합니다.
        ],
    ]
];

연결 풀에 대하여

각 프로세스는 자체 연결 풀을 가지며, 프로세스 간 연결 풀은 공유되지 않습니다.
협程을 사용하지 않을 경우, 비즈니스는 프로세스 내에서 대기열에 따라 실행되며, 동시성이 발생하지 않으므로 연결 풀은 최대 1개의 연결만 유지합니다.
협程을 활성화하면, 비즈니스는 프로세스 내에서 동시 실행되며, 연결 풀은 필요에 따라 동적으로 연결 수를 조정합니다. 최대 max_connections를 초과하지 않으며, 최소 min_connections보다 적지 않습니다.
연결 풀의 연결 수가 최대 max_connections로 제한되므로, Redis를 사용하는 협程 수가 max_connections를 초과할 경우, 협程은 대기열에서 기다리며 최대 wait_timeout 초까지 대기합니다. 이를 초과하면 예외가 발생합니다.
유휴 상태에서는(협程 및 비협程 환경 모두 포함) 연결은 idle_timeout 시간이 경과한 후 회수됩니다. 최소 연결 수인 min_connections에 도달할 때까지 회수됩니다(min_connections는 0일 수 있습니다).

예제

<?php
namespace app\controller;

use support\Request;
use support\Redis;

class UserController
{
    public function db(Request $request)
    {
        $key = 'test_key';
        Redis::set($key, rand());
        return response(Redis::get($key));
    }
}

Redis 인터페이스

Redis::append($key, $value)
Redis::bitCount($key)
Redis::decr($key, $value)
Redis::decrBy($key, $value)
Redis::get($key)
Redis::getBit($key, $offset)
Redis::getRange($key, $start, $end)
Redis::getSet($key, $value)
Redis::incr($key, $value)
Redis::incrBy($key, $value)
Redis::incrByFloat($key, $value)
Redis::mGet(array $keys)
Redis::getMultiple(array $keys)
Redis::mSet($pairs)
Redis::mSetNx($pairs)
Redis::set($key, $value, $expireResolution = null, $expireTTL = null, $flag = null)
Redis::setBit($key, $offset, $value)
Redis::setEx($key, $ttl, $value)
Redis::pSetEx($key, $ttl, $value)
Redis::setNx($key, $value)
Redis::setRange($key, $offset, $value)
Redis::strLen($key)
Redis::del(...$keys)
Redis::exists(...$keys)
Redis::expire($key, $ttl)
Redis::expireAt($key, $timestamp)
Redis::select($dbIndex)

동등한 것

$redis = Redis::connection('default');
$redis->append($key, $value)
$redis->bitCount($key)
$redis->decr($key, $value)
$redis->decrBy($key, $value)
$redis->get($key)
$redis->getBit($key, $offset)
...

주의
Redis::select($db) 인터페이스를 사용할 때 주의해야 합니다. webman은 상주 메모리 프레임워크이므로, 특정 요청에서 Redis::select($db)를 사용하여 데이터베이스를 전환하면 이후 다른 요청에 영향을 미칠 수 있습니다. 여러 데이터베이스를 사용할 경우, 서로 다른 $db를 서로 다른 Redis 연결 구성으로 설정하는 것이 좋습니다.

여러 Redis 연결 사용

예를 들어 구성 파일 config/redis.php

return [
    'default' => [
        'host'     => '127.0.0.1',
        'password' => null,
        'port'     => 6379,
        'database' => 0,
    ],

    'cache' => [
        'host'     => '127.0.0.1',
        'password' => null,
        'port'     => 6379,
        'database' => 1,
    ],

]

기본적으로 default 아래의 구성으로 연결이 사용되며, Redis::connection() 메서드를 사용하여 사용할 Redis 연결을 선택할 수 있습니다.

$redis = Redis::connection('cache');
$redis->get('test_key');

클러스터 구성

애플리케이션이 Redis 서버 클러스터를 사용하는 경우, Redis 구성 파일에서 clusters 키를 사용하여 이러한 클러스터를 정의해야 합니다.

return [
    'clusters' => [
        'default' => [
            [
                'host'     => 'localhost',
                'password' => null,
                'port'     => 6379,
                'database' => 0,
            ],
        ],
    ],

];

기본적으로 클러스터는 노드에서 클라이언트 분할을 구현할 수 있으며, 이를 통해 노드 풀을 구현하고 대량의 사용 가능한 메모리를 생성할 수 있습니다. 여기서 알아야 할 점은 클라이언트 공유가 실패 상황을 처리하지 않는다는 것입니다. 따라서 이 기능은 주 데이터베이스에서 가져온 캐시 데이터에 주로 사용됩니다. Redis의 기본 클러스터를 사용하려면 구성 파일 아래의 options 키에서 다음과 같이 지정해야 합니다.

return[
    'options' => [
        'cluster' => 'redis',
    ],

    'clusters' => [
        // ...
    ],
];

파이프 명령

한 번의 작업에서 서버에 많은 명령을 보내야 하는 경우 파이프 명령을 사용하는 것이 좋습니다. pipeline 메서드는 Redis 인스턴스의 클로저를 받아들입니다. 모든 명령을 Redis 인스턴스에 전송할 수 있으며, 이들은 한 작업으로 실행됩니다.

Redis::pipeline(function ($pipe) {
    for ($i = 0; $i < 1000; $i++) {
        $pipe->set("key:$i", $i);
    }
});