1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
<?php
declare(strict_types=1);
/**
* @copyright 2017 Christoph Wurst <christoph@winzerhof-wurst.at>
*
* @author 2017 Christoph Wurst <christoph@winzerhof-wurst.at>
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
namespace OCA\Mail;
use Horde_Mail_Rfc822_Address;
use JsonSerializable;
/**
* @psalm-immutable
*/
class Address implements JsonSerializable {
public const TYPE_FROM = 0;
public const TYPE_TO = 1;
public const TYPE_CC = 2;
public const TYPE_BCC = 3;
/** @var Horde_Mail_Rfc822_Address */
private $wrapped;
private function __construct(Horde_Mail_Rfc822_Address $wrapped) {
$this->wrapped = $wrapped;
}
public static function fromHorde(Horde_Mail_Rfc822_Address $horde): self {
return new self($horde);
}
public static function fromRaw(string $label, string $email): self {
$wrapped = new Horde_Mail_Rfc822_Address($email);
// If no label is set we use the email
if ($label !== $email) {
$wrapped->personal = $label;
}
return new self($wrapped);
}
/**
* @return string|null
*/
public function getLabel(): ?string {
$personal = $this->wrapped->personal;
if ($personal === null) {
// Fallback
return $this->getEmail();
}
return $personal;
}
/**
* @return string|null
*/
public function getEmail(): ?string {
$email = $this->wrapped->bare_address;
if ($email === null) {
return null;
}
// Lets make sure the e-mail is valid UTF-8 at all times
// Try a soft conversion first (some installations, eg: Alpine linux,
// have issues with the '//IGNORE' option)
$utf8 = iconv('UTF-8', 'UTF-8', $email);
if ($utf8 !== false) {
return $utf8;
}
$utf8 = iconv("UTF-8", "UTF-8//IGNORE", $email);
if ($utf8 === false) {
throw new \Exception("Email address <$email> could not be converted via iconv");
}
return $utf8;
}
/**
* @return Horde_Mail_Rfc822_Address
*/
public function toHorde(): Horde_Mail_Rfc822_Address {
return $this->wrapped;
}
/**
* @return array
*/
public function jsonSerialize(): array {
return [
'label' => $this->getLabel(),
'email' => $this->getEmail(),
];
}
/**
* @param Address $object
* @return boolean
*/
public function equals($object): bool {
return $this->getEmail() === $object->getEmail()
&& $this->getLabel() === $object->getLabel();
}
}
|
