ldc-supportweb/app/Models/Site.php

<?php

namespace App\Models;

use App\Lib\Helpers\ToolboxHelper;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\SoftDeletes;

/**
 * @property string  $name
 * @property string  $url_re7
 * @property string  $url_prod
 * @property integer $gitlab_project_id
 * @property Brand   $brand_id
 */
class Site extends Model
{
    use HasFactory;
    use SoftDeletes;

    /**
     * The attributes that are fillable.
     *
     * @var array
     */
    protected $fillable = [
        'name',
        'url_re7',
        'url_prod',
        'gitlab_project_id',
        'project_manager_id'
    ];

    /**
     * The accessors to append to the model's array form.
     *
     * @var array
     */
    protected $appends = [
        'value'
    ];
    // * EVENTS

    /**
     * Perform any actions required after the model boots.
     *
     * @return void
     */
    protected static function booted()
    {
        static::creating(function (self $model) {
            self::manageFields($model);
        });
        static::updating(function (self $model) {
            self::manageFields($model);
        });
    }

    // * METHODS

    /**
     * Common methods function.
     *
     * @param Model $model
     * @return void
     */
    private static function manageFields(Model $model)
    {
        if ($model->url_re7) {
            ToolboxHelper::assertNoInternalUrls('url_re7', $model->url_re7);
        }
        if ($model->url_prod) {
            ToolboxHelper::assertNoInternalUrls('url_prod', $model->url_prod);
        }
    }


    // * RELATIONSHIPS

    /**
     * HasMany Message relation
     * The users of type client that would have access to this site tickets
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function users()
    {
        return $this->belongsToMany(User::class);
    }

    /**
     * HasMany Ticket relation
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function tickets()
    {
        return $this->hasMany(Ticket::class, 'site_id');
    }

    /**
     * BelongsTo Brand relation
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function brand()
    {
        return $this->belongsTo(Brand::class);
    }

    /**
     * BelongsTo User relation
     * The project manager of the site
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function projectManager(): BelongsTo
    {
        return $this->belongsTo(User::class, 'project_manager_id');
    }

    /**
     * BelongsTo Project relation
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function project()
    {
        return $this->belongsTo(Project::class);
    }

    /**
     * Return value attribute for belongsto search component
     *
     * @return \Illuminate\Database\Eloquent\Casts\Attribute
     */
    protected function value(): Attribute
    {
        return new Attribute(
            get: fn () => $this->id,
        );
    }
}