Loheide-eu-mitarbeiterplatt.../vendor/league/uri-components/Components/Authority.php
Friederich Loheide 9c0f8de791
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m14s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m12s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m7s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m19s
CI / PHP 8.3 / mysql:8.0 (pull_request) Successful in 1m32s
CI / PHP 8.4 / mysql:8.0 (pull_request) Successful in 1m22s
CI / PHP 8.4 / mysql:8.4 (pull_request) Successful in 1m32s
CI / PHP 8.3 / mysql:8.4 (pull_request) Successful in 1m35s
CI / Build-Artefakte aktuell (pull_request) Failing after 1m7s
Phase 0: Fundament für Inhaus
- Laravel 13 mit Filament 5 (Admin), Inertia 3 + Vue 3 + Vuetify 4 (Material 3)
- Anmeldung über Fortify (Login, Passwort vergessen/ändern), keine Selbstregistrierung
- Profil mit Profilbild (WebP in festen Größen), Personenseiten, Header mit Avatar-Menü
- Material-3-Farbschema aus der Primärfarbe, hell/dunkel/System pro Person
- Basis-Branding (Portalname, Logo, Primärfarbe) im Admin unter „Erscheinungsbild“
- Benutzerverwaltung im Admin, Zugang vorläufig über is_admin
- vendor/ (ohne Dev-Pakete) und Frontend-Build mitversioniert, Dev-Pakete in vendor-dev/
- PHPUnit-Tests gegen MySQL/MariaDB, Forgejo-CI-Matrix, Docker-Entwicklungsumgebung
- VERSION, CHANGELOG.md und CONTRIBUTING.md mit Release-Ablauf

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-25 20:35:30 +00:00

321 lines
9.7 KiB
PHP

