Dolibarr / dolibarr

htdocs/includes/swiftmailer/lib/classes/Swift/Mime/Headers/AbstractHeader.php

Indentation +468 added lines, -468 removed lines

@@ -15,472 +15,472 @@
  */
 abstract class Swift_Mime_Headers_AbstractHeader implements Swift_Mime_Header
 {
-    const PHRASE_PATTERN = '(?:(?:(?:(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?[a-zA-Z0-9!#\$%&\'\*\+\-\/=\?\^_`\{\}\|~]+(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?)|(?:(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?"((?:(?:[ \t]*(?:\r\n))?[ \t])?(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21\x23-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])))*(?:(?:[ \t]*(?:\r\n))?[ \t])?"(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?))+?)';
-
-    /**
-     * The name of this Header.
-     *
-     * @var string
-     */
-    private $name;
-
-    /**
-     * The Encoder used to encode this Header.
-     *
-     * @var Swift_Encoder
-     */
-    private $encoder;
-
-    /**
-     * The maximum length of a line in the header.
-     *
-     * @var int
-     */
-    private $lineLength = 78;
-
-    /**
-     * The language used in this Header.
-     *
-     * @var string
-     */
-    private $lang;
-
-    /**
-     * The character set of the text in this Header.
-     *
-     * @var string
-     */
-    private $charset = 'utf-8';
-
-    /**
-     * The value of this Header, cached.
-     *
-     * @var string
-     */
-    private $cachedValue = null;
-
-    /**
-     * Set the character set used in this Header.
-     *
-     * @param string $charset
-     */
-    public function setCharset($charset)
-    {
-        $this->clearCachedValueIf($charset != $this->charset);
-        $this->charset = $charset;
-        if (isset($this->encoder)) {
-            $this->encoder->charsetChanged($charset);
-        }
-    }
-
-    /**
-     * Get the character set used in this Header.
-     *
-     * @return string
-     */
-    public function getCharset()
-    {
-        return $this->charset;
-    }
-
-    /**
-     * Set the language used in this Header.
-     *
-     * For example, for US English, 'en-us'.
-     * This can be unspecified.
-     *
-     * @param string $lang
-     */
-    public function setLanguage($lang)
-    {
-        $this->clearCachedValueIf($this->lang != $lang);
-        $this->lang = $lang;
-    }
-
-    /**
-     * Get the language used in this Header.
-     *
-     * @return string
-     */
-    public function getLanguage()
-    {
-        return $this->lang;
-    }
-
-    /**
-     * Set the encoder used for encoding the header.
-     */
-    public function setEncoder(Swift_Mime_HeaderEncoder $encoder)
-    {
-        $this->encoder = $encoder;
-        $this->setCachedValue(null);
-    }
-
-    /**
-     * Get the encoder used for encoding this Header.
-     *
-     * @return Swift_Mime_HeaderEncoder
-     */
-    public function getEncoder()
-    {
-        return $this->encoder;
-    }
-
-    /**
-     * Get the name of this header (e.g. charset).
-     *
-     * @return string
-     */
-    public function getFieldName()
-    {
-        return $this->name;
-    }
-
-    /**
-     * Set the maximum length of lines in the header (excluding EOL).
-     *
-     * @param int $lineLength
-     */
-    public function setMaxLineLength($lineLength)
-    {
-        $this->clearCachedValueIf($this->lineLength != $lineLength);
-        $this->lineLength = $lineLength;
-    }
-
-    /**
-     * Get the maximum permitted length of lines in this Header.
-     *
-     * @return int
-     */
-    public function getMaxLineLength()
-    {
-        return $this->lineLength;
-    }
-
-    /**
-     * Get this Header rendered as a RFC 2822 compliant string.
-     *
-     * @return string
-     *
-     * @throws Swift_RfcComplianceException
-     */
-    public function toString()
-    {
-        return $this->tokensToString($this->toTokens());
-    }
-
-    /**
-     * Returns a string representation of this object.
-     *
-     * @return string
-     *
-     * @see toString()
-     */
-    public function __toString()
-    {
-        return $this->toString();
-    }
-
-    /**
-     * Set the name of this Header field.
-     *
-     * @param string $name
-     */
-    protected function setFieldName($name)
-    {
-        $this->name = $name;
-    }
-
-    /**
-     * Produces a compliant, formatted RFC 2822 'phrase' based on the string given.
-     *
-     * @param string $string  as displayed
-     * @param string $charset of the text
-     * @param bool   $shorten the first line to make remove for header name
-     *
-     * @return string
-     */
-    protected function createPhrase(Swift_Mime_Header $header, $string, $charset, Swift_Mime_HeaderEncoder $encoder = null, $shorten = false)
-    {
-        // Treat token as exactly what was given
-        $phraseStr = $string;
-        // If it's not valid
-
-        if (!preg_match('/^'.self::PHRASE_PATTERN.'$/D', $phraseStr)) {
-            // .. but it is just ascii text, try escaping some characters
-            // and make it a quoted-string
-            if (preg_match('/^[\x00-\x08\x0B\x0C\x0E-\x7F]*$/D', $phraseStr)) {
-                $phraseStr = $this->escapeSpecials($phraseStr, ['"']);
-                $phraseStr = '"'.$phraseStr.'"';
-            } else {
-                // ... otherwise it needs encoding
-                // Determine space remaining on line if first line
-                if ($shorten) {
-                    $usedLength = \strlen($header->getFieldName().': ');
-                } else {
-                    $usedLength = 0;
-                }
-                $phraseStr = $this->encodeWords($header, $string, $usedLength);
-            }
-        }
-
-        return $phraseStr;
-    }
-
-    /**
-     * Escape special characters in a string (convert to quoted-pairs).
-     *
-     * @param string   $token
-     * @param string[] $include additional chars to escape
-     *
-     * @return string
-     */
-    private function escapeSpecials($token, $include = [])
-    {
-        foreach (array_merge(['\\'], $include) as $char) {
-            $token = str_replace($char, '\\'.$char, $token);
-        }
-
-        return $token;
-    }
-
-    /**
-     * Encode needed word tokens within a string of input.
-     *
-     * @param string $input
-     * @param string $usedLength optional
-     *
-     * @return string
-     */
-    protected function encodeWords(Swift_Mime_Header $header, $input, $usedLength = -1)
-    {
-        $value = '';
-
-        $tokens = $this->getEncodableWordTokens($input);
-
-        foreach ($tokens as $token) {
-            // See RFC 2822, Sect 2.2 (really 2.2 ??)
-            if ($this->tokenNeedsEncoding($token)) {
-                // Don't encode starting WSP
-                $firstChar = substr($token, 0, 1);
-                switch ($firstChar) {
-                    case ' ':
-                    case "\t":
-                        $value .= $firstChar;
-                        $token = substr($token, 1);
-                }
-
-                if (-1 == $usedLength) {
-                    $usedLength = \strlen($header->getFieldName().': ') + \strlen($value);
-                }
-                $value .= $this->getTokenAsEncodedWord($token, $usedLength);
-
-                $header->setMaxLineLength(76); // Forcefully override
-            } else {
-                $value .= $token;
-            }
-        }
-
-        return $value;
-    }
-
-    /**
-     * Test if a token needs to be encoded or not.
-     *
-     * @param string $token
-     *
-     * @return bool
-     */
-    protected function tokenNeedsEncoding($token)
-    {
-        return preg_match('~[\x00-\x08\x10-\x19\x7F-\xFF\r\n]~', $token);
-    }
-
-    /**
-     * Splits a string into tokens in blocks of words which can be encoded quickly.
-     *
-     * @param string $string
-     *
-     * @return string[]
-     */
-    protected function getEncodableWordTokens($string)
-    {
-        $tokens = [];
-
-        $encodedToken = '';
-        // Split at all whitespace boundaries
-        foreach (preg_split('~(?=[\t ])~', $string ?? '') as $token) {
-            if ($this->tokenNeedsEncoding($token)) {
-                $encodedToken .= $token;
-            } else {
-                if (\strlen($encodedToken) > 0) {
-                    $tokens[] = $encodedToken;
-                    $encodedToken = '';
-                }
-                $tokens[] = $token;
-            }
-        }
-        if (\strlen($encodedToken)) {
-            $tokens[] = $encodedToken;
-        }
-
-        return $tokens;
-    }
-
-    /**
-     * Get a token as an encoded word for safe insertion into headers.
-     *
-     * @param string $token           token to encode
-     * @param int    $firstLineOffset optional
-     *
-     * @return string
-     */
-    protected function getTokenAsEncodedWord($token, $firstLineOffset = 0)
-    {
-        // Adjust $firstLineOffset to account for space needed for syntax
-        $charsetDecl = $this->charset;
-        if (isset($this->lang)) {
-            $charsetDecl .= '*'.$this->lang;
-        }
-        $encodingWrapperLength = \strlen(
-            '=?'.$charsetDecl.'?'.$this->encoder->getName().'??='
-            );
-
-        if ($firstLineOffset >= 75) {
-            //Does this logic need to be here?
-            $firstLineOffset = 0;
-        }
-
-        $encodedTextLines = explode("\r\n",
-            $this->encoder->encodeString(
-                $token, $firstLineOffset, 75 - $encodingWrapperLength, $this->charset
-            ) ?? ''
-        );
-
-        if ('iso-2022-jp' !== strtolower($this->charset ?? '')) {
-            // special encoding for iso-2022-jp using mb_encode_mimeheader
-            foreach ($encodedTextLines as $lineNum => $line) {
-                $encodedTextLines[$lineNum] = '=?'.$charsetDecl.
-                    '?'.$this->encoder->getName().
-                    '?'.$line.'?=';
-            }
-        }
-
-        return implode("\r\n ", $encodedTextLines);
-    }
-
-    /**
-     * Generates tokens from the given string which include CRLF as individual tokens.
-     *
-     * @param string $token
-     *
-     * @return string[]
-     */
-    protected function generateTokenLines($token)
-    {
-        return preg_split('~(\r\n)~', $token ?? '', -1, PREG_SPLIT_DELIM_CAPTURE);
-    }
-
-    /**
-     * Set a value into the cache.
-     *
-     * @param string $value
-     */
-    protected function setCachedValue($value)
-    {
-        $this->cachedValue = $value;
-    }
-
-    /**
-     * Get the value in the cache.
-     *
-     * @return string
-     */
-    protected function getCachedValue()
-    {
-        return $this->cachedValue;
-    }
-
-    /**
-     * Clear the cached value if $condition is met.
-     *
-     * @param bool $condition
-     */
-    protected function clearCachedValueIf($condition)
-    {
-        if ($condition) {
-            $this->setCachedValue(null);
-        }
-    }
-
-    /**
-     * Generate a list of all tokens in the final header.
-     *
-     * @param string $string The string to tokenize
-     *
-     * @return array An array of tokens as strings
-     */
-    protected function toTokens($string = null)
-    {
-        if (null === $string) {
-            $string = $this->getFieldBody();
-        }
-
-        $tokens = [];
-
-        // Generate atoms; split at all invisible boundaries followed by WSP
-        foreach (preg_split('~(?=[ \t])~', $string ?? '') as $token) {
-            $newTokens = $this->generateTokenLines($token);
-            foreach ($newTokens as $newToken) {
-                $tokens[] = $newToken;
-            }
-        }
-
-        return $tokens;
-    }
-
-    /**
-     * Takes an array of tokens which appear in the header and turns them into
-     * an RFC 2822 compliant string, adding FWSP where needed.
-     *
-     * @param string[] $tokens
-     *
-     * @return string
-     */
-    private function tokensToString(array $tokens)
-    {
-        $lineCount = 0;
-        $headerLines = [];
-        $headerLines[] = $this->name.': ';
-        $currentLine = &$headerLines[$lineCount++];
-
-        // Build all tokens back into compliant header
-        foreach ($tokens as $i => $token) {
-            // Line longer than specified maximum or token was just a new line
-            if (("\r\n" == $token) ||
-                ($i > 0 && \strlen($currentLine.$token) > $this->lineLength)
-                && 0 < \strlen($currentLine)) {
-                $headerLines[] = '';
-                $currentLine = &$headerLines[$lineCount++];
-            }
-
-            // Append token to the line
-            if ("\r\n" != $token) {
-                $currentLine .= $token;
-            }
-        }
-
-        // Implode with FWS (RFC 2822, 2.2.3)
-        return implode("\r\n", $headerLines)."\r\n";
-    }
-
-    /**
-     * Make a deep copy of object.
-     */
-    public function __clone()
-    {
-        if ($this->encoder) {
-            $this->encoder = clone $this->encoder;
-        }
-    }
+	const PHRASE_PATTERN = '(?:(?:(?:(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?[a-zA-Z0-9!#\$%&\'\*\+\-\/=\?\^_`\{\}\|~]+(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?)|(?:(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?"((?:(?:[ \t]*(?:\r\n))?[ \t])?(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21\x23-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])))*(?:(?:[ \t]*(?:\r\n))?[ \t])?"(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))*(?:(?:(?:(?:[ \t]*(?:\r\n))?[ \t])?(\((?:(?:(?:[ \t]*(?:\r\n))?[ \t])|(?:(?:[\x01-\x08\x0B\x0C\x0E-\x19\x7F]|[\x21-\x27\x2A-\x5B\x5D-\x7E])|(?:\\[\x00-\x08\x0B\x0C\x0E-\x7F])|(?1)))*(?:(?:[ \t]*(?:\r\n))?[ \t])?\)))|(?:(?:[ \t]*(?:\r\n))?[ \t])))?))+?)';
+
+	/**
+	 * The name of this Header.
+	 *
+	 * @var string
+	 */
+	private $name;
+
+	/**
+	 * The Encoder used to encode this Header.
+	 *
+	 * @var Swift_Encoder
+	 */
+	private $encoder;
+
+	/**
+	 * The maximum length of a line in the header.
+	 *
+	 * @var int
+	 */
+	private $lineLength = 78;
+
+	/**
+	 * The language used in this Header.
+	 *
+	 * @var string
+	 */
+	private $lang;
+
+	/**
+	 * The character set of the text in this Header.
+	 *
+	 * @var string
+	 */
+	private $charset = 'utf-8';
+
+	/**
+	 * The value of this Header, cached.
+	 *
+	 * @var string
+	 */
+	private $cachedValue = null;
+
+	/**
+	 * Set the character set used in this Header.
+	 *
+	 * @param string $charset
+	 */
+	public function setCharset($charset)
+	{
+		$this->clearCachedValueIf($charset != $this->charset);
+		$this->charset = $charset;
+		if (isset($this->encoder)) {
+			$this->encoder->charsetChanged($charset);
+		}
+	}
+
+	/**
+	 * Get the character set used in this Header.
+	 *
+	 * @return string
+	 */
+	public function getCharset()
+	{
+		return $this->charset;
+	}
+
+	/**
+	 * Set the language used in this Header.
+	 *
+	 * For example, for US English, 'en-us'.
+	 * This can be unspecified.
+	 *
+	 * @param string $lang
+	 */
+	public function setLanguage($lang)
+	{
+		$this->clearCachedValueIf($this->lang != $lang);
+		$this->lang = $lang;
+	}
+
+	/**
+	 * Get the language used in this Header.
+	 *
+	 * @return string
+	 */
+	public function getLanguage()
+	{
+		return $this->lang;
+	}
+
+	/**
+	 * Set the encoder used for encoding the header.
+	 */
+	public function setEncoder(Swift_Mime_HeaderEncoder $encoder)
+	{
+		$this->encoder = $encoder;
+		$this->setCachedValue(null);
+	}
+
+	/**
+	 * Get the encoder used for encoding this Header.
+	 *
+	 * @return Swift_Mime_HeaderEncoder
+	 */
+	public function getEncoder()
+	{
+		return $this->encoder;
+	}
+
+	/**
+	 * Get the name of this header (e.g. charset).
+	 *
+	 * @return string
+	 */
+	public function getFieldName()
+	{
+		return $this->name;
+	}
+
+	/**
+	 * Set the maximum length of lines in the header (excluding EOL).
+	 *
+	 * @param int $lineLength
+	 */
+	public function setMaxLineLength($lineLength)
+	{
+		$this->clearCachedValueIf($this->lineLength != $lineLength);
+		$this->lineLength = $lineLength;
+	}
+
+	/**
+	 * Get the maximum permitted length of lines in this Header.
+	 *
+	 * @return int
+	 */
+	public function getMaxLineLength()
+	{
+		return $this->lineLength;
+	}
+
+	/**
+	 * Get this Header rendered as a RFC 2822 compliant string.
+	 *
+	 * @return string
+	 *
+	 * @throws Swift_RfcComplianceException
+	 */
+	public function toString()
+	{
+		return $this->tokensToString($this->toTokens());
+	}
+
+	/**
+	 * Returns a string representation of this object.
+	 *
+	 * @return string
+	 *
+	 * @see toString()
+	 */
+	public function __toString()
+	{
+		return $this->toString();
+	}
+
+	/**
+	 * Set the name of this Header field.
+	 *
+	 * @param string $name
+	 */
+	protected function setFieldName($name)
+	{
+		$this->name = $name;
+	}
+
+	/**
+	 * Produces a compliant, formatted RFC 2822 'phrase' based on the string given.
+	 *
+	 * @param string $string  as displayed
+	 * @param string $charset of the text
+	 * @param bool   $shorten the first line to make remove for header name
+	 *
+	 * @return string
+	 */
+	protected function createPhrase(Swift_Mime_Header $header, $string, $charset, Swift_Mime_HeaderEncoder $encoder = null, $shorten = false)
+	{
+		// Treat token as exactly what was given
+		$phraseStr = $string;
+		// If it's not valid
+
+		if (!preg_match('/^'.self::PHRASE_PATTERN.'$/D', $phraseStr)) {
+			// .. but it is just ascii text, try escaping some characters
+			// and make it a quoted-string
+			if (preg_match('/^[\x00-\x08\x0B\x0C\x0E-\x7F]*$/D', $phraseStr)) {
+				$phraseStr = $this->escapeSpecials($phraseStr, ['"']);
+				$phraseStr = '"'.$phraseStr.'"';
+			} else {
+				// ... otherwise it needs encoding
+				// Determine space remaining on line if first line
+				if ($shorten) {
+					$usedLength = \strlen($header->getFieldName().': ');
+				} else {
+					$usedLength = 0;
+				}
+				$phraseStr = $this->encodeWords($header, $string, $usedLength);
+			}
+		}
+
+		return $phraseStr;
+	}
+
+	/**
+	 * Escape special characters in a string (convert to quoted-pairs).
+	 *
+	 * @param string   $token
+	 * @param string[] $include additional chars to escape
+	 *
+	 * @return string
+	 */
+	private function escapeSpecials($token, $include = [])
+	{
+		foreach (array_merge(['\\'], $include) as $char) {
+			$token = str_replace($char, '\\'.$char, $token);
+		}
+
+		return $token;
+	}
+
+	/**
+	 * Encode needed word tokens within a string of input.
+	 *
+	 * @param string $input
+	 * @param string $usedLength optional
+	 *
+	 * @return string
+	 */
+	protected function encodeWords(Swift_Mime_Header $header, $input, $usedLength = -1)
+	{
+		$value = '';
+
+		$tokens = $this->getEncodableWordTokens($input);
+
+		foreach ($tokens as $token) {
+			// See RFC 2822, Sect 2.2 (really 2.2 ??)
+			if ($this->tokenNeedsEncoding($token)) {
+				// Don't encode starting WSP
+				$firstChar = substr($token, 0, 1);
+				switch ($firstChar) {
+					case ' ':
+					case "\t":
+						$value .= $firstChar;
+						$token = substr($token, 1);
+				}
+
+				if (-1 == $usedLength) {
+					$usedLength = \strlen($header->getFieldName().': ') + \strlen($value);
+				}
+				$value .= $this->getTokenAsEncodedWord($token, $usedLength);
+
+				$header->setMaxLineLength(76); // Forcefully override
+			} else {
+				$value .= $token;
+			}
+		}
+
+		return $value;
+	}
+
+	/**
+	 * Test if a token needs to be encoded or not.
+	 *
+	 * @param string $token
+	 *
+	 * @return bool
+	 */
+	protected function tokenNeedsEncoding($token)
+	{
+		return preg_match('~[\x00-\x08\x10-\x19\x7F-\xFF\r\n]~', $token);
+	}
+
+	/**
+	 * Splits a string into tokens in blocks of words which can be encoded quickly.
+	 *
+	 * @param string $string
+	 *
+	 * @return string[]
+	 */
+	protected function getEncodableWordTokens($string)
+	{
+		$tokens = [];
+
+		$encodedToken = '';
+		// Split at all whitespace boundaries
+		foreach (preg_split('~(?=[\t ])~', $string ?? '') as $token) {
+			if ($this->tokenNeedsEncoding($token)) {
+				$encodedToken .= $token;
+			} else {
+				if (\strlen($encodedToken) > 0) {
+					$tokens[] = $encodedToken;
+					$encodedToken = '';
+				}
+				$tokens[] = $token;
+			}
+		}
+		if (\strlen($encodedToken)) {
+			$tokens[] = $encodedToken;
+		}
+
+		return $tokens;
+	}
+
+	/**
+	 * Get a token as an encoded word for safe insertion into headers.
+	 *
+	 * @param string $token           token to encode
+	 * @param int    $firstLineOffset optional
+	 *
+	 * @return string
+	 */
+	protected function getTokenAsEncodedWord($token, $firstLineOffset = 0)
+	{
+		// Adjust $firstLineOffset to account for space needed for syntax
+		$charsetDecl = $this->charset;
+		if (isset($this->lang)) {
+			$charsetDecl .= '*'.$this->lang;
+		}
+		$encodingWrapperLength = \strlen(
+			'=?'.$charsetDecl.'?'.$this->encoder->getName().'??='
+			);
+
+		if ($firstLineOffset >= 75) {
+			//Does this logic need to be here?
+			$firstLineOffset = 0;
+		}
+
+		$encodedTextLines = explode("\r\n",
+			$this->encoder->encodeString(
+				$token, $firstLineOffset, 75 - $encodingWrapperLength, $this->charset
+			) ?? ''
+		);
+
+		if ('iso-2022-jp' !== strtolower($this->charset ?? '')) {
+			// special encoding for iso-2022-jp using mb_encode_mimeheader
+			foreach ($encodedTextLines as $lineNum => $line) {
+				$encodedTextLines[$lineNum] = '=?'.$charsetDecl.
+					'?'.$this->encoder->getName().
+					'?'.$line.'?=';
+			}
+		}
+
+		return implode("\r\n ", $encodedTextLines);
+	}
+
+	/**
+	 * Generates tokens from the given string which include CRLF as individual tokens.
+	 *
+	 * @param string $token
+	 *
+	 * @return string[]
+	 */
+	protected function generateTokenLines($token)
+	{
+		return preg_split('~(\r\n)~', $token ?? '', -1, PREG_SPLIT_DELIM_CAPTURE);
+	}
+
+	/**
+	 * Set a value into the cache.
+	 *
+	 * @param string $value
+	 */
+	protected function setCachedValue($value)
+	{
+		$this->cachedValue = $value;
+	}
+
+	/**
+	 * Get the value in the cache.
+	 *
+	 * @return string
+	 */
+	protected function getCachedValue()
+	{
+		return $this->cachedValue;
+	}
+
+	/**
+	 * Clear the cached value if $condition is met.
+	 *
+	 * @param bool $condition
+	 */
+	protected function clearCachedValueIf($condition)
+	{
+		if ($condition) {
+			$this->setCachedValue(null);
+		}
+	}
+
+	/**
+	 * Generate a list of all tokens in the final header.
+	 *
+	 * @param string $string The string to tokenize
+	 *
+	 * @return array An array of tokens as strings
+	 */
+	protected function toTokens($string = null)
+	{
+		if (null === $string) {
+			$string = $this->getFieldBody();
+		}
+
+		$tokens = [];
+
+		// Generate atoms; split at all invisible boundaries followed by WSP
+		foreach (preg_split('~(?=[ \t])~', $string ?? '') as $token) {
+			$newTokens = $this->generateTokenLines($token);
+			foreach ($newTokens as $newToken) {
+				$tokens[] = $newToken;
+			}
+		}
+
+		return $tokens;
+	}
+
+	/**
+	 * Takes an array of tokens which appear in the header and turns them into
+	 * an RFC 2822 compliant string, adding FWSP where needed.
+	 *
+	 * @param string[] $tokens
+	 *
+	 * @return string
+	 */
+	private function tokensToString(array $tokens)
+	{
+		$lineCount = 0;
+		$headerLines = [];
+		$headerLines[] = $this->name.': ';
+		$currentLine = &$headerLines[$lineCount++];
+
+		// Build all tokens back into compliant header
+		foreach ($tokens as $i => $token) {
+			// Line longer than specified maximum or token was just a new line
+			if (("\r\n" == $token) ||
+				($i > 0 && \strlen($currentLine.$token) > $this->lineLength)
+				&& 0 < \strlen($currentLine)) {
+				$headerLines[] = '';
+				$currentLine = &$headerLines[$lineCount++];
+			}
+
+			// Append token to the line
+			if ("\r\n" != $token) {
+				$currentLine .= $token;
+			}
+		}
+
+		// Implode with FWS (RFC 2822, 2.2.3)
+		return implode("\r\n", $headerLines)."\r\n";
+	}
+
+	/**
+	 * Make a deep copy of object.
+	 */
+	public function __clone()
+	{
+		if ($this->encoder) {
+			$this->encoder = clone $this->encoder;
+		}
+	}
 }

