phpredis json 다운로드 - phpredis json 소스 코드 다운로드

phpredis json

기타 카테고리

1.0.0

다운로드

Phpredis-JSON

PHP Redis 확장 phpredis를 사용하는 RedisJson.

소개

Phpredis-JSON은 RedisJson 모듈에 대한 전체 명령 세트를 제공합니다. phpredis 위에 구축되어 Redis 클라이언트로 사용되므로 phpredis 에 포함된 일부 기능을 Redis 클라이언트로 활용할 수도 있습니다.

왜?

원시 Redis 명령을 보내는 기능을 제공하는 일부 PHP Redis 클라이언트를 사용하여 RedisJSON 명령을 실행할 수 있지만 Phpredis-JSON:

PHP 데이터 구조를 Redis로 보내기 전에 JSON으로 인코딩하고 Redis에서 다시 JSON 응답을 디코딩하는 작업을 방지합니다.
JSON 인코딩/디코딩을 검증하고 실패할 경우 적절한 예외를 발생시킵니다.
RedisJSON 클라이언트의 메서드로 명령 세트를 제공합니다.

요구사항

Redis 서버 4.0+ 버전(RedisJson 모듈은 Redis 4.0+에서만 사용 가능)
RedisJSON 모듈 빌드 및 로드에 지정된 대로 Redis 서버에 설치된 RedisJson 모듈
PHP Redis 확장 5가 설치된 PHP 7.2+

용법

 <?php

use Averias  RedisJson  Enum  JsonCommands ;
use Averias  RedisJson  Exception  ResponseException ;
use Averias  RedisJson  Factory  RedisJsonClientFactory ;

// *** get a RedisJsonClient ***
$ redisJsonClientFactory = new RedisJsonClientFactory ();
/**
 * creates a RedisJsonClient with default connection params:
 * [
 *     'host' => '127.0.0.1',
 *     'port' => 6379,
 *     'timeout' => 0.0, // seconds
 *     'retryInterval' => 15 // milliseconds
 *     'readTimeout' => 2, // seconds
 *     'persistenceId' => null // string for persistent connections, null for no persistent ones
 *     'database' => 0 // Redis database index [0..15]
 * ]
 */
$ defaultClient = $ redisJsonClientFactory -> createClient ();

// creates a configured RedisJsonClient
$ client = $ redisJsonClientFactory -> createClient ([
    ' host ' => ' 127.0.0.1 ' ,
    ' port ' => 6390 ,
    ' timeout ' => 2 ,
    ' database ' => 15
]);

// *** Redis JSON commands ***
$ result = $ client -> jsonSet ( ' people ' , [ " name " => " gafael " , " age " => 12 ]);
echo ( $ result === true ? ' true ' : ' false ' ) . PHP_EOL ; // true

$ result = $ client -> jsonGet ( ' people ' ); // $result = ["name":"gafael","age":12]
echo json_encode ( $ result ) . PHP_EOL ; // {"name":"gafael","age":12}

$ result =  $ client -> jsonGet ( ' people ' , ' .name ' );
echo $ result . PHP_EOL ; // "gafael"

$ result =  $ client -> jsonGet ( ' people ' , ' .age ' );
echo $ result . PHP_EOL ; // 12

// "nonexistent" key does not exist, so a ResponseException is thrown
try {
    $ result = $ client -> jsonGet ( ' nonexistent ' );
    echo $ result . PHP_EOL ;
} catch ( ResponseException $ e ) {
    echo " key nonexistent does not exist " . PHP_EOL ;
}

// *** you can also send RedisJSON command as raw commands using "RedisJsonClient::executeRawCommand"  ***
// you will send
$ result =  $ client -> executeRawCommand (JsonCommands:: SET , ' people ' , ' .colors ' , ' ["blue", "green"] ' );
echo $ result . PHP_EOL ; // 'OK'

// and receive JSON values
$ result =  $ client -> executeRawCommand (JsonCommands:: GET , ' people ' , ' . ' );
echo $ result . PHP_EOL ; // {"name":"gafael","age":12,"colors":["blue","green"]}


// *** you can also issue redis commands and use RedisJsonClient as "phpredis" client:
echo $ client -> hset ( ' hash-key ' , ' age ' , 34 ) . PHP_EOL ; // 0
echo $ client -> hget ( ' hash-key ' , ' age ' ) . PHP_EOL ; // 34

// $ret = [true,"val1",true,"val2"]
$ ret = $ client -> multi ()
    -> set ( ' key1 ' , ' val1 ' )
    -> get ( ' key1 ' )
    -> set ( ' key2 ' , ' val2 ' )
    -> get ( ' key2 ' )
    -> exec ();

echo json_encode ( $ ret ) . PHP_EOL ;

명령

RedisJSON 명령: phpredis-json 명령 목록을 살펴보세요.
Phpredis 명령: phpredis 문서에 지정된 대로 Redis 명령을 보낼 수 있습니다.
원시 명령: RedisJsonClient::executeRawCommand 사용하여 원하는 것을 Redis로 보낼 수 있습니다.

 // raw Redis JSON command
$ client -> executeRawCommand (JsonCommands:: GET , ' people ' , ' . ' );

// raw Redis command
$ client -> executeRawCommand ( ' hget, ' hash-key', ' foo ' );

테스트

RedisJSON 모듈 및 Redis 확장 5가 설치된 로컬 Redis 서버 4.0 이상

콘솔에서 이 프로젝트의 루트 디렉터리에서 다음 명령을 실행합니다.

./vendor/bin/phpunit

127.0.0.1:6379에서 로컬 Redis 서버를 구성하지 않은 경우 위 명령을 실행하기 전에 로컬 Redis 호스트, 포트 및 데이터베이스를 사용하여 ./phpunit.xml 파일의 REDIS_TEST_SERVER, REDIS_TEST_PORT 및 REDIS_TEST_DATABASE를 설정할 수 있습니다.

도커

Docker를 설치한 후 이 프로젝트의 루트 디렉터리에서 다음 명령을 실행합니다.

bash run-tests-docker.sh

위의 bash 스크립트를 실행하면 두 개의 도커 서비스가 구축됩니다. 하나는 xdebug 및 redis 확장이 활성화된 PHP 7.2를 사용하고 다른 하나는 redislabrejson:1.0.4 (RedisJson 모듈이 설치된 Redis 서버 5) 이미지를 사용합니다. 그런 다음 테스트는 phpredis-json docker 서비스 컨테이너 내에서 실행되고 마지막으로 두 컨테이너가 모두 중지됩니다.