engelsystem/src/Models/EventConfig.php

<?php

declare(strict_types=1);

namespace Engelsystem\Models;

use Carbon\Carbon;
use Illuminate\Database\Query\Builder as QueryBuilder;

/**
 * @property string $name
 * @property string $value
 * @property Carbon $created_at
 * @property Carbon $updated_at
 *
 * @method static QueryBuilder|EventConfig[] whereName($value)
 * @method static QueryBuilder|EventConfig[] whereValue($value)
 * @method static QueryBuilder|EventConfig[] whereCreatedAt($value)
 * @method static QueryBuilder|EventConfig[] whereUpdatedAt($value)
 */
class EventConfig extends BaseModel
{
    /** @var string The primary key for the model */
    protected $primaryKey = 'name'; // phpcs:ignore

    /** @var bool Indicates if the IDs are auto-incrementing */
    public $incrementing = false; // phpcs:ignore

    /** @var string Required because it is not event_configs */
    protected $table = 'event_config'; // phpcs:ignore

    /** @var array Values that are mass assignable */
    protected $fillable = ['name', 'value']; // phpcs:ignore

    /** @var array<string, string> The configuration values that should be cast to native types */
    protected array $valueCasts = [
        'buildup_start' => 'datetime_human',
        'event_start'   => 'datetime_human',
        'event_end'     => 'datetime_human',
        'teardown_end'  => 'datetime_human',
        'last_metrics'  => 'datetime',
    ];

    /** @var bool It could be interesting to know when a value changed the last time */
    public $timestamps = true; // phpcs:ignore

    /**
     * Value accessor
     */
    public function getValueAttribute(mixed $value): mixed
    {
        $value = $value ? $this->fromJson($value) : null;

        /** @see \Illuminate\Database\Eloquent\Concerns\HasAttributes::castAttribute */
        if (!empty($value)) {
            return match ($this->getValueCast($this->name)) {
                'datetime_human' => Carbon::make($value),
                'datetime'       => Carbon::createFromFormat(Carbon::ISO8601, $value),
                default          => $value,
            };
        }

        return $value;
    }

    /**
     * Value mutator
     *
     * @return static
     */
    public function setValueAttribute(mixed $value): static
    {
        if (!empty($value)) {
            $value = match ($this->getValueCast($this->name)) {
                /** @var Carbon $value */
                'datetime_human' => $value->toDateTimeString('minute'),
                /** @var Carbon $value */
                'datetime'       => $value->toIso8601String(),
                default          => $value,
            };
        }

        $value = $this->castAttributeAsJson('value', $value);
        $this->attributes['value'] = $value;

        return $this;
    }

    /**
     * Check if the value has to be casted
     */
    protected function getValueCast(string $value): ?string
    {
        return isset($this->valueCasts[$value]) ? $this->valueCasts[$value] : null;
    }
}