presseportale/app/Models/PressReleaseImage.php
Kevin Adametz e746deda4f technik: Statische Analyse wieder aussagekräftig machen
phpstan lief mit 390 Meldungen außerhalb der Baseline, der größte Teil davon
Falschmeldungen. Ursache: Larastan löste keinen einzigen Cast auf, weil alle
Models ihre Casts über die casts()-METHODE deklarieren (Laravel-11-Stil).
Laravel führt die erst zur Laufzeit mit $casts zusammen, Larastan instanziiert
Models aber ohne Konstruktor — $pressRelease->status galt deshalb als string
und jeder Enum-Vergleich als "immer falsch". Dafür gibt es den Schalter
parseModelCastsMethod, dessen Larastan-Default false ist.

Zweite Sammelursache waren fehlende Generics an den Relations-Methoden: Ohne
sie landete phpstan auf Illuminate\Database\Eloquent\Model und meldete jede
Modell-Eigenschaft und jeden eigenen Scope als unbekannt. Alle 102
Relationen tragen jetzt ihr @return <Related, $this>; das verbessert
nebenbei die Vervollständigung in der IDE.

Zusammen fällt die Zahl von 390 auf 169. Die neu erzeugte Baseline umfasst 166
Einträge, überwiegend Closure-Parameter, die als blankes Builder typisiert
sind, sowie zwei nachgeprüfte Falschmeldungs-Gruppen: die Concerns unter
app/Livewire werden ausschließlich aus Volt-Komponenten eingebunden, die
phpstan nicht analysiert, und Cashier typisiert findBillable() gegen den TRAIT
Billable, was phpstan nicht mit User vereinbaren kann — die Laufzeitprüfung
dort ist richtig und bleibt.

Was die Analyse an echten toten Zweigen zutage gefördert hat, ist mit
entfernt: eine doppelte Null-Prüfung im Nachweis-PDF, Prüfungen gegen
NOT-NULL-Spalten in der Rechnungsstellung und im Vorschau-Controller, eine
immer wahre Bedingung im Logo-Pfad und in RetireAgencyCompanyType, ein
überflüssiges ?? [] auf einer Symfony-Methode, die immer ein Array liefert,
sowie der unerreichbare null-Arm in publicPortalLinks(). MigrateLegacyMedia
deklariert seine Medientypen jetzt als Literal-Union, womit das match ohne
default nachweislich vollständig ist statt nur faktisch.

Damit das nicht wieder abdriftet — die Baseline stand seit Mai unverändert —
läuft die Analyse ab jetzt als eigener Schritt in der Test-Pipeline.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-01 11:07:51 +00:00

126 lines
3.4 KiB
PHP

<?php
namespace App\Models;
use App\Enums\AiImageDeclaration;
use App\Enums\ImageLicenseType;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Support\Facades\URL;
class PressReleaseImage extends Model
{
use SoftDeletes;
protected $fillable = [
'press_release_id',
'disk',
'path',
'variants',
'title',
'description',
'copyright',
'author',
'license_type',
'license_detail',
'license_url',
'source_url',
'persons_consent',
'people_rights_status',
'property_rights_status',
'rights_notes',
'rights_confirmed_at',
'is_ai_generated',
'ai_declaration',
'is_preview',
'sort_order',
'width',
'height',
'mime',
'legacy_portal',
'legacy_id',
];
protected function casts(): array
{
return [
'variants' => 'array',
'license_type' => ImageLicenseType::class,
'persons_consent' => 'boolean',
'rights_confirmed_at' => 'datetime',
'is_ai_generated' => 'boolean',
'ai_declaration' => AiImageDeclaration::class,
'is_preview' => 'boolean',
'sort_order' => 'integer',
'width' => 'integer',
'height' => 'integer',
'deleted_at' => 'datetime',
];
}
/**
* @return BelongsTo<PressRelease, $this>
*/
public function pressRelease(): BelongsTo
{
return $this->belongsTo(PressRelease::class);
}
public function url(bool $signed = false): ?string
{
if (blank($this->path)) {
return null;
}
return $this->resolveDiskUrl($this->path, signed: $signed);
}
public function variantUrl(string $key, bool $signed = false): ?string
{
$variantPath = $this->pathForVariant($key);
if (! is_string($variantPath) || blank($variantPath)) {
return null;
}
return $this->resolveDiskUrl($variantPath, $key, $signed);
}
public function pathForVariant(?string $key = null): ?string
{
if ($key === null || $key === 'original') {
return $this->path;
}
$variants = $this->getAttribute('variants');
return is_array($variants) && is_string($variants[$key] ?? null)
? $variants[$key]
: null;
}
/**
* Löst die URL je nach Disk auf: public → direkt, sonst über die geschützte
* Media-Route. `signed=true` erzeugt eine temporär signierte Route, damit
* die anonyme Token-Vorschau (unveröffentlichte PM) die Bilder laden kann,
* ohne die Media-Route generell zu öffnen.
*/
private function resolveDiskUrl(string $relativePath, ?string $variant = null, bool $signed = false): string
{
if ($this->disk === 'public') {
return asset('storage/'.ltrim($relativePath, '/'));
}
$parameters = array_filter([
'image' => $this->getKey(),
'variant' => $variant,
]);
if ($signed) {
return URL::temporarySignedRoute('media.press-release-images.show', now()->addHours(6), $parameters);
}
return route('media.press-release-images.show', $parameters);
}
}