GenericMessage - Code Metrics - genkgo/mail - Measure and Improve Code Quality continuously with Scrutinizer

GenericMessage A
last analyzed 2020-10-26 13:04 UTC

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	167
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	7

Test Coverage

Coverage

98.11%

Importance

Changes

Metric	Value
wmc	19
lcom	2
cbo	7
dl	0
loc	167
ccs	52
cts	53
cp	0.9811
rs	10
c	0
b	0
f	0

11 Methods

Rating	Name	Size	Complexity
A	__construct()	5	1
A	getHeaders()	4	1
A	hasHeader()	5	2
A	getHeader()	10	2
A	withHeader()	6	1
A	withAddedHeader()	6	1
A	withoutHeader()	6	1
A	withBody()	6	1
A	getBody()	4	1
A	__toString()	4	1
B	fromString()	34	7

<?php
declare(strict_types=1);

namespace Genkgo\Mail;

use Genkgo\Mail\Header\HeaderLine;
use Genkgo\Mail\Header\MimeVersion;
use Genkgo\Mail\Stream\EmptyStream;
use Genkgo\Mail\Stream\MessageStream;
use Genkgo\Mail\Stream\StringStream;

final class GenericMessage implements MessageInterface
{
    /**
     * @var array<string, array<int, HeaderInterface>>
     */
    private $headers = [
        'return-path' => [],
        'received' => [],
        'dkim-signature' => [],
        'domainkey-signature' => [],
        'sender' => [],
        'message-id' => [],
        'date' => [],
        'subject' => [],
        'from' => [],
        'reply-to' => [],
        'to' => [],
        'cc' => [],
        'bcc' => [],
        'mime-version' => [],
        'content-type' => [],
        'content-transfer-encoding' => [],
    ];

    /**
     * @var StreamInterface
     */
    private $body;
    
    public function __construct()
    {
        $this->body = new EmptyStream();
        $this->headers['mime-version'] = [new MimeVersion()];
    }

    /**
     * @return iterable<iterable<HeaderInterface>>

     */
    public function getHeaders(): iterable
    {
        return $this->headers;
    }

    /**
     * @param string $name
     * @return bool
     */
    public function hasHeader(string $name): bool
    {
        $name = \strtolower($name);
        return isset($this->headers[$name]) && $this->headers[$name];
    }

    /**
     * @param string $name
     * @return HeaderInterface[]|iterable
     */
    public function getHeader(string $name): iterable
    {
        $name = \strtolower($name);

        if (!isset($this->headers[$name])) {
            return [];
class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}
        }

        return $this->headers[$name];
    }

    /**
     * @param HeaderInterface $header
     * @return MessageInterface
     */
    public function withHeader(HeaderInterface $header): MessageInterface
    {
        $clone = clone $this;
        $clone->headers[\strtolower((string)$header->getName())] = [$header];
        return $clone;
    }

    /**
     * @param HeaderInterface $header
     * @return MessageInterface
     */
    public function withAddedHeader(HeaderInterface $header): MessageInterface
    {
        $clone = clone $this;
        $clone->headers[\strtolower((string)$header->getName())][] = $header;
        return $clone;
    }

    /**
     * @param string $name
     * @return MessageInterface
     */
    public function withoutHeader(string $name): MessageInterface
    {
        $clone = clone $this;
        unset($clone->headers[(string)\strtolower($name)]);
        return $clone;
    }

    /**
     * @param StreamInterface $body
     * @return MessageInterface
     */
    public function withBody(StreamInterface $body): MessageInterface
    {
        $clone = clone $this;
        $clone->body = $body;
        return $clone;
    }

    /**
     * @return StreamInterface
     */
    public function getBody(): StreamInterface
    {
        return $this->body;
    }

    /**
     * @return string
     */
    public function __toString(): string
    {
        return (string) (new MessageStream($this));
    }

    /**
     * @param string $messageString
     * @return MessageInterface
     */
    public static function fromString(string $messageString): MessageInterface
    {
        $message = new self();

        $lines = \preg_split('/\r\n/', $messageString);
        if ($lines === false) {
            throw new \UnexpectedValueException('Cannot parse from string, cannot split lines');
        }

        for ($n = 0, $length = \count($lines); $n < $length; $n++) {
            $line = $lines[$n];

            if ($line === '') {
                $message = $message->withBody(
                    new StringStream(
                        \implode(
                            "\r\n",
                            \array_slice($lines, $n + 1)
                        )
                    )
                );
                break;
            }

            while (isset($lines[$n + 1]) && $lines[$n + 1] !== '' && \trim($lines[$n + 1][0]) === '') {
                $line .= ' ' . \ltrim($lines[$n + 1]);
                $n++;
            }

            $message = $message->withHeader(HeaderLine::fromString($line)->getHeader());
        }

        return $message;
    }
}


