Added support for PEXPIRETIME command (#1031)

Co-authored-by: Vladyslav Vildanov <vladyslavvildanov@Vladyslav-Vildanov-MacBook-Pro.local>

src/ClientContextInterface.php

@@ -153,6 +153,7 @@ use Predis\Command\CommandInterface;
  * @method $this zrevrangebylex($key, $start, $stop, array $options = null)
  * @method $this zremrangebylex($key, $min, $max)
  * @method $this zlexcount($key, $min, $max)
+ * @method $this pexpiretime(string $key)
  * @method $this pfadd($key, array $elements)
  * @method $this pfmerge($destinationKey, array|string $sourceKeys)
  * @method $this pfcount(array|string $keys)

src/ClientInterface.php

@@ -171,6 +171,7 @@ use Predis\Response\Status;
  * @method array             zrevrangebylex(string $key, string $start, string $stop, array $options = null)
  * @method int               zremrangebylex(string $key, string $min, string $max)
  * @method int               zlexcount(string $key, string $min, string $max)
+ * @method int               pexpiretime(string $key)
  * @method int               pfadd(string $key, array $elements)
  * @method mixed             pfmerge(string $destinationKey, array|string $sourceKeys)
  * @method int               pfcount(string[]|string $keyOrKeys, string ...$keys = null)

src/Command/Redis/PEXPIRETIME.php

@@ -0,0 +1,29 @@
+<?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\Command as RedisCommand;
+
+/**
+ * @see https://redis.io/commands/pexpiretime/
+ *
+ * PEXPIRETIME has the same semantic as EXPIRETIME,
+ * but returns the absolute Unix expiration timestamp in milliseconds instead of seconds.
+ */
+class PEXPIRETIME extends RedisCommand
+{
+    public function getId()
+    {
+        return 'PEXPIRETIME';
+    }
+}

tests/Predis/Command/Redis/PEXPIRETIME_Test.php

@@ -0,0 +1,77 @@
+<?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;
+
+/**
+ * @group commands
+ * @group realm-keys
+ */
+class PEXPIRETIME_Test extends PredisCommandTestCase
+{
+    /**
+     * {@inheritdoc}
+     */
+    protected function getExpectedCommand(): string
+    {
+        return PEXPIRETIME::class;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    protected function getExpectedId(): string
+    {
+        return 'PEXPIRETIME';
+    }
+
+    /**
+     * @group disconnected
+     */
+    public function testFilterArguments(): void
+    {
+        $arguments = ['key'];
+        $expected = ['key'];
+
+        $command = $this->getCommand();
+        $command->setArguments($arguments);
+
+        $this->assertSame($expected, $command->getArguments());
+    }
+
+    /**
+     * @group disconnected
+     */
+    public function testParseResponse(): void
+    {
+        $this->assertSame(1, $this->getCommand()->parseResponse(1));
+    }
+
+    /**
+     * @group connected
+     * @return void
+     * @requiresRedisVersion >= 7.0.0
+     */
+    public function testReturnsCorrectExpirationTimeForGivenKey(): void
+    {
+        $redis = $this->getClient();
+        $expirationTime = time() * 1000 + 1000;
+
+        $redis->set('key', 'value');
+        $redis->set('key1', 'value');
+        $redis->pexpireat('key', $expirationTime);
+
+        $this->assertSame($expirationTime, $redis->pexpiretime('key'));
+        $this->assertSame(-1, $redis->pexpiretime('key1'));
+        $this->assertSame(-2, $redis->pexpiretime('non-existing key'));
+    }
+}