Dolibarr / dolibarr

htdocs/includes/sabre/sabre/vobject/lib/ITip/Broker.php

Spacing +5 added lines, -10 removed lines

@@ -632,8 +632,7 @@ 
         }
 
         $oldInstances = !empty($oldEventInfo['attendees'][$attendee]['instances']) ?
-            $oldEventInfo['attendees'][$attendee]['instances'] :
-            [];
+            $oldEventInfo['attendees'][$attendee]['instances'] : [];
 
         $instances = [];
         foreach ($oldInstances as $instance) {
@@ -849,12 +848,10 @@ 
                 }
                 $organizerForceSend =
                     isset($vevent->ORGANIZER['SCHEDULE-FORCE-SEND']) ?
-                    strtoupper($vevent->ORGANIZER['SCHEDULE-FORCE-SEND']) :
-                    null;
+                    strtoupper($vevent->ORGANIZER['SCHEDULE-FORCE-SEND']) : null;
                 $organizerScheduleAgent =
                     isset($vevent->ORGANIZER['SCHEDULE-AGENT']) ?
-                    strtoupper((string) $vevent->ORGANIZER['SCHEDULE-AGENT']) :
-                    'SERVER';
+                    strtoupper((string) $vevent->ORGANIZER['SCHEDULE-AGENT']) : 'SERVER';
             }
             if (is_null($sequence) && isset($vevent->SEQUENCE)) {
                 $sequence = $vevent->SEQUENCE->getValue();
@@ -902,13 +899,11 @@ 
                     }
                     $partStat =
                         isset($attendee['PARTSTAT']) ?
-                        strtoupper($attendee['PARTSTAT']) :
-                        'NEEDS-ACTION';
+                        strtoupper($attendee['PARTSTAT']) : 'NEEDS-ACTION';
 
                     $forceSend =
                         isset($attendee['SCHEDULE-FORCE-SEND']) ?
