|null, created_at?: mixed} $meta */ public function register(string $path, array $meta = [], ?User $user = null): Media { $existing = Media::query()->where('path', $path)->first(); if ($existing) { return $existing; } $attributes = [ ...$this->fileInfo($path), 'disk' => self::DISK, 'path' => $path, 'original_name' => isset($meta['original_name']) ? Str::limit((string) $meta['original_name'], 250, '') : null, 'alt' => $meta['alt'] ?? null, 'caption' => $meta['caption'] ?? null, 'tags' => $meta['tags'] ?? null, 'uploaded_by' => $user?->id, ]; try { $media = new Media($attributes); if (isset($meta['created_at'])) { $media->created_at = Carbon::parse($meta['created_at']); } $media->save(); return $media; } catch (UniqueConstraintViolationException) { // Gleichzeitig von einer anderen Anfrage erfasst. return Media::query()->where('path', $path)->firstOrFail(); } } /** * Pfade auf Mediathek-IDs abbilden; vorhandene, noch unbekannte Bilddateien * werden dabei erfasst (z. B. aus Admin-Formularen oder älteren Versionen). * * @param list $paths * @return array Pfad => Media-ID */ public function ensureRegistered(array $paths): array { $paths = array_values(array_filter(array_unique($paths), fn ($path) => ImagePaths::isCandidate($path))); if ($paths === []) { return []; } $known = Media::query()->whereIn('path', $paths)->pluck('id', 'path')->all(); $disk = Storage::disk(self::DISK); $user = Auth::user(); foreach (array_diff($paths, array_keys($known)) as $path) { if (! $disk->exists($path)) { continue; } try { $modified = @filemtime($disk->path($path)); $known[$path] = $this->register($path, ['created_at' => $modified ? Carbon::createFromTimestamp($modified) : null], $user instanceof User ? $user : null)->id; } catch (Throwable $e) { report($e); } } return $known; } /** * Upload speichern (höchstens 2000 px breit, WebP; GIFs unverändert) und erfassen. */ public function store(UploadedFile $file, string $directory = self::DIRECTORY, ?User $user = null, array $meta = []): Media { $name = $file->getClientOriginalName(); $path = $this->images->storeContentImage($file, trim($directory, '/')); // Vorschaubild für Mediathek und Bildauswahl $this->images->createVariants($path, ['thumb']); return $this->register($path, ['original_name' => $name, ...$meta], $user); } /** * Datei austauschen – Pfad, Alternativtext und alle Einbindungen bleiben. */ public function replace(Media $media, UploadedFile $file): Media { $name = $file->getClientOriginalName(); $this->images->overwrite($media->path, $file); if (! Storage::disk(self::DISK)->exists($this->images->variantPath($media->path, 'thumb'))) { $this->images->createVariants($media->path, ['thumb']); } $media->forceFill([...$this->fileInfo($media->path), 'original_name' => Str::limit($name, 250, ''), 'updated_at' => now()])->save(); return $media; } /** * Bild samt Varianten löschen. Einbindungen zeigen danach ihren Platzhalter. */ public function delete(Media $media): void { $this->images->deleteWithVariants($media->path); $media->delete(); } /** * Datei über ihren Pfad entfernen – mit Eintrag in der Mediathek, falls vorhanden. */ public function deletePath(string $path): void { $media = Media::query()->where('path', $path)->first(); $media ? $this->delete($media) : $this->images->deleteWithVariants($path); } /** * Bereits verwendete Bilder übernehmen und alle Verwendungen neu erfassen. * * @return array{sources: int, media: int} */ public function rebuild(): array { @set_time_limit(0); $sources = app(MediaUsages::class)->rebuild(); return ['sources' => $sources, 'media' => Media::query()->count()]; } /** * @return array{mime: string|null, size: int|null, width: int|null, height: int|null} */ private function fileInfo(string $path): array { $disk = Storage::disk(self::DISK); if (! $disk->exists($path)) { return ['mime' => null, 'size' => null, 'width' => null, 'height' => null]; } $size = @getimagesize($disk->path($path)); return [ 'mime' => $size['mime'] ?? ($disk->mimeType($path) ?: null), 'size' => $disk->size($path), 'width' => $size[0] ?? null, 'height' => $size[1] ?? null, ]; } }