htdocs/includes/swiftmailer/lib/classes/Swift/Mime/CharsetObserver.php

Indentation +6 added lines, -6 removed lines

@@ -15,10 +15,10 @@
  */
 interface Swift_Mime_CharsetObserver
 {
-    /**
-     * Notify this observer that the entity's charset has changed.
-     *
-     * @param string $charset
-     */
-    public function charsetChanged($charset);
+	/**
+	 * Notify this observer that the entity's charset has changed.
+	 *
+	 * @param string $charset
+	 */
+	public function charsetChanged($charset);
 }

htdocs/includes/swiftmailer/lib/classes/Swift/Mime/Header.php

Indentation +63 added lines, -63 removed lines

@@ -15,79 +15,79 @@
  */
 interface Swift_Mime_Header
 {
-    /** Text headers */
-    const TYPE_TEXT = 2;
+	/** Text headers */
+	const TYPE_TEXT = 2;
 
-    /**  headers (text + params) */
-    const TYPE_PARAMETERIZED = 6;
+	/**  headers (text + params) */
+	const TYPE_PARAMETERIZED = 6;
 
-    /** Mailbox and address headers */
-    const TYPE_MAILBOX = 8;
+	/** Mailbox and address headers */
+	const TYPE_MAILBOX = 8;
 
-    /** Date and time headers */
-    const TYPE_DATE = 16;
+	/** Date and time headers */
+	const TYPE_DATE = 16;
 
-    /** Identification headers */
-    const TYPE_ID = 32;
+	/** Identification headers */
+	const TYPE_ID = 32;
 
-    /** Address path headers */
-    const TYPE_PATH = 64;
+	/** Address path headers */
+	const TYPE_PATH = 64;
 
-    /**
-     * Get the type of Header that this instance represents.
-     *
-     * @see TYPE_TEXT, TYPE_PARAMETERIZED, TYPE_MAILBOX
-     * @see TYPE_DATE, TYPE_ID, TYPE_PATH
-     *
-     * @return int
-     */
-    public function getFieldType();
+	/**
+	 * Get the type of Header that this instance represents.
+	 *
+	 * @see TYPE_TEXT, TYPE_PARAMETERIZED, TYPE_MAILBOX
+	 * @see TYPE_DATE, TYPE_ID, TYPE_PATH
+	 *
+	 * @return int
+	 */
+	public function getFieldType();
 
-    /**
-     * Set the model for the field body.
-     *
-     * The actual types needed will vary depending upon the type of Header.
-     *
-     * @param mixed $model
-     */
-    public function setFieldBodyModel($model);
+	/**
+	 * Set the model for the field body.
+	 *
+	 * The actual types needed will vary depending upon the type of Header.
+	 *
+	 * @param mixed $model
+	 */
+	public function setFieldBodyModel($model);
 
-    /**
-     * Set the charset used when rendering the Header.
-     *
-     * @param string $charset
-     */
-    public function setCharset($charset);
+	/**
+	 * Set the charset used when rendering the Header.
+	 *
+	 * @param string $charset
+	 */
+	public function setCharset($charset);
 
-    /**
-     * Get the model for the field body.
-     *
-     * The return type depends on the specifics of the Header.
-     *
-     * @return mixed
-     */
-    public function getFieldBodyModel();
+	/**
+	 * Get the model for the field body.
+	 *
+	 * The return type depends on the specifics of the Header.
+	 *
+	 * @return mixed
+	 */
+	public function getFieldBodyModel();
 
-    /**
-     * Get the name of this header (e.g. Subject).
-     *
-     * The name is an identifier and as such will be immutable.
-     *
-     * @return string
-     */
-    public function getFieldName();
+	/**
+	 * Get the name of this header (e.g. Subject).
+	 *
+	 * The name is an identifier and as such will be immutable.
+	 *
+	 * @return string
+	 */
+	public function getFieldName();
 
-    /**
-     * Get the field body, prepared for folding into a final header value.
-     *
-     * @return string
-     */
-    public function getFieldBody();
+	/**
+	 * Get the field body, prepared for folding into a final header value.
+	 *
+	 * @return string
+	 */
+	public function getFieldBody();
 
-    /**
-     * Get this Header rendered as a compliant string, including trailing CRLF.
-     *
-     * @return string
-     */
-    public function toString();
+	/**
+	 * Get this Header rendered as a compliant string, including trailing CRLF.
+	 *
+	 * @return string
+	 */
+	public function toString();
 }

