Loheide-eu-mitarbeiterplatt.../app/Http/Controllers/MediaController.php
Friederich Loheide 694ccf6ae0 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>
2026-09-26 20:05:50 +00:00

232 lines
9.3 KiB
PHP

<?php
namespace App\Http\Controllers;
use App\Media\MediaLibrary;
use App\Media\MediaUsages;
use App\Models\Media;
use App\Models\MediaUsage;
use App\Models\User;
use App\Support\Audit;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Gate;
use Illuminate\Support\Facades\Storage;
use Illuminate\Validation\Rule;
use Illuminate\Validation\Rules\File;
use Inertia\Inertia;
use Inertia\Response;
use Symfony\Component\HttpFoundation\StreamedResponse;
/**
* Mediathek im Portal (Redaktion) und JSON-Schnittstelle der Bildauswahl.
* Benutzen und Hochladen: „media.use“, Ersetzen und Löschen: „media.manage“.
*/
class MediaController extends Controller
{
public const PER_PAGE = 48;
public function __construct(private readonly MediaLibrary $library, private readonly MediaUsages $usages) {}
public function index(Request $request): Response
{
return Inertia::render('Media/Index', [
'filters' => (object) $request->only(['q', 'von', 'zeitraum', 'status', 'in']),
'uploaders' => User::query()->whereIn('id', Media::query()->whereNotNull('uploaded_by')->distinct()->select('uploaded_by'))
->orderBy('last_name')->orderBy('first_name')->get()->map(fn (User $user) => ['value' => (string) $user->id, 'label' => $user->name])->values(),
'sources' => collect($this->usages->labels())->map(fn (string $label, string $type) => ['value' => $type, 'label' => $label])->values(),
'canManage' => $request->user()->can('media.manage'),
]);
}
public function list(Request $request): JsonResponse
{
$filters = $request->validate([
'q' => ['nullable', 'string', 'max:100'],
'von' => ['nullable', 'integer'],
'zeitraum' => ['nullable', Rule::in(['7', '30', '365'])],
'status' => ['nullable', Rule::in(['unbenutzt', 'verwendet'])],
'in' => ['nullable', 'string', 'max:60'],
'sortierung' => ['nullable', Rule::in(['neu', 'verwendet', 'name'])],
'pfade' => ['nullable', 'array', 'max:500'],
'pfade.*' => ['string', 'max:255'],
'page' => ['nullable', 'integer', 'min:1'],
]);
$query = Media::query()->with('uploader:id,name')->withCount('usages');
$this->applyFilters($query, $filters);
$page = $query->simplePaginate(self::PER_PAGE);
return response()->json([
'items' => $page->getCollection()->map(fn (Media $media) => $media->toLibraryArray())->values(),
'next_page' => $page->hasMorePages() ? $page->currentPage() + 1 : null,
'total' => $page->currentPage() === 1 ? $this->countFor($filters) : null,
]);
}
public function store(Request $request): JsonResponse
{
$request->validate(['image' => ['required', File::image()->types(['jpg', 'jpeg', 'png', 'webp', 'gif'])->max(15 * 1024)]]);
$media = $this->library->store($request->file('image'), MediaLibrary::DIRECTORY, $request->user());
$media->load('uploader:id,name')->loadCount('usages');
return response()->json(['media' => $media->toLibraryArray()], 201);
}
public function show(Media $media): JsonResponse
{
$media->load('uploader:id,name')->loadCount('usages');
$labels = $this->usages->labels();
return response()->json([
'media' => $media->toLibraryArray(),
'usages' => $media->usages()->orderBy('draft')->orderBy('source_type')->orderBy('label')->get()->map(fn (MediaUsage $usage) => [
'id' => $usage->id,
'type' => $usage->source_type,
'type_label' => $labels[$usage->source_type] ?? $usage->source_type,
'context' => $usage->context,
'label' => $usage->label,
'url' => $usage->url,
'draft' => $usage->draft,
])->values(),
]);
}
public function update(Request $request, Media $media): JsonResponse
{
$data = $request->validate([
'alt' => ['nullable', 'string', 'max:300'],
'caption' => ['nullable', 'string', 'max:500'],
'tags' => ['nullable', 'array', 'max:20'],
'tags.*' => ['string', 'max:40'],
]);
$tags = isset($data['tags']) ? array_values(array_unique(array_filter(array_map(fn ($tag) => trim((string) $tag), $data['tags'])))) : ($media->tags ?? []);
$media->forceFill([
'alt' => array_key_exists('alt', $data) ? (trim((string) $data['alt']) ?: null) : $media->alt,
'caption' => array_key_exists('caption', $data) ? (trim((string) $data['caption']) ?: null) : $media->caption,
'tags' => $tags ?: null,
]);
// Nur Metadaten: updated_at nicht anfassen, sonst ändern sich alle Bildadressen („?v=“).
Media::withoutTimestamps(fn () => $media->save());
return response()->json(['media' => $media->loadCount('usages')->load('uploader:id,name')->toLibraryArray()]);
}
public function replace(Request $request, Media $media): JsonResponse
{
Gate::authorize('media.manage');
$request->validate(['image' => ['required', File::image()->types(['jpg', 'jpeg', 'png', 'webp', 'gif'])->max(15 * 1024)]]);
$this->library->replace($media, $request->file('image'));
Audit::log('media.replaced', ['media' => $media->id, 'path' => $media->path]);
return response()->json(['media' => $media->loadCount('usages')->load('uploader:id,name')->toLibraryArray()]);
}
public function destroy(Media $media): JsonResponse
{
Gate::authorize('media.manage');
$usages = $media->usages()->count();
$this->library->delete($media);
Audit::log('media.deleted', ['media' => $media->id, 'path' => $media->path, 'usages' => $usages]);
return response()->json(['deleted' => 1]);
}
public function bulkDestroy(Request $request): JsonResponse
{
Gate::authorize('media.manage');
$data = $request->validate([
'ids' => ['required', 'array', 'max:500'],
'ids.*' => ['integer'],
'only_unused' => ['boolean'],
]);
$deleted = 0;
Media::query()->whereIn('id', $data['ids'])
->when($data['only_unused'] ?? false, fn (Builder $q) => $q->doesntHave('usages'))
->get()->each(function (Media $media) use (&$deleted) {
$this->library->delete($media);
$deleted++;
});
Audit::log('media.bulk_deleted', ['count' => $deleted]);
return response()->json(['deleted' => $deleted]);
}
public function download(Media $media): StreamedResponse
{
$disk = Storage::disk($media->disk ?: MediaLibrary::DISK);
abort_unless($disk->exists($media->path), 404);
$extension = pathinfo($media->path, PATHINFO_EXTENSION);
$name = pathinfo($media->displayName(), PATHINFO_FILENAME) ?: 'bild';
return $disk->download($media->path, $name.'.'.$extension);
}
public function rebuild(): JsonResponse
{
Gate::authorize('media.manage');
$result = $this->library->rebuild();
Audit::log('media.rebuilt', $result);
return response()->json($result);
}
/**
* @param Builder<Media> $query
* @param array<string, mixed> $filters
*/
private function applyFilters(Builder $query, array $filters, bool $sort = true): void
{
if ($term = trim((string) ($filters['q'] ?? ''))) {
$like = '%'.str_replace(['\\', '%', '_'], ['\\\\', '\%', '\_'], $term).'%';
$query->where(fn (Builder $q) => $q
->where('original_name', 'like', $like)
->orWhere('alt', 'like', $like)
->orWhere('caption', 'like', $like)
->orWhere('tags', 'like', $like)
->orWhere('path', 'like', $like));
}
$query->when($filters['von'] ?? null, fn (Builder $q, $id) => $q->where('uploaded_by', $id))
->when($filters['zeitraum'] ?? null, fn (Builder $q, $days) => $q->where('created_at', '>=', now()->subDays((int) $days)))
->when(($filters['status'] ?? null) === 'unbenutzt', fn (Builder $q) => $q->doesntHave('usages'))
->when(($filters['status'] ?? null) === 'verwendet', fn (Builder $q) => $q->has('usages'))
->when($filters['in'] ?? null, fn (Builder $q, $type) => $q->whereHas('usages', fn (Builder $u) => $u->where('source_type', $type)))
->when(array_key_exists('pfade', $filters), fn (Builder $q) => $q->whereIn('path', $filters['pfade'] ?: ['']));
if (! $sort) {
return;
}
match ($filters['sortierung'] ?? 'neu') {
// Zuletzt verwendet: jüngste Einbindung zuerst (wird bei jedem Speichern der Quelle neu erfasst)
'verwendet' => $query->orderByDesc(MediaUsage::query()->selectRaw('MAX(created_at)')->whereColumn('media_usages.media_id', 'media.id'))->orderByDesc('id'),
'name' => $query->orderBy('original_name')->orderBy('id'),
default => $query->orderByDesc('id'),
};
}
/**
* @param array<string, mixed> $filters
*/
private function countFor(array $filters): int
{
$query = Media::query();
$this->applyFilters($query, $filters, false);
return $query->count();
}
}