-                        strtoupper($attendee['SCHEDULE-FORCE-SEND']) :
-                        null;
+                        strtoupper($attendee['SCHEDULE-FORCE-SEND']) : null;
 
                     if (isset($attendees[$attendee->getNormalizedValue()])) {
                         $attendees[$attendee->getNormalizedValue()]['instances'][$recurId] = [

Indentation +938 added lines, -938 removed lines

@@ -37,942 +37,942 @@
  */
 class Broker
 {
-    /**
-     * This setting determines whether the rules for the SCHEDULE-AGENT
-     * parameter should be followed.
-     *
-     * This is a parameter defined on ATTENDEE properties, introduced by RFC
-     * 6638. This parameter allows a caldav client to tell the server 'Don't do
-     * any scheduling operations'.
-     *
-     * If this setting is turned on, any attendees with SCHEDULE-AGENT set to
-     * CLIENT will be ignored. This is the desired behavior for a CalDAV
-     * server, but if you're writing an iTip application that doesn't deal with
-     * CalDAV, you may want to ignore this parameter.
-     *
-     * @var bool
-     */
-    public $scheduleAgentServerRules = true;
-
-    /**
-     * The broker will try during 'parseEvent' figure out whether the change
-     * was significant.
-     *
-     * It uses a few different ways to do this. One of these ways is seeing if
-     * certain properties changed values. This list of specified here.
-     *
-     * This list is taken from:
-     * * http://tools.ietf.org/html/rfc5546#section-2.1.4
-     *
-     * @var string[]
-     */
-    public $significantChangeProperties = [
-        'DTSTART',
-        'DTEND',
-        'DURATION',
-        'DUE',
-        'RRULE',
-        'RDATE',
-        'EXDATE',
-        'STATUS',
-    ];
-
-    /**
-     * This method is used to process an incoming itip message.
-     *
-     * Examples:
-     *
-     * 1. A user is an attendee to an event. The organizer sends an updated
-     * meeting using a new iTip message with METHOD:REQUEST. This function
-     * will process the message and update the attendee's event accordingly.
-     *
-     * 2. The organizer cancelled the event using METHOD:CANCEL. We will update
-     * the users event to state STATUS:CANCELLED.
-     *
-     * 3. An attendee sent a reply to an invite using METHOD:REPLY. We can
-     * update the organizers event to update the ATTENDEE with its correct
-     * PARTSTAT.
-     *
-     * The $existingObject is updated in-place. If there is no existing object
-     * (because it's a new invite for example) a new object will be created.
-     *
-     * If an existing object does not exist, and the method was CANCEL or
-     * REPLY, the message effectively gets ignored, and no 'existingObject'
-     * will be created.
-     *
-     * The updated $existingObject is also returned from this function.
-     *
-     * If the iTip message was not supported, we will always return false.
-     *
-     * @param VCalendar $existingObject
-     *
-     * @return VCalendar|null
-     */
-    public function processMessage(Message $itipMessage, VCalendar $existingObject = null)
-    {
-        // We only support events at the moment.
-        if ('VEVENT' !== $itipMessage->component) {
-            return false;
-        }
-
-        switch ($itipMessage->method) {
-            case 'REQUEST':
-                return $this->processMessageRequest($itipMessage, $existingObject);
-
-            case 'CANCEL':
-                return $this->processMessageCancel($itipMessage, $existingObject);
-
-            case 'REPLY':
-                return $this->processMessageReply($itipMessage, $existingObject);
-
-            default:
-                // Unsupported iTip message
-                return;
-        }
-
-        return $existingObject;
-    }
-
-    /**
-     * This function parses a VCALENDAR object and figure out if any messages
-     * need to be sent.
-     *
-     * A VCALENDAR object will be created from the perspective of either an
-     * attendee, or an organizer. You must pass a string identifying the
-     * current user, so we can figure out who in the list of attendees or the
-     * organizer we are sending this message on behalf of.
-     *
-     * It's possible to specify the current user as an array, in case the user
-     * has more than one identifying href (such as multiple emails).
-     *
-     * It $oldCalendar is specified, it is assumed that the operation is
-     * updating an existing event, which means that we need to look at the
-     * differences between events, and potentially send old attendees
-     * cancellations, and current attendees updates.
-     *
-     * If $calendar is null, but $oldCalendar is specified, we treat the
-     * operation as if the user has deleted an event. If the user was an
-     * organizer, this means that we need to send cancellation notices to
-     * people. If the user was an attendee, we need to make sure that the
-     * organizer gets the 'declined' message.
-     *
-     * @param VCalendar|string      $calendar
-     * @param string|array          $userHref
-     * @param VCalendar|string|null $oldCalendar
-     *
-     * @return array
-     */
-    public function parseEvent($calendar, $userHref, $oldCalendar = null)
-    {
-        if ($oldCalendar) {
-            if (is_string($oldCalendar)) {
-                $oldCalendar = Reader::read($oldCalendar);
-            }
-            if (!isset($oldCalendar->VEVENT)) {
-                // We only support events at the moment
-                return [];
-            }
-
-            $oldEventInfo = $this->parseEventInfo($oldCalendar);
-        } else {
-            $oldEventInfo = [
-                'organizer' => null,
-                'significantChangeHash' => '',
-                'attendees' => [],
-            ];
-        }
-
-        $userHref = (array) $userHref;
-
-        if (!is_null($calendar)) {
-            if (is_string($calendar)) {
-                $calendar = Reader::read($calendar);
-            }
-            if (!isset($calendar->VEVENT)) {
-                // We only support events at the moment
-                return [];
-            }
-            $eventInfo = $this->parseEventInfo($calendar);
-            if (!$eventInfo['attendees'] && !$oldEventInfo['attendees']) {
-                // If there were no attendees on either side of the equation,
-                // we don't need to do anything.
-                return [];
-            }
-            if (!$eventInfo['organizer'] && !$oldEventInfo['organizer']) {
-                // There was no organizer before or after the change.
-                return [];
-            }
-
-            $baseCalendar = $calendar;
-
-            // If the new object didn't have an organizer, the organizer
-            // changed the object from a scheduling object to a non-scheduling
-            // object. We just copy the info from the old object.
-            if (!$eventInfo['organizer'] && $oldEventInfo['organizer']) {
-                $eventInfo['organizer'] = $oldEventInfo['organizer'];
-                $eventInfo['organizerName'] = $oldEventInfo['organizerName'];
-            }
-        } else {
-            // The calendar object got deleted, we need to process this as a
-            // cancellation / decline.
-            if (!$oldCalendar) {
-                // No old and no new calendar, there's no thing to do.
-                return [];
-            }
-
-            $eventInfo = $oldEventInfo;
-
-            if (in_array($eventInfo['organizer'], $userHref)) {
-                // This is an organizer deleting the event.
-                $eventInfo['attendees'] = [];
-                // Increasing the sequence, but only if the organizer deleted
-                // the event.
-                ++$eventInfo['sequence'];
-            } else {
-                // This is an attendee deleting the event.
-                foreach ($eventInfo['attendees'] as $key => $attendee) {
-                    if (in_array($attendee['href'], $userHref)) {
-                        $eventInfo['attendees'][$key]['instances'] = ['master' => ['id' => 'master', 'partstat' => 'DECLINED'],
-                        ];
-                    }
-                }
-            }
-            $baseCalendar = $oldCalendar;
-        }
-
-        if (in_array($eventInfo['organizer'], $userHref)) {
-            return $this->parseEventForOrganizer($baseCalendar, $eventInfo, $oldEventInfo);
-        } elseif ($oldCalendar) {
-            // We need to figure out if the user is an attendee, but we're only
-            // doing so if there's an oldCalendar, because we only want to
-            // process updates, not creation of new events.
-            foreach ($eventInfo['attendees'] as $attendee) {
-                if (in_array($attendee['href'], $userHref)) {
-                    return $this->parseEventForAttendee($baseCalendar, $eventInfo, $oldEventInfo, $attendee['href']);
-                }
-            }
-        }
-
-        return [];
-    }
-
-    /**
-     * Processes incoming REQUEST messages.
-     *
-     * This is message from an organizer, and is either a new event
-     * invite, or an update to an existing one.
-     *
-     * @param VCalendar $existingObject
-     *
-     * @return VCalendar|null
-     */
-    protected function processMessageRequest(Message $itipMessage, VCalendar $existingObject = null)
-    {
-        if (!$existingObject) {
-            // This is a new invite, and we're just going to copy over
-            // all the components from the invite.
-            $existingObject = new VCalendar();
-            foreach ($itipMessage->message->getComponents() as $component) {
-                $existingObject->add(clone $component);
-            }
-        } else {
-            // We need to update an existing object with all the new
-            // information. We can just remove all existing components
-            // and create new ones.
-            foreach ($existingObject->getComponents() as $component) {
-                $existingObject->remove($component);
-            }
-            foreach ($itipMessage->message->getComponents() as $component) {
-                $existingObject->add(clone $component);
-            }
-        }
-
-        return $existingObject;
-    }
-
-    /**
-     * Processes incoming CANCEL messages.
-     *
-     * This is a message from an organizer, and means that either an
-     * attendee got removed from an event, or an event got cancelled
-     * altogether.
-     *
-     * @param VCalendar $existingObject
-     *
-     * @return VCalendar|null
-     */
-    protected function processMessageCancel(Message $itipMessage, VCalendar $existingObject = null)
-    {
-        if (!$existingObject) {
-            // The event didn't exist in the first place, so we're just
-            // ignoring this message.
-        } else {
-            foreach ($existingObject->VEVENT as $vevent) {
-                $vevent->STATUS = 'CANCELLED';
-                $vevent->SEQUENCE = $itipMessage->sequence;
-            }
-        }
-
-        return $existingObject;
-    }
-
-    /**
-     * Processes incoming REPLY messages.
-     *
-     * The message is a reply. This is for example an attendee telling
-     * an organizer he accepted the invite, or declined it.
-     *
-     * @param VCalendar $existingObject
-     *
-     * @return VCalendar|null
-     */
-    protected function processMessageReply(Message $itipMessage, VCalendar $existingObject = null)
-    {
-        // A reply can only be processed based on an existing object.
-        // If the object is not available, the reply is ignored.
-        if (!$existingObject) {
-            return;
-        }
-        $instances = [];
-        $requestStatus = '2.0';
-
-        // Finding all the instances the attendee replied to.
-        foreach ($itipMessage->message->VEVENT as $vevent) {
-            $recurId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->getValue() : 'master';
-            $attendee = $vevent->ATTENDEE;
-            $instances[$recurId] = $attendee['PARTSTAT']->getValue();
-            if (isset($vevent->{'REQUEST-STATUS'})) {
-                $requestStatus = $vevent->{'REQUEST-STATUS'}->getValue();
-                list($requestStatus) = explode(';', $requestStatus);
-            }
-        }
-
-        // Now we need to loop through the original organizer event, to find
-        // all the instances where we have a reply for.
-        $masterObject = null;
-        foreach ($existingObject->VEVENT as $vevent) {
-            $recurId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->getValue() : 'master';
-            if ('master' === $recurId) {
-                $masterObject = $vevent;
-            }
-            if (isset($instances[$recurId])) {
-                $attendeeFound = false;
-                if (isset($vevent->ATTENDEE)) {
-                    foreach ($vevent->ATTENDEE as $attendee) {
-                        if ($attendee->getValue() === $itipMessage->sender) {
-                            $attendeeFound = true;
-                            $attendee['PARTSTAT'] = $instances[$recurId];
-                            $attendee['SCHEDULE-STATUS'] = $requestStatus;
-                            // Un-setting the RSVP status, because we now know
-                            // that the attendee already replied.
-                            unset($attendee['RSVP']);
-                            break;
-                        }
-                    }
-                }
-                if (!$attendeeFound) {
-                    // Adding a new attendee. The iTip documentation calls this
-                    // a party crasher.
-                    $attendee = $vevent->add('ATTENDEE', $itipMessage->sender, [
-                        'PARTSTAT' => $instances[$recurId],
-                    ]);
-                    if ($itipMessage->senderName) {
-                        $attendee['CN'] = $itipMessage->senderName;
-                    }
-                }
-                unset($instances[$recurId]);
-            }
-        }
-
-        if (!$masterObject) {
-            // No master object, we can't add new instances.
-            return;
-        }
-        // If we got replies to instances that did not exist in the
-        // original list, it means that new exceptions must be created.
-        foreach ($instances as $recurId => $partstat) {
-            $recurrenceIterator = new EventIterator($existingObject, $itipMessage->uid);
-            $found = false;
-            $iterations = 1000;
-            do {
-                $newObject = $recurrenceIterator->getEventObject();
-                $recurrenceIterator->next();
-
-                if (isset($newObject->{'RECURRENCE-ID'}) && $newObject->{'RECURRENCE-ID'}->getValue() === $recurId) {
-                    $found = true;
-                }
-                --$iterations;
-            } while ($recurrenceIterator->valid() && !$found && $iterations);
-
-            // Invalid recurrence id. Skipping this object.
-            if (!$found) {
-                continue;
-            }
-
-            unset(
-                $newObject->RRULE,
-                $newObject->EXDATE,
-                $newObject->RDATE
-            );
-            $attendeeFound = false;
-            if (isset($newObject->ATTENDEE)) {
-                foreach ($newObject->ATTENDEE as $attendee) {
-                    if ($attendee->getValue() === $itipMessage->sender) {
-                        $attendeeFound = true;
-                        $attendee['PARTSTAT'] = $partstat;
-                        break;
-                    }
-                }
-            }
-            if (!$attendeeFound) {
-                // Adding a new attendee
-                $attendee = $newObject->add('ATTENDEE', $itipMessage->sender, [
-                    'PARTSTAT' => $partstat,
-                ]);
-                if ($itipMessage->senderName) {
-                    $attendee['CN'] = $itipMessage->senderName;
-                }
-            }
-            $existingObject->add($newObject);
-        }
-
-        return $existingObject;
-    }
-
-    /**
-     * This method is used in cases where an event got updated, and we
-     * potentially need to send emails to attendees to let them know of updates
-     * in the events.
-     *
-     * We will detect which attendees got added, which got removed and create
-     * specific messages for these situations.
-     *
-     * @return array
-     */
-    protected function parseEventForOrganizer(VCalendar $calendar, array $eventInfo, array $oldEventInfo)
-    {
-        // Merging attendee lists.
-        $attendees = [];
-        foreach ($oldEventInfo['attendees'] as $attendee) {
-            $attendees[$attendee['href']] = [
-                'href' => $attendee['href'],
-                'oldInstances' => $attendee['instances'],
-                'newInstances' => [],
-                'name' => $attendee['name'],
-                'forceSend' => null,
-            ];
-        }
-        foreach ($eventInfo['attendees'] as $attendee) {
-            if (isset($attendees[$attendee['href']])) {
-                $attendees[$attendee['href']]['name'] = $attendee['name'];
-                $attendees[$attendee['href']]['newInstances'] = $attendee['instances'];
-                $attendees[$attendee['href']]['forceSend'] = $attendee['forceSend'];
-            } else {
-                $attendees[$attendee['href']] = [
-                    'href' => $attendee['href'],
-                    'oldInstances' => [],
-                    'newInstances' => $attendee['instances'],
-                    'name' => $attendee['name'],
-                    'forceSend' => $attendee['forceSend'],
-                ];
-            }
-        }
-
-        $messages = [];
-
-        foreach ($attendees as $attendee) {
-            // An organizer can also be an attendee. We should not generate any
-            // messages for those.
-            if ($attendee['href'] === $eventInfo['organizer']) {
-                continue;
-            }
-
-            $message = new Message();
-            $message->uid = $eventInfo['uid'];
-            $message->component = 'VEVENT';
-            $message->sequence = $eventInfo['sequence'];
-            $message->sender = $eventInfo['organizer'];
-            $message->senderName = $eventInfo['organizerName'];
-            $message->recipient = $attendee['href'];
-            $message->recipientName = $attendee['name'];
-
-            // Creating the new iCalendar body.
-            $icalMsg = new VCalendar();
-
-            foreach ($calendar->select('VTIMEZONE') as $timezone) {
-                $icalMsg->add(clone $timezone);
-            }
-
-            if (!$attendee['newInstances']) {
-                // If there are no instances the attendee is a part of, it
-                // means the attendee was removed and we need to send him a
-                // CANCEL.
-                $message->method = 'CANCEL';
-
-                $icalMsg->METHOD = $message->method;
-
-                $event = $icalMsg->add('VEVENT', [
-                    'UID' => $message->uid,
-                    'SEQUENCE' => $message->sequence,
-                    'DTSTAMP' => gmdate('Ymd\\THis\\Z'),
-                ]);
-                if (isset($calendar->VEVENT->SUMMARY)) {
-                    $event->add('SUMMARY', $calendar->VEVENT->SUMMARY->getValue());
-                }
-                $event->add(clone $calendar->VEVENT->DTSTART);
-                if (isset($calendar->VEVENT->DTEND)) {
-                    $event->add(clone $calendar->VEVENT->DTEND);
-                } elseif (isset($calendar->VEVENT->DURATION)) {
-                    $event->add(clone $calendar->VEVENT->DURATION);
-                }
-                $org = $event->add('ORGANIZER', $eventInfo['organizer']);
-                if ($eventInfo['organizerName']) {
-                    $org['CN'] = $eventInfo['organizerName'];
-                }
-                $event->add('ATTENDEE', $attendee['href'], [
-                    'CN' => $attendee['name'],
-                ]);
-                $message->significantChange = true;
-            } else {
-                // The attendee gets the updated event body
-                $message->method = 'REQUEST';
-
-                $icalMsg->METHOD = $message->method;
-
-                // We need to find out that this change is significant. If it's
-                // not, systems may opt to not send messages.
-                //
-                // We do this based on the 'significantChangeHash' which is
-                // some value that changes if there's a certain set of
-                // properties changed in the event, or simply if there's a
-                // difference in instances that the attendee is invited to.
-
-                $oldAttendeeInstances = array_keys($attendee['oldInstances']);
-                $newAttendeeInstances = array_keys($attendee['newInstances']);
-
-                $message->significantChange =
-                    'REQUEST' === $attendee['forceSend'] ||
-                    count($oldAttendeeInstances) != count($newAttendeeInstances) ||
-                    count(array_diff($oldAttendeeInstances, $newAttendeeInstances)) > 0 ||
-                    $oldEventInfo['significantChangeHash'] !== $eventInfo['significantChangeHash'];
-
-                foreach ($attendee['newInstances'] as $instanceId => $instanceInfo) {
-                    $currentEvent = clone $eventInfo['instances'][$instanceId];
-                    if ('master' === $instanceId) {
-                        // We need to find a list of events that the attendee
-                        // is not a part of to add to the list of exceptions.
-                        $exceptions = [];
-                        foreach ($eventInfo['instances'] as $instanceId => $vevent) {
-                            if (!isset($attendee['newInstances'][$instanceId])) {
-                                $exceptions[] = $instanceId;
-                            }
-                        }
-
-                        // If there were exceptions, we need to add it to an
-                        // existing EXDATE property, if it exists.
-                        if ($exceptions) {
-                            if (isset($currentEvent->EXDATE)) {
-                                $currentEvent->EXDATE->setParts(array_merge(
-                                    $currentEvent->EXDATE->getParts(),
-                                    $exceptions
-                                ));
-                            } else {
-                                $currentEvent->EXDATE = $exceptions;
-                            }
-                        }
-
-                        // Cleaning up any scheduling information that
-                        // shouldn't be sent along.
-                        unset($currentEvent->ORGANIZER['SCHEDULE-FORCE-SEND']);
-                        unset($currentEvent->ORGANIZER['SCHEDULE-STATUS']);
-
-                        foreach ($currentEvent->ATTENDEE as $attendee) {
-                            unset($attendee['SCHEDULE-FORCE-SEND']);
-                            unset($attendee['SCHEDULE-STATUS']);
-
-                            // We're adding PARTSTAT=NEEDS-ACTION to ensure that
-                            // iOS shows an "Inbox Item"
-                            if (!isset($attendee['PARTSTAT'])) {
-                                $attendee['PARTSTAT'] = 'NEEDS-ACTION';
-                            }
-                        }
-                    }
-
-                    $currentEvent->DTSTAMP = gmdate('Ymd\\THis\\Z');
-                    $icalMsg->add($currentEvent);
-                }
-            }
-
-            $message->message = $icalMsg;
-            $messages[] = $message;
-        }
-
-        return $messages;
-    }
-
-    /**
-     * Parse an event update for an attendee.
-     *
-     * This function figures out if we need to send a reply to an organizer.
-     *
-     * @param string $attendee
-     *
-     * @return Message[]
-     */
-    protected function parseEventForAttendee(VCalendar $calendar, array $eventInfo, array $oldEventInfo, $attendee)
-    {
-        if ($this->scheduleAgentServerRules && 'CLIENT' === $eventInfo['organizerScheduleAgent']) {
-            return [];
-        }
-
-        // Don't bother generating messages for events that have already been
-        // cancelled.
-        if ('CANCELLED' === $eventInfo['status']) {
-            return [];
-        }
-
-        $oldInstances = !empty($oldEventInfo['attendees'][$attendee]['instances']) ?
-            $oldEventInfo['attendees'][$attendee]['instances'] :
-            [];
-
-        $instances = [];
-        foreach ($oldInstances as $instance) {
-            $instances[$instance['id']] = [
-                'id' => $instance['id'],
-                'oldstatus' => $instance['partstat'],
-                'newstatus' => null,
-            ];
-        }
-        foreach ($eventInfo['attendees'][$attendee]['instances'] as $instance) {
-            if (isset($instances[$instance['id']])) {
-                $instances[$instance['id']]['newstatus'] = $instance['partstat'];
-            } else {
-                $instances[$instance['id']] = [
-                    'id' => $instance['id'],
-                    'oldstatus' => null,
-                    'newstatus' => $instance['partstat'],
-                ];
-            }
-        }
-
-        // We need to also look for differences in EXDATE. If there are new
-        // items in EXDATE, it means that an attendee deleted instances of an
-        // event, which means we need to send DECLINED specifically for those
-        // instances.
-        // We only need to do that though, if the master event is not declined.
-        if (isset($instances['master']) && 'DECLINED' !== $instances['master']['newstatus']) {
-            foreach ($eventInfo['exdate'] as $exDate) {
-                if (!in_array($exDate, $oldEventInfo['exdate'])) {
-                    if (isset($instances[$exDate])) {
-                        $instances[$exDate]['newstatus'] = 'DECLINED';
-                    } else {
-                        $instances[$exDate] = [
-                            'id' => $exDate,
-                            'oldstatus' => null,
-                            'newstatus' => 'DECLINED',
-                        ];
-                    }
-                }
-            }
-        }
-
-        // Gathering a few extra properties for each instance.
-        foreach ($instances as $recurId => $instanceInfo) {
-            if (isset($eventInfo['instances'][$recurId])) {
-                $instances[$recurId]['dtstart'] = clone $eventInfo['instances'][$recurId]->DTSTART;
-            } else {
-                $instances[$recurId]['dtstart'] = $recurId;
-            }
-        }
-
-        $message = new Message();
-        $message->uid = $eventInfo['uid'];
-        $message->method = 'REPLY';
-        $message->component = 'VEVENT';
-        $message->sequence = $eventInfo['sequence'];
-        $message->sender = $attendee;
-        $message->senderName = $eventInfo['attendees'][$attendee]['name'];
-        $message->recipient = $eventInfo['organizer'];
-        $message->recipientName = $eventInfo['organizerName'];
-
-        $icalMsg = new VCalendar();
-        $icalMsg->METHOD = 'REPLY';
-
-        foreach ($calendar->select('VTIMEZONE') as $timezone) {
-            $icalMsg->add(clone $timezone);
-        }
-
-        $hasReply = false;
-
-        foreach ($instances as $instance) {
-            if ($instance['oldstatus'] == $instance['newstatus'] && 'REPLY' !== $eventInfo['organizerForceSend']) {
-                // Skip
-                continue;
-            }
-
-            $event = $icalMsg->add('VEVENT', [
-                'UID' => $message->uid,
-                'SEQUENCE' => $message->sequence,
-            ]);
-            $summary = isset($calendar->VEVENT->SUMMARY) ? $calendar->VEVENT->SUMMARY->getValue() : '';
-            // Adding properties from the correct source instance
-            if (isset($eventInfo['instances'][$instance['id']])) {
-                $instanceObj = $eventInfo['instances'][$instance['id']];
-                $event->add(clone $instanceObj->DTSTART);
-                if (isset($instanceObj->DTEND)) {
-                    $event->add(clone $instanceObj->DTEND);
-                } elseif (isset($instanceObj->DURATION)) {
-                    $event->add(clone $instanceObj->DURATION);
-                }
-                if (isset($instanceObj->SUMMARY)) {
-                    $event->add('SUMMARY', $instanceObj->SUMMARY->getValue());
-                } elseif ($summary) {
-                    $event->add('SUMMARY', $summary);
-                }
-            } else {
-                // This branch of the code is reached, when a reply is
-                // generated for an instance of a recurring event, through the
-                // fact that the instance has disappeared by showing up in
-                // EXDATE
-                $dt = DateTimeParser::parse($instance['id'], $eventInfo['timezone']);
-                // Treat is as a DATE field
-                if (strlen($instance['id']) <= 8) {
-                    $event->add('DTSTART', $dt, ['VALUE' => 'DATE']);
-                } else {
-                    $event->add('DTSTART', $dt);
-                }
-                if ($summary) {
-                    $event->add('SUMMARY', $summary);
-                }
-            }
-            if ('master' !== $instance['id']) {
-                $dt = DateTimeParser::parse($instance['id'], $eventInfo['timezone']);
-                // Treat is as a DATE field
-                if (strlen($instance['id']) <= 8) {
-                    $event->add('RECURRENCE-ID', $dt, ['VALUE' => 'DATE']);
-                } else {
-                    $event->add('RECURRENCE-ID', $dt);
-                }
-            }
-            $organizer = $event->add('ORGANIZER', $message->recipient);
-            if ($message->recipientName) {
-                $organizer['CN'] = $message->recipientName;
-            }
-            $attendee = $event->add('ATTENDEE', $message->sender, [
-                'PARTSTAT' => $instance['newstatus'],
-            ]);
-            if ($message->senderName) {
-                $attendee['CN'] = $message->senderName;
-            }
-            $hasReply = true;
-        }
-
-        if ($hasReply) {
-            $message->message = $icalMsg;
-
-            return [$message];
-        } else {
-            return [];
-        }
-    }
-
-    /**
-     * Returns attendee information and information about instances of an
-     * event.
-     *
-     * Returns an array with the following keys:
-     *
-     * 1. uid
-     * 2. organizer
-     * 3. organizerName
-     * 4. organizerScheduleAgent
-     * 5. organizerForceSend
-     * 6. instances
-     * 7. attendees
-     * 8. sequence
-     * 9. exdate
-     * 10. timezone - strictly the timezone on which the recurrence rule is
-     *                based on.
-     * 11. significantChangeHash
-     * 12. status
-     *
-     * @param VCalendar $calendar
-     *
-     * @return array
-     */
-    protected function parseEventInfo(VCalendar $calendar = null)
-    {
-        $uid = null;
-        $organizer = null;
-        $organizerName = null;
-        $organizerForceSend = null;
-        $sequence = null;
-        $timezone = null;
-        $status = null;
-        $organizerScheduleAgent = 'SERVER';
-
-        $significantChangeHash = '';
-
-        // Now we need to collect a list of attendees, and which instances they
-        // are a part of.
-        $attendees = [];
-
-        $instances = [];
-        $exdate = [];
-
-        $significantChangeEventProperties = [];
-
-        foreach ($calendar->VEVENT as $vevent) {
-            $eventSignificantChangeHash = '';
-            $rrule = [];
-
-            if (is_null($uid)) {
-                $uid = $vevent->UID->getValue();
-            } else {
-                if ($uid !== $vevent->UID->getValue()) {
-                    throw new ITipException('If a calendar contained more than one event, they must have the same UID.');
-                }
-            }
-
-            if (!isset($vevent->DTSTART)) {
-                throw new ITipException('An event MUST have a DTSTART property.');
-            }
-
-            if (isset($vevent->ORGANIZER)) {
-                if (is_null($organizer)) {
-                    $organizer = $vevent->ORGANIZER->getNormalizedValue();
-                    $organizerName = isset($vevent->ORGANIZER['CN']) ? $vevent->ORGANIZER['CN'] : null;
-                } else {
-                    if (strtoupper($organizer) !== strtoupper($vevent->ORGANIZER->getNormalizedValue())) {
-                        throw new SameOrganizerForAllComponentsException('Every instance of the event must have the same organizer.');
-                    }
-                }
-                $organizerForceSend =
-                    isset($vevent->ORGANIZER['SCHEDULE-FORCE-SEND']) ?
-                    strtoupper($vevent->ORGANIZER['SCHEDULE-FORCE-SEND']) :
-                    null;
-                $organizerScheduleAgent =
-                    isset($vevent->ORGANIZER['SCHEDULE-AGENT']) ?
-                    strtoupper((string) $vevent->ORGANIZER['SCHEDULE-AGENT']) :
-                    'SERVER';
-            }
-            if (is_null($sequence) && isset($vevent->SEQUENCE)) {
-                $sequence = $vevent->SEQUENCE->getValue();
-            }
-            if (isset($vevent->EXDATE)) {
-                foreach ($vevent->select('EXDATE') as $val) {
-                    $exdate = array_merge($exdate, $val->getParts());
-                }
-                sort($exdate);
-            }
-            if (isset($vevent->RRULE)) {
-                foreach ($vevent->select('RRULE') as $rr) {
-                    foreach ($rr->getParts() as $key => $val) {
-                        // ignore default values (https://github.com/sabre-io/vobject/issues/126)
-                        if ('INTERVAL' === $key && 1 == $val) {
-                            continue;
-                        }
-                        if (is_array($val)) {
-                            $val = implode(',', $val);
-                        }
-                        $rrule[] = "$key=$val";
-                    }
-                }
-                sort($rrule);
-            }
-            if (isset($vevent->STATUS)) {
-                $status = strtoupper($vevent->STATUS->getValue());
-            }
-
-            $recurId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->getValue() : 'master';
-            if (is_null($timezone)) {
-                if ('master' === $recurId) {
-                    $timezone = $vevent->DTSTART->getDateTime()->getTimeZone();
-                } else {
-                    $timezone = $vevent->{'RECURRENCE-ID'}->getDateTime()->getTimeZone();
-                }
-            }
-            if (isset($vevent->ATTENDEE)) {
-                foreach ($vevent->ATTENDEE as $attendee) {
-                    if ($this->scheduleAgentServerRules &&
-                        isset($attendee['SCHEDULE-AGENT']) &&
-                        'CLIENT' === strtoupper($attendee['SCHEDULE-AGENT']->getValue())
-                    ) {
-                        continue;
-                    }
-                    $partStat =
-                        isset($attendee['PARTSTAT']) ?
-                        strtoupper($attendee['PARTSTAT']) :
-                        'NEEDS-ACTION';
-
-                    $forceSend =
-                        isset($attendee['SCHEDULE-FORCE-SEND']) ?
-                        strtoupper($attendee['SCHEDULE-FORCE-SEND']) :
-                        null;
-
-                    if (isset($attendees[$attendee->getNormalizedValue()])) {
-                        $attendees[$attendee->getNormalizedValue()]['instances'][$recurId] = [
-                            'id' => $recurId,
-                            'partstat' => $partStat,
-                            'forceSend' => $forceSend,
-                        ];
-                    } else {
-                        $attendees[$attendee->getNormalizedValue()] = [
-                            'href' => $attendee->getNormalizedValue(),
-                            'instances' => [
-                                $recurId => [
-                                    'id' => $recurId,
-                                    'partstat' => $partStat,
-                                ],
-                            ],
-                            'name' => isset($attendee['CN']) ? (string) $attendee['CN'] : null,
-                            'forceSend' => $forceSend,
-                        ];
-                    }
-                }
-                $instances[$recurId] = $vevent;
-            }
-
-            foreach ($this->significantChangeProperties as $prop) {
-                if (isset($vevent->$prop)) {
-                    $propertyValues = $vevent->select($prop);
-
-                    $eventSignificantChangeHash .= $prop.':';
-
-                    if ('EXDATE' === $prop) {
-                        $eventSignificantChangeHash .= implode(',', $exdate).';';
-                    } elseif ('RRULE' === $prop) {
-                        $eventSignificantChangeHash .= implode(',', $rrule).';';
-                    } else {
-                        foreach ($propertyValues as $val) {
-                            $eventSignificantChangeHash .= $val->getValue().';';
-                        }
-                    }
-                }
-            }
-            $significantChangeEventProperties[] = $eventSignificantChangeHash;
-        }
-
-        asort($significantChangeEventProperties);
-
-        foreach ($significantChangeEventProperties as $eventSignificantChangeHash) {
-            $significantChangeHash .= $eventSignificantChangeHash;
-        }
-        $significantChangeHash = md5($significantChangeHash);
-
-        return compact(
-            'uid',
-            'organizer',
-            'organizerName',
-            'organizerScheduleAgent',
-            'organizerForceSend',
-            'instances',
-            'attendees',
-            'sequence',
-            'exdate',
-            'timezone',
-            'significantChangeHash',
-            'status'
-        );
-    }
+	/**
+	 * This setting determines whether the rules for the SCHEDULE-AGENT
+	 * parameter should be followed.
+	 *
+	 * This is a parameter defined on ATTENDEE properties, introduced by RFC
+	 * 6638. This parameter allows a caldav client to tell the server 'Don't do
+	 * any scheduling operations'.
+	 *
+	 * If this setting is turned on, any attendees with SCHEDULE-AGENT set to
+	 * CLIENT will be ignored. This is the desired behavior for a CalDAV
+	 * server, but if you're writing an iTip application that doesn't deal with
+	 * CalDAV, you may want to ignore this parameter.
+	 *
+	 * @var bool
+	 */
+	public $scheduleAgentServerRules = true;
+
+	/**
+	 * The broker will try during 'parseEvent' figure out whether the change
+	 * was significant.
+	 *
+	 * It uses a few different ways to do this. One of these ways is seeing if
+	 * certain properties changed values. This list of specified here.
+	 *
+	 * This list is taken from:
+	 * * http://tools.ietf.org/html/rfc5546#section-2.1.4
+	 *
+	 * @var string[]
+	 */
+	public $significantChangeProperties = [
+		'DTSTART',
+		'DTEND',
+		'DURATION',
+		'DUE',
+		'RRULE',
+		'RDATE',
+		'EXDATE',
+		'STATUS',
+	];
+
+	/**
+	 * This method is used to process an incoming itip message.
+	 *
+	 * Examples:
+	 *
+	 * 1. A user is an attendee to an event. The organizer sends an updated
+	 * meeting using a new iTip message with METHOD:REQUEST. This function
+	 * will process the message and update the attendee's event accordingly.
+	 *
+	 * 2. The organizer cancelled the event using METHOD:CANCEL. We will update
+	 * the users event to state STATUS:CANCELLED.
+	 *
+	 * 3. An attendee sent a reply to an invite using METHOD:REPLY. We can
+	 * update the organizers event to update the ATTENDEE with its correct
+	 * PARTSTAT.
+	 *
+	 * The $existingObject is updated in-place. If there is no existing object
+	 * (because it's a new invite for example) a new object will be created.
+	 *
+	 * If an existing object does not exist, and the method was CANCEL or
+	 * REPLY, the message effectively gets ignored, and no 'existingObject'
+	 * will be created.
+	 *
+	 * The updated $existingObject is also returned from this function.
+	 *
+	 * If the iTip message was not supported, we will always return false.
+	 *
+	 * @param VCalendar $existingObject
+	 *
+	 * @return VCalendar|null
+	 */
+	public function processMessage(Message $itipMessage, VCalendar $existingObject = null)
+	{
+		// We only support events at the moment.
+		if ('VEVENT' !== $itipMessage->component) {
+			return false;
+		}
+
+		switch ($itipMessage->method) {
+			case 'REQUEST':
+				return $this->processMessageRequest($itipMessage, $existingObject);
+
+			case 'CANCEL':
+				return $this->processMessageCancel($itipMessage, $existingObject);
+
+			case 'REPLY':
+				return $this->processMessageReply($itipMessage, $existingObject);
+
+			default:
+				// Unsupported iTip message
+				return;
+		}
+
+		return $existingObject;
+	}
+
+	/**
+	 * This function parses a VCALENDAR object and figure out if any messages
+	 * need to be sent.
+	 *
+	 * A VCALENDAR object will be created from the perspective of either an
+	 * attendee, or an organizer. You must pass a string identifying the
+	 * current user, so we can figure out who in the list of attendees or the
+	 * organizer we are sending this message on behalf of.
+	 *
+	 * It's possible to specify the current user as an array, in case the user
+	 * has more than one identifying href (such as multiple emails).
+	 *
+	 * It $oldCalendar is specified, it is assumed that the operation is
+	 * updating an existing event, which means that we need to look at the
+	 * differences between events, and potentially send old attendees
+	 * cancellations, and current attendees updates.
+	 *
+	 * If $calendar is null, but $oldCalendar is specified, we treat the
+	 * operation as if the user has deleted an event. If the user was an
+	 * organizer, this means that we need to send cancellation notices to
+	 * people. If the user was an attendee, we need to make sure that the
+	 * organizer gets the 'declined' message.
+	 *
+	 * @param VCalendar|string      $calendar
+	 * @param string|array          $userHref
+	 * @param VCalendar|string|null $oldCalendar
+	 *
+	 * @return array
+	 */
+	public function parseEvent($calendar, $userHref, $oldCalendar = null)
+	{
+		if ($oldCalendar) {
+			if (is_string($oldCalendar)) {
+				$oldCalendar = Reader::read($oldCalendar);
+			}
+			if (!isset($oldCalendar->VEVENT)) {
+				// We only support events at the moment
+				return [];
+			}
+
+			$oldEventInfo = $this->parseEventInfo($oldCalendar);
+		} else {
+			$oldEventInfo = [
+				'organizer' => null,
+				'significantChangeHash' => '',
+				'attendees' => [],
+			];
+		}
+
+		$userHref = (array) $userHref;
+
+		if (!is_null($calendar)) {
+			if (is_string($calendar)) {
+				$calendar = Reader::read($calendar);
+			}
+			if (!isset($calendar->VEVENT)) {
+				// We only support events at the moment
+				return [];
+			}
+			$eventInfo = $this->parseEventInfo($calendar);
+			if (!$eventInfo['attendees'] && !$oldEventInfo['attendees']) {
+				// If there were no attendees on either side of the equation,
+				// we don't need to do anything.
+				return [];
+			}
+			if (!$eventInfo['organizer'] && !$oldEventInfo['organizer']) {
+				// There was no organizer before or after the change.
+				return [];
+			}
+
+			$baseCalendar = $calendar;
+
+			// If the new object didn't have an organizer, the organizer
+			// changed the object from a scheduling object to a non-scheduling
+			// object. We just copy the info from the old object.
+			if (!$eventInfo['organizer'] && $oldEventInfo['organizer']) {
+				$eventInfo['organizer'] = $oldEventInfo['organizer'];
+				$eventInfo['organizerName'] = $oldEventInfo['organizerName'];
+			}
+		} else {
+			// The calendar object got deleted, we need to process this as a
+			// cancellation / decline.
+			if (!$oldCalendar) {
+				// No old and no new calendar, there's no thing to do.
+				return [];
+			}
+
+			$eventInfo = $oldEventInfo;
+
+			if (in_array($eventInfo['organizer'], $userHref)) {
+				// This is an organizer deleting the event.
+				$eventInfo['attendees'] = [];
+				// Increasing the sequence, but only if the organizer deleted
+				// the event.
+				++$eventInfo['sequence'];
+			} else {
+				// This is an attendee deleting the event.
+				foreach ($eventInfo['attendees'] as $key => $attendee) {
+					if (in_array($attendee['href'], $userHref)) {
+						$eventInfo['attendees'][$key]['instances'] = ['master' => ['id' => 'master', 'partstat' => 'DECLINED'],
+						];
+					}
+				}
+			}
+			$baseCalendar = $oldCalendar;
+		}
+
+		if (in_array($eventInfo['organizer'], $userHref)) {
+			return $this->parseEventForOrganizer($baseCalendar, $eventInfo, $oldEventInfo);
+		} elseif ($oldCalendar) {
+			// We need to figure out if the user is an attendee, but we're only
+			// doing so if there's an oldCalendar, because we only want to
+			// process updates, not creation of new events.
+			foreach ($eventInfo['attendees'] as $attendee) {
+				if (in_array($attendee['href'], $userHref)) {
+					return $this->parseEventForAttendee($baseCalendar, $eventInfo, $oldEventInfo, $attendee['href']);
+				}
+			}
+		}
+
+		return [];
+	}
+
+	/**
+	 * Processes incoming REQUEST messages.
+	 *
+	 * This is message from an organizer, and is either a new event
+	 * invite, or an update to an existing one.
+	 *
+	 * @param VCalendar $existingObject
+	 *
+	 * @return VCalendar|null
+	 */
+	protected function processMessageRequest(Message $itipMessage, VCalendar $existingObject = null)
+	{
+		if (!$existingObject) {
+			// This is a new invite, and we're just going to copy over
+			// all the components from the invite.
+			$existingObject = new VCalendar();
+			foreach ($itipMessage->message->getComponents() as $component) {
+				$existingObject->add(clone $component);
+			}
+		} else {
+			// We need to update an existing object with all the new
+			// information. We can just remove all existing components
+			// and create new ones.
+			foreach ($existingObject->getComponents() as $component) {
+				$existingObject->remove($component);
+			}
+			foreach ($itipMessage->message->getComponents() as $component) {
+				$existingObject->add(clone $component);
+			}
+		}
+
+		return $existingObject;
+	}
+
+	/**
+	 * Processes incoming CANCEL messages.
+	 *
+	 * This is a message from an organizer, and means that either an
+	 * attendee got removed from an event, or an event got cancelled
+	 * altogether.
+	 *
+	 * @param VCalendar $existingObject
+	 *
+	 * @return VCalendar|null
+	 */
+	protected function processMessageCancel(Message $itipMessage, VCalendar $existingObject = null)
+	{
+		if (!$existingObject) {
+			// The event didn't exist in the first place, so we're just
+			// ignoring this message.
+		} else {
+			foreach ($existingObject->VEVENT as $vevent) {
+				$vevent->STATUS = 'CANCELLED';
+				$vevent->SEQUENCE = $itipMessage->sequence;
+			}
+		}
+
+		return $existingObject;
+	}
+
+	/**
+	 * Processes incoming REPLY messages.
+	 *
+	 * The message is a reply. This is for example an attendee telling
+	 * an organizer he accepted the invite, or declined it.
+	 *
+	 * @param VCalendar $existingObject
+	 *
+	 * @return VCalendar|null
+	 */
+	protected function processMessageReply(Message $itipMessage, VCalendar $existingObject = null)
+	{
+		// A reply can only be processed based on an existing object.
+		// If the object is not available, the reply is ignored.
+		if (!$existingObject) {
+			return;
+		}
+		$instances = [];
+		$requestStatus = '2.0';
+
+		// Finding all the instances the attendee replied to.
+		foreach ($itipMessage->message->VEVENT as $vevent) {
+			$recurId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->getValue() : 'master';
+			$attendee = $vevent->ATTENDEE;
+			$instances[$recurId] = $attendee['PARTSTAT']->getValue();
+			if (isset($vevent->{'REQUEST-STATUS'})) {
+				$requestStatus = $vevent->{'REQUEST-STATUS'}->getValue();
+				list($requestStatus) = explode(';', $requestStatus);
+			}
+		}
+
+		// Now we need to loop through the original organizer event, to find
+		// all the instances where we have a reply for.
+		$masterObject = null;
+		foreach ($existingObject->VEVENT as $vevent) {
+			$recurId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->getValue() : 'master';
+			if ('master' === $recurId) {
+				$masterObject = $vevent;
+			}
+			if (isset($instances[$recurId])) {
+				$attendeeFound = false;
+				if (isset($vevent->ATTENDEE)) {
+					foreach ($vevent->ATTENDEE as $attendee) {
+						if ($attendee->getValue() === $itipMessage->sender) {
+							$attendeeFound = true;
+							$attendee['PARTSTAT'] = $instances[$recurId];
+							$attendee['SCHEDULE-STATUS'] = $requestStatus;
+							// Un-setting the RSVP status, because we now know
+							// that the attendee already replied.
+							unset($attendee['RSVP']);
+							break;
+						}
+					}
+				}
+				if (!$attendeeFound) {
+					// Adding a new attendee. The iTip documentation calls this
+					// a party crasher.
+					$attendee = $vevent->add('ATTENDEE', $itipMessage->sender, [
+						'PARTSTAT' => $instances[$recurId],
+					]);
+					if ($itipMessage->senderName) {
+						$attendee['CN'] = $itipMessage->senderName;
+					}
+				}
+				unset($instances[$recurId]);
+			}
+		}
+
+		if (!$masterObject) {
+			// No master object, we can't add new instances.
+			return;
+		}
+		// If we got replies to instances that did not exist in the
+		// original list, it means that new exceptions must be created.
+		foreach ($instances as $recurId => $partstat) {
+			$recurrenceIterator = new EventIterator($existingObject, $itipMessage->uid);
+			$found = false;
+			$iterations = 1000;
+			do {
+				$newObject = $recurrenceIterator->getEventObject();
+				$recurrenceIterator->next();
+
+				if (isset($newObject->{'RECURRENCE-ID'}) && $newObject->{'RECURRENCE-ID'}->getValue() === $recurId) {
+					$found = true;
+				}
+				--$iterations;
+			} while ($recurrenceIterator->valid() && !$found && $iterations);
+
+			// Invalid recurrence id. Skipping this object.
+			if (!$found) {
+				continue;
+			}
+
+			unset(
+				$newObject->RRULE,
+				$newObject->EXDATE,
+				$newObject->RDATE
+			);
+			$attendeeFound = false;
+			if (isset($newObject->ATTENDEE)) {
+				foreach ($newObject->ATTENDEE as $attendee) {
+					if ($attendee->getValue() === $itipMessage->sender) {
+						$attendeeFound = true;
+						$attendee['PARTSTAT'] = $partstat;
+						break;
+					}
+				}
+			}
+			if (!$attendeeFound) {
+				// Adding a new attendee
+				$attendee = $newObject->add('ATTENDEE', $itipMessage->sender, [
+					'PARTSTAT' => $partstat,
+				]);
+				if ($itipMessage->senderName) {
+					$attendee['CN'] = $itipMessage->senderName;
+				}
+			}
+			$existingObject->add($newObject);
+		}
+
+		return $existingObject;
+	}
+
+	/**
+	 * This method is used in cases where an event got updated, and we
+	 * potentially need to send emails to attendees to let them know of updates
+	 * in the events.
+	 *
+	 * We will detect which attendees got added, which got removed and create
+	 * specific messages for these situations.
+	 *
+	 * @return array
+	 */
+	protected function parseEventForOrganizer(VCalendar $calendar, array $eventInfo, array $oldEventInfo)
+	{
+		// Merging attendee lists.
+		$attendees = [];
+		foreach ($oldEventInfo['attendees'] as $attendee) {
+			$attendees[$attendee['href']] = [
+				'href' => $attendee['href'],
+				'oldInstances' => $attendee['instances'],
+				'newInstances' => [],
+				'name' => $attendee['name'],
+				'forceSend' => null,
+			];
+		}
+		foreach ($eventInfo['attendees'] as $attendee) {
+			if (isset($attendees[$attendee['href']])) {
+				$attendees[$attendee['href']]['name'] = $attendee['name'];
+				$attendees[$attendee['href']]['newInstances'] = $attendee['instances'];
+				$attendees[$attendee['href']]['forceSend'] = $attendee['forceSend'];
+			} else {
+				$attendees[$attendee['href']] = [
+					'href' => $attendee['href'],
+					'oldInstances' => [],
+					'newInstances' => $attendee['instances'],
+					'name' => $attendee['name'],
+					'forceSend' => $attendee['forceSend'],
+				];
+			}
+		}
+
+		$messages = [];
+
+		foreach ($attendees as $attendee) {
+			// An organizer can also be an attendee. We should not generate any
+			// messages for those.
+			if ($attendee['href'] === $eventInfo['organizer']) {
+				continue;
+			}
+
+			$message = new Message();
+			$message->uid = $eventInfo['uid'];
+			$message->component = 'VEVENT';
+			$message->sequence = $eventInfo['sequence'];
+			$message->sender = $eventInfo['organizer'];
+			$message->senderName = $eventInfo['organizerName'];
+			$message->recipient = $attendee['href'];
+			$message->recipientName = $attendee['name'];
+
+			// Creating the new iCalendar body.
+			$icalMsg = new VCalendar();
+
+			foreach ($calendar->select('VTIMEZONE') as $timezone) {
+				$icalMsg->add(clone $timezone);
+			}
+
+			if (!$attendee['newInstances']) {
+				// If there are no instances the attendee is a part of, it
+				// means the attendee was removed and we need to send him a
+				// CANCEL.
+				$message->method = 'CANCEL';
+
+				$icalMsg->METHOD = $message->method;
+
+				$event = $icalMsg->add('VEVENT', [
+					'UID' => $message->uid,
+					'SEQUENCE' => $message->sequence,
+					'DTSTAMP' => gmdate('Ymd\\THis\\Z'),
+				]);
+				if (isset($calendar->VEVENT->SUMMARY)) {
+					$event->add('SUMMARY', $calendar->VEVENT->SUMMARY->getValue());
+				}
+				$event->add(clone $calendar->VEVENT->DTSTART);
+				if (isset($calendar->VEVENT->DTEND)) {
+					$event->add(clone $calendar->VEVENT->DTEND);
+				} elseif (isset($calendar->VEVENT->DURATION)) {
+					$event->add(clone $calendar->VEVENT->DURATION);
+				}
+				$org = $event->add('ORGANIZER', $eventInfo['organizer']);
+				if ($eventInfo['organizerName']) {
+					$org['CN'] = $eventInfo['organizerName'];
+				}
+				$event->add('ATTENDEE', $attendee['href'], [
+					'CN' => $attendee['name'],
+				]);
+				$message->significantChange = true;
+			} else {
+				// The attendee gets the updated event body
+				$message->method = 'REQUEST';
+
+				$icalMsg->METHOD = $message->method;
+
+				// We need to find out that this change is significant. If it's
+				// not, systems may opt to not send messages.
+				//
+				// We do this based on the 'significantChangeHash' which is
+				// some value that changes if there's a certain set of
+				// properties changed in the event, or simply if there's a
+				// difference in instances that the attendee is invited to.
+
+				$oldAttendeeInstances = array_keys($attendee['oldInstances']);
+				$newAttendeeInstances = array_keys($attendee['newInstances']);
+
+				$message->significantChange =
+					'REQUEST' === $attendee['forceSend'] ||
+					count($oldAttendeeInstances) != count($newAttendeeInstances) ||
+					count(array_diff($oldAttendeeInstances, $newAttendeeInstances)) > 0 ||
+					$oldEventInfo['significantChangeHash'] !== $eventInfo['significantChangeHash'];
+
+				foreach ($attendee['newInstances'] as $instanceId => $instanceInfo) {
+					$currentEvent = clone $eventInfo['instances'][$instanceId];
+					if ('master' === $instanceId) {
+						// We need to find a list of events that the attendee
+						// is not a part of to add to the list of exceptions.
+						$exceptions = [];
+						foreach ($eventInfo['instances'] as $instanceId => $vevent) {
+							if (!isset($attendee['newInstances'][$instanceId])) {
+								$exceptions[] = $instanceId;
+							}
+						}
+
+						// If there were exceptions, we need to add it to an
+						// existing EXDATE property, if it exists.
+						if ($exceptions) {
+							if (isset($currentEvent->EXDATE)) {
+								$currentEvent->EXDATE->setParts(array_merge(
+									$currentEvent->EXDATE->getParts(),
+									$exceptions
+								));
+							} else {
+								$currentEvent->EXDATE = $exceptions;
+							}
+						}
+
+						// Cleaning up any scheduling information that
+						// shouldn't be sent along.
+						unset($currentEvent->ORGANIZER['SCHEDULE-FORCE-SEND']);
+						unset($currentEvent->ORGANIZER['SCHEDULE-STATUS']);
+
+						foreach ($currentEvent->ATTENDEE as $attendee) {
+							unset($attendee['SCHEDULE-FORCE-SEND']);
+							unset($attendee['SCHEDULE-STATUS']);
+
+							// We're adding PARTSTAT=NEEDS-ACTION to ensure that
+							// iOS shows an "Inbox Item"
+							if (!isset($attendee['PARTSTAT'])) {
+								$attendee['PARTSTAT'] = 'NEEDS-ACTION';
+							}
+						}
+					}
+
+					$currentEvent->DTSTAMP = gmdate('Ymd\\THis\\Z');
+					$icalMsg->add($currentEvent);
+				}
+			}
+
+			$message->message = $icalMsg;
+			$messages[] = $message;
+		}
+
+		return $messages;
+	}
+
+	/**
+	 * Parse an event update for an attendee.
+	 *
+	 * This function figures out if we need to send a reply to an organizer.
+	 *
+	 * @param string $attendee
+	 *
+	 * @return Message[]
+	 */
+	protected function parseEventForAttendee(VCalendar $calendar, array $eventInfo, array $oldEventInfo, $attendee)
+	{
+		if ($this->scheduleAgentServerRules && 'CLIENT' === $eventInfo['organizerScheduleAgent']) {
+			return [];
+		}
+
+		// Don't bother generating messages for events that have already been
+		// cancelled.
+		if ('CANCELLED' === $eventInfo['status']) {
+			return [];
+		}
+
+		$oldInstances = !empty($oldEventInfo['attendees'][$attendee]['instances']) ?
+			$oldEventInfo['attendees'][$attendee]['instances'] :
+			[];
+
+		$instances = [];
+		foreach ($oldInstances as $instance) {
+			$instances[$instance['id']] = [
+				'id' => $instance['id'],
+				'oldstatus' => $instance['partstat'],
+				'newstatus' => null,
+			];
+		}
+		foreach ($eventInfo['attendees'][$attendee]['instances'] as $instance) {
+			if (isset($instances[$instance['id']])) {
+				$instances[$instance['id']]['newstatus'] = $instance['partstat'];
+			} else {
+				$instances[$instance['id']] = [
+					'id' => $instance['id'],
+					'oldstatus' => null,
+					'newstatus' => $instance['partstat'],
+				];
+			}
+		}
+
+		// We need to also look for differences in EXDATE. If there are new
+		// items in EXDATE, it means that an attendee deleted instances of an
+		// event, which means we need to send DECLINED specifically for those
+		// instances.
+		// We only need to do that though, if the master event is not declined.
+		if (isset($instances['master']) && 'DECLINED' !== $instances['master']['newstatus']) {
+			foreach ($eventInfo['exdate'] as $exDate) {
+				if (!in_array($exDate, $oldEventInfo['exdate'])) {
+					if (isset($instances[$exDate])) {
+						$instances[$exDate]['newstatus'] = 'DECLINED';
+					} else {
+						$instances[$exDate] = [
+							'id' => $exDate,
+							'oldstatus' => null,
+							'newstatus' => 'DECLINED',
+						];
+					}
+				}
+			}
+		}
+
+		// Gathering a few extra properties for each instance.
+		foreach ($instances as $recurId => $instanceInfo) {
+			if (isset($eventInfo['instances'][$recurId])) {
+				$instances[$recurId]['dtstart'] = clone $eventInfo['instances'][$recurId]->DTSTART;
+			} else {
+				$instances[$recurId]['dtstart'] = $recurId;
+			}
+		}
+
+		$message = new Message();
+		$message->uid = $eventInfo['uid'];
+		$message->method = 'REPLY';
+		$message->component = 'VEVENT';
+		$message->sequence = $eventInfo['sequence'];
+		$message->sender = $attendee;
+		$message->senderName = $eventInfo['attendees'][$attendee]['name'];
+		$message->recipient = $eventInfo['organizer'];
+		$message->recipientName = $eventInfo['organizerName'];
+
+		$icalMsg = new VCalendar();
+		$icalMsg->METHOD = 'REPLY';
+
+		foreach ($calendar->select('VTIMEZONE') as $timezone) {
+			$icalMsg->add(clone $timezone);
+		}
+
+		$hasReply = false;
+
+		foreach ($instances as $instance) {
+			if ($instance['oldstatus'] == $instance['newstatus'] && 'REPLY' !== $eventInfo['organizerForceSend']) {
+				// Skip
+				continue;
+			}
+
+			$event = $icalMsg->add('VEVENT', [
+				'UID' => $message->uid,
+				'SEQUENCE' => $message->sequence,
+			]);
+			$summary = isset($calendar->VEVENT->SUMMARY) ? $calendar->VEVENT->SUMMARY->getValue() : '';
+			// Adding properties from the correct source instance
+			if (isset($eventInfo['instances'][$instance['id']])) {
+				$instanceObj = $eventInfo['instances'][$instance['id']];
+				$event->add(clone $instanceObj->DTSTART);
+				if (isset($instanceObj->DTEND)) {
+					$event->add(clone $instanceObj->DTEND);
+				} elseif (isset($instanceObj->DURATION)) {
+					$event->add(clone $instanceObj->DURATION);
+				}
+				if (isset($instanceObj->SUMMARY)) {
+					$event->add('SUMMARY', $instanceObj->SUMMARY->getValue());
+				} elseif ($summary) {
+					$event->add('SUMMARY', $summary);
+				}
+			} else {
+				// This branch of the code is reached, when a reply is
+				// generated for an instance of a recurring event, through the
+				// fact that the instance has disappeared by showing up in
+				// EXDATE
+				$dt = DateTimeParser::parse($instance['id'], $eventInfo['timezone']);
+				// Treat is as a DATE field
+				if (strlen($instance['id']) <= 8) {
+					$event->add('DTSTART', $dt, ['VALUE' => 'DATE']);
+				} else {
+					$event->add('DTSTART', $dt);
+				}
+				if ($summary) {
+					$event->add('SUMMARY', $summary);
+				}
+			}
+			if ('master' !== $instance['id']) {
+				$dt = DateTimeParser::parse($instance['id'], $eventInfo['timezone']);
+				// Treat is as a DATE field
+				if (strlen($instance['id']) <= 8) {
+					$event->add('RECURRENCE-ID', $dt, ['VALUE' => 'DATE']);
+				} else {
+					$event->add('RECURRENCE-ID', $dt);
+				}
+			}
+			$organizer = $event->add('ORGANIZER', $message->recipient);
+			if ($message->recipientName) {
+				$organizer['CN'] = $message->recipientName;
+			}
+			$attendee = $event->add('ATTENDEE', $message->sender, [
+				'PARTSTAT' => $instance['newstatus'],
+			]);
+			if ($message->senderName) {
+				$attendee['CN'] = $message->senderName;
+			}
+			$hasReply = true;
+		}
+
+		if ($hasReply) {
+			$message->message = $icalMsg;
+
+			return [$message];
+		} else {
+			return [];
+		}
+	}
+
+	/**
+	 * Returns attendee information and information about instances of an
+	 * event.
+	 *
+	 * Returns an array with the following keys:
+	 *
+	 * 1. uid
+	 * 2. organizer
+	 * 3. organizerName
+	 * 4. organizerScheduleAgent
+	 * 5. organizerForceSend
+	 * 6. instances
+	 * 7. attendees
+	 * 8. sequence
+	 * 9. exdate
+	 * 10. timezone - strictly the timezone on which the recurrence rule is
+	 *                based on.
+	 * 11. significantChangeHash
+	 * 12. status
+	 *
+	 * @param VCalendar $calendar
+	 *
+	 * @return array
+	 */
+	protected function parseEventInfo(VCalendar $calendar = null)
+	{
+		$uid = null;
+		$organizer = null;
+		$organizerName = null;
+		$organizerForceSend = null;
+		$sequence = null;
+		$timezone = null;
+		$status = null;
+		$organizerScheduleAgent = 'SERVER';
+
+		$significantChangeHash = '';
+
+		// Now we need to collect a list of attendees, and which instances they
+		// are a part of.
+		$attendees = [];
+
+		$instances = [];
+		$exdate = [];
+
+		$significantChangeEventProperties = [];
+
+		foreach ($calendar->VEVENT as $vevent) {
+			$eventSignificantChangeHash = '';
+			$rrule = [];
+
+			if (is_null($uid)) {
+				$uid = $vevent->UID->getValue();
+			} else {
+				if ($uid !== $vevent->UID->getValue()) {
+					throw new ITipException('If a calendar contained more than one event, they must have the same UID.');
+				}
+			}
+
+			if (!isset($vevent->DTSTART)) {
+				throw new ITipException('An event MUST have a DTSTART property.');
+			}
+
+			if (isset($vevent->ORGANIZER)) {
+				if (is_null($organizer)) {
+					$organizer = $vevent->ORGANIZER->getNormalizedValue();
+					$organizerName = isset($vevent->ORGANIZER['CN']) ? $vevent->ORGANIZER['CN'] : null;
+				} else {
+					if (strtoupper($organizer) !== strtoupper($vevent->ORGANIZER->getNormalizedValue())) {
+						throw new SameOrganizerForAllComponentsException('Every instance of the event must have the same organizer.');
+					}
+				}
+				$organizerForceSend =
+					isset($vevent->ORGANIZER['SCHEDULE-FORCE-SEND']) ?
+					strtoupper($vevent->ORGANIZER['SCHEDULE-FORCE-SEND']) :
+					null;
+				$organizerScheduleAgent =
+					isset($vevent->ORGANIZER['SCHEDULE-AGENT']) ?
+					strtoupper((string) $vevent->ORGANIZER['SCHEDULE-AGENT']) :
+					'SERVER';
+			}
+			if (is_null($sequence) && isset($vevent->SEQUENCE)) {
+				$sequence = $vevent->SEQUENCE->getValue();
+			}
+			if (isset($vevent->EXDATE)) {
+				foreach ($vevent->select('EXDATE') as $val) {
+					$exdate = array_merge($exdate, $val->getParts());
+				}
+				sort($exdate);
+			}
+			if (isset($vevent->RRULE)) {
+				foreach ($vevent->select('RRULE') as $rr) {
+					foreach ($rr->getParts() as $key => $val) {
+						// ignore default values (https://github.com/sabre-io/vobject/issues/126)
+						if ('INTERVAL' === $key && 1 == $val) {
+							continue;
+						}
+						if (is_array($val)) {
+							$val = implode(',', $val);
+						}
+						$rrule[] = "$key=$val";
+					}
+				}
+				sort($rrule);
+			}
+			if (isset($vevent->STATUS)) {
+				$status = strtoupper($vevent->STATUS->getValue());
+			}
+
+			$recurId = isset($vevent->{'RECURRENCE-ID'}) ? $vevent->{'RECURRENCE-ID'}->getValue() : 'master';
+			if (is_null($timezone)) {
+				if ('master' === $recurId) {
+					$timezone = $vevent->DTSTART->getDateTime()->getTimeZone();
+				} else {
+					$timezone = $vevent->{'RECURRENCE-ID'}->getDateTime()->getTimeZone();
+				}
+			}
+			if (isset($vevent->ATTENDEE)) {
+				foreach ($vevent->ATTENDEE as $attendee) {
+					if ($this->scheduleAgentServerRules &&
+						isset($attendee['SCHEDULE-AGENT']) &&
+						'CLIENT' === strtoupper($attendee['SCHEDULE-AGENT']->getValue())
+					) {
+						continue;
+					}
+					$partStat =
+						isset($attendee['PARTSTAT']) ?
+						strtoupper($attendee['PARTSTAT']) :
+						'NEEDS-ACTION';
+
+					$forceSend =
+						isset($attendee['SCHEDULE-FORCE-SEND']) ?
+						strtoupper($attendee['SCHEDULE-FORCE-SEND']) :
+						null;
+
+					if (isset($attendees[$attendee->getNormalizedValue()])) {
+						$attendees[$attendee->getNormalizedValue()]['instances'][$recurId] = [
+							'id' => $recurId,
+							'partstat' => $partStat,
+							'forceSend' => $forceSend,
+						];
+					} else {
+						$attendees[$attendee->getNormalizedValue()] = [
+							'href' => $attendee->getNormalizedValue(),
+							'instances' => [
+								$recurId => [
+									'id' => $recurId,
+									'partstat' => $partStat,
+								],
+							],
+							'name' => isset($attendee['CN']) ? (string) $attendee['CN'] : null,
+							'forceSend' => $forceSend,
+						];
+					}
+				}
+				$instances[$recurId] = $vevent;
+			}
+
+			foreach ($this->significantChangeProperties as $prop) {
+				if (isset($vevent->$prop)) {
+					$propertyValues = $vevent->select($prop);
+
+					$eventSignificantChangeHash .= $prop.':';
+
+					if ('EXDATE' === $prop) {
+						$eventSignificantChangeHash .= implode(',', $exdate).';';
+					} elseif ('RRULE' === $prop) {
+						$eventSignificantChangeHash .= implode(',', $rrule).';';
+					} else {
+						foreach ($propertyValues as $val) {
+							$eventSignificantChangeHash .= $val->getValue().';';
+						}
+					}
+				}
+			}
+			$significantChangeEventProperties[] = $eventSignificantChangeHash;
+		}
+
+		asort($significantChangeEventProperties);
+
+		foreach ($significantChangeEventProperties as $eventSignificantChangeHash) {
+			$significantChangeHash .= $eventSignificantChangeHash;
+		}
+		$significantChangeHash = md5($significantChangeHash);
+
+		return compact(
+			'uid',
+			'organizer',
+			'organizerName',
+			'organizerScheduleAgent',
+			'organizerForceSend',
+			'instances',
+			'attendees',
+			'sequence',
+			'exdate',
+			'timezone',
+			'significantChangeHash',
+			'status'
+		);
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/ITip/Message.php

Indentation +105 added lines, -105 removed lines

@@ -16,121 +16,121 @@
  */
 class Message
 {
-    /**
-     * The object's UID.
-     *
-     * @var string
-     */
-    public $uid;
+	/**
+	 * The object's UID.
+	 *
+	 * @var string
+	 */
+	public $uid;
 
-    /**
-     * The component type, such as VEVENT.
-     *
-     * @var string
-     */
-    public $component;
+	/**
+	 * The component type, such as VEVENT.
+	 *
+	 * @var string
+	 */
+	public $component;
 
-    /**
-     * Contains the ITip method, which is something like REQUEST, REPLY or
-     * CANCEL.
-     *
-     * @var string
-     */
-    public $method;
+	/**
+	 * Contains the ITip method, which is something like REQUEST, REPLY or
+	 * CANCEL.
+	 *
+	 * @var string
+	 */
+	public $method;
 
-    /**
-     * The current sequence number for the event.
-     *
-     * @var int
-     */
-    public $sequence;
+	/**
+	 * The current sequence number for the event.
+	 *
+	 * @var int
+	 */
+	public $sequence;
 
-    /**
-     * The senders' email address.
-     *
-     * Note that this does not imply that this has to be used in a From: field
-     * if the message is sent by email. It may also be populated in Reply-To:
-     * or not at all.
-     *
-     * @var string
-     */
-    public $sender;
+	/**
+	 * The senders' email address.
+	 *
+	 * Note that this does not imply that this has to be used in a From: field
+	 * if the message is sent by email. It may also be populated in Reply-To:
+	 * or not at all.
+	 *
+	 * @var string
+	 */
+	public $sender;
 
-    /**
-     * The name of the sender. This is often populated from a CN parameter from
-     * either the ORGANIZER or ATTENDEE, depending on the message.
-     *
-     * @var string|null
-     */
-    public $senderName;
+	/**
+	 * The name of the sender. This is often populated from a CN parameter from
+	 * either the ORGANIZER or ATTENDEE, depending on the message.
+	 *
+	 * @var string|null
+	 */
+	public $senderName;
 
-    /**
-     * The recipient's email address.
-     *
-     * @var string
-     */
-    public $recipient;
+	/**
+	 * The recipient's email address.
+	 *
+	 * @var string
+	 */
+	public $recipient;
 
-    /**
-     * The name of the recipient. This is usually populated with the CN
-     * parameter from the ATTENDEE or ORGANIZER property, if it's available.
-     *
-     * @var string|null
-     */
-    public $recipientName;
+	/**
+	 * The name of the recipient. This is usually populated with the CN
+	 * parameter from the ATTENDEE or ORGANIZER property, if it's available.
+	 *
+	 * @var string|null
+	 */
+	public $recipientName;
 
-    /**
-     * After the message has been delivered, this should contain a string such
-     * as : 1.1;Sent or 1.2;Delivered.
-     *
-     * In case of a failure, this will hold the error status code.
-     *
-     * See:
-     * http://tools.ietf.org/html/rfc6638#section-7.3
-     *
-     * @var string
-     */
-    public $scheduleStatus;
+	/**
+	 * After the message has been delivered, this should contain a string such
+	 * as : 1.1;Sent or 1.2;Delivered.
+	 *
+	 * In case of a failure, this will hold the error status code.
+	 *
+	 * See:
+	 * http://tools.ietf.org/html/rfc6638#section-7.3
+	 *
+	 * @var string
+	 */
+	public $scheduleStatus;
 
-    /**
-     * The iCalendar / iTip body.
-     *
-     * @var \Sabre\VObject\Component\VCalendar
-     */
-    public $message;
+	/**
+	 * The iCalendar / iTip body.
+	 *
+	 * @var \Sabre\VObject\Component\VCalendar
+	 */
+	public $message;
 
-    /**
-     * This will be set to true, if the iTip broker considers the change
-     * 'significant'.
-     *
-     * In practice, this means that we'll only mark it true, if for instance
-     * DTSTART changed. This allows systems to only send iTip messages when
-     * significant changes happened. This is especially useful for iMip, as
-     * normally a ton of messages may be generated for normal calendar use.
-     *
-     * To see the list of properties that are considered 'significant', check
-     * out Sabre\VObject\ITip\Broker::$significantChangeProperties.
-     *
-     * @var bool
-     */
-    public $significantChange = true;
+	/**
+	 * This will be set to true, if the iTip broker considers the change
+	 * 'significant'.
+	 *
+	 * In practice, this means that we'll only mark it true, if for instance
+	 * DTSTART changed. This allows systems to only send iTip messages when
+	 * significant changes happened. This is especially useful for iMip, as
+	 * normally a ton of messages may be generated for normal calendar use.
+	 *
+	 * To see the list of properties that are considered 'significant', check
+	 * out Sabre\VObject\ITip\Broker::$significantChangeProperties.
+	 *
+	 * @var bool
+	 */
+	public $significantChange = true;
 
-    /**
-     * Returns the schedule status as a string.
-     *
-     * For example:
-     * 1.2
-     *
-     * @return mixed bool|string
-     */
-    public function getScheduleStatus()
-    {
-        if (!$this->scheduleStatus) {
-            return false;
-        } else {
-            list($scheduleStatus) = explode(';', $this->scheduleStatus);
+	/**
+	 * Returns the schedule status as a string.
+	 *
+	 * For example:
+	 * 1.2
+	 *
+	 * @return mixed bool|string
+	 */
+	public function getScheduleStatus()
+	{
+		if (!$this->scheduleStatus) {
+			return false;
+		} else {
+			list($scheduleStatus) = explode(';', $this->scheduleStatus);
 
-            return $scheduleStatus;
-        }
-    }
+			return $scheduleStatus;
+		}
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Writer.php

Indentation +42 added lines, -42 removed lines

@@ -16,53 +16,53 @@
  */
 class Writer
 {
-    /**
-     * Serializes a vCard or iCalendar object.
-     *
-     * @return string
-     */
-    public static function write(Component $component)
-    {
-        return $component->serialize();
-    }
+	/**
+	 * Serializes a vCard or iCalendar object.
+	 *
+	 * @return string
+	 */
+	public static function write(Component $component)
+	{
+		return $component->serialize();
+	}
 
-    /**
-     * Serializes a jCal or jCard object.
-     *
-     * @param int $options
-     *
-     * @return string
-     */
-    public static function writeJson(Component $component, $options = 0)
-    {
-        return json_encode($component, $options);
-    }
+	/**
+	 * Serializes a jCal or jCard object.
+	 *
+	 * @param int $options
+	 *
+	 * @return string
+	 */
+	public static function writeJson(Component $component, $options = 0)
+	{
+		return json_encode($component, $options);
+	}
 
-    /**
-     * Serializes a xCal or xCard object.
-     *
-     * @return string
-     */
-    public static function writeXml(Component $component)
-    {
-        $writer = new Xml\Writer();
-        $writer->openMemory();
-        $writer->setIndent(true);
+	/**
+	 * Serializes a xCal or xCard object.
+	 *
+	 * @return string
+	 */
+	public static function writeXml(Component $component)
+	{
+		$writer = new Xml\Writer();
+		$writer->openMemory();
+		$writer->setIndent(true);
 
-        $writer->startDocument('1.0', 'utf-8');
+		$writer->startDocument('1.0', 'utf-8');
 
-        if ($component instanceof Component\VCalendar) {
-            $writer->startElement('icalendar');
-            $writer->writeAttribute('xmlns', Parser\XML::XCAL_NAMESPACE);
-        } else {
-            $writer->startElement('vcards');
-            $writer->writeAttribute('xmlns', Parser\XML::XCARD_NAMESPACE);
-        }
+		if ($component instanceof Component\VCalendar) {
+			$writer->startElement('icalendar');
+			$writer->writeAttribute('xmlns', Parser\XML::XCAL_NAMESPACE);
+		} else {
+			$writer->startElement('vcards');
+			$writer->writeAttribute('xmlns', Parser\XML::XCARD_NAMESPACE);
+		}
 
-        $component->xmlSerialize($writer);
+		$component->xmlSerialize($writer);
 
-        $writer->endElement();
+		$writer->endElement();
 
-        return $writer->outputMemory();
-    }
+		return $writer->outputMemory();
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/ElementList.php

Indentation +25 added lines, -25 removed lines

@@ -17,32 +17,32 @@
  */
 class ElementList extends ArrayIterator
 {
-    /* {{{ ArrayAccess Interface */
+	/* {{{ ArrayAccess Interface */
 
-    /**
-     * Sets an item through ArrayAccess.
-     *
-     * @param int   $offset
-     * @param mixed $value
-     */
-    #[\ReturnTypeWillChange]
-    public function offsetSet($offset, $value)
-    {
-        throw new LogicException('You can not add new objects to an ElementList');
-    }
+	/**
+	 * Sets an item through ArrayAccess.
+	 *
+	 * @param int   $offset
+	 * @param mixed $value
+	 */
+	#[\ReturnTypeWillChange]
+	public function offsetSet($offset, $value)
+	{
+		throw new LogicException('You can not add new objects to an ElementList');
+	}
 
-    /**
-     * Sets an item through ArrayAccess.
-     *
-     * This method just forwards the request to the inner iterator
-     *
-     * @param int $offset
-     */
-    #[\ReturnTypeWillChange]
-    public function offsetUnset($offset)
-    {
-        throw new LogicException('You can not remove objects from an ElementList');
-    }
+	/**
+	 * Sets an item through ArrayAccess.
+	 *
+	 * This method just forwards the request to the inner iterator
+	 *
+	 * @param int $offset
+	 */
+	#[\ReturnTypeWillChange]
+	public function offsetUnset($offset)
+	{
+		throw new LogicException('You can not remove objects from an ElementList');
+	}
 
-    /* }}} */
+	/* }}} */
 }

htdocs/includes/sabre/sabre/vobject/lib/Settings.php

Indentation +33 added lines, -33 removed lines

@@ -17,39 +17,39 @@
  */
 class Settings
 {
-    /**
-     * The minimum date we accept for various calculations with dates, such as
-     * recurrences.
-     *
-     * The choice of 1900 is pretty arbitrary, but it covers most common
-     * use-cases. In particular, it covers birthdates for virtually everyone
-     * alive on earth, which is less than 5 people at the time of writing.
-     */
-    public static $minDate = '1900-01-01';
+	/**
+	 * The minimum date we accept for various calculations with dates, such as
+	 * recurrences.
+	 *
+	 * The choice of 1900 is pretty arbitrary, but it covers most common
+	 * use-cases. In particular, it covers birthdates for virtually everyone
+	 * alive on earth, which is less than 5 people at the time of writing.
+	 */
+	public static $minDate = '1900-01-01';
 
-    /**
-     * The maximum date we accept for various calculations with dates, such as
-     * recurrences.
-     *
-     * The choice of 2100 is pretty arbitrary, but should cover most
-     * appointments made for many years to come.
-     */
-    public static $maxDate = '2100-01-01';
+	/**
+	 * The maximum date we accept for various calculations with dates, such as
+	 * recurrences.
+	 *
+	 * The choice of 2100 is pretty arbitrary, but should cover most
+	 * appointments made for many years to come.
+	 */
+	public static $maxDate = '2100-01-01';
 
-    /**
-     * The maximum number of recurrences that will be generated.
-     *
-     * This setting limits the maximum of recurring events that this library
-     * generates in its recurrence iterators.
-     *
-     * This is a security measure. Without this, it would be possible to craft
-     * specific events that recur many, many times, potentially DDOSing the
-     * server.
-     *
-     * The default (3500) allows creation of a daily event that goes on for 10
-     * years, which is hopefully long enough for most.
-     *
-     * Set this value to -1 to disable this control altogether.
-     */
-    public static $maxRecurrences = 3500;
+	/**
+	 * The maximum number of recurrences that will be generated.
+	 *
+	 * This setting limits the maximum of recurring events that this library
+	 * generates in its recurrence iterators.
+	 *
+	 * This is a security measure. Without this, it would be possible to craft
+	 * specific events that recur many, many times, potentially DDOSing the
+	 * server.
+	 *
+	 * The default (3500) allows creation of a daily event that goes on for 10
+	 * years, which is hopefully long enough for most.
+	 *
+	 * Set this value to -1 to disable this control altogether.
+	 */
+	public static $maxRecurrences = 3500;
 }

htdocs/includes/sabre/sabre/vobject/lib/Reader.php

Indentation +71 added lines, -71 removed lines

@@ -14,82 +14,82 @@
  */
 class Reader
 {
-    /**
-     * If this option is passed to the reader, it will be less strict about the
-     * validity of the lines.
-     */
-    const OPTION_FORGIVING = 1;
+	/**
+	 * If this option is passed to the reader, it will be less strict about the
+	 * validity of the lines.
+	 */
+	const OPTION_FORGIVING = 1;
 
-    /**
-     * If this option is turned on, any lines we cannot parse will be ignored
-     * by the reader.
-     */
-    const OPTION_IGNORE_INVALID_LINES = 2;
+	/**
+	 * If this option is turned on, any lines we cannot parse will be ignored
+	 * by the reader.
+	 */
+	const OPTION_IGNORE_INVALID_LINES = 2;
 
-    /**
-     * Parses a vCard or iCalendar object, and returns the top component.
-     *
-     * The options argument is a bitfield. Pass any of the OPTIONS constant to
-     * alter the parsers' behaviour.
-     *
-     * You can either supply a string, or a readable stream for input.
-     *
-     * @param string|resource $data
-     * @param int             $options
-     * @param string          $charset
-     *
-     * @return Document
-     */
-    public static function read($data, $options = 0, $charset = 'UTF-8')
-    {
-        $parser = new Parser\MimeDir();
-        $parser->setCharset($charset);
-        $result = $parser->parse($data, $options);
+	/**
+	 * Parses a vCard or iCalendar object, and returns the top component.
+	 *
+	 * The options argument is a bitfield. Pass any of the OPTIONS constant to
+	 * alter the parsers' behaviour.
+	 *
+	 * You can either supply a string, or a readable stream for input.
+	 *
+	 * @param string|resource $data
+	 * @param int             $options
+	 * @param string          $charset
+	 *
+	 * @return Document
+	 */
+	public static function read($data, $options = 0, $charset = 'UTF-8')
+	{
+		$parser = new Parser\MimeDir();
+		$parser->setCharset($charset);
+		$result = $parser->parse($data, $options);
 
-        return $result;
-    }
+		return $result;
+	}
 
-    /**
-     * Parses a jCard or jCal object, and returns the top component.
-     *
-     * The options argument is a bitfield. Pass any of the OPTIONS constant to
-     * alter the parsers' behaviour.
-     *
-     * You can either a string, a readable stream, or an array for its input.
-     * Specifying the array is useful if json_decode was already called on the
-     * input.
-     *
-     * @param string|resource|array $data
-     * @param int                   $options
-     *
-     * @return Document
-     */
-    public static function readJson($data, $options = 0)
-    {
-        $parser = new Parser\Json();
-        $result = $parser->parse($data, $options);
+	/**
+	 * Parses a jCard or jCal object, and returns the top component.
+	 *
+	 * The options argument is a bitfield. Pass any of the OPTIONS constant to
+	 * alter the parsers' behaviour.
+	 *
+	 * You can either a string, a readable stream, or an array for its input.
+	 * Specifying the array is useful if json_decode was already called on the
+	 * input.
+	 *
+	 * @param string|resource|array $data
+	 * @param int                   $options
+	 *
+	 * @return Document
+	 */
+	public static function readJson($data, $options = 0)
+	{
+		$parser = new Parser\Json();
+		$result = $parser->parse($data, $options);
 
-        return $result;
-    }
+		return $result;
+	}
 
-    /**
-     * Parses a xCard or xCal object, and returns the top component.
-     *
-     * The options argument is a bitfield. Pass any of the OPTIONS constant to
-     * alter the parsers' behaviour.
-     *
-     * You can either supply a string, or a readable stream for input.
-     *
-     * @param string|resource $data
-     * @param int             $options
-     *
-     * @return Document
-     */
-    public static function readXML($data, $options = 0)
-    {
-        $parser = new Parser\XML();
-        $result = $parser->parse($data, $options);
+	/**
+	 * Parses a xCard or xCal object, and returns the top component.
+	 *
+	 * The options argument is a bitfield. Pass any of the OPTIONS constant to
+	 * alter the parsers' behaviour.
+	 *
+	 * You can either supply a string, or a readable stream for input.
+	 *
+	 * @param string|resource $data
+	 * @param int             $options
+	 *
+	 * @return Document
+	 */
+	public static function readXML($data, $options = 0)
+	{
+		$parser = new Parser\XML();
+		$result = $parser->parse($data, $options);
 
-        return $result;
-    }
+		return $result;
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/StringUtil.php

Indentation +33 added lines, -33 removed lines

@@ -11,40 +11,40 @@
  */
 class StringUtil
 {
-    /**
-     * Returns true or false depending on if a string is valid UTF-8.
-     *
-     * @param string $str
-     *
-     * @return bool
-     */
-    public static function isUTF8($str)
-    {
-        // Control characters
-        if (preg_match('%[\x00-\x08\x0B-\x0C\x0E\x0F]%', $str)) {
-            return false;
-        }
+	/**
+	 * Returns true or false depending on if a string is valid UTF-8.
+	 *
+	 * @param string $str
+	 *
+	 * @return bool
+	 */
+	public static function isUTF8($str)
+	{
+		// Control characters
+		if (preg_match('%[\x00-\x08\x0B-\x0C\x0E\x0F]%', $str)) {
+			return false;
+		}
 
-        return (bool) preg_match('%%u', $str);
-    }
+		return (bool) preg_match('%%u', $str);
+	}
 
-    /**
-     * This method tries its best to convert the input string to UTF-8.
-     *
-     * Currently only ISO-5991-1 input and UTF-8 input is supported, but this
-     * may be expanded upon if we receive other examples.
-     *
-     * @param string $str
-     *
-     * @return string
-     */
-    public static function convertToUTF8($str)
-    {
-        if (!mb_check_encoding($str, 'UTF-8') && mb_check_encoding($str, 'ISO-8859-1')) {
-            $str = mb_convert_encoding($str, 'UTF-8', 'ISO-8859-1');
-        }
+	/**
+	 * This method tries its best to convert the input string to UTF-8.
+	 *
+	 * Currently only ISO-5991-1 input and UTF-8 input is supported, but this
+	 * may be expanded upon if we receive other examples.
+	 *
+	 * @param string $str
+	 *
+	 * @return string
+	 */
+	public static function convertToUTF8($str)
+	{
+		if (!mb_check_encoding($str, 'UTF-8') && mb_check_encoding($str, 'ISO-8859-1')) {
+			$str = mb_convert_encoding($str, 'UTF-8', 'ISO-8859-1');
+		}
 
-        // Removing any control characters
-        return preg_replace('%(?:[\x00-\x08\x0B-\x0C\x0E-\x1F\x7F])%', '', $str);
-    }
+		// Removing any control characters
+		return preg_replace('%(?:[\x00-\x08\x0B-\x0C\x0E-\x1F\x7F])%', '', $str);
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/BirthdayCalendarGenerator.php

Indentation +156 added lines, -156 removed lines

@@ -13,160 +13,160 @@
  */
 class BirthdayCalendarGenerator
 {
-    /**
-     * Input objects.
-     *
-     * @var array
-     */
-    protected $objects = [];
-
-    /**
-     * Default year.
-     * Used for dates without a year.
-     */
-    const DEFAULT_YEAR = 2000;
-
-    /**
-     * Output format for the SUMMARY.
-     *
-     * @var string
-     */
-    protected $format = '%1$s\'s Birthday';
-
-    /**
-     * Creates the generator.
-     *
-     * Check the setTimeRange and setObjects methods for details about the
-     * arguments.
-     *
-     * @param mixed $objects
-     */
-    public function __construct($objects = null)
-    {
-        if ($objects) {
-            $this->setObjects($objects);
-        }
-    }
-
-    /**
-     * Sets the input objects.
-     *
-     * You must either supply a vCard as a string or as a Component/VCard object.
-     * It's also possible to supply an array of strings or objects.
-     *
-     * @param mixed $objects
-     */
-    public function setObjects($objects)
-    {
-        if (!is_array($objects)) {
-            $objects = [$objects];
-        }
-
-        $this->objects = [];
-        foreach ($objects as $object) {
-            if (is_string($object)) {
-                $vObj = Reader::read($object);
-                if (!$vObj instanceof Component\VCard) {
-                    throw new \InvalidArgumentException('String could not be parsed as \\Sabre\\VObject\\Component\\VCard by setObjects');
-                }
-
-                $this->objects[] = $vObj;
-            } elseif ($object instanceof Component\VCard) {
-                $this->objects[] = $object;
-            } else {
-                throw new \InvalidArgumentException('You can only pass strings or \\Sabre\\VObject\\Component\\VCard arguments to setObjects');
-            }
-        }
-    }
-
-    /**
-     * Sets the output format for the SUMMARY.
-     *
-     * @param string $format
-     */
-    public function setFormat($format)
-    {
-        $this->format = $format;
-    }
-
-    /**
-     * Parses the input data and returns a VCALENDAR.
-     *
-     * @return Component/VCalendar
-     */
-    public function getResult()
-    {
-        $calendar = new VCalendar();
-
-        foreach ($this->objects as $object) {
-            // Skip if there is no BDAY property.
-            if (!$object->select('BDAY')) {
-                continue;
-            }
-
-            // We've seen clients (ez-vcard) putting "BDAY:" properties
-            // without a value into vCards. If we come across those, we'll
-            // skip them.
-            if (empty($object->BDAY->getValue())) {
-                continue;
-            }
-
-            // We're always converting to vCard 4.0 so we can rely on the
-            // VCardConverter handling the X-APPLE-OMIT-YEAR property for us.
-            $object = $object->convert(Document::VCARD40);
-
-            // Skip if the card has no FN property.
-            if (!isset($object->FN)) {
-                continue;
-            }
-
-            // Skip if the BDAY property is not of the right type.
-            if (!$object->BDAY instanceof Property\VCard\DateAndOrTime) {
-                continue;
-            }
-
-            // Skip if we can't parse the BDAY value.
-            try {
-                $dateParts = DateTimeParser::parseVCardDateTime($object->BDAY->getValue());
-            } catch (InvalidDataException $e) {
-                continue;
-            }
-
-            // Set a year if it's not set.
-            $unknownYear = false;
-
-            if (!$dateParts['year']) {
-                $object->BDAY = self::DEFAULT_YEAR.'-'.$dateParts['month'].'-'.$dateParts['date'];
-
-                $unknownYear = true;
-            }
-
-            // Create event.
-            $event = $calendar->add('VEVENT', [
-                'SUMMARY' => sprintf($this->format, $object->FN->getValue()),
-                'DTSTART' => new \DateTime($object->BDAY->getValue()),
-                'RRULE' => 'FREQ=YEARLY',
-                'TRANSP' => 'TRANSPARENT',
-            ]);
-
-            // add VALUE=date
-            $event->DTSTART['VALUE'] = 'DATE';
-
-            // Add X-SABRE-BDAY property.
-            if ($unknownYear) {
-                $event->add('X-SABRE-BDAY', 'BDAY', [
-                    'X-SABRE-VCARD-UID' => $object->UID->getValue(),
-                    'X-SABRE-VCARD-FN' => $object->FN->getValue(),
-                    'X-SABRE-OMIT-YEAR' => self::DEFAULT_YEAR,
-                ]);
-            } else {
-                $event->add('X-SABRE-BDAY', 'BDAY', [
-                    'X-SABRE-VCARD-UID' => $object->UID->getValue(),
-                    'X-SABRE-VCARD-FN' => $object->FN->getValue(),
-                ]);
-            }
-        }
-
-        return $calendar;
-    }
+	/**
+	 * Input objects.
+	 *
+	 * @var array
+	 */
+	protected $objects = [];
+
+	/**
+	 * Default year.
+	 * Used for dates without a year.
+	 */
+	const DEFAULT_YEAR = 2000;
+
+	/**
+	 * Output format for the SUMMARY.
+	 *
+	 * @var string
+	 */
+	protected $format = '%1$s\'s Birthday';
+
+	/**
+	 * Creates the generator.
+	 *
+	 * Check the setTimeRange and setObjects methods for details about the
+	 * arguments.
+	 *
+	 * @param mixed $objects
+	 */
+	public function __construct($objects = null)
+	{
+		if ($objects) {
+			$this->setObjects($objects);
+		}
+	}
+
+	/**
+	 * Sets the input objects.
+	 *
+	 * You must either supply a vCard as a string or as a Component/VCard object.
+	 * It's also possible to supply an array of strings or objects.
+	 *
+	 * @param mixed $objects
+	 */
+	public function setObjects($objects)
+	{
+		if (!is_array($objects)) {
+			$objects = [$objects];
+		}
+
+		$this->objects = [];
+		foreach ($objects as $object) {
+			if (is_string($object)) {
+				$vObj = Reader::read($object);
+				if (!$vObj instanceof Component\VCard) {
+					throw new \InvalidArgumentException('String could not be parsed as \\Sabre\\VObject\\Component\\VCard by setObjects');
+				}
+
+				$this->objects[] = $vObj;
+			} elseif ($object instanceof Component\VCard) {
+				$this->objects[] = $object;
+			} else {
+				throw new \InvalidArgumentException('You can only pass strings or \\Sabre\\VObject\\Component\\VCard arguments to setObjects');
+			}
+		}
+	}
+
+	/**
+	 * Sets the output format for the SUMMARY.
+	 *
+	 * @param string $format
+	 */
+	public function setFormat($format)
+	{
+		$this->format = $format;
+	}
+
+	/**
+	 * Parses the input data and returns a VCALENDAR.
+	 *
+	 * @return Component/VCalendar
+	 */
+	public function getResult()
+	{
+		$calendar = new VCalendar();
+
+		foreach ($this->objects as $object) {
+			// Skip if there is no BDAY property.
+			if (!$object->select('BDAY')) {
+				continue;
+			}
+
+			// We've seen clients (ez-vcard) putting "BDAY:" properties
+			// without a value into vCards. If we come across those, we'll
+			// skip them.
+			if (empty($object->BDAY->getValue())) {
+				continue;
+			}
+
+			// We're always converting to vCard 4.0 so we can rely on the
+			// VCardConverter handling the X-APPLE-OMIT-YEAR property for us.
+			$object = $object->convert(Document::VCARD40);
+
+			// Skip if the card has no FN property.
+			if (!isset($object->FN)) {
+				continue;
+			}
+
+			// Skip if the BDAY property is not of the right type.
+			if (!$object->BDAY instanceof Property\VCard\DateAndOrTime) {
+				continue;
+			}
+
+			// Skip if we can't parse the BDAY value.
+			try {
+				$dateParts = DateTimeParser::parseVCardDateTime($object->BDAY->getValue());
+			} catch (InvalidDataException $e) {
+				continue;
+			}
+
+			// Set a year if it's not set.
+			$unknownYear = false;
+
+			if (!$dateParts['year']) {
+				$object->BDAY = self::DEFAULT_YEAR.'-'.$dateParts['month'].'-'.$dateParts['date'];
+
+				$unknownYear = true;
+			}
+
+			// Create event.
+			$event = $calendar->add('VEVENT', [
+				'SUMMARY' => sprintf($this->format, $object->FN->getValue()),
+				'DTSTART' => new \DateTime($object->BDAY->getValue()),
+				'RRULE' => 'FREQ=YEARLY',
+				'TRANSP' => 'TRANSPARENT',
+			]);
+
+			// add VALUE=date
+			$event->DTSTART['VALUE'] = 'DATE';
+
+			// Add X-SABRE-BDAY property.
+			if ($unknownYear) {
+				$event->add('X-SABRE-BDAY', 'BDAY', [
+					'X-SABRE-VCARD-UID' => $object->UID->getValue(),
+					'X-SABRE-VCARD-FN' => $object->FN->getValue(),
+					'X-SABRE-OMIT-YEAR' => self::DEFAULT_YEAR,
+				]);
+			} else {
+				$event->add('X-SABRE-BDAY', 'BDAY', [
+					'X-SABRE-VCARD-UID' => $object->UID->getValue(),
+					'X-SABRE-VCARD-FN' => $object->FN->getValue(),
+				]);
+			}
+		}
+
+		return $calendar;
+	}
 }

htdocs/includes/sabre/sabre/vobject/lib/Recur/EventIterator.php

Indentation +434 added lines, -434 removed lines

@@ -60,438 +60,438 @@
  */
 class EventIterator implements \Iterator
 {
-    /**
-     * Reference timeZone for floating dates and times.
-     *
-     * @var DateTimeZone
-     */
-    protected $timeZone;
-
-    /**
-     * True if we're iterating an all-day event.
-     *
-     * @var bool
-     */
-    protected $allDay = false;
-
-    /**
-     * Creates the iterator.
-     *
-     * There's three ways to set up the iterator.
-     *
-     * 1. You can pass a VCALENDAR component and a UID.
-     * 2. You can pass an array of VEVENTs (all UIDS should match).
-     * 3. You can pass a single VEVENT component.
-     *
-     * Only the second method is recommended. The other 1 and 3 will be removed
-     * at some point in the future.
-     *
-     * The $uid parameter is only required for the first method.
-     *
-     * @param Component|array $input
-     * @param string|null     $uid
-     * @param DateTimeZone    $timeZone reference timezone for floating dates and
-     *                                  times
-     */
-    public function __construct($input, $uid = null, DateTimeZone $timeZone = null)
-    {
-        if (is_null($timeZone)) {
-            $timeZone = new DateTimeZone('UTC');
-        }
-        $this->timeZone = $timeZone;
-
-        if (is_array($input)) {
-            $events = $input;
-        } elseif ($input instanceof VEvent) {
-            // Single instance mode.
-            $events = [$input];
-        } else {
-            // Calendar + UID mode.
-            $uid = (string) $uid;
-            if (!$uid) {
-                throw new InvalidArgumentException('The UID argument is required when a VCALENDAR is passed to this constructor');
-            }
-            if (!isset($input->VEVENT)) {
-                throw new InvalidArgumentException('No events found in this calendar');
-            }
-            $events = $input->getByUID($uid);
-        }
-
-        foreach ($events as $vevent) {
-            if (!isset($vevent->{'RECURRENCE-ID'})) {
-                $this->masterEvent = $vevent;
-            } else {
-                $this->exceptions[
-                    $vevent->{'RECURRENCE-ID'}->getDateTime($this->timeZone)->getTimeStamp()
-                ] = true;
-                $this->overriddenEvents[] = $vevent;
-            }
-        }
-
-        if (!$this->masterEvent) {
-            // No base event was found. CalDAV does allow cases where only
-            // overridden instances are stored.
-            //
-            // In this particular case, we're just going to grab the first
-            // event and use that instead. This may not always give the
-            // desired result.
-            if (!count($this->overriddenEvents)) {
-                throw new InvalidArgumentException('This VCALENDAR did not have an event with UID: '.$uid);
-            }
-            $this->masterEvent = array_shift($this->overriddenEvents);
-        }
-
-        $this->startDate = $this->masterEvent->DTSTART->getDateTime($this->timeZone);
-        $this->allDay = !$this->masterEvent->DTSTART->hasTime();
-
-        if (isset($this->masterEvent->EXDATE)) {
-            foreach ($this->masterEvent->EXDATE as $exDate) {
-                foreach ($exDate->getDateTimes($this->timeZone) as $dt) {
-                    $this->exceptions[$dt->getTimeStamp()] = true;
-                }
-            }
-        }
-
-        if (isset($this->masterEvent->DTEND)) {
-            $this->eventDuration =
-                $this->masterEvent->DTEND->getDateTime($this->timeZone)->getTimeStamp() -
-                $this->startDate->getTimeStamp();
-        } elseif (isset($this->masterEvent->DURATION)) {
-            $duration = $this->masterEvent->DURATION->getDateInterval();
-            $end = clone $this->startDate;
-            $end = $end->add($duration);
-            $this->eventDuration = $end->getTimeStamp() - $this->startDate->getTimeStamp();
-        } elseif ($this->allDay) {
-            $this->eventDuration = 3600 * 24;
-        } else {
-            $this->eventDuration = 0;
-        }
-
-        if (isset($this->masterEvent->RDATE)) {
-            $this->recurIterator = new RDateIterator(
-                $this->masterEvent->RDATE->getParts(),
-                $this->startDate
-            );
-        } elseif (isset($this->masterEvent->RRULE)) {
-            $this->recurIterator = new RRuleIterator(
-                $this->masterEvent->RRULE->getParts(),
-                $this->startDate
-            );
-        } else {
-            $this->recurIterator = new RRuleIterator(
-                [
-                    'FREQ' => 'DAILY',
-                    'COUNT' => 1,
-                ],
-                $this->startDate
-            );
-        }
-
-        $this->rewind();
-        if (!$this->valid()) {
-            throw new NoInstancesException('This recurrence rule does not generate any valid instances');
-        }
-    }
-
-    /**
-     * Returns the date for the current position of the iterator.
-     *
-     * @return DateTimeImmutable
-     */
-    #[\ReturnTypeWillChange]
-    public function current()
-    {
-        if ($this->currentDate) {
-            return clone $this->currentDate;
-        }
-    }
-
-    /**
-     * This method returns the start date for the current iteration of the
-     * event.
-     *
-     * @return DateTimeImmutable
-     */
-    public function getDtStart()
-    {
-        if ($this->currentDate) {
-            return clone $this->currentDate;
-        }
-    }
-
-    /**
-     * This method returns the end date for the current iteration of the
-     * event.
-     *
-     * @return DateTimeImmutable
-     */
-    public function getDtEnd()
-    {
-        if (!$this->valid()) {
-            return;
-        }
-        if ($this->currentOverriddenEvent && $this->currentOverriddenEvent->DTEND) {
-            return $this->currentOverriddenEvent->DTEND->getDateTime($this->timeZone);
-        } else {
-            $end = clone $this->currentDate;
-
-            return $end->modify('+'.$this->eventDuration.' seconds');
-        }
-    }
-
-    /**
-     * Returns a VEVENT for the current iterations of the event.
-     *
-     * This VEVENT will have a recurrence id, and its DTSTART and DTEND
-     * altered.
-     *
-     * @return VEvent
-     */
-    public function getEventObject()
-    {
-        if ($this->currentOverriddenEvent) {
-            return $this->currentOverriddenEvent;
-        }
-
-        $event = clone $this->masterEvent;
-
-        // Ignoring the following block, because PHPUnit's code coverage
-        // ignores most of these lines, and this messes with our stats.
-        //
-        // @codeCoverageIgnoreStart
-        unset(
-            $event->RRULE,
-            $event->EXDATE,
-            $event->RDATE,
-            $event->EXRULE,
-            $event->{'RECURRENCE-ID'}
-        );
-        // @codeCoverageIgnoreEnd
-
-        $event->DTSTART->setDateTime($this->getDtStart(), $event->DTSTART->isFloating());
-        if (isset($event->DTEND)) {
-            $event->DTEND->setDateTime($this->getDtEnd(), $event->DTEND->isFloating());
-        }
-        $recurid = clone $event->DTSTART;
-        $recurid->name = 'RECURRENCE-ID';
-        $event->add($recurid);
-
-        return $event;
-    }
-
-    /**
-     * Returns the current position of the iterator.
-     *
-     * This is for us simply a 0-based index.
-     *
-     * @return int
-     */
-    #[\ReturnTypeWillChange]
-    public function key()
-    {
-        // The counter is always 1 ahead.
-        return $this->counter - 1;
-    }
-
-    /**
-     * This is called after next, to see if the iterator is still at a valid
-     * position, or if it's at the end.
-     *
-     * @return bool
-     */
-    #[\ReturnTypeWillChange]
-    public function valid()
-    {
-        if ($this->counter > Settings::$maxRecurrences && -1 !== Settings::$maxRecurrences) {
-            throw new MaxInstancesExceededException('Recurring events are only allowed to generate '.Settings::$maxRecurrences);
-        }
-
-        return (bool) $this->currentDate;
-    }
-
-    /**
-     * Sets the iterator back to the starting point.
-     *
-     * @return void
-     */
-    #[\ReturnTypeWillChange]
-    public function rewind()
-    {
-        $this->recurIterator->rewind();
-        // re-creating overridden event index.
-        $index = [];
-        foreach ($this->overriddenEvents as $key => $event) {
-            $stamp = $event->DTSTART->getDateTime($this->timeZone)->getTimeStamp();
-            $index[$stamp][] = $key;
-        }
-        krsort($index);
-        $this->counter = 0;
-        $this->overriddenEventsIndex = $index;
-        $this->currentOverriddenEvent = null;
-
-        $this->nextDate = null;
-        $this->currentDate = clone $this->startDate;
-
-        $this->next();
-    }
-
-    /**
-     * Advances the iterator with one step.
-     *
-     * @return void
-     */
-    #[\ReturnTypeWillChange]
-    public function next()
-    {
-        $this->currentOverriddenEvent = null;
-        ++$this->counter;
-        if ($this->nextDate) {
-            // We had a stored value.
-            $nextDate = $this->nextDate;
-            $this->nextDate = null;
-        } else {
-            // We need to ask rruleparser for the next date.
-            // We need to do this until we find a date that's not in the
-            // exception list.
-            do {
-                if (!$this->recurIterator->valid()) {
-                    $nextDate = null;
-                    break;
-                }
-                $nextDate = $this->recurIterator->current();
-                $this->recurIterator->next();
-            } while (isset($this->exceptions[$nextDate->getTimeStamp()]));
-        }
-
-        // $nextDate now contains what rrule thinks is the next one, but an
-        // overridden event may cut ahead.
-        if ($this->overriddenEventsIndex) {
-            $offsets = end($this->overriddenEventsIndex);
-            $timestamp = key($this->overriddenEventsIndex);
-            $offset = end($offsets);
-            if (!$nextDate || $timestamp < $nextDate->getTimeStamp()) {
-                // Overridden event comes first.
-                $this->currentOverriddenEvent = $this->overriddenEvents[$offset];
-
-                // Putting the rrule next date aside.
-                $this->nextDate = $nextDate;
-                $this->currentDate = $this->currentOverriddenEvent->DTSTART->getDateTime($this->timeZone);
-
-                // Ensuring that this item will only be used once.
-                array_pop($this->overriddenEventsIndex[$timestamp]);
-                if (!$this->overriddenEventsIndex[$timestamp]) {
-                    array_pop($this->overriddenEventsIndex);
-                }
-
-                // Exit point!
-                return;
-            }
-        }
-
-        $this->currentDate = $nextDate;
-    }
-
-    /**
-     * Quickly jump to a date in the future.
-     */
-    public function fastForward(DateTimeInterface $dateTime)
-    {
-        while ($this->valid() && $this->getDtEnd() <= $dateTime) {
-            $this->next();
-        }
-    }
-
-    /**
-     * Returns true if this recurring event never ends.
-     *
-     * @return bool
-     */
-    public function isInfinite()
-    {
-        return $this->recurIterator->isInfinite();
-    }
-
-    /**
-     * RRULE parser.
-     *
-     * @var RRuleIterator
-     */
-    protected $recurIterator;
-
-    /**
-     * The duration, in seconds, of the master event.
-     *
-     * We use this to calculate the DTEND for subsequent events.
-     */
-    protected $eventDuration;
-
-    /**
-     * A reference to the main (master) event.
-     *
-     * @var VEVENT
-     */
-    protected $masterEvent;
-
-    /**
-     * List of overridden events.
-     *
-     * @var array
-     */
-    protected $overriddenEvents = [];
-
-    /**
-     * Overridden event index.
-     *
-     * Key is timestamp, value is the list of indexes of the item in the $overriddenEvent
-     * property.
-     *
-     * @var array
-     */
-    protected $overriddenEventsIndex;
-
-    /**
-     * A list of recurrence-id's that are either part of EXDATE, or are
-     * overridden.
-     *
-     * @var array
-     */
-    protected $exceptions = [];
-
-    /**
-     * Internal event counter.
-     *
-     * @var int
-     */
-    protected $counter;
-
-    /**
-     * The very start of the iteration process.
-     *
-     * @var DateTimeImmutable
-     */
-    protected $startDate;
-
-    /**
-     * Where we are currently in the iteration process.
-     *
-     * @var DateTimeImmutable
-     */
-    protected $currentDate;
-
-    /**
-     * The next date from the rrule parser.
-     *
-     * Sometimes we need to temporary store the next date, because an
-     * overridden event came before.
-     *
-     * @var DateTimeImmutable
-     */
-    protected $nextDate;
-
-    /**
-     * The event that overwrites the current iteration.
-     *
-     * @var VEVENT
-     */
-    protected $currentOverriddenEvent;
+	/**
+	 * Reference timeZone for floating dates and times.
+	 *
+	 * @var DateTimeZone
+	 */
+	protected $timeZone;
+
+	/**
+	 * True if we're iterating an all-day event.
+	 *
+	 * @var bool
+	 */
+	protected $allDay = false;
+
+	/**
+	 * Creates the iterator.
+	 *
+	 * There's three ways to set up the iterator.
+	 *
+	 * 1. You can pass a VCALENDAR component and a UID.
+	 * 2. You can pass an array of VEVENTs (all UIDS should match).
+	 * 3. You can pass a single VEVENT component.
+	 *
+	 * Only the second method is recommended. The other 1 and 3 will be removed
+	 * at some point in the future.
+	 *
+	 * The $uid parameter is only required for the first method.
+	 *
+	 * @param Component|array $input
+	 * @param string|null     $uid
+	 * @param DateTimeZone    $timeZone reference timezone for floating dates and
+	 *                                  times
+	 */
+	public function __construct($input, $uid = null, DateTimeZone $timeZone = null)
+	{
+		if (is_null($timeZone)) {
+			$timeZone = new DateTimeZone('UTC');
+		}
+		$this->timeZone = $timeZone;
+
+		if (is_array($input)) {
+			$events = $input;
+		} elseif ($input instanceof VEvent) {
+			// Single instance mode.
+			$events = [$input];
+		} else {
+			// Calendar + UID mode.
+			$uid = (string) $uid;
+			if (!$uid) {
+				throw new InvalidArgumentException('The UID argument is required when a VCALENDAR is passed to this constructor');
+			}
+			if (!isset($input->VEVENT)) {
+				throw new InvalidArgumentException('No events found in this calendar');
+			}
+			$events = $input->getByUID($uid);
+		}
+
+		foreach ($events as $vevent) {
+			if (!isset($vevent->{'RECURRENCE-ID'})) {
+				$this->masterEvent = $vevent;
+			} else {
+				$this->exceptions[
+					$vevent->{'RECURRENCE-ID'}->getDateTime($this->timeZone)->getTimeStamp()
+				] = true;
+				$this->overriddenEvents[] = $vevent;
+			}
+		}
+
+		if (!$this->masterEvent) {
+			// No base event was found. CalDAV does allow cases where only
+			// overridden instances are stored.
+			//
+			// In this particular case, we're just going to grab the first
+			// event and use that instead. This may not always give the
+			// desired result.
+			if (!count($this->overriddenEvents)) {
+				throw new InvalidArgumentException('This VCALENDAR did not have an event with UID: '.$uid);
+			}
+			$this->masterEvent = array_shift($this->overriddenEvents);
+		}
+
+		$this->startDate = $this->masterEvent->DTSTART->getDateTime($this->timeZone);
+		$this->allDay = !$this->masterEvent->DTSTART->hasTime();
+
+		if (isset($this->masterEvent->EXDATE)) {
+			foreach ($this->masterEvent->EXDATE as $exDate) {
+				foreach ($exDate->getDateTimes($this->timeZone) as $dt) {
+					$this->exceptions[$dt->getTimeStamp()] = true;
+				}
+			}
+		}
+
+		if (isset($this->masterEvent->DTEND)) {
+			$this->eventDuration =
+				$this->masterEvent->DTEND->getDateTime($this->timeZone)->getTimeStamp() -
+				$this->startDate->getTimeStamp();
+		} elseif (isset($this->masterEvent->DURATION)) {
+			$duration = $this->masterEvent->DURATION->getDateInterval();
+			$end = clone $this->startDate;
+			$end = $end->add($duration);
+			$this->eventDuration = $end->getTimeStamp() - $this->startDate->getTimeStamp();
+		} elseif ($this->allDay) {
+			$this->eventDuration = 3600 * 24;
+		} else {
+			$this->eventDuration = 0;
+		}
+
+		if (isset($this->masterEvent->RDATE)) {
+			$this->recurIterator = new RDateIterator(
+				$this->masterEvent->RDATE->getParts(),
+				$this->startDate
+			);
+		} elseif (isset($this->masterEvent->RRULE)) {
+			$this->recurIterator = new RRuleIterator(
+				$this->masterEvent->RRULE->getParts(),
+				$this->startDate
+			);
+		} else {
+			$this->recurIterator = new RRuleIterator(
+				[
+					'FREQ' => 'DAILY',
+					'COUNT' => 1,
+				],
+				$this->startDate
+			);
+		}
+
+		$this->rewind();
+		if (!$this->valid()) {
+			throw new NoInstancesException('This recurrence rule does not generate any valid instances');
+		}
+	}
+
+	/**
+	 * Returns the date for the current position of the iterator.
+	 *
+	 * @return DateTimeImmutable
+	 */
+	#[\ReturnTypeWillChange]
+	public function current()
+	{
+		if ($this->currentDate) {
+			return clone $this->currentDate;
+		}
+	}
+
+	/**
+	 * This method returns the start date for the current iteration of the
+	 * event.
+	 *
+	 * @return DateTimeImmutable
+	 */
+	public function getDtStart()
+	{
+		if ($this->currentDate) {
+			return clone $this->currentDate;
+		}
+	}
+
+	/**
+	 * This method returns the end date for the current iteration of the
+	 * event.
+	 *
+	 * @return DateTimeImmutable
+	 */
+	public function getDtEnd()
+	{
+		if (!$this->valid()) {
+			return;
+		}
+		if ($this->currentOverriddenEvent && $this->currentOverriddenEvent->DTEND) {
+			return $this->currentOverriddenEvent->DTEND->getDateTime($this->timeZone);
+		} else {
+			$end = clone $this->currentDate;
+
+			return $end->modify('+'.$this->eventDuration.' seconds');
+		}
+	}
+
+	/**
+	 * Returns a VEVENT for the current iterations of the event.
+	 *
+	 * This VEVENT will have a recurrence id, and its DTSTART and DTEND
+	 * altered.
+	 *
+	 * @return VEvent
+	 */
+	public function getEventObject()
+	{
+		if ($this->currentOverriddenEvent) {
+			return $this->currentOverriddenEvent;
+		}
+
+		$event = clone $this->masterEvent;
+
+		// Ignoring the following block, because PHPUnit's code coverage
+		// ignores most of these lines, and this messes with our stats.
+		//
+		// @codeCoverageIgnoreStart
+		unset(
+			$event->RRULE,
+			$event->EXDATE,
+			$event->RDATE,
+			$event->EXRULE,
+			$event->{'RECURRENCE-ID'}
+		);
+		// @codeCoverageIgnoreEnd
+
+		$event->DTSTART->setDateTime($this->getDtStart(), $event->DTSTART->isFloating());
+		if (isset($event->DTEND)) {
+			$event->DTEND->setDateTime($this->getDtEnd(), $event->DTEND->isFloating());
+		}
+		$recurid = clone $event->DTSTART;
+		$recurid->name = 'RECURRENCE-ID';
+		$event->add($recurid);
+
+		return $event;
+	}
+
+	/**
+	 * Returns the current position of the iterator.
+	 *
+	 * This is for us simply a 0-based index.
+	 *
+	 * @return int
+	 */
+	#[\ReturnTypeWillChange]
+	public function key()
+	{
+		// The counter is always 1 ahead.
+		return $this->counter - 1;
+	}
+
+	/**
+	 * This is called after next, to see if the iterator is still at a valid
+	 * position, or if it's at the end.
+	 *
+	 * @return bool
+	 */
+	#[\ReturnTypeWillChange]
+	public function valid()
+	{
+		if ($this->counter > Settings::$maxRecurrences && -1 !== Settings::$maxRecurrences) {
+			throw new MaxInstancesExceededException('Recurring events are only allowed to generate '.Settings::$maxRecurrences);
+		}
+
+		return (bool) $this->currentDate;
+	}
+
+	/**
+	 * Sets the iterator back to the starting point.
+	 *
+	 * @return void
+	 */
+	#[\ReturnTypeWillChange]
+	public function rewind()
+	{
+		$this->recurIterator->rewind();
+		// re-creating overridden event index.
+		$index = [];
+		foreach ($this->overriddenEvents as $key => $event) {
+			$stamp = $event->DTSTART->getDateTime($this->timeZone)->getTimeStamp();
+			$index[$stamp][] = $key;
+		}
+		krsort($index);
+		$this->counter = 0;
+		$this->overriddenEventsIndex = $index;
+		$this->currentOverriddenEvent = null;
+
+		$this->nextDate = null;
+		$this->currentDate = clone $this->startDate;
+
+		$this->next();
+	}
+
+	/**
+	 * Advances the iterator with one step.
+	 *
+	 * @return void
+	 */
+	#[\ReturnTypeWillChange]
+	public function next()
+	{
+		$this->currentOverriddenEvent = null;
+		++$this->counter;
+		if ($this->nextDate) {
+			// We had a stored value.
+			$nextDate = $this->nextDate;
+			$this->nextDate = null;
+		} else {
+			// We need to ask rruleparser for the next date.
+			// We need to do this until we find a date that's not in the
+			// exception list.
+			do {
+				if (!$this->recurIterator->valid()) {
+					$nextDate = null;
+					break;
+				}
+				$nextDate = $this->recurIterator->current();
+				$this->recurIterator->next();
+			} while (isset($this->exceptions[$nextDate->getTimeStamp()]));
+		}
+
+		// $nextDate now contains what rrule thinks is the next one, but an
+		// overridden event may cut ahead.
+		if ($this->overriddenEventsIndex) {
+			$offsets = end($this->overriddenEventsIndex);
+			$timestamp = key($this->overriddenEventsIndex);
+			$offset = end($offsets);
+			if (!$nextDate || $timestamp < $nextDate->getTimeStamp()) {
+				// Overridden event comes first.
+				$this->currentOverriddenEvent = $this->overriddenEvents[$offset];
+
+				// Putting the rrule next date aside.
+				$this->nextDate = $nextDate;
+				$this->currentDate = $this->currentOverriddenEvent->DTSTART->getDateTime($this->timeZone);
+
+				// Ensuring that this item will only be used once.
+				array_pop($this->overriddenEventsIndex[$timestamp]);
+				if (!$this->overriddenEventsIndex[$timestamp]) {
+					array_pop($this->overriddenEventsIndex);
+				}
+
+				// Exit point!
+				return;
+			}
+		}
+
+		$this->currentDate = $nextDate;
+	}
+
+	/**
+	 * Quickly jump to a date in the future.
+	 */
+	public function fastForward(DateTimeInterface $dateTime)
+	{
+		while ($this->valid() && $this->getDtEnd() <= $dateTime) {
+			$this->next();
+		}
+	}
+
+	/**
+	 * Returns true if this recurring event never ends.
+	 *
+	 * @return bool
+	 */
+	public function isInfinite()
+	{
+		return $this->recurIterator->isInfinite();
+	}
+
+	/**
+	 * RRULE parser.
+	 *
+	 * @var RRuleIterator
+	 */
+	protected $recurIterator;
+
+	/**
+	 * The duration, in seconds, of the master event.
+	 *
+	 * We use this to calculate the DTEND for subsequent events.
+	 */
+	protected $eventDuration;
+
+	/**
+	 * A reference to the main (master) event.
+	 *
+	 * @var VEVENT
+	 */
+	protected $masterEvent;
+
+	/**
+	 * List of overridden events.
+	 *
+	 * @var array
+	 */
+	protected $overriddenEvents = [];
+
+	/**
+	 * Overridden event index.
+	 *
+	 * Key is timestamp, value is the list of indexes of the item in the $overriddenEvent
+	 * property.
+	 *
+	 * @var array
+	 */
+	protected $overriddenEventsIndex;
+
+	/**
+	 * A list of recurrence-id's that are either part of EXDATE, or are
+	 * overridden.
+	 *
+	 * @var array
+	 */
+	protected $exceptions = [];
+
+	/**
+	 * Internal event counter.
+	 *
+	 * @var int
+	 */
+	protected $counter;
+
+	/**
+	 * The very start of the iteration process.
+	 *
+	 * @var DateTimeImmutable
+	 */
+	protected $startDate;
+
+	/**
+	 * Where we are currently in the iteration process.
+	 *
+	 * @var DateTimeImmutable
+	 */
+	protected $currentDate;
+
+	/**
+	 * The next date from the rrule parser.
+	 *
+	 * Sometimes we need to temporary store the next date, because an
+	 * overridden event came before.
+	 *
+	 * @var DateTimeImmutable
+	 */
+	protected $nextDate;
+
+	/**
+	 * The event that overwrites the current iteration.
+	 *
+	 * @var VEVENT
+	 */
+	protected $currentOverriddenEvent;
 }