*/ public function parse(string $ics): array { return array_values(array_filter(array_column($this->parseDocument($ics)['events'], 'period'))); } /** @return array{events: list, calendar: array} */ public function parseDocument(string $ics): array { if (str_starts_with($ics, "\xEF\xBB\xBF")) { $ics = substr($ics, 3); } $ics = preg_replace("/\r?\n[ \t]/", '', $ics); if (! mb_check_encoding($ics, 'UTF-8') || str_contains($ics, "\0")) { throw new ChannelSyncException('Kalender enthält ungültige Zeichen.'); } $lines = explode("\n", str_replace("\r\n", "\n", $ics)); $stack = []; $calendar = []; $event = []; $periods = []; $properties = []; $eventLines = []; $identities = []; $propertyIdentities = []; $started = false; $closed = false; foreach ($lines as $line) { $line = rtrim($line, "\r"); if (in_array('VEVENT', $stack, true)) { $eventLines[] = $line; } if ($line === '' && $stack === []) { continue; } if ($closed || ! preg_match('/^((?:[^:"]|"[^"]*")*):(.*)$/D', $line, $match)) { throw new ChannelSyncException('Kalender ist unvollständig oder enthält ungültige Inhaltszeilen.'); } $parts = preg_split('/;(?=(?:[^"]*"[^"]*")*[^"]*$)/', $match[1]); $name = strtoupper(array_shift($parts)); $value = $match[2]; if (! preg_match('/^[A-Z0-9-]+$/D', $name)) { throw new ChannelSyncException('Ungültige Kalendereigenschaft.'); } if ($name === 'BEGIN') { $component = strtoupper($value); if ($stack === []) { if ($started || $component !== 'VCALENDAR') { throw new ChannelSyncException('Die Antwort ist kein vollständiger iCal-Kalender.'); } $started = true; } elseif ($component === 'VCALENDAR' || ($component === 'VEVENT' && $stack !== ['VCALENDAR'])) { throw new ChannelSyncException('Ungültig verschachtelte Kalenderkomponente.'); } if ($stack === ['VCALENDAR'] && ! in_array($component, ['VEVENT', 'VTIMEZONE'], true)) { throw new ChannelSyncException('Nicht unterstützte Kalenderkomponente im Belegungsfeed.'); } if ($component === 'VEVENT') { $event = []; $properties = []; $eventLines = [$line]; } $stack[] = $component; continue; } if ($name === 'END') { if ($stack === [] || end($stack) !== strtoupper($value)) { throw new ChannelSyncException('Kalenderkomponente ist nicht vollständig geschlossen.'); } if (end($stack) === 'VEVENT') { $uid = trim($event['UID']['value'] ?? ''); if ($uid === '') { throw new ChannelSyncException('Ein Kalenderereignis hat keine eindeutige UID.'); } $period = $this->toPeriod($event); $identity = $period ? $period->startsOn->toDateString().'|'.$period->endsOn->toDateString() : 'not-occupying'; if (isset($identities[$uid]) && $identities[$uid] !== $identity) { throw new ChannelSyncException('Eine UID enthält widersprüchliche Ereignisse; bitte den Portalkalender prüfen.'); } $normalized = $properties; ksort($normalized); if (isset($propertyIdentities[$uid]) && $propertyIdentities[$uid] !== $normalized) { throw new ChannelSyncException('Eine UID enthält widersprüchliche Originalangaben; bitte den Kalender prüfen.'); } $propertyIdentities[$uid] = $normalized; if (! isset($identities[$uid])) { $raw = implode("\r\n", $eventLines)."\r\n"; $enriched = $period === null ? null : new ExternalPeriod($period->uid, $period->startsOn, $period->endsOn, $period->summary, $properties, $raw); $periods[] = ['uid' => $uid, 'properties' => $properties, 'raw' => $raw, 'period' => $enriched]; } $identities[$uid] = $identity; } array_pop($stack); if ($stack === []) { $closed = true; } continue; } if ($stack === []) { throw new ChannelSyncException('Inhalt außerhalb des Kalenders.'); } $property = ['value' => $value, 'params' => $parts]; if ($stack === ['VCALENDAR']) { if (isset($calendar[$name]) && in_array($name, ['VERSION', 'PRODID', 'METHOD'], true)) { throw new ChannelSyncException('Doppelte Kalender-Kopfdaten.'); } $calendar[$name] = $property; } elseif ($stack === ['VCALENDAR', 'VEVENT']) { if (isset($event[$name]) && in_array($name, ['UID', 'DTSTART', 'DTEND', 'STATUS'], true)) { throw new ChannelSyncException('Doppelte Identitäts- oder Datumsangaben im Kalenderereignis.'); } $event[$name] = $property; } if (in_array('VEVENT', $stack, true)) { $prefix = count($stack) > 2 ? implode('.', array_slice($stack, 2)).'.' : ''; $properties[$prefix.$name][] = $property; } } if (! $closed || $stack !== [] || ($calendar['VERSION']['value'] ?? '') !== '2.0' || blank($calendar['PRODID']['value'] ?? null)) { throw new ChannelSyncException('Kalender ist unvollständig; VERSION, PRODID und geschlossene Komponenten sind erforderlich.'); } if (isset($calendar['METHOD']) && strtoupper($calendar['METHOD']['value']) !== 'PUBLISH') { throw new ChannelSyncException('Erwartet wird ein vollständiger Kalenderstand, keine einzelne Kalendernachricht.'); } return ['events' => $periods, 'calendar' => $calendar]; } public static function text(string $value): string { return preg_replace_callback('/\\\\([nN,;\\\\])/', fn (array $match): string => in_array($match[1], ['n', 'N'], true) ? "\n" : $match[1], $value); } /** @param array}> $event */ private function toPeriod(array $event): ?ExternalPeriod { $stamp = $event['DTSTAMP']['value'] ?? ''; try { if (! preg_match('/^\d{8}T\d{6}Z$/D', $stamp) || CarbonImmutable::createFromFormat('!Ymd\THis\Z', $stamp, 'UTC')->format('Ymd\THis\Z') !== $stamp) { throw new \RuntimeException; } } catch (Throwable) { throw new ChannelSyncException('Ein Ereignis benötigt einen gültigen UTC-Zeitstempel (DTSTAMP).'); } foreach (['RRULE', 'RDATE', 'EXDATE', 'RECURRENCE-ID', 'DURATION'] as $unsupported) { if (isset($event[$unsupported])) { throw new ChannelSyncException('Serien oder Dauerangaben werden für diesen Belegungskalender nicht unterstützt.'); } } if (strtoupper($event['STATUS']['value'] ?? '') === 'CANCELLED') { return null; } if (! isset($event['DTSTART'])) { throw new ChannelSyncException('Einem Kalenderereignis fehlt die Anreise.'); } $start = $this->toDate($event['DTSTART']); if (! isset($event['DTEND']) && ! preg_match('/^\d{8}$/D', $event['DTSTART']['value'])) { throw new ChannelSyncException('Zeitgebundene Ereignisse benötigen eine ausdrückliche Abreise.'); } $end = isset($event['DTEND']) ? $this->toDate($event['DTEND']) : $start->addDay(); if (isset($event['DTEND']) && preg_match('/^\d{8}$/D', $event['DTSTART']['value']) !== preg_match('/^\d{8}$/D', $event['DTEND']['value'])) { throw new ChannelSyncException('An- und Abreise verwenden verschiedene Datumstypen.'); } if ($end->lessThanOrEqualTo($start)) { throw new ChannelSyncException('Ein Kalenderereignis hat keinen positiven Übernachtungszeitraum.'); } if (strtoupper($event['TRANSP']['value'] ?? '') === 'TRANSPARENT') { return null; } $summary = $event['SUMMARY']['value'] ?? null; return new ExternalPeriod($event['UID']['value'], $start, $end, $summary === null ? null : self::text($summary)); } /** @param array{value: string, params: list} $property */ private function toDate(array $property): CarbonImmutable { $value = trim($property['value']); foreach ($property['params'] as $param) { if (str_starts_with(strtoupper($param), 'VALUE=')) { $type = strtoupper(trim(substr($param, 6), '"')); if (! in_array($type, ['DATE', 'DATE-TIME'], true) || ($type === 'DATE') !== (preg_match('/^\d{8}$/D', $value) === 1)) { throw new ChannelSyncException('Ungültiger Datumswerttyp.'); } } if (str_starts_with(strtoupper($param), 'TZID=') && (preg_match('/^\d{8}$/D', $value) || str_ends_with($value, 'Z'))) { throw new ChannelSyncException('Unzulässige Kombination von Datum und Zeitzone.'); } } try { if (preg_match('/^\d{8}$/D', $value)) { $date = CarbonImmutable::createFromFormat('!Ymd', $value); if ($date->format('Ymd') === $value) { return $date; } } elseif (preg_match('/^(\d{8})T(\d{6})(Z?)$/D', $value, $match)) { $zone = $match[3] === 'Z' ? 'UTC' : $this->timezone($property['params']); $date = CarbonImmutable::createFromFormat('!YmdHis', $match[1].$match[2], $zone); if ($date->format('YmdHis') === $match[1].$match[2]) { return $date->setTimezone(config('app.timezone'))->startOfDay(); } } } catch (Throwable) { throw new ChannelSyncException('Ungültiges Kalenderdatum oder unbekannte Zeitzone.'); } throw new ChannelSyncException('Ungültiges Kalenderdatum.'); } /** @param list $params */ private function timezone(array $params): string { foreach ($params as $param) { if (str_starts_with(strtoupper($param), 'TZID=')) { $zone = trim(substr($param, 5), '"'); if (! in_array($zone, timezone_identifiers_list(), true)) { throw new ChannelSyncException('Unbekannte Kalenderzeitzone.'); } return $zone; } } return config('app.timezone'); } }