|
1
|
|
|
<?php |
|
2
|
|
|
/** |
|
3
|
|
|
* This file is part of the ZBateson\MailMimeParser project. |
|
4
|
|
|
* |
|
5
|
|
|
* @license http://opensource.org/licenses/bsd-license.php BSD |
|
6
|
|
|
*/ |
|
7
|
|
|
|
|
8
|
|
|
namespace ZBateson\MailMimeParser\Message; |
|
9
|
|
|
|
|
10
|
|
|
use AppendIterator; |
|
11
|
|
|
use ArrayIterator; |
|
12
|
|
|
use Iterator; |
|
13
|
|
|
use Psr\Log\LoggerInterface; |
|
14
|
|
|
use RecursiveIterator; |
|
15
|
|
|
use RecursiveIteratorIterator; |
|
16
|
|
|
|
|
17
|
|
|
/** |
|
18
|
|
|
* A message part that contains children. |
|
19
|
|
|
* |
|
20
|
|
|
* @author Zaahid Bateson |
|
21
|
|
|
*/ |
|
22
|
|
|
abstract class MultiPart extends MessagePart implements IMultiPart |
|
23
|
|
|
{ |
|
24
|
|
|
/** |
|
25
|
|
|
* @var PartChildrenContainer child part container |
|
26
|
|
|
*/ |
|
27
|
|
|
protected PartChildrenContainer $partChildrenContainer; |
|
28
|
|
|
|
|
29
|
141 |
|
public function __construct( |
|
30
|
|
|
LoggerInterface $logger, |
|
31
|
|
|
PartStreamContainer $streamContainer, |
|
32
|
|
|
PartChildrenContainer $partChildrenContainer, |
|
33
|
|
|
?IMimePart $parent = null |
|
34
|
|
|
) { |
|
35
|
141 |
|
parent::__construct($logger, $streamContainer, $parent); |
|
36
|
141 |
|
$this->partChildrenContainer = $partChildrenContainer; |
|
37
|
|
|
} |
|
38
|
|
|
|
|
39
|
111 |
|
private function getAllPartsIterator() : AppendIterator |
|
40
|
|
|
{ |
|
41
|
111 |
|
$iter = new AppendIterator(); |
|
42
|
111 |
|
$iter->append(new ArrayIterator([$this])); |
|
43
|
111 |
|
$iter->append(new RecursiveIteratorIterator($this->partChildrenContainer, RecursiveIteratorIterator::SELF_FIRST)); |
|
44
|
111 |
|
return $iter; |
|
45
|
|
|
} |
|
46
|
|
|
|
|
47
|
101 |
|
private function iteratorFindAt(Iterator $iter, int $index, ?callable $fnFilter = null) : ?IMessagePart |
|
48
|
|
|
{ |
|
49
|
101 |
|
$pos = 0; |
|
50
|
101 |
|
foreach ($iter as $part) { |
|
51
|
101 |
|
if (($fnFilter === null || $fnFilter($part))) { |
|
52
|
101 |
|
if ($index === $pos) { |
|
53
|
101 |
|
return $part; |
|
54
|
|
|
} |
|
55
|
26 |
|
++$pos; |
|
56
|
|
|
} |
|
57
|
|
|
} |
|
58
|
18 |
|
return null; |
|
59
|
|
|
} |
|
60
|
|
|
|
|
61
|
90 |
|
public function getPart(int $index, ?callable $fnFilter = null) : ?IMessagePart |
|
62
|
|
|
{ |
|
63
|
90 |
|
return $this->iteratorFindAt( |
|
64
|
90 |
|
$this->getAllPartsIterator(), |
|
65
|
90 |
|
$index, |
|
66
|
90 |
|
$fnFilter |
|
67
|
90 |
|
); |
|
68
|
|
|
} |
|
69
|
|
|
|
|
70
|
103 |
|
public function getAllParts(?callable $fnFilter = null) : array |
|
71
|
|
|
{ |
|
72
|
103 |
|
$array = \iterator_to_array($this->getAllPartsIterator(), false); |
|
73
|
103 |
|
if ($fnFilter !== null) { |
|
74
|
64 |
|
return \array_values(\array_filter($array, $fnFilter)); |
|
75
|
|
|
} |
|
76
|
79 |
|
return $array; |
|
77
|
|
|
} |
|
78
|
|
|
|
|
79
|
4 |
|
public function getPartCount(?callable $fnFilter = null) : int |
|
80
|
|
|
{ |
|
81
|
4 |
|
return \count($this->getAllParts($fnFilter)); |
|
82
|
|
|
} |
|
83
|
|
|
|
|
84
|
25 |
|
public function getChild(int $index, ?callable $fnFilter = null) : ?IMessagePart |
|
85
|
|
|
{ |
|
86
|
25 |
|
return $this->iteratorFindAt( |
|
87
|
25 |
|
$this->partChildrenContainer, |
|
88
|
25 |
|
$index, |
|
89
|
25 |
|
$fnFilter |
|
90
|
25 |
|
); |
|
91
|
|
|
} |
|
92
|
|
|
|
|
93
|
80 |
|
public function getChildIterator() : RecursiveIterator |
|
94
|
|
|
{ |
|
95
|
80 |
|
return $this->partChildrenContainer; |
|
96
|
|
|
} |
|
97
|
|
|
|
|
98
|
103 |
|
public function getChildParts(?callable $fnFilter = null) : array |
|
99
|
|
|
{ |
|
100
|
103 |
|
$array = \iterator_to_array($this->partChildrenContainer, false); |
|
101
|
103 |
|
if ($fnFilter !== null) { |
|
102
|
3 |
|
return \array_values(\array_filter($array, $fnFilter)); |
|
103
|
|
|
} |
|
104
|
102 |
|
return $array; |
|
105
|
|
|
} |
|
106
|
|
|
|
|
107
|
99 |
|
public function getChildCount(?callable $fnFilter = null) : int |
|
108
|
|
|
{ |
|
109
|
99 |
|
return \count($this->getChildParts($fnFilter)); |
|
110
|
|
|
} |
|
111
|
|
|
|
|
112
|
2 |
|
public function getPartByMimeType(string $mimeType, int $index = 0) : ?IMessagePart |
|
113
|
|
|
{ |
|
114
|
2 |
|
return $this->getPart($index, PartFilter::fromContentType($mimeType)); |
|
115
|
|
|
} |
|
116
|
|
|
|
|
117
|
1 |
|
public function getAllPartsByMimeType(string $mimeType) : array |
|
118
|
|
|
{ |
|
119
|
1 |
|
return $this->getAllParts(PartFilter::fromContentType($mimeType)); |
|
120
|
|
|
} |
|
121
|
|
|
|
|
122
|
1 |
|
public function getCountOfPartsByMimeType(string $mimeType) : int |
|
123
|
|
|
{ |
|
124
|
1 |
|
return $this->getPartCount(PartFilter::fromContentType($mimeType)); |
|
125
|
|
|
} |
|
126
|
|
|
|
|
127
|
2 |
|
public function getPartByContentId(string $contentId) : ?IMessagePart |
|
128
|
|
|
{ |
|
129
|
2 |
|
$sanitized = \preg_replace('/^\s*<|>\s*$/', '', $contentId); |
|
130
|
2 |
|
return $this->getPart(0, function(IMessagePart $part) use ($sanitized) { |
|
|
|
|
|
|
131
|
2 |
|
$cid = $part->getContentId(); |
|
132
|
2 |
|
return ($cid !== null && \strcasecmp($cid, $sanitized) === 0); |
|
133
|
2 |
|
}); |
|
134
|
|
|
} |
|
135
|
|
|
|
|
136
|
23 |
|
public function addChild(MessagePart $part, ?int $position = null) : static |
|
137
|
|
|
{ |
|
138
|
23 |
|
if ($part !== $this) { |
|
|
|
|
|
|
139
|
23 |
|
$part->parent = $this; |
|
|
|
|
|
|
140
|
23 |
|
$this->partChildrenContainer->add($part, $position); |
|
141
|
23 |
|
$this->notify(); |
|
142
|
|
|
} |
|
143
|
23 |
|
return $this; |
|
144
|
|
|
} |
|
145
|
|
|
|
|
146
|
20 |
|
public function removePart(IMessagePart $part) : ?int |
|
147
|
|
|
{ |
|
148
|
20 |
|
$parent = $part->getParent(); |
|
149
|
20 |
|
if ($this !== $parent && $parent !== null) { |
|
150
|
6 |
|
return $parent->removePart($part); |
|
151
|
|
|
} |
|
152
|
|
|
|
|
153
|
20 |
|
$position = $this->partChildrenContainer->remove($part); |
|
154
|
20 |
|
if ($position !== null) { |
|
155
|
20 |
|
$this->notify(); |
|
156
|
|
|
} |
|
157
|
20 |
|
return $position; |
|
158
|
|
|
} |
|
159
|
|
|
|
|
160
|
3 |
|
public function removeAllParts(?callable $fnFilter = null) : int |
|
161
|
|
|
{ |
|
162
|
3 |
|
$parts = $this->getAllParts($fnFilter); |
|
163
|
3 |
|
$count = \count($parts); |
|
164
|
3 |
|
foreach ($parts as $part) { |
|
165
|
3 |
|
if ($part === $this) { |
|
166
|
2 |
|
--$count; |
|
167
|
2 |
|
continue; |
|
168
|
|
|
} |
|
169
|
3 |
|
$this->removePart($part); |
|
170
|
|
|
} |
|
171
|
3 |
|
return $count; |
|
172
|
|
|
} |
|
173
|
|
|
|
|
174
|
1 |
|
protected function getErrorBagChildren() : array |
|
175
|
|
|
{ |
|
176
|
1 |
|
return \array_merge(parent::getErrorBagChildren(), $this->getChildParts()); |
|
177
|
|
|
} |
|
178
|
|
|
} |
|
179
|
|
|
|