Обновление клиента (apps, 3rdparty, install)

2026-03-16 08:42:57 +00:00
parent b8905de237
commit f390426546
3354 changed files with 505213 additions and 3 deletions
@@ -0,0 +1,155 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SpomkyLabs\Pki\CryptoEncoding;
+
+use ArrayIterator;
+use Countable;
+use IteratorAggregate;
+use LogicException;
+use RuntimeException;
+use Stringable;
+use UnexpectedValueException;
+use function count;
+use function is_string;
+use const PREG_SET_ORDER;
+
+/**
+ * Container for multiple PEM objects.
+ *
+ * The order of PEMs shall be retained, eg. when read from a file.
+ */
+final class PEMBundle implements Countable, IteratorAggregate, Stringable
+{
+    /**
+     * Array of PEM objects.
+     *
+     * @var PEM[]
+     */
+    private array $pems;
+
+    private function __construct(PEM ...$pems)
+    {
+        $this->pems = $pems;
+    }
+
+    public function __toString(): string
+    {
+        return $this->string();
+    }
+
+    public static function create(PEM ...$pems): self
+    {
+        return new self(...$pems);
+    }
+
+    /**
+     * Initialize from a string.
+     */
+    public static function fromString(string $str): self
+    {
+        $hasMatches = preg_match_all(PEM::PEM_REGEX, $str, $matches, PREG_SET_ORDER);
+        if ($hasMatches === false || $hasMatches === 0) {
+            throw new UnexpectedValueException('No PEM blocks.');
+        }
+        $pems = array_map(
+            static function ($match) {
+                $payload = preg_replace('/\s+/', '', $match[2]);
+                if (! is_string($payload)) {
+                    throw new UnexpectedValueException('Failed to decode PEM data.');
+                }
+                $data = base64_decode($payload, true);
+                if ($data === false) {
+                    throw new UnexpectedValueException('Failed to decode PEM data.');
+                }
+                return PEM::create($match[1], $data);
+            },
+            $matches
+        );
+        return self::create(...$pems);
+    }
+
+    /**
+     * Initialize from a file.
+     */
+    public static function fromFile(string $filename): self
+    {
+        if (! is_readable($filename)) {
+            throw new RuntimeException("Failed to read {$filename}.");
+        }
+        $str = file_get_contents($filename);
+        if ($str === false) {
+            throw new RuntimeException("Failed to read {$filename}.");
+        }
+        return self::fromString($str);
+    }
+
+    /**
+     * Get self with PEM objects appended.
+     */
+    public function withPEMs(PEM ...$pems): self
+    {
+        $obj = clone $this;
+        $obj->pems = array_merge($obj->pems, $pems);
+        return $obj;
+    }
+
+    /**
+     * Get all PEMs in a bundle.
+     *
+     * @return PEM[]
+     */
+    public function all(): array
+    {
+        return $this->pems;
+    }
+
+    /**
+     * Get the first PEM in a bundle.
+     */
+    public function first(): PEM
+    {
+        if (count($this->pems) === 0) {
+            throw new LogicException('No PEMs.');
+        }
+        return $this->pems[0];
+    }
+
+    /**
+     * Get the last PEM in a bundle.
+     */
+    public function last(): PEM
+    {
+        if (count($this->pems) === 0) {
+            throw new LogicException('No PEMs.');
+        }
+        return $this->pems[count($this->pems) - 1];
+    }
+
+    /**
+     * @see \Countable::count()
+     */
+    public function count(): int
+    {
+        return count($this->pems);
+    }
+
+    /**
+     * Get iterator for PEMs.
+     *
+     * @see \IteratorAggregate::getIterator()
+     */
+    public function getIterator(): ArrayIterator
+    {
+        return new ArrayIterator($this->pems);
+    }
+
+    /**
+     * Encode bundle to a string of contiguous PEM blocks.
+     */
+    public function string(): string
+    {
+        return implode("\n", array_map(static fn (PEM $pem) => $pem->string(), $this->pems));
+    }
+}