Dolibarr / dolibarr

htdocs/includes/sabre/sabre/vobject/lib/Parser/MimeDir.php

Indentation +628 added lines, -628 removed lines

@@ -25,316 +25,316 @@ 
  */
 class MimeDir extends Parser
 {
-    /**
-     * The input stream.
-     *
-     * @var resource
-     */
-    protected $input;
-
-    /**
-     * Root component.
-     *
-     * @var Component
-     */
-    protected $root;
-
-    /**
-     * By default all input will be assumed to be UTF-8.
-     *
-     * However, both iCalendar and vCard might be encoded using different
-     * character sets. The character set is usually set in the mime-type.
-     *
-     * If this is the case, use setEncoding to specify that a different
-     * encoding will be used. If this is set, the parser will automatically
-     * convert all incoming data to UTF-8.
-     *
-     * @var string
-     */
-    protected $charset = 'UTF-8';
-
-    /**
-     * The list of character sets we support when decoding.
-     *
-     * This would be a const expression but for now we need to support PHP 5.5
-     */
-    protected static $SUPPORTED_CHARSETS = [
-        'UTF-8',
-        'ISO-8859-1',
-        'Windows-1252',
-    ];
-
-    /**
-     * Parses an iCalendar or vCard file.
-     *
-     * Pass a stream or a string. If null is parsed, the existing buffer is
-     * used.
-     *
-     * @param string|resource|null $input
-     * @param int                  $options
-     *
-     * @return \Sabre\VObject\Document
-     */
-    public function parse($input = null, $options = 0)
-    {
-        $this->root = null;
-
-        if (!is_null($input)) {
-            $this->setInput($input);
-        }
-
-        if (0 !== $options) {
-            $this->options = $options;
-        }
-
-        $this->parseDocument();
-
-        return $this->root;
-    }
-
-    /**
-     * By default all input will be assumed to be UTF-8.
-     *
-     * However, both iCalendar and vCard might be encoded using different
-     * character sets. The character set is usually set in the mime-type.
-     *
-     * If this is the case, use setEncoding to specify that a different
-     * encoding will be used. If this is set, the parser will automatically
-     * convert all incoming data to UTF-8.
-     *
-     * @param string $charset
-     */
-    public function setCharset($charset)
-    {
-        if (!in_array($charset, self::$SUPPORTED_CHARSETS)) {
-            throw new \InvalidArgumentException('Unsupported encoding. (Supported encodings: '.implode(', ', self::$SUPPORTED_CHARSETS).')');
-        }
-        $this->charset = $charset;
-    }
-
-    /**
-     * Sets the input buffer. Must be a string or stream.
-     *
-     * @param resource|string $input
-     */
-    public function setInput($input)
-    {
-        // Resetting the parser
-        $this->lineIndex = 0;
-        $this->startLine = 0;
-
-        if (is_string($input)) {
-            // Converting to a stream.
-            $stream = fopen('php://temp', 'r+');
-            fwrite($stream, $input);
-            rewind($stream);
-            $this->input = $stream;
-        } elseif (is_resource($input)) {
-            $this->input = $input;
-        } else {
-            throw new \InvalidArgumentException('This parser can only read from strings or streams.');
-        }
-    }
-
-    /**
-     * Parses an entire document.
-     */
-    protected function parseDocument()
-    {
-        $line = $this->readLine();
-
-        // BOM is ZERO WIDTH NO-BREAK SPACE (U+FEFF).
-        // It's 0xEF 0xBB 0xBF in UTF-8 hex.
-        if (3 <= strlen($line)
-            && 0xef === ord($line[0])
-            && 0xbb === ord($line[1])
-            && 0xbf === ord($line[2])) {
-            $line = substr($line, 3);
-        }
-
-        switch (strtoupper($line)) {
-            case 'BEGIN:VCALENDAR':
-                $class = VCalendar::$componentMap['VCALENDAR'];
-                break;
-            case 'BEGIN:VCARD':
-                $class = VCard::$componentMap['VCARD'];
-                break;
-            default:
-                throw new ParseException('This parser only supports VCARD and VCALENDAR files');
-        }
-
-        $this->root = new $class([], false);
-
-        while (true) {
-            // Reading until we hit END:
-            try {
-                $line = $this->readLine();
-            } catch (EofException $oEx) {
-                $line = 'END:'.$this->root->name;
-            }
-            if ('END:' === strtoupper(substr($line, 0, 4))) {
-                break;
-            }
-            $result = $this->parseLine($line);
-            if ($result) {
-                $this->root->add($result);
-            }
-        }
-
-        $name = strtoupper(substr($line, 4));
-        if ($name !== $this->root->name) {
-            throw new ParseException('Invalid MimeDir file. expected: "END:'.$this->root->name.'" got: "END:'.$name.'"');
-        }
-    }
-
-    /**
-     * Parses a line, and if it hits a component, it will also attempt to parse
-     * the entire component.
-     *
-     * @param string $line Unfolded line
-     *
-     * @return Node
-     */
-    protected function parseLine($line)
-    {
-        // Start of a new component
-        if ('BEGIN:' === strtoupper(substr($line, 0, 6))) {
-            if (substr($line, 6) === $this->root->name) {
-                throw new ParseException('Invalid MimeDir file. Unexpected component: "'.$line.'" in document type '.$this->root->name);
-            }
-            $component = $this->root->createComponent(substr($line, 6), [], false);
-
-            while (true) {
-                // Reading until we hit END:
-                $line = $this->readLine();
-                if ('END:' === strtoupper(substr($line, 0, 4))) {
-                    break;
-                }
-                $result = $this->parseLine($line);
-                if ($result) {
-                    $component->add($result);
-                }
-            }
-
-            $name = strtoupper(substr($line, 4));
-            if ($name !== $component->name) {
-                throw new ParseException('Invalid MimeDir file. expected: "END:'.$component->name.'" got: "END:'.$name.'"');
-            }
-
-            return $component;
-        } else {
-            // Property reader
-            $property = $this->readProperty($line);
-            if (!$property) {
-                // Ignored line
-                return false;
-            }
-
-            return $property;
-        }
-    }
-
-    /**
-     * We need to look ahead 1 line every time to see if we need to 'unfold'
-     * the next line.
-     *
-     * If that was not the case, we store it here.
-     *
-     * @var string|null
-     */
-    protected $lineBuffer;
-
-    /**
-     * The real current line number.
-     */
-    protected $lineIndex = 0;
-
-    /**
-     * In the case of unfolded lines, this property holds the line number for
-     * the start of the line.
-     *
-     * @var int
-     */
-    protected $startLine = 0;
-
-    /**
-     * Contains a 'raw' representation of the current line.
-     *
-     * @var string
-     */
-    protected $rawLine;
-
-    /**
-     * Reads a single line from the buffer.
-     *
-     * This method strips any newlines and also takes care of unfolding.
-     *
-     * @throws \Sabre\VObject\EofException
-     *
-     * @return string
-     */
-    protected function readLine()
-    {
-        if (!\is_null($this->lineBuffer)) {
-            $rawLine = $this->lineBuffer;
-            $this->lineBuffer = null;
-        } else {
-            do {
-                $eof = \feof($this->input);
-
-                $rawLine = \fgets($this->input);
-
-                if ($eof || (\feof($this->input) && false === $rawLine)) {
-                    throw new EofException('End of document reached prematurely');
-                }
-                if (false === $rawLine) {
-                    throw new ParseException('Error reading from input stream');
-                }
-                $rawLine = \rtrim($rawLine, "\r\n");
-            } while ('' === $rawLine); // Skipping empty lines
-            ++$this->lineIndex;
-        }
-        $line = $rawLine;
-
-        $this->startLine = $this->lineIndex;
-
-        // Looking ahead for folded lines.
-        while (true) {
-            $nextLine = \rtrim(\fgets($this->input), "\r\n");
-            ++$this->lineIndex;
-            if (!$nextLine) {
-                break;
-            }
-            if ("\t" === $nextLine[0] || ' ' === $nextLine[0]) {
-                $curLine = \substr($nextLine, 1);
-                $line .= $curLine;
-                $rawLine .= "\n ".$curLine;
-            } else {
-                $this->lineBuffer = $nextLine;
-                break;
-            }
-        }
-        $this->rawLine = $rawLine;
-
-        return $line;
-    }
-
-    /**
-     * Reads a property or component from a line.
-     */
-    protected function readProperty($line)
-    {
-        if ($this->options & self::OPTION_FORGIVING) {
-            $propNameToken = 'A-Z0-9\-\._\\/';
-        } else {
-            $propNameToken = 'A-Z0-9\-\.';
-        }
-
-        $paramNameToken = 'A-Z0-9\-';
-        $safeChar = '^";:,';
-        $qSafeChar = '^"';
-
-        $regex = "/
+	/**
+	 * The input stream.
+	 *
+	 * @var resource
+	 */
+	protected $input;
+
+	/**
+	 * Root component.
+	 *
+	 * @var Component
+	 */
+	protected $root;
+
+	/**
+	 * By default all input will be assumed to be UTF-8.
+	 *
+	 * However, both iCalendar and vCard might be encoded using different
+	 * character sets. The character set is usually set in the mime-type.
+	 *
+	 * If this is the case, use setEncoding to specify that a different
+	 * encoding will be used. If this is set, the parser will automatically
+	 * convert all incoming data to UTF-8.
+	 *
+	 * @var string
+	 */
+	protected $charset = 'UTF-8';
+
+	/**
+	 * The list of character sets we support when decoding.
+	 *
+	 * This would be a const expression but for now we need to support PHP 5.5
+	 */
+	protected static $SUPPORTED_CHARSETS = [
+		'UTF-8',
+		'ISO-8859-1',
+		'Windows-1252',
+	];
+
+	/**
+	 * Parses an iCalendar or vCard file.
+	 *
+	 * Pass a stream or a string. If null is parsed, the existing buffer is
+	 * used.
+	 *
+	 * @param string|resource|null $input
+	 * @param int                  $options
+	 *
+	 * @return \Sabre\VObject\Document
+	 */
+	public function parse($input = null, $options = 0)
+	{
+		$this->root = null;
+
+		if (!is_null($input)) {
+			$this->setInput($input);
+		}
+
+		if (0 !== $options) {
+			$this->options = $options;
+		}
+
+		$this->parseDocument();
+
+		return $this->root;
+	}
+
+	/**
+	 * By default all input will be assumed to be UTF-8.
+	 *
+	 * However, both iCalendar and vCard might be encoded using different
+	 * character sets. The character set is usually set in the mime-type.
+	 *
+	 * If this is the case, use setEncoding to specify that a different
+	 * encoding will be used. If this is set, the parser will automatically
+	 * convert all incoming data to UTF-8.
+	 *
+	 * @param string $charset
+	 */
+	public function setCharset($charset)
+	{
+		if (!in_array($charset, self::$SUPPORTED_CHARSETS)) {
+			throw new \InvalidArgumentException('Unsupported encoding. (Supported encodings: '.implode(', ', self::$SUPPORTED_CHARSETS).')');
+		}
+		$this->charset = $charset;
+	}
+
+	/**
+	 * Sets the input buffer. Must be a string or stream.
+	 *
+	 * @param resource|string $input
+	 */
+	public function setInput($input)
+	{
+		// Resetting the parser
+		$this->lineIndex = 0;
+		$this->startLine = 0;
+
+		if (is_string($input)) {
+			// Converting to a stream.
+			$stream = fopen('php://temp', 'r+');
+			fwrite($stream, $input);
+			rewind($stream);
+			$this->input = $stream;
+		} elseif (is_resource($input)) {
+			$this->input = $input;
+		} else {
+			throw new \InvalidArgumentException('This parser can only read from strings or streams.');
+		}
+	}
+
+	/**
+	 * Parses an entire document.
+	 */
+	protected function parseDocument()
+	{
+		$line = $this->readLine();
+
+		// BOM is ZERO WIDTH NO-BREAK SPACE (U+FEFF).
+		// It's 0xEF 0xBB 0xBF in UTF-8 hex.
+		if (3 <= strlen($line)
+			&& 0xef === ord($line[0])
+			&& 0xbb === ord($line[1])
+			&& 0xbf === ord($line[2])) {
+			$line = substr($line, 3);
+		}
+
+		switch (strtoupper($line)) {
+			case 'BEGIN:VCALENDAR':
+				$class = VCalendar::$componentMap['VCALENDAR'];
+				break;
+			case 'BEGIN:VCARD':
+				$class = VCard::$componentMap['VCARD'];
+				break;
+			default:
+				throw new ParseException('This parser only supports VCARD and VCALENDAR files');
+		}
+
+		$this->root = new $class([], false);
+
+		while (true) {
+			// Reading until we hit END:
+			try {
+				$line = $this->readLine();
+			} catch (EofException $oEx) {
+				$line = 'END:'.$this->root->name;
+			}
+			if ('END:' === strtoupper(substr($line, 0, 4))) {
+				break;
+			}
+			$result = $this->parseLine($line);
+			if ($result) {
+				$this->root->add($result);
+			}
+		}
+
+		$name = strtoupper(substr($line, 4));
+		if ($name !== $this->root->name) {
+			throw new ParseException('Invalid MimeDir file. expected: "END:'.$this->root->name.'" got: "END:'.$name.'"');
+		}
+	}
+
+	/**
+	 * Parses a line, and if it hits a component, it will also attempt to parse
+	 * the entire component.
+	 *
+	 * @param string $line Unfolded line
+	 *
+	 * @return Node
+	 */
+	protected function parseLine($line)
+	{
+		// Start of a new component
+		if ('BEGIN:' === strtoupper(substr($line, 0, 6))) {
+			if (substr($line, 6) === $this->root->name) {
+				throw new ParseException('Invalid MimeDir file. Unexpected component: "'.$line.'" in document type '.$this->root->name);
+			}
+			$component = $this->root->createComponent(substr($line, 6), [], false);
+
+			while (true) {
+				// Reading until we hit END:
+				$line = $this->readLine();
+				if ('END:' === strtoupper(substr($line, 0, 4))) {
+					break;
+				}
+				$result = $this->parseLine($line);
+				if ($result) {
+					$component->add($result);
+				}
+			}
+
+			$name = strtoupper(substr($line, 4));
+			if ($name !== $component->name) {
+				throw new ParseException('Invalid MimeDir file. expected: "END:'.$component->name.'" got: "END:'.$name.'"');
+			}
+
+			return $component;
+		} else {
+			// Property reader
+			$property = $this->readProperty($line);
+			if (!$property) {
+				// Ignored line
+				return false;
+			}
+
+			return $property;
+		}
+	}
+
+	/**
+	 * We need to look ahead 1 line every time to see if we need to 'unfold'
+	 * the next line.
+	 *
+	 * If that was not the case, we store it here.
+	 *
+	 * @var string|null
+	 */
+	protected $lineBuffer;
+
+	/**
+	 * The real current line number.
+	 */
+	protected $lineIndex = 0;
+
+	/**
+	 * In the case of unfolded lines, this property holds the line number for
+	 * the start of the line.
+	 *
+	 * @var int
+	 */
+	protected $startLine = 0;
+
+	/**
+	 * Contains a 'raw' representation of the current line.
+	 *
+	 * @var string
+	 */
+	protected $rawLine;
+
+	/**
+	 * Reads a single line from the buffer.
+	 *
+	 * This method strips any newlines and also takes care of unfolding.
+	 *
+	 * @throws \Sabre\VObject\EofException
+	 *
+	 * @return string
+	 */
+	protected function readLine()
+	{
+		if (!\is_null($this->lineBuffer)) {
+			$rawLine = $this->lineBuffer;
+			$this->lineBuffer = null;
+		} else {
+			do {
+				$eof = \feof($this->input);
+
+				$rawLine = \fgets($this->input);
+
+				if ($eof || (\feof($this->input) && false === $rawLine)) {
+					throw new EofException('End of document reached prematurely');
+				}
+				if (false === $rawLine) {
+					throw new ParseException('Error reading from input stream');
+				}
+				$rawLine = \rtrim($rawLine, "\r\n");
+			} while ('' === $rawLine); // Skipping empty lines
+			++$this->lineIndex;
+		}
+		$line = $rawLine;
+
+		$this->startLine = $this->lineIndex;
+
+		// Looking ahead for folded lines.
+		while (true) {
+			$nextLine = \rtrim(\fgets($this->input), "\r\n");
+			++$this->lineIndex;
+			if (!$nextLine) {
+				break;
+			}
+			if ("\t" === $nextLine[0] || ' ' === $nextLine[0]) {
+				$curLine = \substr($nextLine, 1);
+				$line .= $curLine;
+				$rawLine .= "\n ".$curLine;
+			} else {
+				$this->lineBuffer = $nextLine;
+				break;
+			}
+		}
+		$this->rawLine = $rawLine;
+
+		return $line;
+	}
+
+	/**
+	 * Reads a property or component from a line.
+	 */
+	protected function readProperty($line)
+	{
+		if ($this->options & self::OPTION_FORGIVING) {
+			$propNameToken = 'A-Z0-9\-\._\\/';
+		} else {
+			$propNameToken = 'A-Z0-9\-\.';
+		}
+
+		$paramNameToken = 'A-Z0-9\-';
+		$safeChar = '^";:,';
+		$qSafeChar = '^"';
+
+		$regex = "/
             ^(?P<name> [$propNameToken]+ ) (?=[;:])        # property name
             |
             (?<=:)(?P<propValue> .+)$                      # property value
@@ -347,337 +347,337 @@ 
             ) (?=[;:,])
             /xi";
 
-        //echo $regex, "\n"; exit();
-        preg_match_all($regex, $line, $matches, PREG_SET_ORDER);
+		//echo $regex, "\n"; exit();
+		preg_match_all($regex, $line, $matches, PREG_SET_ORDER);
 
-        $property = [
-            'name' => null,
-            'parameters' => [],
-            'value' => null,
-        ];
+		$property = [
+			'name' => null,
+			'parameters' => [],
+			'value' => null,
+		];
 
-        $lastParam = null;
+		$lastParam = null;
 
-        /*
+		/*
          * Looping through all the tokens.
          *
          * Note that we are looping through them in reverse order, because if a
          * sub-pattern matched, the subsequent named patterns will not show up
          * in the result.
          */
-        foreach ($matches as $match) {
-            if (isset($match['paramValue'])) {
-                if ($match['paramValue'] && '"' === $match['paramValue'][0]) {
-                    $value = substr($match['paramValue'], 1, -1);
-                } else {
-                    $value = $match['paramValue'];
-                }
-
-                $value = $this->unescapeParam($value);
-
-                if (is_null($lastParam)) {
-                    if ($this->options & self::OPTION_IGNORE_INVALID_LINES) {
-                        // When the property can't be matched and the configuration
-                        // option is set to ignore invalid lines, we ignore this line
-                        // This can happen when servers provide faulty data as iCloud
-                        //  frequently does with X-APPLE-STRUCTURED-LOCATION
-                        continue;
-                    }
-                    throw new ParseException('Invalid Mimedir file. Line starting at '.$this->startLine.' did not follow iCalendar/vCard conventions');
-                }
-                if (is_null($property['parameters'][$lastParam])) {
-                    $property['parameters'][$lastParam] = $value;
-                } elseif (is_array($property['parameters'][$lastParam])) {
-                    $property['parameters'][$lastParam][] = $value;
-                } elseif ($property['parameters'][$lastParam] === $value) {
-                    // When the current value of the parameter is the same as the
-                    // new one, then we can leave the current parameter as it is.
-                } else {
-                    $property['parameters'][$lastParam] = [
-                        $property['parameters'][$lastParam],
-                        $value,
-                    ];
-                }
-                continue;
-            }
-            if (isset($match['paramName'])) {
-                $lastParam = strtoupper($match['paramName']);
-                if (!isset($property['parameters'][$lastParam])) {
-                    $property['parameters'][$lastParam] = null;
-                }
-                continue;
-            }
-            if (isset($match['propValue'])) {
-                $property['value'] = $match['propValue'];
-                continue;
-            }
-            if (isset($match['name']) && $match['name']) {
-                $property['name'] = strtoupper($match['name']);
-                continue;
-            }
-
-            // @codeCoverageIgnoreStart
-            throw new \LogicException('This code should not be reachable');
-            // @codeCoverageIgnoreEnd
-        }
-
-        if (is_null($property['value'])) {
-            $property['value'] = '';
-        }
-        if (!$property['name']) {
-            if ($this->options & self::OPTION_IGNORE_INVALID_LINES) {
-                return false;
-            }
-            throw new ParseException('Invalid Mimedir file. Line starting at '.$this->startLine.' did not follow iCalendar/vCard conventions');
-        }
-
-        // vCard 2.1 states that parameters may appear without a name, and only
-        // a value. We can deduce the value based on its name.
-        //
-        // Our parser will get those as parameters without a value instead, so
-        // we're filtering these parameters out first.
-        $namedParameters = [];
-        $namelessParameters = [];
-
-        foreach ($property['parameters'] as $name => $value) {
-            if (!is_null($value)) {
-                $namedParameters[$name] = $value;
-            } else {
-                $namelessParameters[] = $name;
-            }
-        }
-
-        $propObj = $this->root->createProperty($property['name'], null, $namedParameters);
-
-        foreach ($namelessParameters as $namelessParameter) {
-            $propObj->add(null, $namelessParameter);
-        }
-
-        if (isset($propObj['ENCODING']) && 'QUOTED-PRINTABLE' === strtoupper($propObj['ENCODING'])) {
-            $propObj->setQuotedPrintableValue($this->extractQuotedPrintableValue());
-        } else {
-            $charset = $this->charset;
-            if (Document::VCARD21 === $this->root->getDocumentType() && isset($propObj['CHARSET'])) {
-                // vCard 2.1 allows the character set to be specified per property.
-                $charset = (string) $propObj['CHARSET'];
-            }
-            switch (strtolower($charset)) {
-                case 'utf-8':
-                    break;
-                case 'windows-1252':
-                case 'iso-8859-1':
-                    $property['value'] = mb_convert_encoding($property['value'], 'UTF-8', $charset);
-                    break;
-                default:
-                    throw new ParseException('Unsupported CHARSET: '.$propObj['CHARSET']);
-            }
-            $propObj->setRawMimeDirValue($property['value']);
-        }
-
-        return $propObj;
-    }
-
-    /**
-     * Unescapes a property value.
-     *
-     * vCard 2.1 says:
-     *   * Semi-colons must be escaped in some property values, specifically
-     *     ADR, ORG and N.
-     *   * Semi-colons must be escaped in parameter values, because semi-colons
-     *     are also use to separate values.
-     *   * No mention of escaping backslashes with another backslash.
-     *   * newlines are not escaped either, instead QUOTED-PRINTABLE is used to
-     *     span values over more than 1 line.
-     *
-     * vCard 3.0 says:
-     *   * (rfc2425) Backslashes, newlines (\n or \N) and comma's must be
-     *     escaped, all time time.
-     *   * Comma's are used for delimiters in multiple values
-     *   * (rfc2426) Adds to to this that the semi-colon MUST also be escaped,
-     *     as in some properties semi-colon is used for separators.
-     *   * Properties using semi-colons: N, ADR, GEO, ORG
-     *   * Both ADR and N's individual parts may be broken up further with a
-     *     comma.
-     *   * Properties using commas: NICKNAME, CATEGORIES
-     *
-     * vCard 4.0 (rfc6350) says:
-     *   * Commas must be escaped.
-     *   * Semi-colons may be escaped, an unescaped semi-colon _may_ be a
-     *     delimiter, depending on the property.
-     *   * Backslashes must be escaped
-     *   * Newlines must be escaped as either \N or \n.
-     *   * Some compound properties may contain multiple parts themselves, so a
-     *     comma within a semi-colon delimited property may also be unescaped
-     *     to denote multiple parts _within_ the compound property.
-     *   * Text-properties using semi-colons: N, ADR, ORG, CLIENTPIDMAP.
-     *   * Text-properties using commas: NICKNAME, RELATED, CATEGORIES, PID.
-     *
-     * Even though the spec says that commas must always be escaped, the
-     * example for GEO in Section 6.5.2 seems to violate this.
-     *
-     * iCalendar 2.0 (rfc5545) says:
-     *   * Commas or semi-colons may be used as delimiters, depending on the
-     *     property.
-     *   * Commas, semi-colons, backslashes, newline (\N or \n) are always
-     *     escaped, unless they are delimiters.
-     *   * Colons shall not be escaped.
-     *   * Commas can be considered the 'default delimiter' and is described as
-     *     the delimiter in cases where the order of the multiple values is
-     *     insignificant.
-     *   * Semi-colons are described as the delimiter for 'structured values'.
-     *     They are specifically used in Semi-colons are used as a delimiter in
-     *     REQUEST-STATUS, RRULE, GEO and EXRULE. EXRULE is deprecated however.
-     *
-     * Now for the parameters
-     *
-     * If delimiter is not set (empty string) this method will just return a string.
-     * If it's a comma or a semi-colon the string will be split on those
-     * characters, and always return an array.
-     *
-     * @param string $input
-     * @param string $delimiter
-     *
-     * @return string|string[]
-     */
-    public static function unescapeValue($input, $delimiter = ';')
-    {
-        $regex = '#  (?: (\\\\ (?: \\\\ | N | n | ; | , ) )';
-        if ($delimiter) {
-            $regex .= ' | ('.$delimiter.')';
-        }
-        $regex .= ') #x';
-
-        $matches = preg_split($regex, $input, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
-
-        $resultArray = [];
-        $result = '';
-
-        foreach ($matches as $match) {
-            switch ($match) {
-                case '\\\\':
-                    $result .= '\\';
-                    break;
-                case '\N':
-                case '\n':
-                    $result .= "\n";
-                    break;
-                case '\;':
-                    $result .= ';';
-                    break;
-                case '\,':
-                    $result .= ',';
-                    break;
-                case $delimiter:
-                    $resultArray[] = $result;
-                    $result = '';
-                    break;
-                default:
-                    $result .= $match;
-                    break;
-            }
-        }
-
-        $resultArray[] = $result;
-
-        return $delimiter ? $resultArray : $result;
-    }
-
-    /**
-     * Unescapes a parameter value.
-     *
-     * vCard 2.1:
-     *   * Does not mention a mechanism for this. In addition, double quotes
-     *     are never used to wrap values.
-     *   * This means that parameters can simply not contain colons or
-     *     semi-colons.
-     *
-     * vCard 3.0 (rfc2425, rfc2426):
-     *   * Parameters _may_ be surrounded by double quotes.
-     *   * If this is not the case, semi-colon, colon and comma may simply not
-     *     occur (the comma used for multiple parameter values though).
-     *   * If it is surrounded by double-quotes, it may simply not contain
-     *     double-quotes.
-     *   * This means that a parameter can in no case encode double-quotes, or
-     *     newlines.
-     *
-     * vCard 4.0 (rfc6350)
-     *   * Behavior seems to be identical to vCard 3.0
-     *
-     * iCalendar 2.0 (rfc5545)
-     *   * Behavior seems to be identical to vCard 3.0
-     *
-     * Parameter escaping mechanism (rfc6868) :
-     *   * This rfc describes a new way to escape parameter values.
-     *   * New-line is encoded as ^n
-     *   * ^ is encoded as ^^.
-     *   * " is encoded as ^'
-     *
-     * @param string $input
-     */
-    private function unescapeParam($input)
-    {
-        return
-            preg_replace_callback(
-                '#(\^(\^|n|\'))#',
-                function ($matches) {
-                    switch ($matches[2]) {
-                        case 'n':
-                            return "\n";
-                        case '^':
-                            return '^';
-                        case '\'':
-                            return '"';
-
-                    // @codeCoverageIgnoreStart
-                    }
-                    // @codeCoverageIgnoreEnd
-                },
-                $input
-            );
-    }
-
-    /**
-     * Gets the full quoted printable value.
-     *
-     * We need a special method for this, because newlines have both a meaning
-     * in vCards, and in QuotedPrintable.
-     *
-     * This method does not do any decoding.
-     *
-     * @return string
-     */
-    private function extractQuotedPrintableValue()
-    {
-        // We need to parse the raw line again to get the start of the value.
-        //
-        // We are basically looking for the first colon (:), but we need to
-        // skip over the parameters first, as they may contain one.
-        $regex = '/^
+		foreach ($matches as $match) {
+			if (isset($match['paramValue'])) {
+				if ($match['paramValue'] && '"' === $match['paramValue'][0]) {
+					$value = substr($match['paramValue'], 1, -1);
+				} else {
+					$value = $match['paramValue'];
+				}
+
+				$value = $this->unescapeParam($value);
+
+				if (is_null($lastParam)) {
+					if ($this->options & self::OPTION_IGNORE_INVALID_LINES) {
+						// When the property can't be matched and the configuration
+						// option is set to ignore invalid lines, we ignore this line
+						// This can happen when servers provide faulty data as iCloud
+						//  frequently does with X-APPLE-STRUCTURED-LOCATION
+						continue;
+					}
+					throw new ParseException('Invalid Mimedir file. Line starting at '.$this->startLine.' did not follow iCalendar/vCard conventions');
+				}
+				if (is_null($property['parameters'][$lastParam])) {
+					$property['parameters'][$lastParam] = $value;
+				} elseif (is_array($property['parameters'][$lastParam])) {
+					$property['parameters'][$lastParam][] = $value;
+				} elseif ($property['parameters'][$lastParam] === $value) {
+					// When the current value of the parameter is the same as the
+					// new one, then we can leave the current parameter as it is.
+				} else {
+					$property['parameters'][$lastParam] = [
+						$property['parameters'][$lastParam],
+						$value,
+					];
+				}
+				continue;
+			}
+			if (isset($match['paramName'])) {
+				$lastParam = strtoupper($match['paramName']);
+				if (!isset($property['parameters'][$lastParam])) {
+					$property['parameters'][$lastParam] = null;
+				}
+				continue;
+			}
+			if (isset($match['propValue'])) {
+				$property['value'] = $match['propValue'];
+				continue;
+			}
+			if (isset($match['name']) && $match['name']) {
+				$property['name'] = strtoupper($match['name']);
+				continue;
+			}
+
+			// @codeCoverageIgnoreStart
+			throw new \LogicException('This code should not be reachable');
+			// @codeCoverageIgnoreEnd
+		}
+
+		if (is_null($property['value'])) {
+			$property['value'] = '';
+		}
+		if (!$property['name']) {
+			if ($this->options & self::OPTION_IGNORE_INVALID_LINES) {
+				return false;
+			}
+			throw new ParseException('Invalid Mimedir file. Line starting at '.$this->startLine.' did not follow iCalendar/vCard conventions');
+		}
+
+		// vCard 2.1 states that parameters may appear without a name, and only
+		// a value. We can deduce the value based on its name.
+		//
+		// Our parser will get those as parameters without a value instead, so
+		// we're filtering these parameters out first.
+		$namedParameters = [];
+		$namelessParameters = [];
+
+		foreach ($property['parameters'] as $name => $value) {
+			if (!is_null($value)) {
+				$namedParameters[$name] = $value;
+			} else {
+				$namelessParameters[] = $name;
+			}
+		}
+
+		$propObj = $this->root->createProperty($property['name'], null, $namedParameters);
+
+		foreach ($namelessParameters as $namelessParameter) {
+			$propObj->add(null, $namelessParameter);
+		}
+
+		if (isset($propObj['ENCODING']) && 'QUOTED-PRINTABLE' === strtoupper($propObj['ENCODING'])) {
+			$propObj->setQuotedPrintableValue($this->extractQuotedPrintableValue());
+		} else {
+			$charset = $this->charset;
+			if (Document::VCARD21 === $this->root->getDocumentType() && isset($propObj['CHARSET'])) {
+				// vCard 2.1 allows the character set to be specified per property.
+				$charset = (string) $propObj['CHARSET'];
+			}
+			switch (strtolower($charset)) {
+				case 'utf-8':
+					break;
+				case 'windows-1252':
+				case 'iso-8859-1':
+					$property['value'] = mb_convert_encoding($property['value'], 'UTF-8', $charset);
+					break;
+				default:
+					throw new ParseException('Unsupported CHARSET: '.$propObj['CHARSET']);
+			}
+			$propObj->setRawMimeDirValue($property['value']);
+		}
+
+		return $propObj;
+	}
+
+	/**
+	 * Unescapes a property value.
+	 *
+	 * vCard 2.1 says:
+	 *   * Semi-colons must be escaped in some property values, specifically
+	 *     ADR, ORG and N.
+	 *   * Semi-colons must be escaped in parameter values, because semi-colons
+	 *     are also use to separate values.
+	 *   * No mention of escaping backslashes with another backslash.
+	 *   * newlines are not escaped either, instead QUOTED-PRINTABLE is used to
+	 *     span values over more than 1 line.
+	 *
+	 * vCard 3.0 says:
+	 *   * (rfc2425) Backslashes, newlines (\n or \N) and comma's must be
+	 *     escaped, all time time.
+	 *   * Comma's are used for delimiters in multiple values
+	 *   * (rfc2426) Adds to to this that the semi-colon MUST also be escaped,
+	 *     as in some properties semi-colon is used for separators.
+	 *   * Properties using semi-colons: N, ADR, GEO, ORG
+	 *   * Both ADR and N's individual parts may be broken up further with a
+	 *     comma.
+	 *   * Properties using commas: NICKNAME, CATEGORIES
+	 *
+	 * vCard 4.0 (rfc6350) says:
+	 *   * Commas must be escaped.
+	 *   * Semi-colons may be escaped, an unescaped semi-colon _may_ be a
+	 *     delimiter, depending on the property.
+	 *   * Backslashes must be escaped
+	 *   * Newlines must be escaped as either \N or \n.
+	 *   * Some compound properties may contain multiple parts themselves, so a
+	 *     comma within a semi-colon delimited property may also be unescaped
+	 *     to denote multiple parts _within_ the compound property.
+	 *   * Text-properties using semi-colons: N, ADR, ORG, CLIENTPIDMAP.
+	 *   * Text-properties using commas: NICKNAME, RELATED, CATEGORIES, PID.
+	 *
+	 * Even though the spec says that commas must always be escaped, the
+	 * example for GEO in Section 6.5.2 seems to violate this.
+	 *
+	 * iCalendar 2.0 (rfc5545) says:
+	 *   * Commas or semi-colons may be used as delimiters, depending on the
+	 *     property.
+	 *   * Commas, semi-colons, backslashes, newline (\N or \n) are always
+	 *     escaped, unless they are delimiters.
+	 *   * Colons shall not be escaped.
+	 *   * Commas can be considered the 'default delimiter' and is described as
+	 *     the delimiter in cases where the order of the multiple values is
+	 *     insignificant.
+	 *   * Semi-colons are described as the delimiter for 'structured values'.
+	 *     They are specifically used in Semi-colons are used as a delimiter in
+	 *     REQUEST-STATUS, RRULE, GEO and EXRULE. EXRULE is deprecated however.
+	 *
+	 * Now for the parameters
+	 *
+	 * If delimiter is not set (empty string) this method will just return a string.
+	 * If it's a comma or a semi-colon the string will be split on those
+	 * characters, and always return an array.
+	 *
+	 * @param string $input
+	 * @param string $delimiter
+	 *
+	 * @return string|string[]
+	 */
+	public static function unescapeValue($input, $delimiter = ';')
+	{
+		$regex = '#  (?: (\\\\ (?: \\\\ | N | n | ; | , ) )';
+		if ($delimiter) {
+			$regex .= ' | ('.$delimiter.')';
+		}
+		$regex .= ') #x';
+
+		$matches = preg_split($regex, $input, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
+
+		$resultArray = [];
+		$result = '';
+
+		foreach ($matches as $match) {
+			switch ($match) {
+				case '\\\\':
+					$result .= '\\';
+					break;
+				case '\N':
+				case '\n':
+					$result .= "\n";
+					break;
+				case '\;':
+					$result .= ';';
+					break;
+				case '\,':
+					$result .= ',';
+					break;
+				case $delimiter:
+					$resultArray[] = $result;
+					$result = '';
+					break;
+				default:
+					$result .= $match;
+					break;
+			}
+		}
+
+		$resultArray[] = $result;
+
+		return $delimiter ? $resultArray : $result;
+	}
+
+	/**
+	 * Unescapes a parameter value.
+	 *
+	 * vCard 2.1:
+	 *   * Does not mention a mechanism for this. In addition, double quotes
+	 *     are never used to wrap values.
+	 *   * This means that parameters can simply not contain colons or
+	 *     semi-colons.
+	 *
+	 * vCard 3.0 (rfc2425, rfc2426):
+	 *   * Parameters _may_ be surrounded by double quotes.
+	 *   * If this is not the case, semi-colon, colon and comma may simply not
+	 *     occur (the comma used for multiple parameter values though).
+	 *   * If it is surrounded by double-quotes, it may simply not contain
+	 *     double-quotes.
+	 *   * This means that a parameter can in no case encode double-quotes, or
+	 *     newlines.
+	 *
+	 * vCard 4.0 (rfc6350)
+	 *   * Behavior seems to be identical to vCard 3.0
+	 *
+	 * iCalendar 2.0 (rfc5545)
+	 *   * Behavior seems to be identical to vCard 3.0
+	 *
+	 * Parameter escaping mechanism (rfc6868) :
+	 *   * This rfc describes a new way to escape parameter values.
+	 *   * New-line is encoded as ^n
+	 *   * ^ is encoded as ^^.
+	 *   * " is encoded as ^'
+	 *
+	 * @param string $input
+	 */
+	private function unescapeParam($input)
+	{
+		return
+			preg_replace_callback(
+				'#(\^(\^|n|\'))#',
+				function ($matches) {
+					switch ($matches[2]) {
+						case 'n':
+							return "\n";
+						case '^':
+							return '^';
+						case '\'':
+							return '"';
+
+					// @codeCoverageIgnoreStart
+					}
+					// @codeCoverageIgnoreEnd
+				},
+				$input
+			);
+	}
+
+	/**
+	 * Gets the full quoted printable value.
+	 *
+	 * We need a special method for this, because newlines have both a meaning
+	 * in vCards, and in QuotedPrintable.
+	 *
+	 * This method does not do any decoding.
+	 *
+	 * @return string
+	 */
+	private function extractQuotedPrintableValue()
+	{
+		// We need to parse the raw line again to get the start of the value.
+		//
+		// We are basically looking for the first colon (:), but we need to
+		// skip over the parameters first, as they may contain one.
+		$regex = '/^
             (?: [^:])+ # Anything but a colon
             (?: "[^"]")* # A parameter in double quotes
             : # start of the value we really care about
             (.*)$
         /xs';
 
-        preg_match($regex, $this->rawLine, $matches);
-
-        $value = $matches[1];
-        // Removing the first whitespace character from every line. Kind of
-        // like unfolding, but we keep the newline.
-        $value = str_replace("\n ", "\n", $value);
-
-        // Microsoft products don't always correctly fold lines, they may be
-        // missing a whitespace. So if 'forgiving' is turned on, we will take
-        // those as well.
-        if ($this->options & self::OPTION_FORGIVING) {
-            while ('=' === substr($value, -1) && $this->lineBuffer) {
-                // Reading the line
-                $this->readLine();
-                // Grabbing the raw form
-                $value .= "\n".$this->rawLine;
-            }
-        }
-
-        return $value;
-    }
+		preg_match($regex, $this->rawLine, $matches);
+
+		$value = $matches[1];
+		// Removing the first whitespace character from every line. Kind of
+		// like unfolding, but we keep the newline.
+		$value = str_replace("\n ", "\n", $value);
+
+		// Microsoft products don't always correctly fold lines, they may be
+		// missing a whitespace. So if 'forgiving' is turned on, we will take
+		// those as well.
+		if ($this->options & self::OPTION_FORGIVING) {
+			while ('=' === substr($value, -1) && $this->lineBuffer) {
+				// Reading the line
+				$this->readLine();
+				// Grabbing the raw form
+				$value .= "\n".$this->rawLine;
+			}
+		}
+
+		return $value;
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VJournal.php

Indentation +75 added lines, -75 removed lines

@@ -16,86 +16,86 @@
  */
 class VJournal extends VObject\Component
 {
-    /**
-     * Returns true or false depending on if the event falls in the specified
-     * time-range. This is used for filtering purposes.
-     *
-     * The rules used to determine if an event falls within the specified
-     * time-range is based on the CalDAV specification.
-     *
-     * @return bool
-     */
-    public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
-    {
-        $dtstart = isset($this->DTSTART) ? $this->DTSTART->getDateTime() : null;
-        if ($dtstart) {
-            $effectiveEnd = $dtstart;
-            if (!$this->DTSTART->hasTime()) {
-                $effectiveEnd = $effectiveEnd->modify('+1 day');
-            }
+	/**
+	 * Returns true or false depending on if the event falls in the specified
+	 * time-range. This is used for filtering purposes.
+	 *
+	 * The rules used to determine if an event falls within the specified
+	 * time-range is based on the CalDAV specification.
+	 *
+	 * @return bool
+	 */
+	public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
+	{
+		$dtstart = isset($this->DTSTART) ? $this->DTSTART->getDateTime() : null;
+		if ($dtstart) {
+			$effectiveEnd = $dtstart;
+			if (!$this->DTSTART->hasTime()) {
+				$effectiveEnd = $effectiveEnd->modify('+1 day');
+			}
 
-            return $start <= $effectiveEnd && $end > $dtstart;
-        }
+			return $start <= $effectiveEnd && $end > $dtstart;
+		}
 
-        return false;
-    }
+		return false;
+	}
 
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        return [
-            'UID' => 1,
-            'DTSTAMP' => 1,
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		return [
+			'UID' => 1,
+			'DTSTAMP' => 1,
 
-            'CLASS' => '?',
-            'CREATED' => '?',
-            'DTSTART' => '?',
-            'LAST-MODIFIED' => '?',
-            'ORGANIZER' => '?',
-            'RECURRENCE-ID' => '?',
-            'SEQUENCE' => '?',
-            'STATUS' => '?',
-            'SUMMARY' => '?',
-            'URL' => '?',
+			'CLASS' => '?',
+			'CREATED' => '?',
+			'DTSTART' => '?',
+			'LAST-MODIFIED' => '?',
+			'ORGANIZER' => '?',
+			'RECURRENCE-ID' => '?',
+			'SEQUENCE' => '?',
+			'STATUS' => '?',
+			'SUMMARY' => '?',
+			'URL' => '?',
 
-            'RRULE' => '?',
+			'RRULE' => '?',
 
-            'ATTACH' => '*',
-            'ATTENDEE' => '*',
-            'CATEGORIES' => '*',
-            'COMMENT' => '*',
-            'CONTACT' => '*',
-            'DESCRIPTION' => '*',
-            'EXDATE' => '*',
-            'RELATED-TO' => '*',
-            'RDATE' => '*',
-        ];
-    }
+			'ATTACH' => '*',
+			'ATTENDEE' => '*',
+			'CATEGORIES' => '*',
+			'COMMENT' => '*',
+			'CONTACT' => '*',
+			'DESCRIPTION' => '*',
+			'EXDATE' => '*',
+			'RELATED-TO' => '*',
+			'RDATE' => '*',
+		];
+	}
 
-    /**
-     * This method should return a list of default property values.
-     *
-     * @return array
-     */
-    protected function getDefaults()
-    {
-        return [
-            'UID' => 'sabre-vobject-'.VObject\UUIDUtil::getUUID(),
-            'DTSTAMP' => gmdate('Ymd\\THis\\Z'),
-        ];
-    }
+	/**
+	 * This method should return a list of default property values.
+	 *
+	 * @return array
+	 */
+	protected function getDefaults()
+	{
+		return [
+			'UID' => 'sabre-vobject-'.VObject\UUIDUtil::getUUID(),
+			'DTSTAMP' => gmdate('Ymd\\THis\\Z'),
+		];
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VAvailability.php

Indentation +119 added lines, -119 removed lines

@@ -17,133 +17,133 @@
  */
 class VAvailability extends VObject\Component
 {
-    /**
-     * Returns true or false depending on if the event falls in the specified
-     * time-range. This is used for filtering purposes.
-     *
-     * The rules used to determine if an event falls within the specified
-     * time-range is based on:
-     *
-     * https://tools.ietf.org/html/draft-daboo-calendar-availability-05#section-3.1
-     *
-     * @return bool
-     */
-    public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
-    {
-        list($effectiveStart, $effectiveEnd) = $this->getEffectiveStartEnd();
+	/**
+	 * Returns true or false depending on if the event falls in the specified
+	 * time-range. This is used for filtering purposes.
+	 *
+	 * The rules used to determine if an event falls within the specified
+	 * time-range is based on:
+	 *
+	 * https://tools.ietf.org/html/draft-daboo-calendar-availability-05#section-3.1
+	 *
+	 * @return bool
+	 */
+	public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
+	{
+		list($effectiveStart, $effectiveEnd) = $this->getEffectiveStartEnd();
 
-        return
-            (is_null($effectiveStart) || $start < $effectiveEnd) &&
-            (is_null($effectiveEnd) || $end > $effectiveStart)
-        ;
-    }
+		return
+			(is_null($effectiveStart) || $start < $effectiveEnd) &&
+			(is_null($effectiveEnd) || $end > $effectiveStart)
+		;
+	}
 
-    /**
-     * Returns the 'effective start' and 'effective end' of this VAVAILABILITY
-     * component.
-     *
-     * We use the DTSTART and DTEND or DURATION to determine this.
-     *
-     * The returned value is an array containing DateTimeImmutable instances.
-     * If either the start or end is 'unbounded' its value will be null
-     * instead.
-     *
-     * @return array
-     */
-    public function getEffectiveStartEnd()
-    {
-        $effectiveStart = null;
-        $effectiveEnd = null;
+	/**
+	 * Returns the 'effective start' and 'effective end' of this VAVAILABILITY
+	 * component.
+	 *
+	 * We use the DTSTART and DTEND or DURATION to determine this.
+	 *
+	 * The returned value is an array containing DateTimeImmutable instances.
+	 * If either the start or end is 'unbounded' its value will be null
+	 * instead.
+	 *
+	 * @return array
+	 */
+	public function getEffectiveStartEnd()
+	{
+		$effectiveStart = null;
+		$effectiveEnd = null;
 
-        if (isset($this->DTSTART)) {
-            $effectiveStart = $this->DTSTART->getDateTime();
-        }
-        if (isset($this->DTEND)) {
-            $effectiveEnd = $this->DTEND->getDateTime();
-        } elseif ($effectiveStart && isset($this->DURATION)) {
-            $effectiveEnd = $effectiveStart->add(VObject\DateTimeParser::parseDuration($this->DURATION));
-        }
+		if (isset($this->DTSTART)) {
+			$effectiveStart = $this->DTSTART->getDateTime();
+		}
+		if (isset($this->DTEND)) {
+			$effectiveEnd = $this->DTEND->getDateTime();
+		} elseif ($effectiveStart && isset($this->DURATION)) {
+			$effectiveEnd = $effectiveStart->add(VObject\DateTimeParser::parseDuration($this->DURATION));
+		}
 
-        return [$effectiveStart, $effectiveEnd];
-    }
+		return [$effectiveStart, $effectiveEnd];
+	}
 
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        return [
-            'UID' => 1,
-            'DTSTAMP' => 1,
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		return [
+			'UID' => 1,
+			'DTSTAMP' => 1,
 
-            'BUSYTYPE' => '?',
-            'CLASS' => '?',
-            'CREATED' => '?',
-            'DESCRIPTION' => '?',
-            'DTSTART' => '?',
-            'LAST-MODIFIED' => '?',
-            'ORGANIZER' => '?',
-            'PRIORITY' => '?',
-            'SEQUENCE' => '?',
-            'SUMMARY' => '?',
-            'URL' => '?',
-            'DTEND' => '?',
-            'DURATION' => '?',
+			'BUSYTYPE' => '?',
+			'CLASS' => '?',
+			'CREATED' => '?',
+			'DESCRIPTION' => '?',
+			'DTSTART' => '?',
+			'LAST-MODIFIED' => '?',
+			'ORGANIZER' => '?',
+			'PRIORITY' => '?',
+			'SEQUENCE' => '?',
+			'SUMMARY' => '?',
+			'URL' => '?',
+			'DTEND' => '?',
+			'DURATION' => '?',
 
-            'CATEGORIES' => '*',
-            'COMMENT' => '*',
-            'CONTACT' => '*',
-        ];
-    }
+			'CATEGORIES' => '*',
+			'COMMENT' => '*',
+			'CONTACT' => '*',
+		];
+	}
 
-    /**
-     * Validates the node for correctness.
-     *
-     * The following options are supported:
-     *   Node::REPAIR - May attempt to automatically repair the problem.
-     *   Node::PROFILE_CARDDAV - Validate the vCard for CardDAV purposes.
-     *   Node::PROFILE_CALDAV - Validate the iCalendar for CalDAV purposes.
-     *
-     * This method returns an array with detected problems.
-     * Every element has the following properties:
-     *
-     *  * level - problem level.
-     *  * message - A human-readable string describing the issue.
-     *  * node - A reference to the problematic node.
-     *
-     * The level means:
-     *   1 - The issue was repaired (only happens if REPAIR was turned on).
-     *   2 - A warning.
-     *   3 - An error.
-     *
-     * @param int $options
-     *
-     * @return array
-     */
-    public function validate($options = 0)
-    {
-        $result = parent::validate($options);
+	/**
+	 * Validates the node for correctness.
+	 *
+	 * The following options are supported:
+	 *   Node::REPAIR - May attempt to automatically repair the problem.
+	 *   Node::PROFILE_CARDDAV - Validate the vCard for CardDAV purposes.
+	 *   Node::PROFILE_CALDAV - Validate the iCalendar for CalDAV purposes.
+	 *
+	 * This method returns an array with detected problems.
+	 * Every element has the following properties:
+	 *
+	 *  * level - problem level.
+	 *  * message - A human-readable string describing the issue.
+	 *  * node - A reference to the problematic node.
+	 *
+	 * The level means:
+	 *   1 - The issue was repaired (only happens if REPAIR was turned on).
+	 *   2 - A warning.
+	 *   3 - An error.
+	 *
+	 * @param int $options
+	 *
+	 * @return array
+	 */
+	public function validate($options = 0)
+	{
+		$result = parent::validate($options);
 
-        if (isset($this->DTEND) && isset($this->DURATION)) {
-            $result[] = [
-                'level' => 3,
-                'message' => 'DTEND and DURATION cannot both be present',
-                'node' => $this,
-            ];
-        }
+		if (isset($this->DTEND) && isset($this->DURATION)) {
+			$result[] = [
+				'level' => 3,
+				'message' => 'DTEND and DURATION cannot both be present',
+				'node' => $this,
+			];
+		}
 
-        return $result;
-    }
+		return $result;
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VCalendar.php

Indentation +503 added lines, -503 removed lines

@@ -22,507 +22,507 @@
  */
 class VCalendar extends VObject\Document
 {
-    /**
-     * The default name for this component.
-     *
-     * This should be 'VCALENDAR' or 'VCARD'.
-     *
-     * @var string
-     */
-    public static $defaultName = 'VCALENDAR';
-
-    /**
-     * This is a list of components, and which classes they should map to.
-     *
-     * @var array
-     */
-    public static $componentMap = [
-        'VCALENDAR' => self::class,
-        'VALARM' => VAlarm::class,
-        'VEVENT' => VEvent::class,
-        'VFREEBUSY' => VFreeBusy::class,
-        'VAVAILABILITY' => VAvailability::class,
-        'AVAILABLE' => Available::class,
-        'VJOURNAL' => VJournal::class,
-        'VTIMEZONE' => VTimeZone::class,
-        'VTODO' => VTodo::class,
-    ];
-
-    /**
-     * List of value-types, and which classes they map to.
-     *
-     * @var array
-     */
-    public static $valueMap = [
-        'BINARY' => VObject\Property\Binary::class,
-        'BOOLEAN' => VObject\Property\Boolean::class,
-        'CAL-ADDRESS' => VObject\Property\ICalendar\CalAddress::class,
-        'DATE' => VObject\Property\ICalendar\Date::class,
-        'DATE-TIME' => VObject\Property\ICalendar\DateTime::class,
-        'DURATION' => VObject\Property\ICalendar\Duration::class,
-        'FLOAT' => VObject\Property\FloatValue::class,
-        'INTEGER' => VObject\Property\IntegerValue::class,
-        'PERIOD' => VObject\Property\ICalendar\Period::class,
-        'RECUR' => VObject\Property\ICalendar\Recur::class,
-        'TEXT' => VObject\Property\Text::class,
-        'TIME' => VObject\Property\Time::class,
-        'UNKNOWN' => VObject\Property\Unknown::class, // jCard / jCal-only.
-        'URI' => VObject\Property\Uri::class,
-        'UTC-OFFSET' => VObject\Property\UtcOffset::class,
-    ];
-
-    /**
-     * List of properties, and which classes they map to.
-     *
-     * @var array
-     */
-    public static $propertyMap = [
-        // Calendar properties
-        'CALSCALE' => VObject\Property\FlatText::class,
-        'METHOD' => VObject\Property\FlatText::class,
-        'PRODID' => VObject\Property\FlatText::class,
-        'VERSION' => VObject\Property\FlatText::class,
-
-        // Component properties
-        'ATTACH' => VObject\Property\Uri::class,
-        'CATEGORIES' => VObject\Property\Text::class,
-        'CLASS' => VObject\Property\FlatText::class,
-        'COMMENT' => VObject\Property\FlatText::class,
-        'DESCRIPTION' => VObject\Property\FlatText::class,
-        'GEO' => VObject\Property\FloatValue::class,
-        'LOCATION' => VObject\Property\FlatText::class,
-        'PERCENT-COMPLETE' => VObject\Property\IntegerValue::class,
-        'PRIORITY' => VObject\Property\IntegerValue::class,
-        'RESOURCES' => VObject\Property\Text::class,
-        'STATUS' => VObject\Property\FlatText::class,
-        'SUMMARY' => VObject\Property\FlatText::class,
-
-        // Date and Time Component Properties
-        'COMPLETED' => VObject\Property\ICalendar\DateTime::class,
-        'DTEND' => VObject\Property\ICalendar\DateTime::class,
-        'DUE' => VObject\Property\ICalendar\DateTime::class,
-        'DTSTART' => VObject\Property\ICalendar\DateTime::class,
-        'DURATION' => VObject\Property\ICalendar\Duration::class,
-        'FREEBUSY' => VObject\Property\ICalendar\Period::class,
-        'TRANSP' => VObject\Property\FlatText::class,
-
-        // Time Zone Component Properties
-        'TZID' => VObject\Property\FlatText::class,
-        'TZNAME' => VObject\Property\FlatText::class,
-        'TZOFFSETFROM' => VObject\Property\UtcOffset::class,
-        'TZOFFSETTO' => VObject\Property\UtcOffset::class,
-        'TZURL' => VObject\Property\Uri::class,
-
-        // Relationship Component Properties
-        'ATTENDEE' => VObject\Property\ICalendar\CalAddress::class,
-        'CONTACT' => VObject\Property\FlatText::class,
-        'ORGANIZER' => VObject\Property\ICalendar\CalAddress::class,
-        'RECURRENCE-ID' => VObject\Property\ICalendar\DateTime::class,
-        'RELATED-TO' => VObject\Property\FlatText::class,
-        'URL' => VObject\Property\Uri::class,
-        'UID' => VObject\Property\FlatText::class,
-
-        // Recurrence Component Properties
-        'EXDATE' => VObject\Property\ICalendar\DateTime::class,
-        'RDATE' => VObject\Property\ICalendar\DateTime::class,
-        'RRULE' => VObject\Property\ICalendar\Recur::class,
-        'EXRULE' => VObject\Property\ICalendar\Recur::class, // Deprecated since rfc5545
-
-        // Alarm Component Properties
-        'ACTION' => VObject\Property\FlatText::class,
-        'REPEAT' => VObject\Property\IntegerValue::class,
-        'TRIGGER' => VObject\Property\ICalendar\Duration::class,
-
-        // Change Management Component Properties
-        'CREATED' => VObject\Property\ICalendar\DateTime::class,
-        'DTSTAMP' => VObject\Property\ICalendar\DateTime::class,
-        'LAST-MODIFIED' => VObject\Property\ICalendar\DateTime::class,
-        'SEQUENCE' => VObject\Property\IntegerValue::class,
-
-        // Request Status
-        'REQUEST-STATUS' => VObject\Property\Text::class,
-
-        // Additions from draft-daboo-valarm-extensions-04
-        'ALARM-AGENT' => VObject\Property\Text::class,
-        'ACKNOWLEDGED' => VObject\Property\ICalendar\DateTime::class,
-        'PROXIMITY' => VObject\Property\Text::class,
-        'DEFAULT-ALARM' => VObject\Property\Boolean::class,
-
-        // Additions from draft-daboo-calendar-availability-05
-        'BUSYTYPE' => VObject\Property\Text::class,
-    ];
-
-    /**
-     * Returns the current document type.
-     *
-     * @return int
-     */
-    public function getDocumentType()
-    {
-        return self::ICALENDAR20;
-    }
-
-    /**
-     * Returns a list of all 'base components'. For instance, if an Event has
-     * a recurrence rule, and one instance is overridden, the overridden event
-     * will have the same UID, but will be excluded from this list.
-     *
-     * VTIMEZONE components will always be excluded.
-     *
-     * @param string $componentName filter by component name
-     *
-     * @return VObject\Component[]
-     */
-    public function getBaseComponents($componentName = null)
-    {
-        $isBaseComponent = function ($component) {
-            if (!$component instanceof VObject\Component) {
-                return false;
-            }
-            if ('VTIMEZONE' === $component->name) {
-                return false;
-            }
-            if (isset($component->{'RECURRENCE-ID'})) {
-                return false;
-            }
-
-            return true;
-        };
-
-        if ($componentName) {
-            // Early exit
-            return array_filter(
-                $this->select($componentName),
-                $isBaseComponent
-            );
-        }
-
-        $components = [];
-        foreach ($this->children as $childGroup) {
-            foreach ($childGroup as $child) {
-                if (!$child instanceof Component) {
-                    // If one child is not a component, they all are so we skip
-                    // the entire group.
-                    continue 2;
-                }
-                if ($isBaseComponent($child)) {
-                    $components[] = $child;
-                }
-            }
-        }
-
-        return $components;
-    }
-
-    /**
-     * Returns the first component that is not a VTIMEZONE, and does not have
-     * an RECURRENCE-ID.
-     *
-     * If there is no such component, null will be returned.
-     *
-     * @param string $componentName filter by component name
-     *
-     * @return VObject\Component|null
-     */
-    public function getBaseComponent($componentName = null)
-    {
-        $isBaseComponent = function ($component) {
-            if (!$component instanceof VObject\Component) {
-                return false;
-            }
-            if ('VTIMEZONE' === $component->name) {
-                return false;
-            }
-            if (isset($component->{'RECURRENCE-ID'})) {
-                return false;
-            }
-
-            return true;
-        };
-
-        if ($componentName) {
-            foreach ($this->select($componentName) as $child) {
-                if ($isBaseComponent($child)) {
-                    return $child;
-                }
-            }
-
-            return null;
-        }
-
-        // Searching all components
-        foreach ($this->children as $childGroup) {
-            foreach ($childGroup as $child) {
-                if ($isBaseComponent($child)) {
-                    return $child;
-                }
-            }
-        }
-
-        return null;
-    }
-
-    /**
-     * Expand all events in this VCalendar object and return a new VCalendar
-     * with the expanded events.
-     *
-     * If this calendar object, has events with recurrence rules, this method
-     * can be used to expand the event into multiple sub-events.
-     *
-     * Each event will be stripped from its recurrence information, and only
-     * the instances of the event in the specified timerange will be left
-     * alone.
-     *
-     * In addition, this method will cause timezone information to be stripped,
-     * and normalized to UTC.
-     *
-     * @param DateTimeZone $timeZone reference timezone for floating dates and
-     *                               times
-     *
-     * @return VCalendar
-     */
-    public function expand(DateTimeInterface $start, DateTimeInterface $end, DateTimeZone $timeZone = null)
-    {
-        $newChildren = [];
-        $recurringEvents = [];
-
-        if (!$timeZone) {
-            $timeZone = new DateTimeZone('UTC');
-        }
-
-        $stripTimezones = function (Component $component) use ($timeZone, &$stripTimezones) {
-            foreach ($component->children() as $componentChild) {
-                if ($componentChild instanceof Property\ICalendar\DateTime && $componentChild->hasTime()) {
-                    $dt = $componentChild->getDateTimes($timeZone);
-                    // We only need to update the first timezone, because
-                    // setDateTimes will match all other timezones to the
-                    // first.
-                    $dt[0] = $dt[0]->setTimeZone(new DateTimeZone('UTC'));
-                    $componentChild->setDateTimes($dt);
-                } elseif ($componentChild instanceof Component) {
-                    $stripTimezones($componentChild);
-                }
-            }
-
-            return $component;
-        };
-
-        foreach ($this->children() as $child) {
-            if ($child instanceof Property && 'PRODID' !== $child->name) {
-                // We explicitly want to ignore PRODID, because we want to
-                // overwrite it with our own.
-                $newChildren[] = clone $child;
-            } elseif ($child instanceof Component && 'VTIMEZONE' !== $child->name) {
-                // We're also stripping all VTIMEZONE objects because we're
-                // converting everything to UTC.
-                if ('VEVENT' === $child->name && (isset($child->{'RECURRENCE-ID'}) || isset($child->RRULE) || isset($child->RDATE))) {
-                    // Handle these a bit later.
-                    $uid = (string) $child->UID;
-                    if (!$uid) {
-                        throw new InvalidDataException('Every VEVENT object must have a UID property');
-                    }
-                    if (isset($recurringEvents[$uid])) {
-                        $recurringEvents[$uid][] = clone $child;
-                    } else {
-                        $recurringEvents[$uid] = [clone $child];
-                    }
-                } elseif ('VEVENT' === $child->name && $child->isInTimeRange($start, $end)) {
-                    $newChildren[] = $stripTimezones(clone $child);
-                }
-            }
-        }
-
-        foreach ($recurringEvents as $events) {
-            try {
-                $it = new EventIterator($events, null, $timeZone);
-            } catch (NoInstancesException $e) {
-                // This event is recurring, but it doesn't have a single
-                // instance. We are skipping this event from the output
-                // entirely.
-                continue;
-            }
-            $it->fastForward($start);
-
-            while ($it->valid() && $it->getDTStart() < $end) {
-                if ($it->getDTEnd() > $start) {
-                    $newChildren[] = $stripTimezones($it->getEventObject());
-                }
-                $it->next();
-            }
-        }
-
-        return new self($newChildren);
-    }
-
-    /**
-     * This method should return a list of default property values.
-     *
-     * @return array
-     */
-    protected function getDefaults()
-    {
-        return [
-            'VERSION' => '2.0',
-            'PRODID' => '-//Sabre//Sabre VObject '.VObject\Version::VERSION.'//EN',
-            'CALSCALE' => 'GREGORIAN',
-        ];
-    }
-
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        return [
-            'PRODID' => 1,
-            'VERSION' => 1,
-
-            'CALSCALE' => '?',
-            'METHOD' => '?',
-        ];
-    }
-
-    /**
-     * Validates the node for correctness.
-     *
-     * The following options are supported:
-     *   Node::REPAIR - May attempt to automatically repair the problem.
-     *   Node::PROFILE_CARDDAV - Validate the vCard for CardDAV purposes.
-     *   Node::PROFILE_CALDAV - Validate the iCalendar for CalDAV purposes.
-     *
-     * This method returns an array with detected problems.
-     * Every element has the following properties:
-     *
-     *  * level - problem level.
-     *  * message - A human-readable string describing the issue.
-     *  * node - A reference to the problematic node.
-     *
-     * The level means:
-     *   1 - The issue was repaired (only happens if REPAIR was turned on).
-     *   2 - A warning.
-     *   3 - An error.
-     *
-     * @param int $options
-     *
-     * @return array
-     */
-    public function validate($options = 0)
-    {
-        $warnings = parent::validate($options);
-
-        if ($ver = $this->VERSION) {
-            if ('2.0' !== (string) $ver) {
-                $warnings[] = [
-                    'level' => 3,
-                    'message' => 'Only iCalendar version 2.0 as defined in rfc5545 is supported.',
-                    'node' => $this,
-                ];
-            }
-        }
-
-        $uidList = [];
-        $componentsFound = 0;
-        $componentTypes = [];
-
-        foreach ($this->children() as $child) {
-            if ($child instanceof Component) {
-                ++$componentsFound;
-
-                if (!in_array($child->name, ['VEVENT', 'VTODO', 'VJOURNAL'])) {
-                    continue;
-                }
-                $componentTypes[] = $child->name;
-
-                $uid = (string) $child->UID;
-                $isMaster = isset($child->{'RECURRENCE-ID'}) ? 0 : 1;
-                if (isset($uidList[$uid])) {
-                    ++$uidList[$uid]['count'];
-                    if ($isMaster && $uidList[$uid]['hasMaster']) {
-                        $warnings[] = [
-                            'level' => 3,
-                            'message' => 'More than one master object was found for the object with UID '.$uid,
-                            'node' => $this,
-                        ];
-                    }
-                    $uidList[$uid]['hasMaster'] += $isMaster;
-                } else {
-                    $uidList[$uid] = [
-                        'count' => 1,
-                        'hasMaster' => $isMaster,
-                    ];
-                }
-            }
-        }
-
-        if (0 === $componentsFound) {
-            $warnings[] = [
-                'level' => 3,
-                'message' => 'An iCalendar object must have at least 1 component.',
-                'node' => $this,
-            ];
-        }
-
-        if ($options & self::PROFILE_CALDAV) {
-            if (count($uidList) > 1) {
-                $warnings[] = [
-                    'level' => 3,
-                    'message' => 'A calendar object on a CalDAV server may only have components with the same UID.',
-                    'node' => $this,
-                ];
-            }
-            if (0 === count($componentTypes)) {
-                $warnings[] = [
-                    'level' => 3,
-                    'message' => 'A calendar object on a CalDAV server must have at least 1 component (VTODO, VEVENT, VJOURNAL).',
-                    'node' => $this,
-                ];
-            }
-            if (count(array_unique($componentTypes)) > 1) {
-                $warnings[] = [
-                    'level' => 3,
-                    'message' => 'A calendar object on a CalDAV server may only have 1 type of component (VEVENT, VTODO or VJOURNAL).',
-                    'node' => $this,
-                ];
-            }
-
-            if (isset($this->METHOD)) {
-                $warnings[] = [
-                    'level' => 3,
-                    'message' => 'A calendar object on a CalDAV server MUST NOT have a METHOD property.',
-                    'node' => $this,
-                ];
-            }
-        }
-
-        return $warnings;
-    }
-
-    /**
-     * Returns all components with a specific UID value.
-     *
-     * @return array
-     */
-    public function getByUID($uid)
-    {
-        return array_filter($this->getComponents(), function ($item) use ($uid) {
-            if (!$itemUid = $item->select('UID')) {
-                return false;
-            }
-            $itemUid = current($itemUid)->getValue();
-
-            return $uid === $itemUid;
-        });
-    }
+	/**
+	 * The default name for this component.
+	 *
+	 * This should be 'VCALENDAR' or 'VCARD'.
+	 *
+	 * @var string
+	 */
+	public static $defaultName = 'VCALENDAR';
+
+	/**
+	 * This is a list of components, and which classes they should map to.
+	 *
+	 * @var array
+	 */
+	public static $componentMap = [
+		'VCALENDAR' => self::class,
+		'VALARM' => VAlarm::class,
+		'VEVENT' => VEvent::class,
+		'VFREEBUSY' => VFreeBusy::class,
+		'VAVAILABILITY' => VAvailability::class,
+		'AVAILABLE' => Available::class,
+		'VJOURNAL' => VJournal::class,
+		'VTIMEZONE' => VTimeZone::class,
+		'VTODO' => VTodo::class,
+	];
+
+	/**
+	 * List of value-types, and which classes they map to.
+	 *
+	 * @var array
+	 */
+	public static $valueMap = [
+		'BINARY' => VObject\Property\Binary::class,
+		'BOOLEAN' => VObject\Property\Boolean::class,
+		'CAL-ADDRESS' => VObject\Property\ICalendar\CalAddress::class,
+		'DATE' => VObject\Property\ICalendar\Date::class,
+		'DATE-TIME' => VObject\Property\ICalendar\DateTime::class,
+		'DURATION' => VObject\Property\ICalendar\Duration::class,
+		'FLOAT' => VObject\Property\FloatValue::class,
+		'INTEGER' => VObject\Property\IntegerValue::class,
+		'PERIOD' => VObject\Property\ICalendar\Period::class,
+		'RECUR' => VObject\Property\ICalendar\Recur::class,
+		'TEXT' => VObject\Property\Text::class,
+		'TIME' => VObject\Property\Time::class,
+		'UNKNOWN' => VObject\Property\Unknown::class, // jCard / jCal-only.
+		'URI' => VObject\Property\Uri::class,
+		'UTC-OFFSET' => VObject\Property\UtcOffset::class,
+	];
+
+	/**
+	 * List of properties, and which classes they map to.
+	 *
+	 * @var array
+	 */
+	public static $propertyMap = [
+		// Calendar properties
+		'CALSCALE' => VObject\Property\FlatText::class,
+		'METHOD' => VObject\Property\FlatText::class,
+		'PRODID' => VObject\Property\FlatText::class,
+		'VERSION' => VObject\Property\FlatText::class,
+
+		// Component properties
+		'ATTACH' => VObject\Property\Uri::class,
+		'CATEGORIES' => VObject\Property\Text::class,
+		'CLASS' => VObject\Property\FlatText::class,
+		'COMMENT' => VObject\Property\FlatText::class,
+		'DESCRIPTION' => VObject\Property\FlatText::class,
+		'GEO' => VObject\Property\FloatValue::class,
+		'LOCATION' => VObject\Property\FlatText::class,
+		'PERCENT-COMPLETE' => VObject\Property\IntegerValue::class,
+		'PRIORITY' => VObject\Property\IntegerValue::class,
+		'RESOURCES' => VObject\Property\Text::class,
+		'STATUS' => VObject\Property\FlatText::class,
+		'SUMMARY' => VObject\Property\FlatText::class,
+
+		// Date and Time Component Properties
+		'COMPLETED' => VObject\Property\ICalendar\DateTime::class,
+		'DTEND' => VObject\Property\ICalendar\DateTime::class,
+		'DUE' => VObject\Property\ICalendar\DateTime::class,
+		'DTSTART' => VObject\Property\ICalendar\DateTime::class,
+		'DURATION' => VObject\Property\ICalendar\Duration::class,
+		'FREEBUSY' => VObject\Property\ICalendar\Period::class,
+		'TRANSP' => VObject\Property\FlatText::class,
+
+		// Time Zone Component Properties
+		'TZID' => VObject\Property\FlatText::class,
+		'TZNAME' => VObject\Property\FlatText::class,
+		'TZOFFSETFROM' => VObject\Property\UtcOffset::class,
+		'TZOFFSETTO' => VObject\Property\UtcOffset::class,
+		'TZURL' => VObject\Property\Uri::class,
+
+		// Relationship Component Properties
+		'ATTENDEE' => VObject\Property\ICalendar\CalAddress::class,
+		'CONTACT' => VObject\Property\FlatText::class,
+		'ORGANIZER' => VObject\Property\ICalendar\CalAddress::class,
+		'RECURRENCE-ID' => VObject\Property\ICalendar\DateTime::class,
+		'RELATED-TO' => VObject\Property\FlatText::class,
+		'URL' => VObject\Property\Uri::class,
+		'UID' => VObject\Property\FlatText::class,
+
+		// Recurrence Component Properties
+		'EXDATE' => VObject\Property\ICalendar\DateTime::class,
+		'RDATE' => VObject\Property\ICalendar\DateTime::class,
+		'RRULE' => VObject\Property\ICalendar\Recur::class,
+		'EXRULE' => VObject\Property\ICalendar\Recur::class, // Deprecated since rfc5545
+
+		// Alarm Component Properties
+		'ACTION' => VObject\Property\FlatText::class,
+		'REPEAT' => VObject\Property\IntegerValue::class,
+		'TRIGGER' => VObject\Property\ICalendar\Duration::class,
+
+		// Change Management Component Properties
+		'CREATED' => VObject\Property\ICalendar\DateTime::class,
+		'DTSTAMP' => VObject\Property\ICalendar\DateTime::class,
+		'LAST-MODIFIED' => VObject\Property\ICalendar\DateTime::class,
+		'SEQUENCE' => VObject\Property\IntegerValue::class,
+
+		// Request Status
+		'REQUEST-STATUS' => VObject\Property\Text::class,
+
+		// Additions from draft-daboo-valarm-extensions-04
+		'ALARM-AGENT' => VObject\Property\Text::class,
+		'ACKNOWLEDGED' => VObject\Property\ICalendar\DateTime::class,
+		'PROXIMITY' => VObject\Property\Text::class,
+		'DEFAULT-ALARM' => VObject\Property\Boolean::class,
+
+		// Additions from draft-daboo-calendar-availability-05
+		'BUSYTYPE' => VObject\Property\Text::class,
+	];
+
+	/**
+	 * Returns the current document type.
+	 *
+	 * @return int
+	 */
+	public function getDocumentType()
+	{
+		return self::ICALENDAR20;
+	}
+
+	/**
+	 * Returns a list of all 'base components'. For instance, if an Event has
+	 * a recurrence rule, and one instance is overridden, the overridden event
+	 * will have the same UID, but will be excluded from this list.
+	 *
+	 * VTIMEZONE components will always be excluded.
+	 *
+	 * @param string $componentName filter by component name
+	 *
+	 * @return VObject\Component[]
+	 */
+	public function getBaseComponents($componentName = null)
+	{
+		$isBaseComponent = function ($component) {
+			if (!$component instanceof VObject\Component) {
+				return false;
+			}
+			if ('VTIMEZONE' === $component->name) {
+				return false;
+			}
+			if (isset($component->{'RECURRENCE-ID'})) {
+				return false;
+			}
+
+			return true;
+		};
+
+		if ($componentName) {
+			// Early exit
+			return array_filter(
+				$this->select($componentName),
+				$isBaseComponent
+			);
+		}
+
+		$components = [];
+		foreach ($this->children as $childGroup) {
+			foreach ($childGroup as $child) {
+				if (!$child instanceof Component) {
+					// If one child is not a component, they all are so we skip
+					// the entire group.
+					continue 2;
+				}
+				if ($isBaseComponent($child)) {
+					$components[] = $child;
+				}
+			}
+		}
+
+		return $components;
+	}
+
+	/**
+	 * Returns the first component that is not a VTIMEZONE, and does not have
+	 * an RECURRENCE-ID.
+	 *
+	 * If there is no such component, null will be returned.
+	 *
+	 * @param string $componentName filter by component name
+	 *
+	 * @return VObject\Component|null
+	 */
+	public function getBaseComponent($componentName = null)
+	{
+		$isBaseComponent = function ($component) {
+			if (!$component instanceof VObject\Component) {
+				return false;
+			}
+			if ('VTIMEZONE' === $component->name) {
+				return false;
+			}
+			if (isset($component->{'RECURRENCE-ID'})) {
+				return false;
+			}
+
+			return true;
+		};
+
+		if ($componentName) {
+			foreach ($this->select($componentName) as $child) {
+				if ($isBaseComponent($child)) {
+					return $child;
+				}
+			}
+
+			return null;
+		}
+
+		// Searching all components
+		foreach ($this->children as $childGroup) {
+			foreach ($childGroup as $child) {
+				if ($isBaseComponent($child)) {
+					return $child;
+				}
+			}
+		}
+
+		return null;
+	}
+
+	/**
+	 * Expand all events in this VCalendar object and return a new VCalendar
+	 * with the expanded events.
+	 *
+	 * If this calendar object, has events with recurrence rules, this method
+	 * can be used to expand the event into multiple sub-events.
+	 *
+	 * Each event will be stripped from its recurrence information, and only
+	 * the instances of the event in the specified timerange will be left
+	 * alone.
+	 *
+	 * In addition, this method will cause timezone information to be stripped,
+	 * and normalized to UTC.
+	 *
+	 * @param DateTimeZone $timeZone reference timezone for floating dates and
+	 *                               times
+	 *
+	 * @return VCalendar
+	 */
+	public function expand(DateTimeInterface $start, DateTimeInterface $end, DateTimeZone $timeZone = null)
+	{
+		$newChildren = [];
+		$recurringEvents = [];
+
+		if (!$timeZone) {
+			$timeZone = new DateTimeZone('UTC');
+		}
+
+		$stripTimezones = function (Component $component) use ($timeZone, &$stripTimezones) {
+			foreach ($component->children() as $componentChild) {
+				if ($componentChild instanceof Property\ICalendar\DateTime && $componentChild->hasTime()) {
+					$dt = $componentChild->getDateTimes($timeZone);
+					// We only need to update the first timezone, because
+					// setDateTimes will match all other timezones to the
+					// first.
+					$dt[0] = $dt[0]->setTimeZone(new DateTimeZone('UTC'));
+					$componentChild->setDateTimes($dt);
+				} elseif ($componentChild instanceof Component) {
+					$stripTimezones($componentChild);
+				}
+			}
+
+			return $component;
+		};
+
+		foreach ($this->children() as $child) {
+			if ($child instanceof Property && 'PRODID' !== $child->name) {
+				// We explicitly want to ignore PRODID, because we want to
+				// overwrite it with our own.
+				$newChildren[] = clone $child;
+			} elseif ($child instanceof Component && 'VTIMEZONE' !== $child->name) {
+				// We're also stripping all VTIMEZONE objects because we're
+				// converting everything to UTC.
+				if ('VEVENT' === $child->name && (isset($child->{'RECURRENCE-ID'}) || isset($child->RRULE) || isset($child->RDATE))) {
+					// Handle these a bit later.
+					$uid = (string) $child->UID;
+					if (!$uid) {
+						throw new InvalidDataException('Every VEVENT object must have a UID property');
+					}
+					if (isset($recurringEvents[$uid])) {
+						$recurringEvents[$uid][] = clone $child;
+					} else {
+						$recurringEvents[$uid] = [clone $child];
+					}
+				} elseif ('VEVENT' === $child->name && $child->isInTimeRange($start, $end)) {
+					$newChildren[] = $stripTimezones(clone $child);
+				}
+			}
+		}
+
+		foreach ($recurringEvents as $events) {
+			try {
+				$it = new EventIterator($events, null, $timeZone);
+			} catch (NoInstancesException $e) {
+				// This event is recurring, but it doesn't have a single
+				// instance. We are skipping this event from the output
+				// entirely.
+				continue;
+			}
+			$it->fastForward($start);
+
+			while ($it->valid() && $it->getDTStart() < $end) {
+				if ($it->getDTEnd() > $start) {
+					$newChildren[] = $stripTimezones($it->getEventObject());
+				}
+				$it->next();
+			}
+		}
+
+		return new self($newChildren);
+	}
+
+	/**
+	 * This method should return a list of default property values.
+	 *
+	 * @return array
+	 */
+	protected function getDefaults()
+	{
+		return [
+			'VERSION' => '2.0',
+			'PRODID' => '-//Sabre//Sabre VObject '.VObject\Version::VERSION.'//EN',
+			'CALSCALE' => 'GREGORIAN',
+		];
+	}
+
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		return [
+			'PRODID' => 1,
+			'VERSION' => 1,
+
+			'CALSCALE' => '?',
+			'METHOD' => '?',
+		];
+	}
+
+	/**
+	 * Validates the node for correctness.
+	 *
+	 * The following options are supported:
+	 *   Node::REPAIR - May attempt to automatically repair the problem.
+	 *   Node::PROFILE_CARDDAV - Validate the vCard for CardDAV purposes.
+	 *   Node::PROFILE_CALDAV - Validate the iCalendar for CalDAV purposes.
+	 *
+	 * This method returns an array with detected problems.
+	 * Every element has the following properties:
+	 *
+	 *  * level - problem level.
+	 *  * message - A human-readable string describing the issue.
+	 *  * node - A reference to the problematic node.
+	 *
+	 * The level means:
+	 *   1 - The issue was repaired (only happens if REPAIR was turned on).
+	 *   2 - A warning.
+	 *   3 - An error.
+	 *
+	 * @param int $options
+	 *
+	 * @return array
+	 */
+	public function validate($options = 0)
+	{
+		$warnings = parent::validate($options);
+
+		if ($ver = $this->VERSION) {
+			if ('2.0' !== (string) $ver) {
+				$warnings[] = [
+					'level' => 3,
+					'message' => 'Only iCalendar version 2.0 as defined in rfc5545 is supported.',
+					'node' => $this,
+				];
+			}
+		}
+
+		$uidList = [];
+		$componentsFound = 0;
+		$componentTypes = [];
+
+		foreach ($this->children() as $child) {
+			if ($child instanceof Component) {
+				++$componentsFound;
+
+				if (!in_array($child->name, ['VEVENT', 'VTODO', 'VJOURNAL'])) {
+					continue;
+				}
+				$componentTypes[] = $child->name;
+
+				$uid = (string) $child->UID;
+				$isMaster = isset($child->{'RECURRENCE-ID'}) ? 0 : 1;
+				if (isset($uidList[$uid])) {
+					++$uidList[$uid]['count'];
+					if ($isMaster && $uidList[$uid]['hasMaster']) {
+						$warnings[] = [
+							'level' => 3,
+							'message' => 'More than one master object was found for the object with UID '.$uid,
+							'node' => $this,
+						];
+					}
+					$uidList[$uid]['hasMaster'] += $isMaster;
+				} else {
+					$uidList[$uid] = [
+						'count' => 1,
+						'hasMaster' => $isMaster,
+					];
+				}
+			}
+		}
+
+		if (0 === $componentsFound) {
+			$warnings[] = [
+				'level' => 3,
+				'message' => 'An iCalendar object must have at least 1 component.',
+				'node' => $this,
+			];
+		}
+
+		if ($options & self::PROFILE_CALDAV) {
+			if (count($uidList) > 1) {
+				$warnings[] = [
+					'level' => 3,
+					'message' => 'A calendar object on a CalDAV server may only have components with the same UID.',
+					'node' => $this,
+				];
+			}
+			if (0 === count($componentTypes)) {
+				$warnings[] = [
+					'level' => 3,
+					'message' => 'A calendar object on a CalDAV server must have at least 1 component (VTODO, VEVENT, VJOURNAL).',
+					'node' => $this,
+				];
+			}
+			if (count(array_unique($componentTypes)) > 1) {
+				$warnings[] = [
+					'level' => 3,
+					'message' => 'A calendar object on a CalDAV server may only have 1 type of component (VEVENT, VTODO or VJOURNAL).',
+					'node' => $this,
+				];
+			}
+
+			if (isset($this->METHOD)) {
+				$warnings[] = [
+					'level' => 3,
+					'message' => 'A calendar object on a CalDAV server MUST NOT have a METHOD property.',
+					'node' => $this,
+				];
+			}
+		}
+
+		return $warnings;
+	}
+
+	/**
+	 * Returns all components with a specific UID value.
+	 *
+	 * @return array
+	 */
+	public function getByUID($uid)
+	{
+		return array_filter($this->getComponents(), function ($item) use ($uid) {
+			if (!$itemUid = $item->select('UID')) {
+				return false;
+			}
+			$itemUid = current($itemUid)->getValue();
+
+			return $uid === $itemUid;
+		});
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VAlarm.php

Indentation +105 added lines, -105 removed lines

@@ -18,121 +18,121 @@
  */
 class VAlarm extends VObject\Component
 {
-    /**
-     * Returns a DateTime object when this alarm is going to trigger.
-     *
-     * This ignores repeated alarm, only the first trigger is returned.
-     *
-     * @return DateTimeImmutable
-     */
-    public function getEffectiveTriggerTime()
-    {
-        $trigger = $this->TRIGGER;
-        if (!isset($trigger['VALUE']) || 'DURATION' === strtoupper($trigger['VALUE'])) {
-            $triggerDuration = VObject\DateTimeParser::parseDuration($this->TRIGGER);
-            $related = (isset($trigger['RELATED']) && 'END' == strtoupper($trigger['RELATED'])) ? 'END' : 'START';
+	/**
+	 * Returns a DateTime object when this alarm is going to trigger.
+	 *
+	 * This ignores repeated alarm, only the first trigger is returned.
+	 *
+	 * @return DateTimeImmutable
+	 */
+	public function getEffectiveTriggerTime()
+	{
+		$trigger = $this->TRIGGER;
+		if (!isset($trigger['VALUE']) || 'DURATION' === strtoupper($trigger['VALUE'])) {
+			$triggerDuration = VObject\DateTimeParser::parseDuration($this->TRIGGER);
+			$related = (isset($trigger['RELATED']) && 'END' == strtoupper($trigger['RELATED'])) ? 'END' : 'START';
 
-            $parentComponent = $this->parent;
-            if ('START' === $related) {
-                if ('VTODO' === $parentComponent->name) {
-                    $propName = 'DUE';
-                } else {
-                    $propName = 'DTSTART';
-                }
+			$parentComponent = $this->parent;
+			if ('START' === $related) {
+				if ('VTODO' === $parentComponent->name) {
+					$propName = 'DUE';
+				} else {
+					$propName = 'DTSTART';
+				}
 
-                $effectiveTrigger = $parentComponent->$propName->getDateTime();
-                $effectiveTrigger = $effectiveTrigger->add($triggerDuration);
-            } else {
-                if ('VTODO' === $parentComponent->name) {
-                    $endProp = 'DUE';
-                } elseif ('VEVENT' === $parentComponent->name) {
-                    $endProp = 'DTEND';
-                } else {
-                    throw new InvalidDataException('time-range filters on VALARM components are only supported when they are a child of VTODO or VEVENT');
-                }
+				$effectiveTrigger = $parentComponent->$propName->getDateTime();
+				$effectiveTrigger = $effectiveTrigger->add($triggerDuration);
+			} else {
+				if ('VTODO' === $parentComponent->name) {
+					$endProp = 'DUE';
+				} elseif ('VEVENT' === $parentComponent->name) {
+					$endProp = 'DTEND';
+				} else {
+					throw new InvalidDataException('time-range filters on VALARM components are only supported when they are a child of VTODO or VEVENT');
+				}
 
-                if (isset($parentComponent->$endProp)) {
-                    $effectiveTrigger = $parentComponent->$endProp->getDateTime();
-                    $effectiveTrigger = $effectiveTrigger->add($triggerDuration);
-                } elseif (isset($parentComponent->DURATION)) {
-                    $effectiveTrigger = $parentComponent->DTSTART->getDateTime();
-                    $duration = VObject\DateTimeParser::parseDuration($parentComponent->DURATION);
-                    $effectiveTrigger = $effectiveTrigger->add($duration);
-                    $effectiveTrigger = $effectiveTrigger->add($triggerDuration);
-                } else {
-                    $effectiveTrigger = $parentComponent->DTSTART->getDateTime();
-                    $effectiveTrigger = $effectiveTrigger->add($triggerDuration);
-                }
-            }
-        } else {
-            $effectiveTrigger = $trigger->getDateTime();
-        }
+				if (isset($parentComponent->$endProp)) {
+					$effectiveTrigger = $parentComponent->$endProp->getDateTime();
+					$effectiveTrigger = $effectiveTrigger->add($triggerDuration);
+				} elseif (isset($parentComponent->DURATION)) {
+					$effectiveTrigger = $parentComponent->DTSTART->getDateTime();
+					$duration = VObject\DateTimeParser::parseDuration($parentComponent->DURATION);
+					$effectiveTrigger = $effectiveTrigger->add($duration);
+					$effectiveTrigger = $effectiveTrigger->add($triggerDuration);
+				} else {
+					$effectiveTrigger = $parentComponent->DTSTART->getDateTime();
+					$effectiveTrigger = $effectiveTrigger->add($triggerDuration);
+				}
+			}
+		} else {
+			$effectiveTrigger = $trigger->getDateTime();
+		}
 
-        return $effectiveTrigger;
-    }
+		return $effectiveTrigger;
+	}
 
-    /**
-     * Returns true or false depending on if the event falls in the specified
-     * time-range. This is used for filtering purposes.
-     *
-     * The rules used to determine if an event falls within the specified
-     * time-range is based on the CalDAV specification.
-     *
-     * @param DateTime $start
-     * @param DateTime $end
-     *
-     * @return bool
-     */
-    public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
-    {
-        $effectiveTrigger = $this->getEffectiveTriggerTime();
+	/**
+	 * Returns true or false depending on if the event falls in the specified
+	 * time-range. This is used for filtering purposes.
+	 *
+	 * The rules used to determine if an event falls within the specified
+	 * time-range is based on the CalDAV specification.
+	 *
+	 * @param DateTime $start
+	 * @param DateTime $end
+	 *
+	 * @return bool
+	 */
+	public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
+	{
+		$effectiveTrigger = $this->getEffectiveTriggerTime();
 
-        if (isset($this->DURATION)) {
-            $duration = VObject\DateTimeParser::parseDuration($this->DURATION);
-            $repeat = (string) $this->REPEAT;
-            if (!$repeat) {
-                $repeat = 1;
-            }
+		if (isset($this->DURATION)) {
+			$duration = VObject\DateTimeParser::parseDuration($this->DURATION);
+			$repeat = (string) $this->REPEAT;
+			if (!$repeat) {
+				$repeat = 1;
+			}
 
-            $period = new \DatePeriod($effectiveTrigger, $duration, (int) $repeat);
+			$period = new \DatePeriod($effectiveTrigger, $duration, (int) $repeat);
 
-            foreach ($period as $occurrence) {
-                if ($start <= $occurrence && $end > $occurrence) {
-                    return true;
-                }
-            }
+			foreach ($period as $occurrence) {
+				if ($start <= $occurrence && $end > $occurrence) {
+					return true;
+				}
+			}
 
-            return false;
-        } else {
-            return $start <= $effectiveTrigger && $end > $effectiveTrigger;
-        }
-    }
+			return false;
+		} else {
+			return $start <= $effectiveTrigger && $end > $effectiveTrigger;
+		}
+	}
 
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        return [
-            'ACTION' => 1,
-            'TRIGGER' => 1,
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		return [
+			'ACTION' => 1,
+			'TRIGGER' => 1,
 
-            'DURATION' => '?',
-            'REPEAT' => '?',
+			'DURATION' => '?',
+			'REPEAT' => '?',
 
-            'ATTACH' => '?',
-        ];
-    }
+			'ATTACH' => '?',
+		];
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VTodo.php

Indentation +151 added lines, -151 removed lines

@@ -16,166 +16,166 @@
  */
 class VTodo extends VObject\Component
 {
-    /**
-     * Returns true or false depending on if the event falls in the specified
-     * time-range. This is used for filtering purposes.
-     *
-     * The rules used to determine if an event falls within the specified
-     * time-range is based on the CalDAV specification.
-     *
-     * @return bool
-     */
-    public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
-    {
-        $dtstart = isset($this->DTSTART) ? $this->DTSTART->getDateTime() : null;
-        $duration = isset($this->DURATION) ? VObject\DateTimeParser::parseDuration($this->DURATION) : null;
-        $due = isset($this->DUE) ? $this->DUE->getDateTime() : null;
-        $completed = isset($this->COMPLETED) ? $this->COMPLETED->getDateTime() : null;
-        $created = isset($this->CREATED) ? $this->CREATED->getDateTime() : null;
+	/**
+	 * Returns true or false depending on if the event falls in the specified
+	 * time-range. This is used for filtering purposes.
+	 *
+	 * The rules used to determine if an event falls within the specified
+	 * time-range is based on the CalDAV specification.
+	 *
+	 * @return bool
+	 */
+	public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
+	{
+		$dtstart = isset($this->DTSTART) ? $this->DTSTART->getDateTime() : null;
+		$duration = isset($this->DURATION) ? VObject\DateTimeParser::parseDuration($this->DURATION) : null;
+		$due = isset($this->DUE) ? $this->DUE->getDateTime() : null;
+		$completed = isset($this->COMPLETED) ? $this->COMPLETED->getDateTime() : null;
+		$created = isset($this->CREATED) ? $this->CREATED->getDateTime() : null;
 
-        if ($dtstart) {
-            if ($duration) {
-                $effectiveEnd = $dtstart->add($duration);
+		if ($dtstart) {
+			if ($duration) {
+				$effectiveEnd = $dtstart->add($duration);
 
-                return $start <= $effectiveEnd && $end > $dtstart;
-            } elseif ($due) {
-                return
-                    ($start < $due || $start <= $dtstart) &&
-                    ($end > $dtstart || $end >= $due);
-            } else {
-                return $start <= $dtstart && $end > $dtstart;
-            }
-        }
-        if ($due) {
-            return $start < $due && $end >= $due;
-        }
-        if ($completed && $created) {
-            return
-                ($start <= $created || $start <= $completed) &&
-                ($end >= $created || $end >= $completed);
-        }
-        if ($completed) {
-            return $start <= $completed && $end >= $completed;
-        }
-        if ($created) {
-            return $end > $created;
-        }
+				return $start <= $effectiveEnd && $end > $dtstart;
+			} elseif ($due) {
+				return
+					($start < $due || $start <= $dtstart) &&
+					($end > $dtstart || $end >= $due);
+			} else {
+				return $start <= $dtstart && $end > $dtstart;
+			}
+		}
+		if ($due) {
+			return $start < $due && $end >= $due;
+		}
+		if ($completed && $created) {
+			return
+				($start <= $created || $start <= $completed) &&
+				($end >= $created || $end >= $completed);
+		}
+		if ($completed) {
+			return $start <= $completed && $end >= $completed;
+		}
+		if ($created) {
+			return $end > $created;
+		}
 
-        return true;
-    }
+		return true;
+	}
 
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        return [
-            'UID' => 1,
-            'DTSTAMP' => 1,
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		return [
+			'UID' => 1,
+			'DTSTAMP' => 1,
 
-            'CLASS' => '?',
-            'COMPLETED' => '?',
-            'CREATED' => '?',
-            'DESCRIPTION' => '?',
-            'DTSTART' => '?',
-            'GEO' => '?',
-            'LAST-MODIFIED' => '?',
-            'LOCATION' => '?',
-            'ORGANIZER' => '?',
-            'PERCENT' => '?',
-            'PRIORITY' => '?',
-            'RECURRENCE-ID' => '?',
-            'SEQUENCE' => '?',
-            'STATUS' => '?',
-            'SUMMARY' => '?',
-            'URL' => '?',
+			'CLASS' => '?',
+			'COMPLETED' => '?',
+			'CREATED' => '?',
+			'DESCRIPTION' => '?',
+			'DTSTART' => '?',
+			'GEO' => '?',
+			'LAST-MODIFIED' => '?',
+			'LOCATION' => '?',
+			'ORGANIZER' => '?',
+			'PERCENT' => '?',
+			'PRIORITY' => '?',
+			'RECURRENCE-ID' => '?',
+			'SEQUENCE' => '?',
+			'STATUS' => '?',
+			'SUMMARY' => '?',
+			'URL' => '?',
 
-            'RRULE' => '?',
-            'DUE' => '?',
-            'DURATION' => '?',
+			'RRULE' => '?',
+			'DUE' => '?',
+			'DURATION' => '?',
 
-            'ATTACH' => '*',
-            'ATTENDEE' => '*',
-            'CATEGORIES' => '*',
-            'COMMENT' => '*',
-            'CONTACT' => '*',
-            'EXDATE' => '*',
-            'REQUEST-STATUS' => '*',
-            'RELATED-TO' => '*',
-            'RESOURCES' => '*',
-            'RDATE' => '*',
-        ];
-    }
+			'ATTACH' => '*',
+			'ATTENDEE' => '*',
+			'CATEGORIES' => '*',
+			'COMMENT' => '*',
+			'CONTACT' => '*',
+			'EXDATE' => '*',
+			'REQUEST-STATUS' => '*',
+			'RELATED-TO' => '*',
+			'RESOURCES' => '*',
+			'RDATE' => '*',
+		];
+	}
 
-    /**
-     * Validates the node for correctness.
-     *
-     * The following options are supported:
-     *   Node::REPAIR - May attempt to automatically repair the problem.
-     *
-     * This method returns an array with detected problems.
-     * Every element has the following properties:
-     *
-     *  * level - problem level.
-     *  * message - A human-readable string describing the issue.
-     *  * node - A reference to the problematic node.
-     *
-     * The level means:
-     *   1 - The issue was repaired (only happens if REPAIR was turned on)
-     *   2 - An inconsequential issue
-     *   3 - A severe issue.
-     *
-     * @param int $options
-     *
-     * @return array
-     */
-    public function validate($options = 0)
-    {
-        $result = parent::validate($options);
-        if (isset($this->DUE) && isset($this->DTSTART)) {
-            $due = $this->DUE;
-            $dtStart = $this->DTSTART;
+	/**
+	 * Validates the node for correctness.
+	 *
+	 * The following options are supported:
+	 *   Node::REPAIR - May attempt to automatically repair the problem.
+	 *
+	 * This method returns an array with detected problems.
+	 * Every element has the following properties:
+	 *
+	 *  * level - problem level.
+	 *  * message - A human-readable string describing the issue.
+	 *  * node - A reference to the problematic node.
+	 *
+	 * The level means:
+	 *   1 - The issue was repaired (only happens if REPAIR was turned on)
+	 *   2 - An inconsequential issue
+	 *   3 - A severe issue.
+	 *
+	 * @param int $options
+	 *
+	 * @return array
+	 */
+	public function validate($options = 0)
+	{
+		$result = parent::validate($options);
+		if (isset($this->DUE) && isset($this->DTSTART)) {
+			$due = $this->DUE;
+			$dtStart = $this->DTSTART;
 
-            if ($due->getValueType() !== $dtStart->getValueType()) {
-                $result[] = [
-                    'level' => 3,
-                    'message' => 'The value type (DATE or DATE-TIME) must be identical for DUE and DTSTART',
-                    'node' => $due,
-                ];
-            } elseif ($due->getDateTime() < $dtStart->getDateTime()) {
-                $result[] = [
-                    'level' => 3,
-                    'message' => 'DUE must occur after DTSTART',
-                    'node' => $due,
-                ];
-            }
-        }
+			if ($due->getValueType() !== $dtStart->getValueType()) {
+				$result[] = [
+					'level' => 3,
+					'message' => 'The value type (DATE or DATE-TIME) must be identical for DUE and DTSTART',
+					'node' => $due,
+				];
+			} elseif ($due->getDateTime() < $dtStart->getDateTime()) {
+				$result[] = [
+					'level' => 3,
+					'message' => 'DUE must occur after DTSTART',
+					'node' => $due,
+				];
+			}
+		}
 
-        return $result;
-    }
+		return $result;
+	}
 
-    /**
-     * This method should return a list of default property values.
-     *
-     * @return array
-     */
-    protected function getDefaults()
-    {
-        return [
-            'UID' => 'sabre-vobject-'.VObject\UUIDUtil::getUUID(),
-            'DTSTAMP' => date('Ymd\\THis\\Z'),
-        ];
-    }
+	/**
+	 * This method should return a list of default property values.
+	 *
+	 * @return array
+	 */
+	protected function getDefaults()
+	{
+		return [
+			'UID' => 'sabre-vobject-'.VObject\UUIDUtil::getUUID(),
+			'DTSTAMP' => date('Ymd\\THis\\Z'),
+		];
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VFreeBusy.php

Indentation +65 added lines, -65 removed lines

@@ -17,77 +17,77 @@
  */
 class VFreeBusy extends VObject\Component
 {
-    /**
-     * Checks based on the contained FREEBUSY information, if a timeslot is
-     * available.
-     *
-     * @return bool
-     */
-    public function isFree(DateTimeInterface $start, DatetimeInterface $end)
-    {
-        foreach ($this->select('FREEBUSY') as $freebusy) {
-            // We are only interested in FBTYPE=BUSY (the default),
-            // FBTYPE=BUSY-TENTATIVE or FBTYPE=BUSY-UNAVAILABLE.
-            if (isset($freebusy['FBTYPE']) && 'BUSY' !== strtoupper(substr((string) $freebusy['FBTYPE'], 0, 4))) {
-                continue;
-            }
+	/**
+	 * Checks based on the contained FREEBUSY information, if a timeslot is
+	 * available.
+	 *
+	 * @return bool
+	 */
+	public function isFree(DateTimeInterface $start, DatetimeInterface $end)
+	{
+		foreach ($this->select('FREEBUSY') as $freebusy) {
+			// We are only interested in FBTYPE=BUSY (the default),
+			// FBTYPE=BUSY-TENTATIVE or FBTYPE=BUSY-UNAVAILABLE.
+			if (isset($freebusy['FBTYPE']) && 'BUSY' !== strtoupper(substr((string) $freebusy['FBTYPE'], 0, 4))) {
+				continue;
+			}
 
-            // The freebusy component can hold more than 1 value, separated by
-            // commas.
-            $periods = explode(',', (string) $freebusy);
+			// The freebusy component can hold more than 1 value, separated by
+			// commas.
+			$periods = explode(',', (string) $freebusy);
 
-            foreach ($periods as $period) {
-                // Every period is formatted as [start]/[end]. The start is an
-                // absolute UTC time, the end may be an absolute UTC time, or
-                // duration (relative) value.
-                list($busyStart, $busyEnd) = explode('/', $period);
+			foreach ($periods as $period) {
+				// Every period is formatted as [start]/[end]. The start is an
+				// absolute UTC time, the end may be an absolute UTC time, or
+				// duration (relative) value.
+				list($busyStart, $busyEnd) = explode('/', $period);
 
-                $busyStart = VObject\DateTimeParser::parse($busyStart);
-                $busyEnd = VObject\DateTimeParser::parse($busyEnd);
-                if ($busyEnd instanceof \DateInterval) {
-                    $busyEnd = $busyStart->add($busyEnd);
-                }
+				$busyStart = VObject\DateTimeParser::parse($busyStart);
+				$busyEnd = VObject\DateTimeParser::parse($busyEnd);
+				if ($busyEnd instanceof \DateInterval) {
+					$busyEnd = $busyStart->add($busyEnd);
+				}
 
-                if ($start < $busyEnd && $end > $busyStart) {
-                    return false;
-                }
-            }
-        }
+				if ($start < $busyEnd && $end > $busyStart) {
+					return false;
+				}
+			}
+		}
 
-        return true;
-    }
+		return true;
+	}
 
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        return [
-            'UID' => 1,
-            'DTSTAMP' => 1,
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		return [
+			'UID' => 1,
+			'DTSTAMP' => 1,
 
-            'CONTACT' => '?',
-            'DTSTART' => '?',
-            'DTEND' => '?',
-            'ORGANIZER' => '?',
-            'URL' => '?',
+			'CONTACT' => '?',
+			'DTSTART' => '?',
+			'DTEND' => '?',
+			'ORGANIZER' => '?',
+			'URL' => '?',
 
-            'ATTENDEE' => '*',
-            'COMMENT' => '*',
-            'FREEBUSY' => '*',
-            'REQUEST-STATUS' => '*',
-        ];
-    }
+			'ATTENDEE' => '*',
+			'COMMENT' => '*',
+			'FREEBUSY' => '*',
+			'REQUEST-STATUS' => '*',
+		];
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VEvent.php

Indentation +111 added lines, -111 removed lines

@@ -18,123 +18,123 @@
  */
 class VEvent extends VObject\Component
 {
-    /**
-     * Returns true or false depending on if the event falls in the specified
-     * time-range. This is used for filtering purposes.
-     *
-     * The rules used to determine if an event falls within the specified
-     * time-range is based on the CalDAV specification.
-     *
-     * @return bool
-     */
-    public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
-    {
-        if ($this->RRULE) {
-            try {
-                $it = new EventIterator($this, null, $start->getTimezone());
-            } catch (NoInstancesException $e) {
-                // If we've caught this exception, there are no instances
-                // for the event that fall into the specified time-range.
-                return false;
-            }
+	/**
+	 * Returns true or false depending on if the event falls in the specified
+	 * time-range. This is used for filtering purposes.
+	 *
+	 * The rules used to determine if an event falls within the specified
+	 * time-range is based on the CalDAV specification.
+	 *
+	 * @return bool
+	 */
+	public function isInTimeRange(DateTimeInterface $start, DateTimeInterface $end)
+	{
+		if ($this->RRULE) {
+			try {
+				$it = new EventIterator($this, null, $start->getTimezone());
+			} catch (NoInstancesException $e) {
+				// If we've caught this exception, there are no instances
+				// for the event that fall into the specified time-range.
+				return false;
+			}
 
-            $it->fastForward($start);
+			$it->fastForward($start);
 
-            // We fast-forwarded to a spot where the end-time of the
-            // recurrence instance exceeded the start of the requested
-            // time-range.
-            //
-            // If the starttime of the recurrence did not exceed the
-            // end of the time range as well, we have a match.
-            return $it->getDTStart() < $end && $it->getDTEnd() > $start;
-        }
+			// We fast-forwarded to a spot where the end-time of the
+			// recurrence instance exceeded the start of the requested
+			// time-range.
+			//
+			// If the starttime of the recurrence did not exceed the
+			// end of the time range as well, we have a match.
+			return $it->getDTStart() < $end && $it->getDTEnd() > $start;
+		}
 
-        $effectiveStart = $this->DTSTART->getDateTime($start->getTimezone());
-        if (isset($this->DTEND)) {
-            // The DTEND property is considered non inclusive. So for a 3 day
-            // event in july, dtstart and dtend would have to be July 1st and
-            // July 4th respectively.
-            //
-            // See:
-            // http://tools.ietf.org/html/rfc5545#page-54
-            $effectiveEnd = $this->DTEND->getDateTime($end->getTimezone());
-        } elseif (isset($this->DURATION)) {
-            $effectiveEnd = $effectiveStart->add(VObject\DateTimeParser::parseDuration($this->DURATION));
-        } elseif (!$this->DTSTART->hasTime()) {
-            $effectiveEnd = $effectiveStart->modify('+1 day');
-        } else {
-            $effectiveEnd = $effectiveStart;
-        }
+		$effectiveStart = $this->DTSTART->getDateTime($start->getTimezone());
+		if (isset($this->DTEND)) {
+			// The DTEND property is considered non inclusive. So for a 3 day
+			// event in july, dtstart and dtend would have to be July 1st and
+			// July 4th respectively.
+			//
+			// See:
+			// http://tools.ietf.org/html/rfc5545#page-54
+			$effectiveEnd = $this->DTEND->getDateTime($end->getTimezone());
+		} elseif (isset($this->DURATION)) {
+			$effectiveEnd = $effectiveStart->add(VObject\DateTimeParser::parseDuration($this->DURATION));
+		} elseif (!$this->DTSTART->hasTime()) {
+			$effectiveEnd = $effectiveStart->modify('+1 day');
+		} else {
+			$effectiveEnd = $effectiveStart;
+		}
 
-        return
-            ($start < $effectiveEnd) && ($end > $effectiveStart)
-        ;
-    }
+		return
+			($start < $effectiveEnd) && ($end > $effectiveStart)
+		;
+	}
 
-    /**
-     * This method should return a list of default property values.
-     *
-     * @return array
-     */
-    protected function getDefaults()
-    {
-        return [
-            'UID' => 'sabre-vobject-'.VObject\UUIDUtil::getUUID(),
-            'DTSTAMP' => gmdate('Ymd\\THis\\Z'),
-        ];
-    }
+	/**
+	 * This method should return a list of default property values.
+	 *
+	 * @return array
+	 */
+	protected function getDefaults()
+	{
+		return [
+			'UID' => 'sabre-vobject-'.VObject\UUIDUtil::getUUID(),
+			'DTSTAMP' => gmdate('Ymd\\THis\\Z'),
+		];
+	}
 
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        $hasMethod = isset($this->parent->METHOD);
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		$hasMethod = isset($this->parent->METHOD);
 
-        return [
-            'UID' => 1,
-            'DTSTAMP' => 1,
-            'DTSTART' => $hasMethod ? '?' : '1',
-            'CLASS' => '?',
-            'CREATED' => '?',
-            'DESCRIPTION' => '?',
-            'GEO' => '?',
-            'LAST-MODIFIED' => '?',
-            'LOCATION' => '?',
-            'ORGANIZER' => '?',
-            'PRIORITY' => '?',
-            'SEQUENCE' => '?',
-            'STATUS' => '?',
-            'SUMMARY' => '?',
-            'TRANSP' => '?',
-            'URL' => '?',
-            'RECURRENCE-ID' => '?',
-            'RRULE' => '?',
-            'DTEND' => '?',
-            'DURATION' => '?',
+		return [
+			'UID' => 1,
+			'DTSTAMP' => 1,
+			'DTSTART' => $hasMethod ? '?' : '1',
+			'CLASS' => '?',
+			'CREATED' => '?',
+			'DESCRIPTION' => '?',
+			'GEO' => '?',
+			'LAST-MODIFIED' => '?',
+			'LOCATION' => '?',
+			'ORGANIZER' => '?',
+			'PRIORITY' => '?',
+			'SEQUENCE' => '?',
+			'STATUS' => '?',
+			'SUMMARY' => '?',
+			'TRANSP' => '?',
+			'URL' => '?',
+			'RECURRENCE-ID' => '?',
+			'RRULE' => '?',
+			'DTEND' => '?',
+			'DURATION' => '?',
 
-            'ATTACH' => '*',
-            'ATTENDEE' => '*',
-            'CATEGORIES' => '*',
-            'COMMENT' => '*',
-            'CONTACT' => '*',
-            'EXDATE' => '*',
-            'REQUEST-STATUS' => '*',
-            'RELATED-TO' => '*',
-            'RESOURCES' => '*',
-            'RDATE' => '*',
-        ];
-    }
+			'ATTACH' => '*',
+			'ATTENDEE' => '*',
+			'CATEGORIES' => '*',
+			'COMMENT' => '*',
+			'CONTACT' => '*',
+			'EXDATE' => '*',
+			'REQUEST-STATUS' => '*',
+			'RELATED-TO' => '*',
+			'RESOURCES' => '*',
+			'RDATE' => '*',
+		];
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Component/VTimeZone.php

Indentation +41 added lines, -41 removed lines

@@ -16,48 +16,48 @@
  */
 class VTimeZone extends VObject\Component
 {
-    /**
-     * Returns the PHP DateTimeZone for this VTIMEZONE component.
-     *
-     * If we can't accurately determine the timezone, this method will return
-     * UTC.
-     *
-     * @return \DateTimeZone
-     */
-    public function getTimeZone()
-    {
-        return VObject\TimeZoneUtil::getTimeZone((string) $this->TZID, $this->root);
-    }
+	/**
+	 * Returns the PHP DateTimeZone for this VTIMEZONE component.
+	 *
+	 * If we can't accurately determine the timezone, this method will return
+	 * UTC.
+	 *
+	 * @return \DateTimeZone
+	 */
+	public function getTimeZone()
+	{
+		return VObject\TimeZoneUtil::getTimeZone((string) $this->TZID, $this->root);
+	}
 
-    /**
-     * A simple list of validation rules.
-     *
-     * This is simply a list of properties, and how many times they either
-     * must or must not appear.
-     *
-     * Possible values per property:
-     *   * 0 - Must not appear.
-     *   * 1 - Must appear exactly once.
-     *   * + - Must appear at least once.
-     *   * * - Can appear any number of times.
-     *   * ? - May appear, but not more than once.
-     *
-     * @var array
-     */
-    public function getValidationRules()
-    {
-        return [
-            'TZID' => 1,
+	/**
+	 * A simple list of validation rules.
+	 *
+	 * This is simply a list of properties, and how many times they either
+	 * must or must not appear.
+	 *
+	 * Possible values per property:
+	 *   * 0 - Must not appear.
+	 *   * 1 - Must appear exactly once.
+	 *   * + - Must appear at least once.
+	 *   * * - Can appear any number of times.
+	 *   * ? - May appear, but not more than once.
+	 *
+	 * @var array
+	 */
+	public function getValidationRules()
+	{
+		return [
+			'TZID' => 1,
 
-            'LAST-MODIFIED' => '?',
-            'TZURL' => '?',
+			'LAST-MODIFIED' => '?',
+			'TZURL' => '?',
 
-            // At least 1 STANDARD or DAYLIGHT must appear.
-            //
-            // The validator is not specific yet to pick this up, so these
-            // rules are too loose.
-            'STANDARD' => '*',
-            'DAYLIGHT' => '*',
-        ];
-    }
+			// At least 1 STANDARD or DAYLIGHT must appear.
+			//
+			// The validator is not specific yet to pick this up, so these
+			// rules are too loose.
+			'STANDARD' => '*',
+			'DAYLIGHT' => '*',
+		];
+	}
 }