Swift_CharacterStream_NgCharacterStream::setCharacterReaderFactory() - Code Metrics - voku/swiftmailer - Measure and Improve Code Quality continuously with Scrutinizer

setCharacterReaderFactory() A
last analyzed 2017-12-05 09:25 UTC

↳ Parent: Swift_CharacterStream_NgCharacterStream

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	3
CRAP Score	1

Importance

Changes

Metric	Value
cc	1
eloc	2
nc	1
nop	1
dl	0
loc	4
rs	10
c	0
b	0
f	0
ccs	3
cts	3
cp	1
crap	1

<?php

/*
 * This file is part of SwiftMailer.
 * (c) 2004-2009 Chris Corbyn
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

/**
 * A CharacterStream implementation which stores characters in an internal array.
 *
 * @author Xavier De Cock <[email protected]>
 */
class Swift_CharacterStream_NgCharacterStream implements Swift_CharacterStream
namespace YourVendor;

class YourClass { }
{
    /**
     * The char reader (lazy-loaded) for the current charset.
     *
     * @var Swift_CharacterReader
     */
    private $_charReader;

    /**
     * A factory for creating CharacterReader instances.
     *
     * @var Swift_CharacterReaderFactory
     */
    private $_charReaderFactory;

    /**
     * The character set this stream is using.
     *
     * @var string
     */
    private $_charset;

    /**
     * The data's stored as-is.
     *
     * @var string
     */
    private $_datas = '';

    /**
     * Number of bytes in the stream.
     *
     * @var int
     */
    private $_datasSize = 0;

    /**
     * Map.
     *
     * @var mixed
     */
    private $_map;

    /**
     * Map Type.
     *
     * @var int
     */
    private $_mapType = 0;

    /**
     * Number of characters in the stream.
     *
     * @var int
     */
    private $_charCount = 0;

    /**
     * Position in the stream.
     *
     * @var int
     */
    private $_currentPos = 0;

    /**
     * Constructor.
     *
     * @param Swift_CharacterReaderFactory $factory
     * @param string                       $charset
     */
    public function __construct(Swift_CharacterReaderFactory $factory, $charset)
    {
        $this->setCharacterReaderFactory($factory);
        $this->setCharacterSet($charset);
    }

    /* -- Changing parameters of the stream -- */

    /**
     * Set the character set used in this CharacterStream.
     *
     * @param string $charset
     */
    public function setCharacterSet($charset)
    {
        if ($charset) {
            $this->_charset = $charset;
            $this->_charReader = null;
            $this->_mapType = 0;

            $this->setCharReaderForCurrentCharset();
        }
    }

    /**
     * Set the CharacterReaderFactory for multi charset support.
     *
     * @param Swift_CharacterReaderFactory $factory
     */
    public function setCharacterReaderFactory(Swift_CharacterReaderFactory $factory)
    {
        $this->_charReaderFactory = $factory;
    }

    /**
     * @see Swift_CharacterStream::flushContents()
     */
    public function flushContents()
    {
        $this->_datas = null;
        $this->_map = null;
        $this->_charCount = 0;
        $this->_currentPos = 0;
        $this->_datasSize = 0;
    }

    /**
     * @see Swift_CharacterStream::importByteStream()
     *
     * @param Swift_OutputByteStream $os
     */
    public function importByteStream(Swift_OutputByteStream $os)

    {
        $this->flushContents();
        $blocks = 512;
        $os->setReadPointer(0);
        
        while (false !== ($read = $os->read($blocks))) {
            $this->write($read);
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
        }
    }

    /**
     * @see Swift_CharacterStream::importString()
     *
     * @param string $string
     */
    public function importString($string)
    {
        $this->flushContents();
        $this->write($string);
    }

