142 lines
3.1 KiB
PHP
142 lines
3.1 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
|
|
namespace KTXF\Mail\Entity;
|
|
|
|
/**
|
|
* Mail Address Implementation
|
|
*
|
|
* Concrete implementation of IAddress for email addresses.
|
|
*
|
|
* @since 2025.05.01
|
|
*/
|
|
class Address implements IAddress {
|
|
|
|
/**
|
|
* @param string $address Email address
|
|
* @param string|null $name Display name
|
|
*/
|
|
public function __construct(
|
|
private string $address = '',
|
|
private ?string $name = null,
|
|
) {}
|
|
|
|
/**
|
|
* Creates an Address from a formatted string
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param string $value Formatted as "Name <address>" or just "address"
|
|
*
|
|
* @return self
|
|
*/
|
|
public static function fromString(string $value): self {
|
|
$value = trim($value);
|
|
|
|
// Match "Name <address>" format
|
|
if (preg_match('/^(.+?)\s*<([^>]+)>$/', $value, $matches)) {
|
|
return new self(trim($matches[2]), trim($matches[1], ' "\''));
|
|
}
|
|
|
|
// Match "<address>" format
|
|
if (preg_match('/^<([^>]+)>$/', $value, $matches)) {
|
|
return new self(trim($matches[1]));
|
|
}
|
|
|
|
// Assume plain address
|
|
return new self($value);
|
|
}
|
|
|
|
/**
|
|
* Creates an Address from an array
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param array $data Array with 'address' and optional 'name' keys
|
|
*
|
|
* @return self
|
|
*/
|
|
public static function fromArray(array $data): self {
|
|
return new self(
|
|
$data[self::JSON_PROPERTY_ADDRESS] ?? $data['address'] ?? '',
|
|
$data[self::JSON_PROPERTY_NAME] ?? $data['name'] ?? null,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function getAddress(): string {
|
|
return $this->address;
|
|
}
|
|
|
|
/**
|
|
* Sets the email address
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param string $address
|
|
*
|
|
* @return self
|
|
*/
|
|
public function setAddress(string $address): self {
|
|
$this->address = $address;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function getName(): ?string {
|
|
return $this->name;
|
|
}
|
|
|
|
/**
|
|
* Sets the display name
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param string|null $name
|
|
*
|
|
* @return self
|
|
*/
|
|
public function setName(?string $name): self {
|
|
$this->name = $name;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function toString(): string {
|
|
if ($this->name !== null && $this->name !== '') {
|
|
return sprintf('"%s" <%s>', $this->name, $this->address);
|
|
}
|
|
return $this->address;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function jsonSerialize(): array {
|
|
return array_filter([
|
|
self::JSON_PROPERTY_ADDRESS => $this->address,
|
|
self::JSON_PROPERTY_NAME => $this->name,
|
|
], fn($v) => $v !== null && $v !== '');
|
|
}
|
|
|
|
/**
|
|
* String representation
|
|
*/
|
|
public function __toString(): string {
|
|
return $this->toString();
|
|
}
|
|
|
|
}
|