ServerUrlList.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\LDAP\Server;
 
use Generator;
use ILIAS\Data\URI;
 
class ServerUrlList implements \Stringable
{
    private array $entries;
 
    public function __construct(array $entries = [])
    {
        $this->entries = array_values($entries);
    }
 
    public static function fromString(string $stored): self
    {
        $stored = trim($stored);
        if ($stored === '') {
            return new self([]);
        }
 
        $parts = array_map(
            static fn(string $s): string => trim($s),
            explode(',', $stored)
        );
 
        $entries = [];
        foreach ($parts as $part) {
            if ($part === '') {
                continue;
            }
 
            try {
                $entries[] = new URI($part);
            } catch (\Throwable) {
                $entries[] = $part;
            }
        }
 
        return new self($entries);
    }
 
    public function count(): int
    {
        return \count($this->entries);
    }
 
    public function getConnectionStringAtIndex(int $index): string
    {
        if ($index < 0 || !\array_key_exists($index, $this->entries)) {
            return '';
        }
 
        $el = $this->entries[$index];
 
        return (string) $el;
    }
 
    public function toString(): string
    {
        $strings = array_map(
            static fn(URI|string $el): string => $el instanceof URI ? (string) $el : (string) $el,
            $this->entries
        );
 
        return implode(',', $strings);
    }
 
    public function __toString(): string
    {
        return $this->toString();
    }
 
    public function getInvalidParts(): array
    {
        $invalid = [];
        foreach ($this->entries as $el) {
            if (!($el instanceof URI)) {
                $invalid[] = $el;
            }
        }
 
        return $invalid;
    }
 
    public function rotate(): self
    {
        if (\count($this->entries) < 2) {
            return $this;
        }
 
        $rotated = array_merge(
            \array_slice($this->entries, 1),
            [$this->entries[0]]
        );
 
        return new self($rotated);
    }
 
    public function withPrimaryAt(int $index): self
    {
        if ($index < 0 || !\array_key_exists($index, $this->entries)) {
            return $this;
        }
 
        $entry = $this->entries[$index];
        $rest = array_merge(
            \array_slice($this->entries, 0, $index),
            \array_slice($this->entries, $index + 1)
        );
 
        return new self(array_merge([$entry], $rest));
    }
 
    public function validUrls(): Generator
    {
        foreach ($this->entries as $index => $entry) {
            if ($entry instanceof URI) {
                yield $index => $entry;
            }
        }
    }
}