    /**
     * @see Swift_CharacterStream::read()
     *
     * @param int $length
     *
     * @return string|false false on error
     */
    public function read($length)
    {
        if ($this->_currentPos >= $this->_charCount) {
            return false;
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());
}
        }

        $ret = false;

        $length = $this->_currentPos + $length > $this->_charCount ? $this->_charCount - $this->_currentPos : $length;
        switch ($this->_mapType) {
            case Swift_CharacterReader::MAP_TYPE_FIXED_LEN:
                $len = $length * $this->_map;
                $ret = substr($this->_datas, $this->_currentPos * $this->_map, $len);
                $this->_currentPos += $length;
                break;

            case Swift_CharacterReader::MAP_TYPE_INVALID:
                $ret = '';
                for (; $this->_currentPos < $length; ++$this->_currentPos) {
                    if (isset($this->_map[$this->_currentPos])) {
                        $ret .= '?';
                    } else {
                        $ret .= $this->_datas[$this->_currentPos];
                    }
                }
                break;

            case Swift_CharacterReader::MAP_TYPE_POSITIONS:
                $end = $this->_currentPos + $length;
                $end = $end > $this->_charCount ? $this->_charCount : $end;
                $ret = '';

                $start = 0;
                if ($this->_currentPos > 0) {
                    $start = $this->_map['p'][$this->_currentPos - 1];
                }

                $to = $start;
                for (; $this->_currentPos < $end; ++$this->_currentPos) {
                    if (isset($this->_map['i'], $this->_map['i'][$this->_currentPos])) {
                        $ret .= substr($this->_datas, $start, $to - $start) . '?';
                        $start = $this->_map['p'][$this->_currentPos];
                    } else {
                        $to = $this->_map['p'][$this->_currentPos];
                    }
                }

                $ret .= substr($this->_datas, $start, $to - $start);
                break;
        }

        return $ret;
    }

    /**
     * @see Swift_CharacterStream::readBytes()
     *
     * @param int $length
     *
     * @return int[]|false false on error
     */
    public function readBytes($length)

    {
        $read = $this->read($length);
        if ($read !== false) {
            return \array_map('\ord', \str_split($read, 1));
        }

        return false;
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());
}
    }

    /**
     * @see Swift_CharacterStream::setPointer()
     *
     * @param int $charOffset
     */
    public function setPointer($charOffset)
    {
        if ($this->_charCount < $charOffset) {
            $charOffset = $this->_charCount;
        }
        $this->_currentPos = $charOffset;
    }

    /**
     * Set the char-reader for the current charset.
     */
    private function setCharReaderForCurrentCharset()
    {
        if (null === $this->_charReader) {
            $this->_charReader = $this->_charReaderFactory->getReaderFor($this->_charset);
            $this->_map = array();
            $this->_mapType = $this->_charReader->getMapType();
        }
    }

    /**
     * @see Swift_CharacterStream::write()
     *
     * @param string $chars
     */
    public function write($chars)
    {
        $this->setCharReaderForCurrentCharset();

        $ignored = '';
        $this->_datas .= $chars;
        $this->_charCount += $this->_charReader->getCharPositions(
            substr($this->_datas, $this->_datasSize),
            $this->_datasSize,
            $this->_map,
            $ignored
        );

        if ($ignored !== false) {
            $this->_datasSize = strlen($this->_datas) - strlen($ignored);
        } else {
            $this->_datasSize = strlen($this->_datas);
        }
    }
}


1			<?php
2
3			/*
4			* This file is part of SwiftMailer.
5			* (c) 2004-2009 Chris Corbyn
6			*
7			* For the full copyright and license information, please view the LICENSE
8			* file that was distributed with this source code.
9			*/
10
11			/**
12			* A CharacterStream implementation which stores characters in an internal array.
13			*
14			* @author Xavier De Cock <[email protected]>
15			*/
16			class Swift_CharacterStream_NgCharacterStream implements Swift_CharacterStream
			0 ignored issues – show Coding Style Compatibility introduced 2015-11-22 11:38 UTC by Report Bug Copy Issue Report PSR1 recommends that each class must be in a namespace of at least one level to avoid collisions. You can fix this by adding a namespace to your class: namespace YourVendor; class YourClass { } When choosing a vendor namespace, try to pick something that is not too generic to avoid conflicts with other libraries. Loading history...
