Download the PHP package clue/redis-protocol without Composer
On this page you can find all versions of the php package clue/redis-protocol. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download clue/redis-protocol
More information about clue/redis-protocol
Files in clue/redis-protocol
Package redis-protocol
Short Description A streaming redis wire protocol parser and serializer implementation in PHP
License MIT
Homepage https://github.com/clue/php-redis-protocol
Informations about the package redis-protocol
clue/redis-protocol
A streaming redis protocol parser and serializer written in PHP
This parser and serializer implementation allows you to parse redis protocol messages into native PHP values and vice-versa. This is usually needed by a redis client implementation which also handles the connection socket.
To re-iterate: This is not a redis client implementation. This is a protocol implementation that is usually used by a redis client implementation. If you're looking for an easy way to build your own client implementation, then this is for you. If you merely want to connect to a redis server and issue some commands, you're probably better off using one of the existing client implementations.
Table of contents
- Quickstart example
- Usage
- Factory
- Parser
- Model
- Serializer
- Install
- License
Quickstart example
Usage
Factory
The factory helps with instantiating the right parser and serializer. Eventually the best available implementation will be chosen depending on your installed extensions. You're also free to instantiate them directly, but this will lock you down on a given implementation (which could be okay depending on your use-case).
Parser
The library includes a streaming redis protocol parser. As such, it can safely
parse redis protocol messages and work with an incomplete data stream. For this,
each included parser implements a single method
ParserInterface::pushIncoming($chunk)
.
- The
ResponseParser
is what most redis client implementation would want to use in order to parse incoming response messages from a redis server instance. - The
RequestParser
can be used to test messages coming from a redis client or even to implement a redis server. - The
MessageBuffer
decorates either of the available parsers and merely offers some helper methods in order to work with single messages:hasIncomingModel()
to check if there's a complete message in the pipelinepopIncomingModel()
to extract a complete message from the incoming queue.
Model
Each message (response as well as request) is represented by a model
implementing the ModelInterface
that has two methods:
getValueNative()
returns the wrapped value.getMessageSerialized($serializer)
returns the serialized protocol messages that will be sent over the wire.
These models are very lightweight and add little overhead. They help keeping the
code organized and also provide a means to distinguish a single line
StatusReply
from a binary-safe BulkReply
.
The parser always returns models. Models can also be instantiated directly:
Serializer
The serializer is responsible for creating serialized messages and the corresponing message models to be sent across the wire.
Install
It's very unlikely you'll want to use this protocol parser standalone. It should be added as a dependency to your redis client implementation instead. The recommended way to install this library is through Composer. New to Composer?
This will install the latest supported version:
More details and upgrade guides can be found in the CHANGELOG.
License
Its parser and serializer originally used to be based on jpd/redisent, which is released under the ISC license, copyright (c) 2009-2012 Justin Poliey [email protected].
Other than that, this library is MIT licensed.