zbateson / mail-mime-parser

src/Parser/NonMimeParserService.php

<?php
/**
 * This file is part of the ZBateson\MailMimeParser project.
 *
 * @license http://opensource.org/licenses/bsd-license.php BSD
 */

namespace ZBateson\MailMimeParser\Parser;

use ZBateson\MailMimeParser\Parser\Part\UUEncodedPartHeaderContainerFactory;
use ZBateson\MailMimeParser\Parser\Proxy\ParserMimePartProxy;
use ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxy;
use ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxyFactory;
use ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy;
use ZBateson\MailMimeParser\Parser\Proxy\ParserUUEncodedPartProxy;
use ZBateson\MailMimeParser\Parser\Proxy\ParserUUEncodedPartProxyFactory;

/**
 * Parses content for non-mime messages and uu-encoded child parts.
 *
 * @author Zaahid Bateson
 */
class NonMimeParserService extends AbstractParserService
{
    protected UUEncodedPartHeaderContainerFactory $partHeaderContainerFactory;

    public function __construct(
        ParserNonMimeMessageProxyFactory $parserNonMimeMessageProxyFactory,
        ParserUUEncodedPartProxyFactory $parserUuEncodedPartProxyFactory,
        PartBuilderFactory $partBuilderFactory,
        UUEncodedPartHeaderContainerFactory $uuEncodedPartHeaderContainerFactory
    ) {
        parent::__construct($parserNonMimeMessageProxyFactory, $parserUuEncodedPartProxyFactory, $partBuilderFactory);
        $this->partHeaderContainerFactory = $uuEncodedPartHeaderContainerFactory;
    }

    /**
     * Always returns true, and should therefore be the last parser reached by
     * a ParserManager.
     */
    public function canParse(PartBuilder $part) : bool
    {
        return true;
    }

    /**
     * Creates a UUEncodedPartHeaderContainer attached to a PartBuilder, and
     * calls $this->parserManager->createParserProxyFor().
     *
     * It also sets the PartBuilder's stream part start pos and content start
     * pos to that of $parent->getNextParStart() (since a 'begin' line is read
     * prior to another child being created, see parseNextPart()).
     */
    private function createPart(ParserNonMimeMessageProxy $parent) : ParserPartProxy
    {
        $hc = $this->partHeaderContainerFactory->newInstance($parent->getNextPartMode(), $parent->getNextPartFilename());

It seems like $parent->getNextPartMode() can also be of type null; however, parameter $mode of ZBateson\MailMimeParser\Parser\Part\UUEncodedPartHeaderContainerFactory::newInstance() does only seem to accept integer, maybe add an additional type check?

It seems like $parent->getNextPartFilename() can also be of type null; however, parameter $filename of ZBateson\MailMimeParser\Parser\Part\UUEncodedPartHeaderContainerFactory::newInstance() does only seem to accept string, maybe add an additional type check?

        $pb = $this->partBuilderFactory->newChildPartBuilder($hc, $parent);
        $proxy = $this->parserManager->createParserProxyFor($pb);
        $pb->setStreamPartStartPos($parent->getNextPartStart());

It seems like $parent->getNextPartStart() can also be of type null; however, parameter $streamPartStartPos of ZBateson\MailMimeParser\Parser\PartBuilder::setStreamPartStartPos() does only seem to accept integer, maybe add an additional type check?

        $pb->setStreamContentStartPos($parent->getNextPartStart());

It seems like $parent->getNextPartStart() can also be of type null; however, parameter $streamContentStartPos of ZBateson\MailMimeParser\Parser\PartBuilder::setStreamContentStartPos() does only seem to accept integer, maybe add an additional type check?

        return $proxy;
    }

    /**
     * Reads content from the passed ParserPartProxy's stream till a uu-encoded
     * 'begin' line is found, setting $proxy->setStreamPartContentAndEndPos() to
     * the last byte read before the begin line.
     *
     * @param ParserNonMimeMessageProxy|ParserUUEncodedPartProxy $proxy
     */
    private function parseNextPart(ParserPartProxy $proxy) : static
    {
        $handle = $proxy->getMessageResourceHandle();
        while (!\feof($handle)) {
            $start = \ftell($handle);
            $line = \trim(MessageParserService::readLine($handle));
            if (\preg_match('/^begin ([0-7]{3}) (.*)$/', $line, $matches)) {
                $proxy->setNextPartStart($start);

The method setNextPartStart() does not exist on ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy. It seems like you code against a sub-type of ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy such as ZBateson\MailMimeParser\Parser\Proxy\ParserUUEncodedPartProxy or ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxy.

                $proxy->setNextPartMode((int) $matches[1]);

The method setNextPartMode() does not exist on ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy. It seems like you code against a sub-type of ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy such as ZBateson\MailMimeParser\Parser\Proxy\ParserUUEncodedPartProxy or ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxy.

                $proxy->setNextPartFilename($matches[2]);

The method setNextPartFilename() does not exist on ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy. It seems like you code against a sub-type of ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy such as ZBateson\MailMimeParser\Parser\Proxy\ParserUUEncodedPartProxy or ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxy.

                return $this;
            }
            $proxy->setStreamPartAndContentEndPos(\ftell($handle));
        }
        return $this;
    }

    public function parseContent(ParserPartProxy $proxy) : static
    {
        $handle = $proxy->getMessageResourceHandle();
        if ($proxy->getNextPartStart() !== null || \feof($handle)) {

The method getNextPartStart() does not exist on ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy. It seems like you code against a sub-type of ZBateson\MailMimeParser\Parser\Proxy\ParserPartProxy such as ZBateson\MailMimeParser\Parser\Proxy\ParserUUEncodedPartProxy or ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxy.

            return $this;
        }
        if ($proxy->getStreamContentStartPos() === null) {
            $proxy->setStreamContentStartPos(\ftell($handle));
        }
        $this->parseNextPart($proxy);
        return $this;
    }

    public function parseNextChild(ParserMimePartProxy $proxy) : ?ParserPartProxy
    {
        $handle = $proxy->getMessageResourceHandle();
        if ($proxy->getNextPartStart() === null || \feof($handle)) {

The method getNextPartStart() does not exist on ZBateson\MailMimeParser\Parser\Proxy\ParserMimePartProxy. It seems like you code against a sub-type of ZBateson\MailMimeParser\Parser\Proxy\ParserMimePartProxy such as ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxy.

            return null;
        }
        $child = $this->createPart($proxy);
        $proxy->clearNextPart();

The method clearNextPart() does not exist on ZBateson\MailMimeParser\Parser\Proxy\ParserMimePartProxy. It seems like you code against a sub-type of ZBateson\MailMimeParser\Parser\Proxy\ParserMimePartProxy such as ZBateson\MailMimeParser\Parser\Proxy\ParserNonMimeMessageProxy.

        return $child;
    }
}