Mediathek: zentrale Bildverwaltung mit Verwendungsnachweis und Bildauswahl

- Tabellen media und media_usages, Modelle Media/MediaUsage
- App\Media\MediaLibrary (store/register/replace/delete/rebuild) und
  Registry App\Media\MediaUsages (Quellen: Seiten, Neuigkeiten inkl.
  künftiger content-Spalte, Termine, Startseiten-Kacheln), ImagePaths-Extraktor
- Alle Uploads landen in der Mediathek (Seiten-Editor direkt, übrige über
  Beobachter beim Speichern); Daten-Migration und media:rebuild übernehmen
  bestehende Bilder
- Recht media.manage, Zugang media.use für alle Redaktionsbereiche
- /redaktion/mediathek (Suche, Filter, Upload mit Fortschritt, Details,
  Eingebunden in, Ersetzen, Löschen mit Warnung, Mehrfachauswahl),
  Abschnitt in der Redaktion und Menüpunkt im Admin-Bereich
- MediaPicker (Hochladen/Mediathek) im Pagebuilder: Bildfelder und
  Galerie (Mehrfachauswahl), editor.pickMedia im provide-API
- Bild-URLs mit ?v=Änderungszeit, null bei fehlender Datei; Modelle löschen
  geteilte Bilder nicht mehr selbst

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Friederich Loheide 2026-09-26 20:05:50 +00:00
parent 3b72b5327e
commit 694ccf6ae0
46 changed files with 3101 additions and 89 deletions

View file

@ -6,6 +6,9 @@ use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Intervention\Image\Drivers\Gd\Driver;
use Intervention\Image\Encoders\GifEncoder;
use Intervention\Image\Encoders\JpegEncoder;
use Intervention\Image\Encoders\PngEncoder;
use Intervention\Image\Encoders\WebpEncoder;
use Intervention\Image\ImageManager;
use Throwable;
@ -23,7 +26,10 @@ class Images
private const VARIANTS_LARGEST_FIRST = ['large', 'thumb'];
public function createVariants(string $path): void
/**
* @param list<string>|null $only nur diese Varianten (z. B. ['thumb'] für die Mediathek)
*/
public function createVariants(string $path, ?array $only = null): void
{
$disk = Storage::disk('uploads');
@ -39,6 +45,10 @@ class Images
$image = ImageManager::usingDriver(Driver::class)->decodePath($disk->path($path));
foreach (self::VARIANTS_LARGEST_FIRST as $variant) {
if ($only !== null && ! in_array($variant, $only, true)) {
continue;
}
[$width, $height] = self::VARIANTS[$variant];
$image->coverDown($width, $height);
$disk->put($this->variantPath($path, $variant), $image->encode(new WebpEncoder(quality: 82))->toString());
@ -48,12 +58,6 @@ class Images
}
}
/**
* Bild für Inhalte (Pagebuilder, Beiträge): Seitenverhältnis bleibt, höchstens
* 2000 Pixel breit, als WebP. GIFs bleiben unverändert (Animationen).
*
* @return string Pfad im Speicher „uploads“
*/
/**
* Führt $callback mit dem Pfad einer lokalen Kopie des Uploads aus.
*
@ -83,6 +87,12 @@ class Images
}
}
/**
* Bild für Inhalte (Pagebuilder, Beiträge): Seitenverhältnis bleibt, höchstens
* 2000 Pixel breit, als WebP. GIFs bleiben unverändert (Animationen).
*
* @return string Pfad im Speicher „uploads“
*/
public function storeContentImage(UploadedFile $file, string $directory): string
{
$disk = Storage::disk('uploads');
@ -104,6 +114,50 @@ class Images
return $name.'.webp';
}
/**
* Datei an Ort und Stelle austauschen (Mediathek „Ersetzen“): Der Pfad bleibt,
* damit jede Einbindung automatisch das neue Bild zeigt. Das Format folgt der
* Dateiendung des bestehenden Pfads; vorhandene Varianten werden neu erzeugt.
*/
public function overwrite(string $path, UploadedFile $file): void
{
$disk = Storage::disk('uploads');
$previous = (int) @filemtime($disk->path($path));
$extension = strtolower(pathinfo($path, PATHINFO_EXTENSION));
$variants = array_values(array_filter(array_keys(self::VARIANTS), fn (string $variant) => $disk->exists($this->variantPath($path, $variant))));
if ($extension === 'gif' && $file->getMimeType() === 'image/gif') {
self::withLocalCopy($file, fn (string $local) => $disk->put($path, (string) file_get_contents($local)));
} else {
self::withLocalCopy($file, function (string $local) use ($disk, $path, $extension) {
self::raiseMemoryLimitFor($local);
$image = ImageManager::usingDriver(Driver::class)->decodePath($local);
$image->scaleDown(width: 2000);
$encoded = match ($extension) {
'jpg', 'jpeg' => $image->encode(new JpegEncoder(quality: 85)),
'png' => $image->encode(new PngEncoder),
'gif' => $image->encode(new GifEncoder),
default => $image->encode(new WebpEncoder(quality: 84)),
};
$disk->put($path, $encoded->toString());
});
}
if ($variants !== []) {
$this->createVariants($path, $variants);
}
// Der Änderungszeitpunkt steckt in „?v=“ der Adressen (siehe url()): muss sich
// auch beim Ersetzen in derselben Sekunde ändern, damit Browser neu laden.
$modified = max(time(), $previous + 1);
foreach ([$path, ...array_map(fn (string $variant) => $this->variantPath($path, $variant), $variants)] as $file) {
@touch($disk->path($file), $modified);
}
clearstatcache();
}
public function deleteWithVariants(?string $path): void
{
if (! $path) {
@ -118,16 +172,30 @@ class Images
}
}
public function url(?string $path, string $variant = 'large'): ?string
/**
* Öffentliche Adresse – null, wenn die Datei fehlt (z. B. in der Mediathek
* gelöscht): Komponenten zeigen dann ihren Platzhalter statt eines kaputten Bilds.
* „?v=“ ändert sich beim Ersetzen, damit Browser trotz langem Cache das neue Bild laden.
*
* @param string|null $variant null = Original
*/
public function url(?string $path, ?string $variant = 'large'): ?string
{
if (! $path) {
return null;
}
$disk = Storage::disk('uploads');
$variantPath = $this->variantPath($path, $variant);
$variantPath = $variant ? $this->variantPath($path, $variant) : null;
$file = $variantPath && $disk->exists($variantPath) ? $variantPath : $path;
return $disk->url($disk->exists($variantPath) ? $variantPath : $path);
if ($file === $path && ! $disk->exists($path)) {
return null;
}
$modified = @filemtime($disk->path($file));
return $disk->url($file).($modified ? '?v='.$modified : '');
}
/**
@ -170,7 +238,7 @@ class Images
};
}
private function variantPath(string $path, string $variant): string
public function variantPath(string $path, string $variant): string
{
return preg_replace('/\.[^.\/]+$/', '', $path)."-{$variant}.webp";
}