Moved cache drivers outside core to extensions (plugins)

plugins/cache-redis/Predis/Protocol/Text/Handler/BulkResponse.php

@@ -0,0 +1,55 @@
+<?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\Protocol\Text\Handler;
+
+use Predis\CommunicationException;
+use Predis\Connection\CompositeConnectionInterface;
+use Predis\Protocol\ProtocolException;
+
+/**
+ * Handler for the bulk response type in the standard Redis wire protocol.
+ * It translates the payload to a string or a NULL.
+ *
+ * @link http://redis.io/topics/protocol
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+class BulkResponse implements ResponseHandlerInterface
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function handle(CompositeConnectionInterface $connection, $payload)
+    {
+        $length = (int) $payload;
+
+        if ("$length" !== $payload) {
+            CommunicationException::handle(new ProtocolException(
+                $connection, "Cannot parse '$payload' as a valid length for a bulk response."
+            ));
+        }
+
+        if ($length >= 0) {
+            return substr($connection->readBuffer($length + 2), 0, -2);
+        }
+
+        if ($length == -1) {
+            return;
+        }
+
+        CommunicationException::handle(new ProtocolException(
+            $connection, "Value '$payload' is not a valid length for a bulk response."
+        ));
+
+        return;
+    }
+}

plugins/cache-redis/Predis/Protocol/Text/Handler/ErrorResponse.php

@@ -0,0 +1,34 @@
+<?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\Protocol\Text\Handler;
+
+use Predis\Connection\CompositeConnectionInterface;
+use Predis\Response\Error;
+
+/**
+ * Handler for the error response type in the standard Redis wire protocol.
+ * It translates the payload to a complex response object for Predis.
+ *
+ * @link http://redis.io/topics/protocol
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+class ErrorResponse implements ResponseHandlerInterface
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function handle(CompositeConnectionInterface $connection, $payload)
+    {
+        return new Error($payload);
+    }
+}

plugins/cache-redis/Predis/Protocol/Text/Handler/IntegerResponse.php

@@ -0,0 +1,45 @@
+<?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\Protocol\Text\Handler;
+
+use Predis\CommunicationException;
+use Predis\Connection\CompositeConnectionInterface;
+use Predis\Protocol\ProtocolException;
+
+/**
+ * Handler for the integer response type in the standard Redis wire protocol.
+ * It translates the payload an integer or NULL.
+ *
+ * @link http://redis.io/topics/protocol
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+class IntegerResponse implements ResponseHandlerInterface
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function handle(CompositeConnectionInterface $connection, $payload)
+    {
+        if (is_numeric($payload)) {
+            return (int) $payload;
+        }
+
+        if ($payload !== 'nil') {
+            CommunicationException::handle(new ProtocolException(
+                $connection, "Cannot parse '$payload' as a valid numeric response."
+            ));
+        }
+
+        return;
+    }
+}

plugins/cache-redis/Predis/Protocol/Text/Handler/MultiBulkResponse.php

@@ -0,0 +1,68 @@
+<?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\Protocol\Text\Handler;
+
+use Predis\CommunicationException;
+use Predis\Connection\CompositeConnectionInterface;
+use Predis\Protocol\ProtocolException;
+
+/**
+ * Handler for the multibulk response type in the standard Redis wire protocol.
+ * It returns multibulk responses as PHP arrays.
+ *
+ * @link http://redis.io/topics/protocol
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+class MultiBulkResponse implements ResponseHandlerInterface
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function handle(CompositeConnectionInterface $connection, $payload)
+    {
+        $length = (int) $payload;
+
+        if ("$length" !== $payload) {
+            CommunicationException::handle(new ProtocolException(
+                $connection, "Cannot parse '$payload' as a valid length of a multi-bulk response."
+            ));
+        }
+
+        if ($length === -1) {
+            return;
+        }
+
+        $list = array();
+
+        if ($length > 0) {
+            $handlersCache = array();
+            $reader = $connection->getProtocol()->getResponseReader();
+
+            for ($i = 0; $i < $length; ++$i) {
+                $header = $connection->readLine();
+                $prefix = $header[0];
+
+                if (isset($handlersCache[$prefix])) {
+                    $handler = $handlersCache[$prefix];
+                } else {
+                    $handler = $reader->getHandler($prefix);
+                    $handlersCache[$prefix] = $handler;
+                }
+
+                $list[$i] = $handler->handle($connection, substr($header, 1));
+            }
+        }
+
+        return $list;
+    }
+}

plugins/cache-redis/Predis/Protocol/Text/Handler/ResponseHandlerInterface.php

@@ -0,0 +1,33 @@
+<?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\Protocol\Text\Handler;
+
+use Predis\Connection\CompositeConnectionInterface;
+
+/**
+ * Defines a pluggable handler used to parse a particular type of response.
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+interface ResponseHandlerInterface
+{
+    /**
+     * Deserializes a response returned by Redis and reads more data from the
+     * connection if needed.
+     *
+     * @param CompositeConnectionInterface $connection Redis connection.
+     * @param string                       $payload    String payload.
+     *
+     * @return mixed
+     */
+    public function handle(CompositeConnectionInterface $connection, $payload);
+}

plugins/cache-redis/Predis/Protocol/Text/Handler/StatusResponse.php

@@ -0,0 +1,35 @@
+<?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\Protocol\Text\Handler;
+
+use Predis\Connection\CompositeConnectionInterface;
+use Predis\Response\Status;
+
+/**
+ * Handler for the status response type in the standard Redis wire protocol. It
+ * translates certain classes of status response to PHP objects or just returns
+ * the payload as a string.
+ *
+ * @link http://redis.io/topics/protocol
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+class StatusResponse implements ResponseHandlerInterface
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function handle(CompositeConnectionInterface $connection, $payload)
+    {
+        return Status::get($payload);
+    }
+}

plugins/cache-redis/Predis/Protocol/Text/Handler/StreamableMultiBulkResponse.php

@@ -0,0 +1,47 @@
+<?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\Protocol\Text\Handler;
+
+use Predis\CommunicationException;
+use Predis\Connection\CompositeConnectionInterface;
+use Predis\Protocol\ProtocolException;
+use Predis\Response\Iterator\MultiBulk as MultiBulkIterator;
+
+/**
+ * Handler for the multibulk response type in the standard Redis wire protocol.
+ * It returns multibulk responses as iterators that can stream bulk elements.
+ *
+ * Streamable multibulk responses are not globally supported by the abstractions
+ * built-in into Predis, such as transactions or pipelines. Use them with care!
+ *
+ * @link http://redis.io/topics/protocol
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+class StreamableMultiBulkResponse implements ResponseHandlerInterface
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function handle(CompositeConnectionInterface $connection, $payload)
+    {
+        $length = (int) $payload;
+
+        if ("$length" != $payload) {
+            CommunicationException::handle(new ProtocolException(
+                $connection, "Cannot parse '$payload' as a valid length for a multi-bulk response."
+            ));
+        }
+
+        return new MultiBulkIterator($connection, $length);
+    }
+}