Files
itflow/libs/vendor/zbateson/mail-mime-parser/src/Stream/HeaderStream.php

102 lines
2.9 KiB
PHP

<?php
/**
* This file is part of the ZBateson\MailMimeParser project.
*
* @license http://opensource.org/licenses/bsd-license.php BSD
*/
namespace ZBateson\MailMimeParser\Stream;
use ArrayIterator;
use GuzzleHttp\Psr7;
use Psr\Http\Message\StreamInterface;
use SplObserver;
use SplSubject;
use Traversable;
use ZBateson\MailMimeParser\Header\HeaderConsts;
use ZBateson\MailMimeParser\Message\IMessagePart;
use ZBateson\MailMimeParser\Message\IMimePart;
/**
* Psr7 stream decorator implementation providing a readable stream for a part's
* headers.
*
* HeaderStream is only used by a MimePart parent. It can accept any
* MessagePart - for non-MimeParts, only type headers are generated based on
* available information.
*
* @author Zaahid Bateson
*/
class HeaderStream extends MessagePartStreamDecorator implements SplObserver, StreamInterface
{
/**
* @var IMessagePart the part to read from.
*/
protected IMessagePart $part;
public function __construct(IMessagePart $part)
{
parent::__construct($part);
$part->attach($this);
// unsetting the property forces the first access to go through
// __get().
unset($this->stream);
}
public function __destruct()
{
$this->part->detach($this);
}
public function update(SplSubject $subject) : void
{
if ($this->stream !== null) {
$this->stream = $this->createStream();
}
}
/**
* Returns a header array for the current part.
*
* If the part is not a MimePart, Content-Type, Content-Disposition and
* Content-Transfer-Encoding headers are generated manually.
*/
private function getPartHeadersIterator() : Traversable
{
if ($this->part instanceof IMimePart) {
return $this->part->getRawHeaderIterator();
} elseif ($this->part->getParent() !== null && $this->part->getParent()->isMime()) {
return new ArrayIterator([
[HeaderConsts::CONTENT_TYPE, $this->part->getContentType()],
[HeaderConsts::CONTENT_DISPOSITION, $this->part->getContentDisposition()],
[HeaderConsts::CONTENT_TRANSFER_ENCODING, $this->part->getContentTransferEncoding()]
]);
}
return new ArrayIterator();
}
/**
* Writes out headers for $this->part and follows them with an empty line.
*/
public function writePartHeadersTo(StreamInterface $stream) : static
{
foreach ($this->getPartHeadersIterator() as $header) {
$stream->write("{$header[0]}: {$header[1]}\r\n");
}
$stream->write("\r\n");
return $this;
}
/**
* Creates the underlying stream lazily when required.
*/
protected function createStream() : StreamInterface
{
$stream = Psr7\Utils::streamFor();
$this->writePartHeadersTo($stream);
$stream->rewind();
return $stream;
}
}