htdocs/includes/swiftmailer/lib/classes/Swift/Mime/SimpleHeaderSet.php

Indentation +381 added lines, -381 removed lines

@@ -15,385 +15,385 @@
  */
 class Swift_Mime_SimpleHeaderSet implements Swift_Mime_CharsetObserver
 {
-    /** HeaderFactory */
-    private $factory;
-
-    /** Collection of set Headers */
-    private $headers = [];
-
-    /** Field ordering details */
-    private $order = [];
-
-    /** List of fields which are required to be displayed */
-    private $required = [];
-
-    /** The charset used by Headers */
-    private $charset;
-
-    /**
-     * Create a new SimpleHeaderSet with the given $factory.
-     *
-     * @param string $charset
-     */
-    public function __construct(Swift_Mime_SimpleHeaderFactory $factory, $charset = null)
-    {
-        $this->factory = $factory;
-        if (isset($charset)) {
-            $this->setCharset($charset);
-        }
-    }
-
-    public function newInstance()
-    {
-        return new self($this->factory);
-    }
-
-    /**
-     * Set the charset used by these headers.
-     *
-     * @param string $charset
-     */
-    public function setCharset($charset)
-    {
-        $this->charset = $charset;
-        $this->factory->charsetChanged($charset);
-        $this->notifyHeadersOfCharset($charset);
-    }
-
-    /**
-     * Add a new Mailbox Header with a list of $addresses.
-     *
-     * @param string       $name
-     * @param array|string $addresses
-     */
-    public function addMailboxHeader($name, $addresses = null)
-    {
-        $this->storeHeader($name, $this->factory->createMailboxHeader($name, $addresses));
-    }
-
-    /**
-     * Add a new Date header using $dateTime.
-     *
-     * @param string $name
-     */
-    public function addDateHeader($name, DateTimeInterface $dateTime = null)
-    {
-        $this->storeHeader($name, $this->factory->createDateHeader($name, $dateTime));
-    }
-
-    /**
-     * Add a new basic text header with $name and $value.
-     *
-     * @param string $name
-     * @param string $value
-     */
-    public function addTextHeader($name, $value = null)
-    {
-        $this->storeHeader($name, $this->factory->createTextHeader($name, $value));
-    }
-
-    /**
-     * Add a new ParameterizedHeader with $name, $value and $params.
-     *
-     * @param string $name
-     * @param string $value
-     * @param array  $params
-     */
-    public function addParameterizedHeader($name, $value = null, $params = [])
-    {
-        $this->storeHeader($name, $this->factory->createParameterizedHeader($name, $value, $params));
-    }
-
-    /**
-     * Add a new ID header for Message-ID or Content-ID.
-     *
-     * @param string       $name
-     * @param string|array $ids
-     */
-    public function addIdHeader($name, $ids = null)
-    {
-        $this->storeHeader($name, $this->factory->createIdHeader($name, $ids));
-    }
-
-    /**
-     * Add a new Path header with an address (path) in it.
-     *
-     * @param string $name
-     * @param string $path
-     */
-    public function addPathHeader($name, $path = null)
-    {
-        $this->storeHeader($name, $this->factory->createPathHeader($name, $path));
-    }
-
-    /**
-     * Returns true if at least one header with the given $name exists.
-     *
-     * If multiple headers match, the actual one may be specified by $index.
-     *
-     * @param string $name
-     * @param int    $index
-     *
-     * @return bool
-     */
-    public function has($name, $index = 0)
-    {
-        $lowerName = strtolower($name ?? '');
-
-        if (!\array_key_exists($lowerName, $this->headers)) {
-            return false;
-        }
-
-        if (\func_num_args() < 2) {
-            // index was not specified, so we only need to check that there is at least one header value set
-            return (bool) \count($this->headers[$lowerName]);
-        }
-
-        return \array_key_exists($index, $this->headers[$lowerName]);
-    }
-
-    /**
-     * Set a header in the HeaderSet.
-     *
-     * The header may be a previously fetched header via {@link get()} or it may
-     * be one that has been created separately.
-     *
-     * If $index is specified, the header will be inserted into the set at this
-     * offset.
-     *
-     * @param int $index
-     */
-    public function set(Swift_Mime_Header $header, $index = 0)
-    {
-        $this->storeHeader($header->getFieldName(), $header, $index);
-    }
-
-    /**
-     * Get the header with the given $name.
-     *
-     * If multiple headers match, the actual one may be specified by $index.
-     * Returns NULL if none present.
-     *
-     * @param string $name
-     * @param int    $index
-     *
-     * @return Swift_Mime_Header|null
-     */
-    public function get($name, $index = 0)
-    {
-        $name = strtolower($name ?? '');
-
-        if (\func_num_args() < 2) {
-            if ($this->has($name)) {
-                $values = array_values($this->headers[$name]);
-
-                return array_shift($values);
-            }
-        } else {
-            if ($this->has($name, $index)) {
-                return $this->headers[$name][$index];
-            }
-        }
-    }
-
-    /**
-     * Get all headers with the given $name.
-     *
-     * @param string $name
-     *
-     * @return array
-     */
-    public function getAll($name = null)
-    {
-        if (!isset($name)) {
-            $headers = [];
-            foreach ($this->headers as $collection) {
-                $headers = array_merge($headers, $collection);
-            }
-
-            return $headers;
-        }
-
-        $lowerName = strtolower($name ?? '');
-        if (!\array_key_exists($lowerName, $this->headers)) {
-            return [];
-        }
-
-        return $this->headers[$lowerName];
-    }
-
-    /**
-     * Return the name of all Headers.
-     *
-     * @return array
-     */
-    public function listAll()
-    {
-        $headers = $this->headers;
-        if ($this->canSort()) {
-            uksort($headers, [$this, 'sortHeaders']);
-        }
-
-        return array_keys($headers);
-    }
-
-    /**
-     * Remove the header with the given $name if it's set.
-     *
-     * If multiple headers match, the actual one may be specified by $index.
-     *
-     * @param string $name
-     * @param int    $index
-     */
-    public function remove($name, $index = 0)
-    {
-        $lowerName = strtolower($name ?? '');
-        unset($this->headers[$lowerName][$index]);
-    }
-
-    /**
-     * Remove all headers with the given $name.
-     *
-     * @param string $name
-     */
-    public function removeAll($name)
-    {
-        $lowerName = strtolower($name ?? '');
-        unset($this->headers[$lowerName]);
-    }
-
-    /**
-     * Define a list of Header names as an array in the correct order.
-     *
-     * These Headers will be output in the given order where present.
-     */
-    public function defineOrdering(array $sequence)
-    {
-        $this->order = array_flip(array_map('strtolower', $sequence));
-    }
-
-    /**
-     * Set a list of header names which must always be displayed when set.
-     *
-     * Usually headers without a field value won't be output unless set here.
-     */
-    public function setAlwaysDisplayed(array $names)
-    {
-        $this->required = array_flip(array_map('strtolower', $names));
-    }
-
-    /**
-     * Notify this observer that the entity's charset has changed.
-     *
-     * @param string $charset
-     */
-    public function charsetChanged($charset)
-    {
-        $this->setCharset($charset);
-    }
-
-    /**
-     * Returns a string with a representation of all headers.
-     *
-     * @return string
-     */
-    public function toString()
-    {
-        $string = '';
-        $headers = $this->headers;
-        if ($this->canSort()) {
-            uksort($headers, [$this, 'sortHeaders']);
-        }
-        foreach ($headers as $collection) {
-            foreach ($collection as $header) {
-                if ($this->isDisplayed($header) || '' != $header->getFieldBody()) {
-                    $string .= $header->toString();
-                }
-            }
-        }
-
-        return $string;
-    }
-
-    /**
-     * Returns a string representation of this object.
-     *
-     * @return string
-     *
-     * @see toString()
-     */
-    public function __toString()
-    {
-        return $this->toString();
-    }
-
-    /** Save a Header to the internal collection */
-    private function storeHeader($name, Swift_Mime_Header $header, $offset = null)
-    {
-        if (!isset($this->headers[strtolower($name ?? '')])) {
-            $this->headers[strtolower($name ?? '')] = [];
-        }
-        if (!isset($offset)) {
-            $this->headers[strtolower($name ?? '')][] = $header;
-        } else {
-            $this->headers[strtolower($name ?? '')][$offset] = $header;
-        }
-    }
-
-    /** Test if the headers can be sorted */
-    private function canSort()
-    {
-        return \count($this->order) > 0;
-    }
-
-    /** uksort() algorithm for Header ordering */
-    private function sortHeaders($a, $b)
-    {
-        $lowerA = strtolower($a ?? '');
-        $lowerB = strtolower($b ?? '');
-        $aPos = \array_key_exists($lowerA, $this->order) ? $this->order[$lowerA] : -1;
-        $bPos = \array_key_exists($lowerB, $this->order) ? $this->order[$lowerB] : -1;
-
-        if (-1 === $aPos && -1 === $bPos) {
-            // just be sure to be determinist here
-            return $a > $b ? -1 : 1;
-        }
-
-        if (-1 == $aPos) {
-            return 1;
-        } elseif (-1 == $bPos) {
-            return -1;
-        }
-
-        return $aPos < $bPos ? -1 : 1;
-    }
-
-    /** Test if the given Header is always displayed */
-    private function isDisplayed(Swift_Mime_Header $header)
-    {
-        return \array_key_exists(strtolower($header->getFieldName() ?? ''), $this->required);
-    }
-
-    /** Notify all Headers of the new charset */
-    private function notifyHeadersOfCharset($charset)
-    {
-        foreach ($this->headers as $headerGroup) {
-            foreach ($headerGroup as $header) {
-                $header->setCharset($charset);
-            }
-        }
-    }
-
-    /**
-     * Make a deep copy of object.
-     */
-    public function __clone()
-    {
-        $this->factory = clone $this->factory;
-        foreach ($this->headers as $groupKey => $headerGroup) {
-            foreach ($headerGroup as $key => $header) {
-                $this->headers[$groupKey][$key] = clone $header;
-            }
-        }
-    }
+	/** HeaderFactory */
+	private $factory;
+
+	/** Collection of set Headers */
+	private $headers = [];
+
+	/** Field ordering details */
+	private $order = [];
+
+	/** List of fields which are required to be displayed */
+	private $required = [];
+
+	/** The charset used by Headers */
+	private $charset;
+
+	/**
+	 * Create a new SimpleHeaderSet with the given $factory.
+	 *
+	 * @param string $charset
+	 */
+	public function __construct(Swift_Mime_SimpleHeaderFactory $factory, $charset = null)
+	{
+		$this->factory = $factory;
+		if (isset($charset)) {
+			$this->setCharset($charset);
+		}
+	}
+
+	public function newInstance()
+	{
+		return new self($this->factory);
+	}
+
+	/**
+	 * Set the charset used by these headers.
+	 *
+	 * @param string $charset
+	 */
+	public function setCharset($charset)
+	{
+		$this->charset = $charset;
+		$this->factory->charsetChanged($charset);
+		$this->notifyHeadersOfCharset($charset);
+	}
+
+	/**
+	 * Add a new Mailbox Header with a list of $addresses.
+	 *
+	 * @param string       $name
+	 * @param array|string $addresses
+	 */
+	public function addMailboxHeader($name, $addresses = null)
+	{
+		$this->storeHeader($name, $this->factory->createMailboxHeader($name, $addresses));
+	}
+
+	/**
+	 * Add a new Date header using $dateTime.
+	 *
+	 * @param string $name
+	 */
+	public function addDateHeader($name, DateTimeInterface $dateTime = null)
+	{
+		$this->storeHeader($name, $this->factory->createDateHeader($name, $dateTime));
+	}
+
+	/**
+	 * Add a new basic text header with $name and $value.
+	 *
+	 * @param string $name
+	 * @param string $value
+	 */
+	public function addTextHeader($name, $value = null)
+	{
+		$this->storeHeader($name, $this->factory->createTextHeader($name, $value));
+	}
+
+	/**
+	 * Add a new ParameterizedHeader with $name, $value and $params.
+	 *
+	 * @param string $name
+	 * @param string $value
+	 * @param array  $params
+	 */
+	public function addParameterizedHeader($name, $value = null, $params = [])
+	{
+		$this->storeHeader($name, $this->factory->createParameterizedHeader($name, $value, $params));
+	}
+
+	/**
+	 * Add a new ID header for Message-ID or Content-ID.
+	 *
+	 * @param string       $name
+	 * @param string|array $ids
+	 */
+	public function addIdHeader($name, $ids = null)
+	{
+		$this->storeHeader($name, $this->factory->createIdHeader($name, $ids));
+	}
+
+	/**
+	 * Add a new Path header with an address (path) in it.
+	 *
+	 * @param string $name
+	 * @param string $path
+	 */
+	public function addPathHeader($name, $path = null)
+	{
+		$this->storeHeader($name, $this->factory->createPathHeader($name, $path));
+	}
+
+	/**
+	 * Returns true if at least one header with the given $name exists.
+	 *
+	 * If multiple headers match, the actual one may be specified by $index.
+	 *
+	 * @param string $name
+	 * @param int    $index
+	 *
+	 * @return bool
+	 */
+	public function has($name, $index = 0)
+	{
+		$lowerName = strtolower($name ?? '');
+
+		if (!\array_key_exists($lowerName, $this->headers)) {
+			return false;
+		}
+
+		if (\func_num_args() < 2) {
+			// index was not specified, so we only need to check that there is at least one header value set
+			return (bool) \count($this->headers[$lowerName]);
+		}
+
+		return \array_key_exists($index, $this->headers[$lowerName]);
+	}
+
+	/**
+	 * Set a header in the HeaderSet.
+	 *
+	 * The header may be a previously fetched header via {@link get()} or it may
+	 * be one that has been created separately.
+	 *
+	 * If $index is specified, the header will be inserted into the set at this
+	 * offset.
+	 *
+	 * @param int $index
+	 */
+	public function set(Swift_Mime_Header $header, $index = 0)
+	{
+		$this->storeHeader($header->getFieldName(), $header, $index);
+	}
+
+	/**
+	 * Get the header with the given $name.
+	 *
+	 * If multiple headers match, the actual one may be specified by $index.
+	 * Returns NULL if none present.
+	 *
+	 * @param string $name
+	 * @param int    $index
+	 *
+	 * @return Swift_Mime_Header|null
+	 */
+	public function get($name, $index = 0)
+	{
+		$name = strtolower($name ?? '');
+
+		if (\func_num_args() < 2) {
+			if ($this->has($name)) {
+				$values = array_values($this->headers[$name]);
+
+				return array_shift($values);
+			}
+		} else {
+			if ($this->has($name, $index)) {
+				return $this->headers[$name][$index];
+			}
+		}
+	}
+
+	/**
+	 * Get all headers with the given $name.
+	 *
+	 * @param string $name
+	 *
+	 * @return array
+	 */
+	public function getAll($name = null)
+	{
+		if (!isset($name)) {
+			$headers = [];
+			foreach ($this->headers as $collection) {
+				$headers = array_merge($headers, $collection);
+			}
+
+			return $headers;
+		}
+
+		$lowerName = strtolower($name ?? '');
+		if (!\array_key_exists($lowerName, $this->headers)) {
+			return [];
+		}
+
+		return $this->headers[$lowerName];
+	}
+
+	/**
+	 * Return the name of all Headers.
+	 *
+	 * @return array
+	 */
+	public function listAll()
+	{
+		$headers = $this->headers;
+		if ($this->canSort()) {
+			uksort($headers, [$this, 'sortHeaders']);
+		}
+
+		return array_keys($headers);
+	}
+
+	/**
+	 * Remove the header with the given $name if it's set.
+	 *
+	 * If multiple headers match, the actual one may be specified by $index.
+	 *
+	 * @param string $name
+	 * @param int    $index
+	 */
+	public function remove($name, $index = 0)
+	{
+		$lowerName = strtolower($name ?? '');
+		unset($this->headers[$lowerName][$index]);
+	}
+
+	/**
+	 * Remove all headers with the given $name.
+	 *
+	 * @param string $name
+	 */
+	public function removeAll($name)
+	{
+		$lowerName = strtolower($name ?? '');
+		unset($this->headers[$lowerName]);
+	}
+
+	/**
+	 * Define a list of Header names as an array in the correct order.
+	 *
+	 * These Headers will be output in the given order where present.
+	 */
+	public function defineOrdering(array $sequence)
+	{
+		$this->order = array_flip(array_map('strtolower', $sequence));
+	}
+
+	/**
+	 * Set a list of header names which must always be displayed when set.
+	 *
+	 * Usually headers without a field value won't be output unless set here.
+	 */
+	public function setAlwaysDisplayed(array $names)
+	{
+		$this->required = array_flip(array_map('strtolower', $names));
+	}
+
+	/**
+	 * Notify this observer that the entity's charset has changed.
+	 *
+	 * @param string $charset
+	 */
+	public function charsetChanged($charset)
+	{
+		$this->setCharset($charset);
+	}
+
+	/**
+	 * Returns a string with a representation of all headers.
+	 *
+	 * @return string
+	 */
+	public function toString()
+	{
+		$string = '';
+		$headers = $this->headers;
+		if ($this->canSort()) {
+			uksort($headers, [$this, 'sortHeaders']);
+		}
+		foreach ($headers as $collection) {
+			foreach ($collection as $header) {
+				if ($this->isDisplayed($header) || '' != $header->getFieldBody()) {
+					$string .= $header->toString();
+				}
+			}
+		}
+
+		return $string;
+	}
+
+	/**
+	 * Returns a string representation of this object.
+	 *
+	 * @return string
+	 *
+	 * @see toString()
+	 */
+	public function __toString()
+	{
+		return $this->toString();
+	}
+
+	/** Save a Header to the internal collection */
+	private function storeHeader($name, Swift_Mime_Header $header, $offset = null)
+	{
+		if (!isset($this->headers[strtolower($name ?? '')])) {
+			$this->headers[strtolower($name ?? '')] = [];
+		}
+		if (!isset($offset)) {
+			$this->headers[strtolower($name ?? '')][] = $header;
+		} else {
+			$this->headers[strtolower($name ?? '')][$offset] = $header;
+		}
+	}
+
+	/** Test if the headers can be sorted */
+	private function canSort()
+	{
+		return \count($this->order) > 0;
+	}
+
+	/** uksort() algorithm for Header ordering */
+	private function sortHeaders($a, $b)
+	{
+		$lowerA = strtolower($a ?? '');
+		$lowerB = strtolower($b ?? '');
+		$aPos = \array_key_exists($lowerA, $this->order) ? $this->order[$lowerA] : -1;
+		$bPos = \array_key_exists($lowerB, $this->order) ? $this->order[$lowerB] : -1;
+
+		if (-1 === $aPos && -1 === $bPos) {
+			// just be sure to be determinist here
+			return $a > $b ? -1 : 1;
+		}
+
+		if (-1 == $aPos) {
+			return 1;
+		} elseif (-1 == $bPos) {
+			return -1;
+		}
+
+		return $aPos < $bPos ? -1 : 1;
+	}
+
+	/** Test if the given Header is always displayed */
+	private function isDisplayed(Swift_Mime_Header $header)
+	{
+		return \array_key_exists(strtolower($header->getFieldName() ?? ''), $this->required);
+	}
+
+	/** Notify all Headers of the new charset */
+	private function notifyHeadersOfCharset($charset)
+	{
+		foreach ($this->headers as $headerGroup) {
+			foreach ($headerGroup as $header) {
+				$header->setCharset($charset);
+			}
+		}
+	}
+
+	/**
+	 * Make a deep copy of object.
+	 */
+	public function __clone()
+	{
+		$this->factory = clone $this->factory;
+		foreach ($this->headers as $groupKey => $headerGroup) {
+			foreach ($headerGroup as $key => $header) {
+				$this->headers[$groupKey][$key] = clone $header;
+			}
+		}
+	}
 }

