Added support for XINFO commands (#1331)

* Codestyle changes related to php-cs-fixer update (#1311)

* Codestyle changes

* Added missing type-hints

* Added GETDEL command to KeyPrefixProcessor (#1306)

* Added GETDEL command to KeyPrefixProcessor

* Added test coverage

* Codestyle fixes

* Added timeout after FT.CREATE call

* Added support for JSON.MERGE command (#1304)

* Added support for JSON.MSET command (#1307)

* Fixed subcommand test bug (#1313)

* Update CHANGELOG.md

* Update CHANGELOG.md

* Added support for XGROUP container commands

* Fixed bug with incorrect multiple words processing (#1325)

* Fixed bug with incorrect multiple words processing

* Convert subcommand string to lower case

* Update SubcommandStrategyResolver.php

* Added test coverage

* Codestyle fixes

---------

Co-authored-by: Till Krüss <tillkruss@users.noreply.github.com>

* Added split words handling

* Fixed command id to be lowercase

* Fixed test decorator

* Added support for XINFO commands

* Changed decorator to corresponding version

* Updated tests to match server response

* Updated test decorators

* Added relay-incompatible decorator

* Updated return type

* Added support for FUNCTION DUMP, FUNCTION FLUSH, FUNCTION RESTORE commands (#1332)

* Remove empty file

* Added missing interface methods

* Removed nullable type

---------

Co-authored-by: Till Krüss <tillkruss@users.noreply.github.com>
Co-authored-by: Chayim <chayim@users.noreply.github.com>

src/ClientInterface.php

@@ -45,6 +45,7 @@ use Predis\Command\Container\Json\JSONDEBUG;
 use Predis\Command\Container\Search\FTCONFIG;
 use Predis\Command\Container\Search\FTCURSOR;
 use Predis\Command\Container\XGROUP;
+use Predis\Command\Container\XINFO;
 use Predis\Command\FactoryInterface;
 use Predis\Configuration\OptionsInterface;
 use Predis\Connection\ConnectionInterface;
@@ -371,6 +372,7 @@ use Predis\Response\Status;
  * @property JSONDEBUG $jsondebug
  * @property ACL       $acl
  * @property XGROUP    $xgroup
+ * @property XINFO     $xinfo
  */
 interface ClientInterface
 {

src/Command/Argument/Stream/XInfoStreamOptions.php

@@ -0,0 +1,49 @@
+<?php
+
+/*
+ * This file is part of the Predis package.
+ *
+ * (c) 2009-2020 Daniele Alessandri
+ * (c) 2021-2023 Till Krüss
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Predis\Command\Argument\Stream;
+
+use Predis\Command\Argument\ArrayableArgument;
+
+class XInfoStreamOptions implements ArrayableArgument
+{
+    /**
+     * @var array
+     */
+    protected $options = [];
+
+    /**
+     * Modifier provides a more verbose reply.
+     * The COUNT option can be used to limit the number of stream and PEL entries that are returned.
+     *
+     * @param  int|null $count
+     * @return self
+     */
+    public function full(int $count = null): self
+    {
+        $this->options[] = 'FULL';
+
+        if (null !== $count) {
+            array_push($this->options, 'COUNT', $count);
+        }
+
+        return $this;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function toArray(): array
+    {
+        return $this->options;
+    }
+}

src/Command/Container/XINFO.php

@@ -0,0 +1,28 @@
+<?php
+
+/*
+ * This file is part of the Predis package.
+ *
+ * (c) 2009-2020 Daniele Alessandri
+ * (c) 2021-2023 Till Krüss
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Predis\Command\Container;
+
+use Predis\Command\Argument\Stream\XInfoStreamOptions;
+
+/**
+ * @method array consumers(string $key, string $group)
+ * @method array groups(string $key)
+ * @method array stream(string $key, XInfoStreamOptions $options = null)
+ */
+class XINFO extends AbstractContainer
+{
+    public function getContainerCommandId(): string
+    {
+        return 'XINFO';
+    }
+}

src/Command/Redis/XINFO.php

@@ -0,0 +1,69 @@
+<?php
+
+/*
+ * This file is part of the Predis package.
+ *
+ * (c) 2009-2020 Daniele Alessandri
+ * (c) 2021-2023 Till Krüss
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Predis\Command\Redis;
+
+use Predis\Command\Argument\ArrayableArgument;
+use Predis\Command\Command as RedisCommand;
+
+class XINFO extends RedisCommand
+{
+    public function getId()
+    {
+        return 'XINFO';
+    }
+
+    public function setArguments(array $arguments)
+    {
+        if ($arguments[0] === 'STREAM') {
+            $this->setStreamArguments($arguments);
+        } else {
+            parent::setArguments($arguments);
+        }
+    }
+
+    /**
+     * @param  array $arguments
+     * @return void
+     */
+    private function setStreamArguments(array $arguments): void
+    {
+        $processedArguments = [$arguments[0], $arguments[1]];
+
+        if (array_key_exists(2, $arguments) && $arguments[2] instanceof ArrayableArgument) {
+            $processedArguments = array_merge($processedArguments, $arguments[2]->toArray());
+        }
+
+        parent::setArguments($processedArguments);
+    }
+
+    public function parseResponse($data)
+    {
+        $result = [];
+
+        for ($i = 0, $iMax = count($data); $i < $iMax; $i++) {
+            if (is_array($data[$i])) {
+                $result[$i] = $this->parseResponse($data[$i]);
+            }
+
+            if (array_key_exists($i + 1, $data)) {
+                if (is_array($data[$i + 1])) {
+                    $result[$data[$i]] = $this->parseResponse($data[++$i]);
+                } else {
+                    $result[$data[$i]] = $data[++$i];
+                }
+            }
+        }
+
+        return $result;
+    }
+}