123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228 |
- <?php
- /*
- * This file is part of the Predis package.
- *
- * (c) Daniele Alessandri <suppakilla@gmail.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
- namespace Predis\Connection;
- use Predis\Command\CommandInterface;
- use Predis\NotSupportedException;
- use Predis\Response\Error as ErrorResponse;
- use Predis\Response\Status as StatusResponse;
- /**
- * This class provides the implementation of a Predis connection that uses PHP's
- * streams for network communication and wraps the phpiredis C extension (PHP
- * bindings for hiredis) to parse and serialize the Redis protocol.
- *
- * This class is intended to provide an optional low-overhead alternative for
- * processing responses from Redis compared to the standard pure-PHP classes.
- * Differences in speed when dealing with short inline responses are practically
- * nonexistent, the actual speed boost is for big multibulk responses when this
- * protocol processor can parse and return responses very fast.
- *
- * For instructions on how to build and install the phpiredis extension, please
- * consult the repository of the project.
- *
- * The connection parameters supported by this class are:
- *
- * - scheme: it can be either 'redis', 'tcp' or 'unix'.
- * - host: hostname or IP address of the server.
- * - port: TCP port of the server.
- * - path: path of a UNIX domain socket when scheme is 'unix'.
- * - timeout: timeout to perform the connection.
- * - read_write_timeout: timeout of read / write operations.
- * - async_connect: performs the connection asynchronously.
- * - tcp_nodelay: enables or disables Nagle's algorithm for coalescing.
- * - persistent: the connection is left intact after a GC collection.
- *
- * @link https://github.com/nrk/phpiredis
- *
- * @author Daniele Alessandri <suppakilla@gmail.com>
- */
- class PhpiredisStreamConnection extends StreamConnection
- {
- private $reader;
- /**
- * {@inheritdoc}
- */
- public function __construct(ParametersInterface $parameters)
- {
- $this->assertExtensions();
- parent::__construct($parameters);
- $this->reader = $this->createReader();
- }
- /**
- * {@inheritdoc}
- */
- public function __destruct()
- {
- phpiredis_reader_destroy($this->reader);
- parent::__destruct();
- }
- /**
- * Checks if the phpiredis extension is loaded in PHP.
- */
- private function assertExtensions()
- {
- if (!extension_loaded('phpiredis')) {
- throw new NotSupportedException(
- 'The "phpiredis" extension is required by this connection backend.'
- );
- }
- }
- /**
- * {@inheritdoc}
- */
- protected function tcpStreamInitializer(ParametersInterface $parameters)
- {
- $uri = "tcp://[{$parameters->host}]:{$parameters->port}";
- $flags = STREAM_CLIENT_CONNECT;
- $socket = null;
- if (isset($parameters->async_connect) && (bool) $parameters->async_connect) {
- $flags |= STREAM_CLIENT_ASYNC_CONNECT;
- }
- if (isset($parameters->persistent) && (bool) $parameters->persistent) {
- $flags |= STREAM_CLIENT_PERSISTENT;
- $uri .= strpos($path = $parameters->path, '/') === 0 ? $path : "/$path";
- }
- $resource = @stream_socket_client($uri, $errno, $errstr, (float) $parameters->timeout, $flags);
- if (!$resource) {
- $this->onConnectionError(trim($errstr), $errno);
- }
- if (isset($parameters->read_write_timeout) && function_exists('socket_import_stream')) {
- $rwtimeout = (float) $parameters->read_write_timeout;
- $rwtimeout = $rwtimeout > 0 ? $rwtimeout : -1;
- $timeout = array(
- 'sec' => $timeoutSeconds = floor($rwtimeout),
- 'usec' => ($rwtimeout - $timeoutSeconds) * 1000000,
- );
- $socket = $socket ?: socket_import_stream($resource);
- @socket_set_option($socket, SOL_SOCKET, SO_SNDTIMEO, $timeout);
- @socket_set_option($socket, SOL_SOCKET, SO_RCVTIMEO, $timeout);
- }
- if (isset($parameters->tcp_nodelay) && function_exists('socket_import_stream')) {
- $socket = $socket ?: socket_import_stream($resource);
- socket_set_option($socket, SOL_TCP, TCP_NODELAY, (int) $parameters->tcp_nodelay);
- }
- return $resource;
- }
- /**
- * Creates a new instance of the protocol reader resource.
- *
- * @return resource
- */
- private function createReader()
- {
- $reader = phpiredis_reader_create();
- phpiredis_reader_set_status_handler($reader, $this->getStatusHandler());
- phpiredis_reader_set_error_handler($reader, $this->getErrorHandler());
- return $reader;
- }
- /**
- * Returns the underlying protocol reader resource.
- *
- * @return resource
- */
- protected function getReader()
- {
- return $this->reader;
- }
- /**
- * Returns the handler used by the protocol reader for inline responses.
- *
- * @return \Closure
- */
- protected function getStatusHandler()
- {
- return function ($payload) {
- return StatusResponse::get($payload);
- };
- }
- /**
- * Returns the handler used by the protocol reader for error responses.
- *
- * @return \Closure
- */
- protected function getErrorHandler()
- {
- return function ($errorMessage) {
- return new ErrorResponse($errorMessage);
- };
- }
- /**
- * {@inheritdoc}
- */
- public function read()
- {
- $socket = $this->getResource();
- $reader = $this->reader;
- while (PHPIREDIS_READER_STATE_INCOMPLETE === $state = phpiredis_reader_get_state($reader)) {
- $buffer = stream_socket_recvfrom($socket, 4096);
- if ($buffer === false || $buffer === '') {
- $this->onConnectionError('Error while reading bytes from the server.');
- }
- phpiredis_reader_feed($reader, $buffer);
- }
- if ($state === PHPIREDIS_READER_STATE_COMPLETE) {
- return phpiredis_reader_get_reply($reader);
- } else {
- $this->onProtocolError(phpiredis_reader_get_error($reader));
- return;
- }
- }
- /**
- * {@inheritdoc}
- */
- public function writeRequest(CommandInterface $command)
- {
- $arguments = $command->getArguments();
- array_unshift($arguments, $command->getId());
- $this->write(phpiredis_format_command($arguments));
- }
- /**
- * {@inheritdoc}
- */
- public function __wakeup()
- {
- $this->assertExtensions();
- $this->reader = $this->createReader();
- }
- }
|