*/ public function labels(): array { return [ 'heading' => 'Überschrift und Einleitung', 'prose' => 'Fließtext', 'image_text' => 'Bild und Text', 'call_to_action' => 'Handlungsaufruf', 'cards' => 'Karten', 'faq' => 'FAQ', ]; } /** * @param list> $blocks * @return list> */ public function normalize(array $blocks): array { $normalized = []; foreach (array_values($blocks) as $index => $block) { if (! is_array($block)) { throw ValidationException::withMessages([ "blocks.$index" => 'Ein Baustein ist unvollständig.', ]); } $type = $block['type'] ?? null; if (! is_string($type) || ! array_key_exists($type, $this->labels())) { throw ValidationException::withMessages([ "blocks.$index.type" => 'Dieser Bausteintyp ist nicht freigegeben.', ]); } $normalized[] = $this->normalizeOne($type, $block, $index); } return $normalized; } /** * @param array $block * @return array */ private function normalizeOne(string $type, array $block, int $index): array { $rules = match ($type) { 'heading' => [ 'heading' => ['required', 'string', 'max:200'], 'intro' => ['nullable', 'string', 'max:1000'], ], 'prose' => [ 'body' => ['required', 'string', 'max:20000'], ], 'image_text' => [ 'image' => ['nullable', 'string', 'max:255'], 'alt' => ['required', 'string', 'max:300'], 'body' => ['required', 'string', 'max:5000'], ], 'call_to_action' => [ 'heading' => ['required', 'string', 'max:200'], 'text' => ['nullable', 'string', 'max:1000'], 'label' => ['required', 'string', 'max:80'], 'url' => ['required', 'string', 'max:500'], ], 'cards' => [ 'items' => ['required', 'array', 'min:1', 'max:6'], 'items.*.title' => ['required', 'string', 'max:120'], 'items.*.text' => ['nullable', 'string', 'max:500'], 'items.*.url' => ['nullable', 'string', 'max:500'], ], 'faq' => [ 'items' => ['required', 'array', 'min:1', 'max:20'], 'items.*.question' => ['required', 'string', 'max:300'], 'items.*.answer' => ['required', 'string', 'max:2000'], ], default => [], }; $validator = Validator::make($block, $rules); if ($validator->fails()) { $messages = []; foreach ($validator->errors()->messages() as $key => $errors) { $messages["blocks.$index.$key"] = $errors; } throw ValidationException::withMessages($messages); } $clean = ['type' => $type]; foreach (array_keys($rules) as $key) { if (str_contains($key, '.*')) { continue; } $clean[$key] = $block[$key] ?? null; } if ($type === 'image_text') { $clean['image'] = $this->imagePath($clean['image'] ?? null, $index); } if (in_array($type, ['call_to_action', 'cards'], true)) { $clean = $this->assertSafeUrls($clean, $index); } return $clean; } private function imagePath(mixed $image, int $index): ?string { if (is_array($image)) { $image = $image[0] ?? null; } if ($image === null || $image === '') { return null; } if (! is_string($image) || str_contains($image, '..') || ! str_starts_with($image, 'cms/')) { throw ValidationException::withMessages([ "blocks.$index.image" => 'Das Bild liegt nicht im öffentlichen Medienbereich.', ]); } return $image; } /** * @param array $block * @return array */ private function assertSafeUrls(array $block, int $index): array { if (array_key_exists('url', $block)) { $block['url'] = $this->safeUrl($block['url'], "blocks.$index.url"); } if (isset($block['items']) && is_array($block['items'])) { foreach ($block['items'] as $itemIndex => $item) { if (is_array($item) && filled($item['url'] ?? null)) { $block['items'][$itemIndex]['url'] = $this->safeUrl($item['url'], "blocks.$index.items.$itemIndex.url"); } } } return $block; } private function safeUrl(mixed $url, string $key): string { if (! is_string($url)) { throw ValidationException::withMessages([$key => 'Die Adresse ist ungültig.']); } $isRelative = str_starts_with($url, '/') && ! str_starts_with($url, '//'); $isAbsolute = preg_match('#^https?://#i', $url) === 1; if (! $isRelative && ! $isAbsolute) { throw ValidationException::withMessages([$key => 'Erlaubt sind Seitenpfade oder http(s)-Adressen.']); } return $url; } }