htdocs/includes/swiftmailer/lib/classes/Swift/Preferences.php

Indentation +71 added lines, -71 removed lines

@@ -15,86 +15,86 @@
  */
 class Swift_Preferences
 {
-    /** Singleton instance */
-    private static $instance = null;
+	/** Singleton instance */
+	private static $instance = null;
 
-    /** Constructor not to be used */
-    private function __construct()
-    {
-    }
+	/** Constructor not to be used */
+	private function __construct()
+	{
+	}
 
-    /**
-     * Gets the instance of Preferences.
-     *
-     * @return self
-     */
-    public static function getInstance()
-    {
-        if (!isset(self::$instance)) {
-            self::$instance = new self();
-        }
+	/**
+	 * Gets the instance of Preferences.
+	 *
+	 * @return self
+	 */
+	public static function getInstance()
+	{
+		if (!isset(self::$instance)) {
+			self::$instance = new self();
+		}
 
-        return self::$instance;
-    }
+		return self::$instance;
+	}
 
-    /**
-     * Set the default charset used.
-     *
-     * @param string $charset
-     *
-     * @return $this
-     */
-    public function setCharset($charset)
-    {
-        Swift_DependencyContainer::getInstance()->register('properties.charset')->asValue($charset);
+	/**
+	 * Set the default charset used.
+	 *
+	 * @param string $charset
+	 *
+	 * @return $this
+	 */
+	public function setCharset($charset)
+	{
+		Swift_DependencyContainer::getInstance()->register('properties.charset')->asValue($charset);
 
-        return $this;
-    }
+		return $this;
+	}
 
-    /**
-     * Set the directory where temporary files can be saved.
-     *
-     * @param string $dir
-     *
-     * @return $this
-     */
-    public function setTempDir($dir)
-    {
-        Swift_DependencyContainer::getInstance()->register('tempdir')->asValue($dir);
+	/**
+	 * Set the directory where temporary files can be saved.
+	 *
+	 * @param string $dir
+	 *
+	 * @return $this
+	 */
+	public function setTempDir($dir)
+	{
+		Swift_DependencyContainer::getInstance()->register('tempdir')->asValue($dir);
 
-        return $this;
-    }
+		return $this;
+	}
 
-    /**
-     * Set the type of cache to use (i.e. "disk" or "array").
-     *
-     * @param string $type
-     *
-     * @return $this
-     */
-    public function setCacheType($type)
-    {
-        Swift_DependencyContainer::getInstance()->register('cache')->asAliasOf(sprintf('cache.%s', $type));
+	/**
+	 * Set the type of cache to use (i.e. "disk" or "array").
+	 *
+	 * @param string $type
+	 *
+	 * @return $this
+	 */
+	public function setCacheType($type)
+	{
+		Swift_DependencyContainer::getInstance()->register('cache')->asAliasOf(sprintf('cache.%s', $type));
 
-        return $this;
-    }
+		return $this;
+	}
 
-    /**
-     * Set the QuotedPrintable dot escaper preference.
-     *
-     * @param bool $dotEscape
-     *
-     * @return $this
-     */
-    public function setQPDotEscape($dotEscape)
-    {
-        $dotEscape = !empty($dotEscape);
-        Swift_DependencyContainer::getInstance()
-            ->register('mime.qpcontentencoder')
-            ->asNewInstanceOf('Swift_Mime_ContentEncoder_QpContentEncoder')
-            ->withDependencies(['mime.charstream', 'mime.bytecanonicalizer'])
-            ->addConstructorValue($dotEscape);
+	/**
+	 * Set the QuotedPrintable dot escaper preference.
+	 *
+	 * @param bool $dotEscape
+	 *
+	 * @return $this
+	 */
+	public function setQPDotEscape($dotEscape)
+	{
+		$dotEscape = !empty($dotEscape);
+		Swift_DependencyContainer::getInstance()
+			->register('mime.qpcontentencoder')
+			->asNewInstanceOf('Swift_Mime_ContentEncoder_QpContentEncoder')
+			->withDependencies(['mime.charstream', 'mime.bytecanonicalizer'])
+			->addConstructorValue($dotEscape);
 
-        return $this;
-    }
+		return $this;
+	}
 }