<?php
/**
* League.Uri (https://uri.thephpleague.com)
*
* (c) Ignace Nyamagana Butera <nyamsprod@gmail.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
declare(strict_types=1);
namespace League\Uri\Components;
use BackedEnum;
use Deprecated;
use League\Uri\Contracts\AuthorityInterface;
use League\Uri\Contracts\HostInterface;
use League\Uri\Contracts\PortInterface;
use League\Uri\Contracts\UriComponentInterface;
use League\Uri\Contracts\UriException;
use League\Uri\Contracts\UriInterface;
use League\Uri\Contracts\UserInfoInterface;
use League\Uri\Exceptions\SyntaxError;
use League\Uri\StringCoercionMode;
use League\Uri\UriString;
use Psr\Http\Message\UriInterface as Psr7UriInterface;
use SensitiveParameter;
use Stringable;
use Uri\Rfc3986\Uri as Rfc3986Uri;
use Uri\WhatWg\Url as WhatWgUrl;
final class Authority extends Component implements AuthorityInterface
{
private readonly HostInterface $host;
private readonly PortInterface $port;
private readonly UserInfoInterface $userInfo;
public function __construct(
BackedEnum|Stringable|string|null $host,
BackedEnum|Stringable|string|int|null $port = null,
#[SensitiveParameter] BackedEnum|Stringable|string|null $userInfo = null
) {
$this->host = !$host instanceof HostInterface ? Host::new($host) : $host;
$this->port = !$port instanceof PortInterface ? Port::new($port) : $port;
$this->userInfo = !$userInfo instanceof UserInfoInterface ? UserInfo::new($userInfo) : $userInfo;
if (null === $this->host->value() && null !== $this->value()) {
throw new SyntaxError('A non-empty authority must contains a non null host.');
}
}
/**
* @throws SyntaxError If the component contains invalid HostInterface part.
*/
public static function new(BackedEnum|Stringable|string|null $value = null): self
{
$components = UriString::parseAuthority(self::filterComponent($value));
return new self(
Host::new($components['host']),
Port::new($components['port']),
new UserInfo(
$components['user'],
$components['pass']
)
);
}
/**
* Create a new instance from a string.or a stringable structure or returns null on failure.
*/
public static function tryNew(BackedEnum|Stringable|string|null $uri = null): ?self
{
try {
return self::new($uri);
} catch (UriException) {
return null;
}
}
/**
* Create a new instance from a URI object.
*/
public static function fromUri(WhatwgUrl|Rfc3986Uri|BackedEnum|Stringable|string $uri): self
{
$uri = self::filterUri($uri);
if ($uri instanceof Rfc3986Uri) {
return new self($uri->getHost(), $uri->getPort(), $uri->getUserInfo());
}
if ($uri instanceof WhatWgUrl) {
$userInfo = $uri->getUsername();
if (null !== ($password = $uri->getPassword())) {
$userInfo .= ':'.$password;
}
return new self($uri->getUnicodeHost(), $uri->getPort(), $userInfo);
}
if ($uri instanceof Psr7UriInterface) {
$components = UriString::parse($uri);
$userInfo = $components['user'];
if (null !== ($password = $components['pass'])) {
$userInfo .= ':'.$password;
}
return new self($components['host'], $components['port'], $userInfo);
}
return self::new($uri->getAuthority());
}
/**
* Create a new instance from a hash of parse_url parts.
*
* Create a new instance from a hash representation of the URI similar
* to PHP parse_url function result
*
* @param array{
* user? : ?string,
* pass? : ?string,
* host? : ?string,
* port? : ?int
* } $components
*/
public static function fromComponents(array $components): self
{
$components += ['user' => null, 'pass' => null, 'host' => null, 'port' => null];
return match (true) {
null === $components['user'] => new self($components['host'], $components['port']),
null === $components['pass'] => new self($components['host'], $components['port'], $components['user']),
default => new self($components['host'], $components['port'], $components['user'].':'.$components['pass']),
};
}
public function value(): ?string
{
return self::getAuthorityValue($this->userInfo, $this->host, $this->port);
}
private static function getAuthorityValue(
UserInfoInterface $userInfo,
HostInterface $host,
PortInterface $port
): ?string {
$auth = $host->value();
$port = $port->value();
if (null !== $port) {
$auth .= ':'.$port;
}
$userInfo = $userInfo->value();
return match (null) {
$userInfo => $auth,
default => $userInfo.'@'.$auth,
};
}
public function getUriComponent(): string
{
return match (null) {
$this->host->value() => $this->toString(),
default => '//'.$this->toString(),
};
}
public function getHost(): ?string
{
return $this->host->value();
}
public function getPort(): ?int
{
return $this->port->toInt();
}
public function getUserInfo(): ?string
{
return $this->userInfo->value();
}
public function equals(mixed $value): bool
{
if (!StringCoercionMode::Native->isCoercible($value)) {
return false;
}
if (!$value instanceof UriComponentInterface) {
$value = self::tryNew(StringCoercionMode::Native->coerce($value));
if (null === $value) {
return false;
}
}
return $value->getUriComponent() === $this->getUriComponent();
}
/**
* @return array{user: ?string, pass: ?string, host: ?string, port: ?int}
*/
public function components(): array
{
return $this->userInfo->components() + [
'host' => $this->host->value(),
'port' => $this->port->toInt(),
];
}
public function withHost(BackedEnum|Stringable|string|null $host): AuthorityInterface
{
if (!$host instanceof HostInterface) {
$host = Host::new($host);
}
return match ($this->host->value()) {
$host->value() => $this,
default => new self($host, $this->port, $this->userInfo),
};
}
public function withPort(BackedEnum|Stringable|string|int|null $port): AuthorityInterface
{
if (!$port instanceof PortInterface) {
$port = Port::new($port);
}
return match ($this->port->value()) {
$port->value() => $this,
default => new self($this->host, $port, $this->userInfo),
};
}
public function withUserInfo(
BackedEnum|Stringable|string|null $user,
#[SensitiveParameter] BackedEnum|Stringable|string|null $password = null
): AuthorityInterface {
$userInfo = new UserInfo($user, $password);
return match ($this->userInfo->value()) {
$userInfo->value() => $this,
default => new self($this->host, $this->port, $userInfo),
};
}
/**
* DEPRECATION WARNING! This method will be removed in the next major point release.
*
* @deprecated Since version 7.0.0
* @see Authority::fromUri()
*
* @codeCoverageIgnore
*
* Create a new instance from a URI object.
*/
#[Deprecated(message:'use League\Uri\Components\Authority::fromUri() instead', since:'league/uri-components:7.0.0')]
public static function createFromUri(UriInterface|Psr7UriInterface $uri): self
{
return self::fromUri($uri);
}
/**
* DEPRECATION WARNING! This method will be removed in the next major point release.
*
* @deprecated Since version 7.0.0
* @see Authority::new()
*
* @codeCoverageIgnore
*
* Returns a new instance from a string or a stringable object.
*/
#[Deprecated(message:'use League\Uri\Components\Authority::new() instead', since:'league/uri-components:7.0.0')]
public static function createFromString(Stringable|string $authority): self
{
return self::new($authority);
}
/**
* DEPRECATION WARNING! This method will be removed in the next major point release.
*
* @deprecated Since version 7.0.0
* @see Authority::new()
*
* @codeCoverageIgnore
*
* Returns a new instance from null.
*/
#[Deprecated(message:'use League\Uri\Components\Authority::new() instead', since:'league/uri-components:7.0.0')]
public static function createFromNull(): self
{
return self::new();
}
/**
* DEPRECATION WARNING! This method will be removed in the next major point release.
*
* @deprecated Since version 7.0.0
* @see Authority::fromComponents()
*
* @codeCoverageIgnore
*
* Create a new instance from a hash of parse_url parts.
*
* Create a new instance from a hash representation of the URI similar
* to PHP parse_url function result
*
* @param array{
* user? : ?string,
* pass? : ?string,
* host? : ?string,
* port? : ?int
* } $components
*/
#[Deprecated(message:'use League\Uri\Components\Authority::fromComponents() instead', since:'league/uri-components:7.0.0')]
public static function createFromComponents(array $components): self
{
return self::fromComponents($components);
}
}