1		<?php
2		declare(strict_types=1);
3
4		namespace Genkgo\Mail;
5
6		use Genkgo\Mail\Header\HeaderLine;
7		use Genkgo\Mail\Header\MimeVersion;
8		use Genkgo\Mail\Stream\EmptyStream;
9		use Genkgo\Mail\Stream\MessageStream;
10		use Genkgo\Mail\Stream\StringStream;
11
12		final class GenericMessage implements MessageInterface
13		{
14		/**
15		* @var array<string, array<int, HeaderInterface>>
16		*/
17		private $headers = [
18		'return-path' => [],
19		'received' => [],
20		'dkim-signature' => [],
21		'domainkey-signature' => [],
22		'sender' => [],
23		'message-id' => [],
24		'date' => [],
25		'subject' => [],
26		'from' => [],
27		'reply-to' => [],
28		'to' => [],
29		'cc' => [],
30		'bcc' => [],
31		'mime-version' => [],
32		'content-type' => [],
33		'content-transfer-encoding' => [],
34		];
35
36		/**
37		* @var StreamInterface
38		*/
39		private $body;
40
41	132	public function __construct()
42		{
43	132	$this->body = new EmptyStream();
44	132	$this->headers['mime-version'] = [new MimeVersion()];
45	132	}
46
47		/**
48		* @return iterable<iterable<HeaderInterface>>
		0 ignored issues – show Documentation introduced 2020-03-01 17:14 UTC by Report Bug Copy Issue Report The doc-type `iterable<iterable<HeaderInterface>>` could not be parsed: Expected "\|" or "end of type", but got "<" at position 8. (view supported doc-types) This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types. Loading history...
49		*/
50	76	public function getHeaders(): iterable
51		{
52	76	return $this->headers;
53		}
54
55		/**
56		* @param string $name
57		* @return bool
58		*/
59	34	public function hasHeader(string $name): bool
60		{
61	34	$name = \strtolower($name);
62	34	return isset($this->headers[$name]) && $this->headers[$name];
63		}
64
65		/**
66		* @param string $name
67		* @return HeaderInterface[]\|iterable
68		*/
69	61	public function getHeader(string $name): iterable
70		{
71	61	$name = \strtolower($name);
72
73	61	if (!isset($this->headers[$name])) {
74	2	return [];
		0 ignored issues – show Bug Best Practice introduced 2017-05-26 13:09 UTC by Report Bug Copy Issue Report The return type of `return array();` (`array`) is incompatible with the return type declared by the interface `Genkgo\Mail\MessageInterface::getHeader` of type `Genkgo\Mail\iterable\|Genkgo\Mail\HeaderInterface[]`. If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design. Let’s take a look at an example: class Author { private $name; public function __construct($name) { $this->name = $name; } public function getName() { return $this->name; } } abstract class Post { public function getAuthor() { return 'Johannes'; } } class BlogPost extends Post { public function getAuthor() { return new Author('Johannes'); } } class ForumPost extends Post { /* ... */ } function my_function(Post $post) { echo strtoupper($post->getAuthor()); } Our function `my_function` expects a `Post` object, and outputs the author of the post. The base class `Post` returns a simple string and outputting a simple string will work just fine. However, the child class `BlogPost` which is a sub-type of `Post` instead decided to return an `object`, and is therefore violating the SOLID principles. If a `BlogPost` were passed to `my_function`, PHP would not complain, but ultimately fail when executing the `strtoupper` call in its body. Loading history...
75		}
76
77	61	return $this->headers[$name];
78		}
79
80		/**
81		* @param HeaderInterface $header
82		* @return MessageInterface
83		*/
84	115	public function withHeader(HeaderInterface $header): MessageInterface
85		{
86	115	$clone = clone $this;
87	115	$clone->headers[\strtolower((string)$header->getName())] = [$header];
88	115	return $clone;
89		}
90
91		/**
92		* @param HeaderInterface $header
93		* @return MessageInterface
94		*/
95	3	public function withAddedHeader(HeaderInterface $header): MessageInterface
96		{
97	3	$clone = clone $this;
98	3	$clone->headers[\strtolower((string)$header->getName())][] = $header;
99	3	return $clone;
100		}
101
102		/**
103		* @param string $name
104		* @return MessageInterface
105		*/
106	5	public function withoutHeader(string $name): MessageInterface
107		{
108	5	$clone = clone $this;
109	5	unset($clone->headers[(string)\strtolower($name)]);
110	5	return $clone;
111		}
112
113		/**
114		* @param StreamInterface $body
115		* @return MessageInterface
116		*/
117	93	public function withBody(StreamInterface $body): MessageInterface
118		{
119	93	$clone = clone $this;
120	93	$clone->body = $body;
121	93	return $clone;
122		}
123
124		/**
125		* @return StreamInterface
126		*/
127	78	public function getBody(): StreamInterface
128		{
129	78	return $this->body;
130		}
131
132		/**
133		* @return string
134		*/
135	58	public function __toString(): string
136		{
137	58	return (string) (new MessageStream($this));
138		}
139
140		/**
141		* @param string $messageString
142		* @return MessageInterface
143		*/
144	48	public static function fromString(string $messageString): MessageInterface
145		{
146	48	$message = new self();
147
148	48	$lines = \preg_split('/\r\n/', $messageString);
149	48	if ($lines === false) {
150		throw new \UnexpectedValueException('Cannot parse from string, cannot split lines');
151		}
152
153	48	for ($n = 0, $length = \count($lines); $n < $length; $n++) {
154	48	$line = $lines[$n];
155
156	48	if ($line === '') {
157	47	$message = $message->withBody(
158	47	new StringStream(
159	47	\implode(
160	47	"\r\n",
161	47	\array_slice($lines, $n + 1)
162		)
163		)
164		);
165	47	break;
166		}
167
168	48	while (isset($lines[$n + 1]) && $lines[$n + 1] !== '' && \trim($lines[$n + 1][0]) === '') {
169	2	$line .= ' ' . \ltrim($lines[$n + 1]);
170	2	$n++;
171		}
172
173	48	$message = $message->withHeader(HeaderLine::fromString($line)->getHeader());
174		}
175
176	47	return $message;
177		}
178		}
179

genkgo / mail

GenericMessage A last analyzed 2020-10-26 13:04 UTC

Complexity

Size/Duplication

Coupling/Cohesion

Test Coverage

Importance

11 Methods

Duplication Side-by-Side

Filter issues like

GenericMessage A
last analyzed 2020-10-26 13:04 UTC