htdocs/includes/swiftmailer/lib/classes/Swift/LoadBalancedTransport.php

Indentation +14 added lines, -14 removed lines

@@ -15,19 +15,19 @@
  */
 class Swift_LoadBalancedTransport extends Swift_Transport_LoadBalancedTransport
 {
-    /**
-     * Creates a new LoadBalancedTransport with $transports.
-     *
-     * @param array $transports
-     */
-    public function __construct($transports = [])
-    {
-        \call_user_func_array(
-            [$this, 'Swift_Transport_LoadBalancedTransport::__construct'],
-            Swift_DependencyContainer::getInstance()
-                ->createDependenciesFor('transport.loadbalanced')
-            );
+	/**
+	 * Creates a new LoadBalancedTransport with $transports.
+	 *
+	 * @param array $transports
+	 */
+	public function __construct($transports = [])
+	{
+		\call_user_func_array(
+			[$this, 'Swift_Transport_LoadBalancedTransport::__construct'],
+			Swift_DependencyContainer::getInstance()
+				->createDependenciesFor('transport.loadbalanced')
+			);
 
-        $this->setTransports($transports);
-    }
+		$this->setTransports($transports);
+	}
 }

htdocs/includes/swiftmailer/lib/classes/Swift/AddressEncoderException.php

