Retwis ported to modern Redis data types.

The example (and related documentation at redis.io) was not updated for
5 years. Redis had no sorted sets and hashes when the original code was
written (!). An update was really needed.

We also use a modern PHP client now: Predis. A copy is shipped within
this repository to make life easier to newcomers trying Redis for the
first time via this example.

Predis/Connection/ConnectionParameters.php

@@ -0,0 +1,183 @@
+<?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\ClientException;
+
+/**
+ * Handles parsing and validation of connection parameters.
+ *
+ * @author Daniele Alessandri <suppakilla@gmail.com>
+ */
+class ConnectionParameters implements ConnectionParametersInterface
+{
+    private $parameters;
+
+    private static $defaults = array(
+        'scheme' => 'tcp',
+        'host' => '127.0.0.1',
+        'port' => 6379,
+        'timeout' => 5.0,
+    );
+
+    /**
+     * @param string|array $parameters Connection parameters in the form of an URI string or a named array.
+     */
+    public function __construct($parameters = array())
+    {
+        if (!is_array($parameters)) {
+            $parameters = self::parseURI($parameters);
+        }
+
+        $this->parameters = $this->filter($parameters) + $this->getDefaults();
+    }
+
+    /**
+     * Returns some default parameters with their values.
+     *
+     * @return array
+     */
+    protected function getDefaults()
+    {
+        return self::$defaults;
+    }
+
+    /**
+     * Returns cast functions for user-supplied parameter values.
+     *
+     * @return array
+     */
+    protected function getValueCasters()
+    {
+        return array(
+            'port' => 'self::castInteger',
+            'async_connect' => 'self::castBoolean',
+            'persistent' => 'self::castBoolean',
+            'timeout' => 'self::castFloat',
+            'read_write_timeout' => 'self::castFloat',
+            'iterable_multibulk' => 'self::castBoolean',
+        );
+    }
+
+    /**
+     * Validates value as boolean.
+     *
+     * @param  mixed $value Input value.
+     * @return bool
+     */
+    private static function castBoolean($value)
+    {
+        return (bool) $value;
+    }
+
+    /**
+     * Validates value as float.
+     *
+     * @param  mixed $value Input value.
+     * @return float
+     */
+    private static function castFloat($value)
+    {
+        return (float) $value;
+    }
+
+    /**
+     * Validates value as integer.
+     *
+     * @param  mixed $value Input value.
+     * @return int
+     */
+    private static function castInteger($value)
+    {
+        return (int) $value;
+    }
+
+    /**
+     * Parses an URI string and returns an array of connection parameters.
+     *
+     * @param  string $uri Connection string.
+     * @return array
+     */
+    public static function parseURI($uri)
+    {
+        if (stripos($uri, 'unix') === 0) {
+            // Hack to support URIs for UNIX sockets with minimal effort.
+            $uri = str_ireplace('unix:///', 'unix://localhost/', $uri);
+        }
+
+        if (!($parsed = @parse_url($uri)) || !isset($parsed['host'])) {
+            throw new ClientException("Invalid URI: $uri");
+        }
+
+        if (isset($parsed['query'])) {
+            parse_str($parsed['query'], $queryarray);
+            unset($parsed['query']);
+
+            $parsed = array_merge($parsed, $queryarray);
+        }
+
+        return $parsed;
+    }
+
+    /**
+     * Validates and converts each value of the connection parameters array.
+     *
+     * @param  array $parameters Connection parameters.
+     * @return array
+     */
+    private function filter(Array $parameters)
+    {
+        if ($parameters) {
+            $casters = array_intersect_key($this->getValueCasters(), $parameters);
+
+            foreach ($casters as $parameter => $caster) {
+                $parameters[$parameter] = call_user_func($caster, $parameters[$parameter]);
+            }
+        }
+
+        return $parameters;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function __get($parameter)
+    {
+        if (isset($this->{$parameter})) {
+            return $this->parameters[$parameter];
+        }
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function __isset($parameter)
+    {
+        return isset($this->parameters[$parameter]);
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function toArray()
+    {
+        return $this->parameters;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function __sleep()
+    {
+        return array('parameters');
+    }
+}