…, 'url' => …, 'excerpt' => ?, 'meta' => ?, 'image' => ?, 'external' => ?bool] */ class GlobalSearch { public const MIN_LENGTH = 2; /** @var array */ private array $sources = []; /** * @param string $icon Lucide-Name, z. B. „newspaper“ * @param callable(User, string, int): list> $search */ public function add(string $key, string $label, string $icon, callable $search, int $sort = 50): void { $this->sources[$key] = compact('label', 'icon', 'sort', 'search'); } public function remove(string $key): void { unset($this->sources[$key]); } /** * @return list>}> */ public function run(User $user, string $query, int $limit): array { $query = trim($query); if (mb_strlen($query) < self::MIN_LENGTH) { return []; } $groups = []; foreach (collect($this->sources)->sortBy('sort') as $key => $source) { if (! app(PluginAccess::class)->allows($key, $user)) { continue; } try { $items = array_slice(array_values(($source['search'])($user, $query, $limit)), 0, $limit); } catch (Throwable $e) { // Eine fehlerhafte Quelle darf die Suche nicht lahmlegen. Log::error("Suchquelle {$key} fehlgeschlagen: ".$e->getMessage(), ['exception' => $e]); continue; } if ($items !== []) { $groups[] = ['key' => $key, 'label' => $source['label'], 'icon' => $source['icon'], 'items' => $items]; } } return $groups; } /** * Suchbegriffe (alle müssen vorkommen). * * @return list */ public static function terms(string $query): array { return array_values(array_filter(preg_split('/\s+/u', trim($query)) ?: [], fn ($t) => $t !== '')); } /** * Jeder Begriff muss in mindestens einer der Spalten vorkommen. * * @param Builder $query * @param list $columns */ public static function whereTerms(Builder $query, array $columns, string $search): void { foreach (self::terms($search) as $term) { $like = '%'.str_replace(['\\', '%', '_'], ['\\\\', '\\%', '\\_'], $term).'%'; $query->where(function (Builder $q) use ($columns, $like) { foreach ($columns as $column) { $q->orWhere($column, 'like', $like); } }); } } /** * Textausschnitt rund um den ersten Treffer (ohne HTML). */ public static function excerpt(?string $text, string $query, int $length = 160): ?string { $plain = trim((string) preg_replace('/\s+/u', ' ', html_entity_decode(strip_tags(str_replace('>', '> ', (string) $text)), ENT_QUOTES | ENT_HTML5))); if ($plain === '') { return null; } $position = null; foreach (self::terms($query) as $term) { $found = mb_stripos($plain, $term); if ($found !== false && ($position === null || $found < $position)) { $position = $found; } } if ($position === null || $position < $length / 3) { return Str::limit($plain, $length); } $start = max(0, $position - (int) ($length / 3)); $snippet = mb_substr($plain, $start, $length); return '… '.trim($snippet).(mb_strlen($plain) > $start + $length ? ' …' : ''); } }