Indentation +10 added lines, -10 removed lines

@@ -16,17 +16,17 @@
  */
 class Swift_AddressEncoderException extends Swift_RfcComplianceException
 {
-    protected $address;
+	protected $address;
 
-    public function __construct(string $message, string $address)
-    {
-        parent::__construct($message);
+	public function __construct(string $message, string $address)
+	{
+		parent::__construct($message);
 
-        $this->address = $address;
-    }
+		$this->address = $address;
+	}
 
-    public function getAddress(): string
-    {
-        return $this->address;
-    }
+	public function getAddress(): string
+	{
+		return $this->address;
+	}
 }

htdocs/includes/swiftmailer/lib/classes/Swift/CharacterReader/GenericFixedWidthReader.php

Indentation +71 added lines, -71 removed lines

@@ -16,82 +16,82 @@
  */
 class Swift_CharacterReader_GenericFixedWidthReader implements Swift_CharacterReader
 {
-    /**
-     * The number of bytes in a single character.
-     *
-     * @var int
-     */
-    private $width;
+	/**
+	 * The number of bytes in a single character.
+	 *
+	 * @var int
+	 */
+	private $width;
 
-    /**
-     * Creates a new GenericFixedWidthReader using $width bytes per character.
-     *
-     * @param int $width
-     */
-    public function __construct($width)
-    {
-        $this->width = $width;
-    }
+	/**
+	 * Creates a new GenericFixedWidthReader using $width bytes per character.
+	 *
+	 * @param int $width
+	 */
+	public function __construct($width)
+	{
+		$this->width = $width;
+	}
 
-    /**
-     * Returns the complete character map.
-     *
-     * @param string $string
-     * @param int    $startOffset
-     * @param array  $currentMap
-     * @param mixed  $ignoredChars
-     *
-     * @return int
-     */
-    public function getCharPositions($string, $startOffset, &$currentMap, &$ignoredChars)
-    {
-        $strlen = \strlen($string);
-        // % and / are CPU intensive, so, maybe find a better way
-        $ignored = $strlen % $this->width;
-        $ignoredChars = $ignored ? substr($string, -$ignored) : '';
-        $currentMap = $this->width;
+	/**
+	 * Returns the complete character map.
+	 *
+	 * @param string $string
+	 * @param int    $startOffset
+	 * @param array  $currentMap
+	 * @param mixed  $ignoredChars
+	 *
+	 * @return int
+	 */
+	public function getCharPositions($string, $startOffset, &$currentMap, &$ignoredChars)
+	{
+		$strlen = \strlen($string);
+		// % and / are CPU intensive, so, maybe find a better way
+		$ignored = $strlen % $this->width;
+		$ignoredChars = $ignored ? substr($string, -$ignored) : '';
+		$currentMap = $this->width;
 
-        return ($strlen - $ignored) / $this->width;
-    }
+		return ($strlen - $ignored) / $this->width;
+	}
 
-    /**
-     * Returns the mapType.
-     *
-     * @return int
-     */
-    public function getMapType()
-    {
-        return self::MAP_TYPE_FIXED_LEN;
-    }
+	/**
+	 * Returns the mapType.
+	 *
+	 * @return int
+	 */
+	public function getMapType()
+	{
+		return self::MAP_TYPE_FIXED_LEN;
+	}
 
-    /**
-     * Returns an integer which specifies how many more bytes to read.
-     *
-     * A positive integer indicates the number of more bytes to fetch before invoking
-     * this method again.
-     *
-     * A value of zero means this is already a valid character.
-     * A value of -1 means this cannot possibly be a valid character.
-     *
-     * @param string $bytes
-     * @param int    $size
-     *
-     * @return int
-     */
-    public function validateByteSequence($bytes, $size)
-    {
-        $needed = $this->width - $size;
+	/**
+	 * Returns an integer which specifies how many more bytes to read.
+	 *
+	 * A positive integer indicates the number of more bytes to fetch before invoking
+	 * this method again.
+	 *
+	 * A value of zero means this is already a valid character.
+	 * A value of -1 means this cannot possibly be a valid character.
+	 *
+	 * @param string $bytes
+	 * @param int    $size
+	 *
+	 * @return int
+	 */
+	public function validateByteSequence($bytes, $size)
+	{
+		$needed = $this->width - $size;
 
-        return $needed > -1 ? $needed : -1;
-    }
+		return $needed > -1 ? $needed : -1;
+	}
 
-    /**
-     * Returns the number of bytes which should be read to start each character.
-     *
-     * @return int
-     */
-    public function getInitialByteSize()
-    {
-        return $this->width;
-    }
+	/**
+	 * Returns the number of bytes which should be read to start each character.
+	 *
+	 * @return int
+	 */
+	public function getInitialByteSize()
+	{
+		return $this->width;
+	}
 }