17			{
18			/**
19			* The char reader (lazy-loaded) for the current charset.
20			*
21			* @var Swift_CharacterReader
22			*/
23			private $_charReader;
24
25			/**
26			* A factory for creating CharacterReader instances.
27			*
28			* @var Swift_CharacterReaderFactory
29			*/
30			private $_charReaderFactory;
31
32			/**
33			* The character set this stream is using.
34			*
35			* @var string
36			*/
37			private $_charset;
38
39			/**
40			* The data's stored as-is.
41			*
42			* @var string
43			*/
44			private $_datas = '';
45
46			/**
47			* Number of bytes in the stream.
48			*
49			* @var int
50			*/
51			private $_datasSize = 0;
52
53			/**
54			* Map.
55			*
56			* @var mixed
57			*/
58			private $_map;
59
60			/**
61			* Map Type.
62			*
63			* @var int
64			*/
65			private $_mapType = 0;
66
67			/**
68			* Number of characters in the stream.
69			*
70			* @var int
71			*/
72			private $_charCount = 0;
73
74			/**
75			* Position in the stream.
76			*
77			* @var int
78			*/
79			private $_currentPos = 0;
80
81			/**
82			* Constructor.
83			*
84			* @param Swift_CharacterReaderFactory $factory
85			* @param string $charset
86			*/
87	9		public function __construct(Swift_CharacterReaderFactory $factory, $charset)
88			{
89	9		$this->setCharacterReaderFactory($factory);
90	9		$this->setCharacterSet($charset);
91	9		}
92
93			/* -- Changing parameters of the stream -- */
94
95			/**
96			* Set the character set used in this CharacterStream.
97			*
98			* @param string $charset
99			*/
100	9		public function setCharacterSet($charset)
101			{
102	9		if ($charset) {
103	9		$this->_charset = $charset;
104	9		$this->_charReader = null;
105	9		$this->_mapType = 0;
106
107	9		$this->setCharReaderForCurrentCharset();
108	9		}
109	9		}
110
111			/**
112			* Set the CharacterReaderFactory for multi charset support.
113			*
114			* @param Swift_CharacterReaderFactory $factory
115			*/
116	9		public function setCharacterReaderFactory(Swift_CharacterReaderFactory $factory)
117			{
118	9		$this->_charReaderFactory = $factory;
119	9		}
120
121			/**
122			* @see Swift_CharacterStream::flushContents()
123			*/
124	9		public function flushContents()
125			{
126	9		$this->_datas = null;
127	9		$this->_map = null;
128	9		$this->_charCount = 0;
129	9		$this->_currentPos = 0;
130	9		$this->_datasSize = 0;
131	9		}
132
133			/**
134			* @see Swift_CharacterStream::importByteStream()
135			*
136			* @param Swift_OutputByteStream $os
137			*/
138	2	View Code Duplication	public function importByteStream(Swift_OutputByteStream $os)
			0 ignored issues – show Duplication introduced 2017-09-21 08:11 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
139			{
140	2		$this->flushContents();
141	2		$blocks = 512;
142	2		$os->setReadPointer(0);
143
144	2		while (false !== ($read = $os->read($blocks))) {
145	2		$this->write($read);
			0 ignored issues – show Bug introduced 2016-02-10 17:04 UTC by Report Bug Copy Issue Report It seems like `$read` defined by `$os->read($blocks)` on line `144` can also be of type `boolean`; however, `Swift_CharacterStream_NgCharacterStream::write()` does only seem to accept `string`, maybe add an additional type check? If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /** * @return array\|string */ function returnsDifferentValues($x) { if ($x) { return 'foo'; } return array(); } $x = returnsDifferentValues($y); if (is_array($x)) { // $x is an array. } If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. Loading history...
146	2		}
147	2		}
148
149			/**
150			* @see Swift_CharacterStream::importString()
151			*
152			* @param string $string
153			*/
154	7		public function importString($string)
155			{
156	7		$this->flushContents();
157	7		$this->write($string);
158	7		}
159
160			/**
161			* @see Swift_CharacterStream::read()
162			*
163			* @param int $length
164			*
165			* @return string\|false false on error
166			*/
167	9		public function read($length)
168			{
169	9		if ($this->_currentPos >= $this->_charCount) {
170	9		return false;
			0 ignored issues – show Bug Best Practice introduced 2015-11-22 11:38 UTC by Report Bug Copy Issue Report The return type of `return false;` (`false`) is incompatible with the return type declared by the interface `Swift_CharacterStream::read` of type `string`. 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...
171			}
172
173	9		$ret = false;
			0 ignored issues – show Comprehensibility Best Practice introduced 2016-02-10 17:04 UTC by Report Bug Copy Issue Report The expression `false;` of type `false` adds `false` to the return on line 217 which is incompatible with the return type declared by the interface `Swift_CharacterStream::read` of type `string`. It seems like you forgot to handle an error condition. Loading history...
174	9		$length = $this->_currentPos + $length > $this->_charCount ? $this->_charCount - $this->_currentPos : $length;
175	9		switch ($this->_mapType) {
176	9		case Swift_CharacterReader::MAP_TYPE_FIXED_LEN:
177	1		$len = $length * $this->_map;
178	1		$ret = substr($this->_datas, $this->_currentPos * $this->_map, $len);
179	1		$this->_currentPos += $length;
180	1		break;
181
182	9		case Swift_CharacterReader::MAP_TYPE_INVALID:
183			$ret = '';
184			for (; $this->_currentPos < $length; ++$this->_currentPos) {
185			if (isset($this->_map[$this->_currentPos])) {
186			$ret .= '?';
187			} else {
188			$ret .= $this->_datas[$this->_currentPos];
189			}
190			}
191			break;
192
193	9		case Swift_CharacterReader::MAP_TYPE_POSITIONS:
194	9		$end = $this->_currentPos + $length;
195	9		$end = $end > $this->_charCount ? $this->_charCount : $end;
196	9		$ret = '';
197
198	9		$start = 0;
199	9		if ($this->_currentPos > 0) {
200	3		$start = $this->_map['p'][$this->_currentPos - 1];
201	3		}
202
203	9		$to = $start;
204	9		for (; $this->_currentPos < $end; ++$this->_currentPos) {
205	9		if (isset($this->_map['i'], $this->_map['i'][$this->_currentPos])) {
206			$ret .= substr($this->_datas, $start, $to - $start) . '?';
207			$start = $this->_map['p'][$this->_currentPos];
208			} else {
209	9		$to = $this->_map['p'][$this->_currentPos];
210			}
211	9		}
212
213	9		$ret .= substr($this->_datas, $start, $to - $start);
214	9		break;
215	9		}
216
217	9		return $ret;
218			}
219
220			/**
221			* @see Swift_CharacterStream::readBytes()
222			*
223			* @param int $length
224			*
225			* @return int[]\|false false on error
226			*/
227	9	View Code Duplication	public function readBytes($length)
			0 ignored issues – show Duplication introduced 2017-09-21 08:11 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
228			{
229	9		$read = $this->read($length);
230	9		if ($read !== false) {
231	9		return \array_map('\ord', \str_split($read, 1));
232			}
233
234	9		return false;
			0 ignored issues – show Bug Best Practice introduced 2017-05-04 09:46 UTC by Report Bug Copy Issue Report The return type of `return false;` (`false`) is incompatible with the return type declared by the interface `Swift_CharacterStream::readBytes` of type `integer[]`. 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...
235			}
236
237			/**
238			* @see Swift_CharacterStream::setPointer()
239			*
240			* @param int $charOffset
241			*/
242			public function setPointer($charOffset)
243			{
244			if ($this->_charCount < $charOffset) {
245			$charOffset = $this->_charCount;
246			}
247			$this->_currentPos = $charOffset;
248			}
249
250			/**
251			* Set the char-reader for the current charset.
252			*/
253	9		private function setCharReaderForCurrentCharset()
254			{
255	9		if (null === $this->_charReader) {
256	9		$this->_charReader = $this->_charReaderFactory->getReaderFor($this->_charset);
257	9		$this->_map = array();
258	9		$this->_mapType = $this->_charReader->getMapType();
259	9		}
260	9		}
261
262			/**
263			* @see Swift_CharacterStream::write()
264			*
265			* @param string $chars
266			*/
267	9		public function write($chars)
268			{
269	9		$this->setCharReaderForCurrentCharset();
270
271	9		$ignored = '';
272	9		$this->_datas .= $chars;
273	9		$this->_charCount += $this->_charReader->getCharPositions(
274	9		substr($this->_datas, $this->_datasSize),
275	9		$this->_datasSize,
276	9		$this->_map,
277			$ignored
278	9		);
279
280	9		if ($ignored !== false) {
281	9		$this->_datasSize = strlen($this->_datas) - strlen($ignored);
282	9		} else {
283			$this->_datasSize = strlen($this->_datas);
284			}
285	9		}
286			}
287

voku / swiftmailer

setCharacterReaderFactory() A last analyzed 2017-12-05 09:25 UTC

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like

setCharacterReaderFactory() A
last analyzed 2017-12-05 09:25 UTC