htdocs/includes/swiftmailer/lib/classes/Swift/CharacterReader/Utf8Reader.php

Indentation +149 added lines, -149 removed lines

@@ -16,161 +16,161 @@
  */
 class Swift_CharacterReader_Utf8Reader implements Swift_CharacterReader
 {
-    /** Pre-computed for optimization */
-    private static $length_map = [
-        // N=0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x0N
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x1N
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x2N
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x3N
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x4N
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x5N
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x6N
-        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x7N
-        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0x8N
-        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0x9N
-        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0xAN
-        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0xBN
-        2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, // 0xCN
-        2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, // 0xDN
-        3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, // 0xEN
-        4, 4, 4, 4, 4, 4, 4, 4, 5, 5, 5, 5, 6, 6, 0, 0, // 0xFN
-    ];
+	/** Pre-computed for optimization */
+	private static $length_map = [
+		// N=0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x0N
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x1N
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x2N
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x3N
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x4N
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x5N
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x6N
+		1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x7N
+		0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0x8N
+		0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0x9N
+		0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0xAN
+		0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0xBN
+		2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, // 0xCN
+		2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, // 0xDN
+		3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, // 0xEN
+		4, 4, 4, 4, 4, 4, 4, 4, 5, 5, 5, 5, 6, 6, 0, 0, // 0xFN
+	];
 
-    private static $s_length_map = [
-        "\x00" => 1, "\x01" => 1, "\x02" => 1, "\x03" => 1, "\x04" => 1, "\x05" => 1, "\x06" => 1, "\x07" => 1,
-        "\x08" => 1, "\x09" => 1, "\x0a" => 1, "\x0b" => 1, "\x0c" => 1, "\x0d" => 1, "\x0e" => 1, "\x0f" => 1,
-        "\x10" => 1, "\x11" => 1, "\x12" => 1, "\x13" => 1, "\x14" => 1, "\x15" => 1, "\x16" => 1, "\x17" => 1,
-        "\x18" => 1, "\x19" => 1, "\x1a" => 1, "\x1b" => 1, "\x1c" => 1, "\x1d" => 1, "\x1e" => 1, "\x1f" => 1,
-        "\x20" => 1, "\x21" => 1, "\x22" => 1, "\x23" => 1, "\x24" => 1, "\x25" => 1, "\x26" => 1, "\x27" => 1,
-        "\x28" => 1, "\x29" => 1, "\x2a" => 1, "\x2b" => 1, "\x2c" => 1, "\x2d" => 1, "\x2e" => 1, "\x2f" => 1,
-        "\x30" => 1, "\x31" => 1, "\x32" => 1, "\x33" => 1, "\x34" => 1, "\x35" => 1, "\x36" => 1, "\x37" => 1,
-        "\x38" => 1, "\x39" => 1, "\x3a" => 1, "\x3b" => 1, "\x3c" => 1, "\x3d" => 1, "\x3e" => 1, "\x3f" => 1,
-        "\x40" => 1, "\x41" => 1, "\x42" => 1, "\x43" => 1, "\x44" => 1, "\x45" => 1, "\x46" => 1, "\x47" => 1,
-        "\x48" => 1, "\x49" => 1, "\x4a" => 1, "\x4b" => 1, "\x4c" => 1, "\x4d" => 1, "\x4e" => 1, "\x4f" => 1,
-        "\x50" => 1, "\x51" => 1, "\x52" => 1, "\x53" => 1, "\x54" => 1, "\x55" => 1, "\x56" => 1, "\x57" => 1,
-        "\x58" => 1, "\x59" => 1, "\x5a" => 1, "\x5b" => 1, "\x5c" => 1, "\x5d" => 1, "\x5e" => 1, "\x5f" => 1,
-        "\x60" => 1, "\x61" => 1, "\x62" => 1, "\x63" => 1, "\x64" => 1, "\x65" => 1, "\x66" => 1, "\x67" => 1,
-        "\x68" => 1, "\x69" => 1, "\x6a" => 1, "\x6b" => 1, "\x6c" => 1, "\x6d" => 1, "\x6e" => 1, "\x6f" => 1,
-        "\x70" => 1, "\x71" => 1, "\x72" => 1, "\x73" => 1, "\x74" => 1, "\x75" => 1, "\x76" => 1, "\x77" => 1,
-        "\x78" => 1, "\x79" => 1, "\x7a" => 1, "\x7b" => 1, "\x7c" => 1, "\x7d" => 1, "\x7e" => 1, "\x7f" => 1,
-        "\x80" => 0, "\x81" => 0, "\x82" => 0, "\x83" => 0, "\x84" => 0, "\x85" => 0, "\x86" => 0, "\x87" => 0,
-        "\x88" => 0, "\x89" => 0, "\x8a" => 0, "\x8b" => 0, "\x8c" => 0, "\x8d" => 0, "\x8e" => 0, "\x8f" => 0,
-        "\x90" => 0, "\x91" => 0, "\x92" => 0, "\x93" => 0, "\x94" => 0, "\x95" => 0, "\x96" => 0, "\x97" => 0,
-        "\x98" => 0, "\x99" => 0, "\x9a" => 0, "\x9b" => 0, "\x9c" => 0, "\x9d" => 0, "\x9e" => 0, "\x9f" => 0,
-        "\xa0" => 0, "\xa1" => 0, "\xa2" => 0, "\xa3" => 0, "\xa4" => 0, "\xa5" => 0, "\xa6" => 0, "\xa7" => 0,
-        "\xa8" => 0, "\xa9" => 0, "\xaa" => 0, "\xab" => 0, "\xac" => 0, "\xad" => 0, "\xae" => 0, "\xaf" => 0,
-        "\xb0" => 0, "\xb1" => 0, "\xb2" => 0, "\xb3" => 0, "\xb4" => 0, "\xb5" => 0, "\xb6" => 0, "\xb7" => 0,
-        "\xb8" => 0, "\xb9" => 0, "\xba" => 0, "\xbb" => 0, "\xbc" => 0, "\xbd" => 0, "\xbe" => 0, "\xbf" => 0,
-        "\xc0" => 2, "\xc1" => 2, "\xc2" => 2, "\xc3" => 2, "\xc4" => 2, "\xc5" => 2, "\xc6" => 2, "\xc7" => 2,
-        "\xc8" => 2, "\xc9" => 2, "\xca" => 2, "\xcb" => 2, "\xcc" => 2, "\xcd" => 2, "\xce" => 2, "\xcf" => 2,
-        "\xd0" => 2, "\xd1" => 2, "\xd2" => 2, "\xd3" => 2, "\xd4" => 2, "\xd5" => 2, "\xd6" => 2, "\xd7" => 2,
-        "\xd8" => 2, "\xd9" => 2, "\xda" => 2, "\xdb" => 2, "\xdc" => 2, "\xdd" => 2, "\xde" => 2, "\xdf" => 2,
-        "\xe0" => 3, "\xe1" => 3, "\xe2" => 3, "\xe3" => 3, "\xe4" => 3, "\xe5" => 3, "\xe6" => 3, "\xe7" => 3,
-        "\xe8" => 3, "\xe9" => 3, "\xea" => 3, "\xeb" => 3, "\xec" => 3, "\xed" => 3, "\xee" => 3, "\xef" => 3,
-        "\xf0" => 4, "\xf1" => 4, "\xf2" => 4, "\xf3" => 4, "\xf4" => 4, "\xf5" => 4, "\xf6" => 4, "\xf7" => 4,
-        "\xf8" => 5, "\xf9" => 5, "\xfa" => 5, "\xfb" => 5, "\xfc" => 6, "\xfd" => 6, "\xfe" => 0, "\xff" => 0,
-     ];
+	private static $s_length_map = [
+		"\x00" => 1, "\x01" => 1, "\x02" => 1, "\x03" => 1, "\x04" => 1, "\x05" => 1, "\x06" => 1, "\x07" => 1,
+		"\x08" => 1, "\x09" => 1, "\x0a" => 1, "\x0b" => 1, "\x0c" => 1, "\x0d" => 1, "\x0e" => 1, "\x0f" => 1,
+		"\x10" => 1, "\x11" => 1, "\x12" => 1, "\x13" => 1, "\x14" => 1, "\x15" => 1, "\x16" => 1, "\x17" => 1,
+		"\x18" => 1, "\x19" => 1, "\x1a" => 1, "\x1b" => 1, "\x1c" => 1, "\x1d" => 1, "\x1e" => 1, "\x1f" => 1,
+		"\x20" => 1, "\x21" => 1, "\x22" => 1, "\x23" => 1, "\x24" => 1, "\x25" => 1, "\x26" => 1, "\x27" => 1,
+		"\x28" => 1, "\x29" => 1, "\x2a" => 1, "\x2b" => 1, "\x2c" => 1, "\x2d" => 1, "\x2e" => 1, "\x2f" => 1,
+		"\x30" => 1, "\x31" => 1, "\x32" => 1, "\x33" => 1, "\x34" => 1, "\x35" => 1, "\x36" => 1, "\x37" => 1,
+		"\x38" => 1, "\x39" => 1, "\x3a" => 1, "\x3b" => 1, "\x3c" => 1, "\x3d" => 1, "\x3e" => 1, "\x3f" => 1,
+		"\x40" => 1, "\x41" => 1, "\x42" => 1, "\x43" => 1, "\x44" => 1, "\x45" => 1, "\x46" => 1, "\x47" => 1,
+		"\x48" => 1, "\x49" => 1, "\x4a" => 1, "\x4b" => 1, "\x4c" => 1, "\x4d" => 1, "\x4e" => 1, "\x4f" => 1,
+		"\x50" => 1, "\x51" => 1, "\x52" => 1, "\x53" => 1, "\x54" => 1, "\x55" => 1, "\x56" => 1, "\x57" => 1,
+		"\x58" => 1, "\x59" => 1, "\x5a" => 1, "\x5b" => 1, "\x5c" => 1, "\x5d" => 1, "\x5e" => 1, "\x5f" => 1,
+		"\x60" => 1, "\x61" => 1, "\x62" => 1, "\x63" => 1, "\x64" => 1, "\x65" => 1, "\x66" => 1, "\x67" => 1,
+		"\x68" => 1, "\x69" => 1, "\x6a" => 1, "\x6b" => 1, "\x6c" => 1, "\x6d" => 1, "\x6e" => 1, "\x6f" => 1,
+		"\x70" => 1, "\x71" => 1, "\x72" => 1, "\x73" => 1, "\x74" => 1, "\x75" => 1, "\x76" => 1, "\x77" => 1,
+		"\x78" => 1, "\x79" => 1, "\x7a" => 1, "\x7b" => 1, "\x7c" => 1, "\x7d" => 1, "\x7e" => 1, "\x7f" => 1,
+		"\x80" => 0, "\x81" => 0, "\x82" => 0, "\x83" => 0, "\x84" => 0, "\x85" => 0, "\x86" => 0, "\x87" => 0,
+		"\x88" => 0, "\x89" => 0, "\x8a" => 0, "\x8b" => 0, "\x8c" => 0, "\x8d" => 0, "\x8e" => 0, "\x8f" => 0,
+		"\x90" => 0, "\x91" => 0, "\x92" => 0, "\x93" => 0, "\x94" => 0, "\x95" => 0, "\x96" => 0, "\x97" => 0,
+		"\x98" => 0, "\x99" => 0, "\x9a" => 0, "\x9b" => 0, "\x9c" => 0, "\x9d" => 0, "\x9e" => 0, "\x9f" => 0,
+		"\xa0" => 0, "\xa1" => 0, "\xa2" => 0, "\xa3" => 0, "\xa4" => 0, "\xa5" => 0, "\xa6" => 0, "\xa7" => 0,
+		"\xa8" => 0, "\xa9" => 0, "\xaa" => 0, "\xab" => 0, "\xac" => 0, "\xad" => 0, "\xae" => 0, "\xaf" => 0,
+		"\xb0" => 0, "\xb1" => 0, "\xb2" => 0, "\xb3" => 0, "\xb4" => 0, "\xb5" => 0, "\xb6" => 0, "\xb7" => 0,
+		"\xb8" => 0, "\xb9" => 0, "\xba" => 0, "\xbb" => 0, "\xbc" => 0, "\xbd" => 0, "\xbe" => 0, "\xbf" => 0,
+		"\xc0" => 2, "\xc1" => 2, "\xc2" => 2, "\xc3" => 2, "\xc4" => 2, "\xc5" => 2, "\xc6" => 2, "\xc7" => 2,
+		"\xc8" => 2, "\xc9" => 2, "\xca" => 2, "\xcb" => 2, "\xcc" => 2, "\xcd" => 2, "\xce" => 2, "\xcf" => 2,
+		"\xd0" => 2, "\xd1" => 2, "\xd2" => 2, "\xd3" => 2, "\xd4" => 2, "\xd5" => 2, "\xd6" => 2, "\xd7" => 2,
+		"\xd8" => 2, "\xd9" => 2, "\xda" => 2, "\xdb" => 2, "\xdc" => 2, "\xdd" => 2, "\xde" => 2, "\xdf" => 2,
+		"\xe0" => 3, "\xe1" => 3, "\xe2" => 3, "\xe3" => 3, "\xe4" => 3, "\xe5" => 3, "\xe6" => 3, "\xe7" => 3,
+		"\xe8" => 3, "\xe9" => 3, "\xea" => 3, "\xeb" => 3, "\xec" => 3, "\xed" => 3, "\xee" => 3, "\xef" => 3,
+		"\xf0" => 4, "\xf1" => 4, "\xf2" => 4, "\xf3" => 4, "\xf4" => 4, "\xf5" => 4, "\xf6" => 4, "\xf7" => 4,
+		"\xf8" => 5, "\xf9" => 5, "\xfa" => 5, "\xfb" => 5, "\xfc" => 6, "\xfd" => 6, "\xfe" => 0, "\xff" => 0,
+	 ];
 
-    /**
-     * Returns the complete character map.
-     *
-     * @param string $string
-     * @param int    $startOffset
-     * @param array  $currentMap
-     * @param mixed  $ignoredChars
-     *
-     * @return int
-     */
-    public function getCharPositions($string, $startOffset, &$currentMap, &$ignoredChars)
-    {
-        if (!isset($currentMap['i']) || !isset($currentMap['p'])) {
-            $currentMap['p'] = $currentMap['i'] = [];
-        }
+	/**
+	 * Returns the complete character map.
+	 *
+	 * @param string $string
+	 * @param int    $startOffset
+	 * @param array  $currentMap
+	 * @param mixed  $ignoredChars
+	 *
+	 * @return int
+	 */
+	public function getCharPositions($string, $startOffset, &$currentMap, &$ignoredChars)
+	{
+		if (!isset($currentMap['i']) || !isset($currentMap['p'])) {
+			$currentMap['p'] = $currentMap['i'] = [];
+		}
 
-        $strlen = \strlen($string);
-        $charPos = \count($currentMap['p']);
-        $foundChars = 0;
-        $invalid = false;
-        for ($i = 0; $i < $strlen; ++$i) {
-            $char = $string[$i];
-            $size = self::$s_length_map[$char];
-            if (0 == $size) {
-                /* char is invalid, we must wait for a resync */
-                $invalid = true;
-                continue;
-            } else {
-                if (true === $invalid) {
-                    /* We mark the chars as invalid and start a new char */
-                    $currentMap['p'][$charPos + $foundChars] = $startOffset + $i;
-                    $currentMap['i'][$charPos + $foundChars] = true;
-                    ++$foundChars;
-                    $invalid = false;
-                }
-                if (($i + $size) > $strlen) {
-                    $ignoredChars = substr($string, $i);
-                    break;
-                }
-                for ($j = 1; $j < $size; ++$j) {
-                    $char = $string[$i + $j];
-                    if ($char > "\x7F" && $char < "\xC0") {
-                        // Valid - continue parsing
-                    } else {
-                        /* char is invalid, we must wait for a resync */
-                        $invalid = true;
-                        continue 2;
-                    }
-                }
-                /* Ok we got a complete char here */
-                $currentMap['p'][$charPos + $foundChars] = $startOffset + $i + $size;
-                $i += $j - 1;
-                ++$foundChars;
-            }
-        }
+		$strlen = \strlen($string);
+		$charPos = \count($currentMap['p']);
+		$foundChars = 0;
+		$invalid = false;
+		for ($i = 0; $i < $strlen; ++$i) {
+			$char = $string[$i];
+			$size = self::$s_length_map[$char];
+			if (0 == $size) {
+				/* char is invalid, we must wait for a resync */
+				$invalid = true;
+				continue;
+			} else {
+				if (true === $invalid) {
+					/* We mark the chars as invalid and start a new char */
+					$currentMap['p'][$charPos + $foundChars] = $startOffset + $i;
+					$currentMap['i'][$charPos + $foundChars] = true;
+					++$foundChars;
+					$invalid = false;
+				}
+				if (($i + $size) > $strlen) {
+					$ignoredChars = substr($string, $i);
+					break;
+				}
+				for ($j = 1; $j < $size; ++$j) {
+					$char = $string[$i + $j];
+					if ($char > "\x7F" && $char < "\xC0") {
+						// Valid - continue parsing
+					} else {
+						/* char is invalid, we must wait for a resync */
+						$invalid = true;
+						continue 2;
+					}
+				}
+				/* Ok we got a complete char here */
+				$currentMap['p'][$charPos + $foundChars] = $startOffset + $i + $size;
+				$i += $j - 1;
+				++$foundChars;
+			}
+		}
 
-        return $foundChars;
-    }
+		return $foundChars;
+	}
 
-    /**
-     * Returns mapType.
-     *
-     * @return int mapType
-     */
-    public function getMapType()
-    {
-        return self::MAP_TYPE_POSITIONS;
-    }
+	/**
+	 * Returns mapType.
+	 *
+	 * @return int mapType
+	 */
+	public function getMapType()
+	{
+		return self::MAP_TYPE_POSITIONS;
+	}
 
-    /**
-     * Returns an integer which specifies how many more bytes to read.
-     *
-     * A positive integer indicates the number of more bytes to fetch before invoking
-     * this method again.
-     * A value of zero means this is already a valid character.
-     * A value of -1 means this cannot possibly be a valid character.
-     *
-     * @param string $bytes
-     * @param int    $size
-     *
-     * @return int
-     */
-    public function validateByteSequence($bytes, $size)
-    {
-        if ($size < 1) {
-            return -1;
-        }
-        $needed = self::$length_map[$bytes[0]] - $size;
+	/**
+	 * Returns an integer which specifies how many more bytes to read.
+	 *
+	 * A positive integer indicates the number of more bytes to fetch before invoking
+	 * this method again.
+	 * A value of zero means this is already a valid character.
+	 * A value of -1 means this cannot possibly be a valid character.
+	 *
+	 * @param string $bytes
+	 * @param int    $size
+	 *
+	 * @return int
+	 */
+	public function validateByteSequence($bytes, $size)
+	{
+		if ($size < 1) {
+			return -1;
+		}
+		$needed = self::$length_map[$bytes[0]] - $size;
 
-        return $needed > -1 ? $needed : -1;
-    }
+		return $needed > -1 ? $needed : -1;
+	}
 
-    /**
-     * Returns the number of bytes which should be read to start each character.
-     *
-     * @return int
-     */
-    public function getInitialByteSize()
-    {
-        return 1;
-    }
+	/**
+	 * Returns the number of bytes which should be read to start each character.
+	 *
+	 * @return int
+	 */
+	public function getInitialByteSize()
+	{
+		return 1;
+	}
 }