Модели Eloquent

Устройство моделей

<?php
// Наше пространство имён для моделей
namespace App\Models;

// Импорт нужных классов для удобства
use Carbon\Carbon;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;

/**
 * Здесь мы перечисляем все колонки таблицы с их типами 
 * для автодополнения IDE
 * @property int $id
 * @property string $username
 * @property string $password
 * @property int $role_id
 * @property bool $active
 * @property Carbon $created_at
 * @property Carbon $updated_at
 *
 * Здесь перечислены связи таблицы, их нельзя перезаписывать, только чтение
 * Роль у пользователя может быть только одна
 * @property-read UserRole $role
 * А вот токенов несколько, поэтому в типе указан массив моделей
 * @property-read UserToken[] $tokens
 */
class User extends Model
{
    // Основные свойства модели
    protected $table = 'users'; // имя таблицы без префикса
    protected $primaryKey = 'id'; // Имя первичного ключа
    protected $keyType = 'int'; // Тип ключа - число
    public $incrementing = true; // Ключ автоматически увеличивается на 1
    public $timestamps = true; // У модели есть колонки created_at и updated_at

    // Массив с колонками, которые можно массово менять у модели через метод ->fill()
    protected $fillable = ['username', 'password', 'role_id', 'active'];
    // Скрытые колонки, которые прячутся при распечатке модели через ->toArray()
    protected $hidden = ['password'];

    // Массив с приведением типов колонок, например
    // active станет не int как в MySQL, а именно boolean
    protected $casts = ['active' => 'boolean'];

    // Дальше связи с другими моделями, помните мы указывали ключи в миграциях? 
    // Это вот они, да.

    // Данная модель является дочерней по отношениею к UserRole
    // то есть, принадлежит (belongs) к роли
    public function role(): BelongsTo
    {
        // 2й и 3й параметр указаны для примера, 
        // Eloquent и сам прекрасно понимает, что связь role должна использовать 
        // колонку role_id, и присоединяться к id у UserRole
        return $this->belongsTo(UserRole::class, 'role_id', 'id');
    }

    // А здесь связь в обратную сторону - много токенов принадлежат одному User
    // То есть юзер имеет много (has many) токенов
    public function tokens(): HasMany
    {
        // Принадлежащими считаются все UserToken, 
        // где колонка user_id равна id модели User
        // Второй параметр здесь я тоже написал для примера
        return $this->hasMany(UserToken::class, 'user_id');
    }
}

<?php

namespace App\Models;

use Carbon\Carbon;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * @property string $token
 * @property int $user_id
 * @property Carbon $valid_till
 * @property string $ip
 * @property bool $active
 * @property Carbon $created_at
 * @property Carbon $updated_at
 *
 * @property-read User $user
 */
class UserToken extends Model
{
    // Первичный ключ уже не увеличивается автоматически
    public $incrementing = false;
    // Да и колонка для него не id
    protected $primaryKey = 'token';
    // А тип ключа - строка
    protected $keyType = 'string';

    // Вместо fillable, который разрешает массово обновлять колонки, указан guarded,
    // который запрещает обновлять колонки. Это значит, что все колонки, 
    // не указанные здесь, обновлять можно. 
    // Можно указывать или fillable, или guarded, оновременно - нельзя.
    protected $guarded = ['created_at', 'updated_at'];

    // В свойство колонок с датами добавлена и наша - valid_till. 
    // Это значит, что в PHP эта колонка будет экземпляром 
    // библиотеки для работы с датами Carbon
    protected $dates = ['valid_till'];

    protected $casts = ['active' => 'boolean'];

    // Каждый токен принадлежат своему User
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }
}

Работа с моделями

// Здесь мы генерируем и выполняем SQL запрос без получения модели
// UPDATE app_users SET fullname = 'test' WHERE id = 1;
User::query()->where('id', 1)->update(['fullname' => 'test']);

// А здесь мы получаем модель
// SELECT * FROM app_users WHERE id = 1;
// Создаём новый экземпляр класса User и забиваем его полученными значениями
if ($user = User::query()->find(1)) {
    // Потом меняем атрибут внутри класса
    $user->fullname = 'test';
    // И сохраняем данные обратно в таблицу
    // UPDATE app_users SET fullname = 'test' WHERE id = 1;
    $user->save();
}

// Получаем юзера с id = 1
if ($user = User::query()->find(1)) {
    // И удаляем всего его токены через SQL запрос
    // DELETE FROM app_user_tokens WHERE user_id = 1;
    $user->tokens()->delete();
}

// Получаем юзера с id = 1
if ($user = User::query()->find(1)) {
    // И удаляем всего его токены через перебор моделей UserToken
    foreach ($user->tokens as $token) {
        $token->delete();
    }
}

$user = new User();
$user->fill([
    'username' => 'new_user',
    'password' => 'new_password',
    'role_id' => 2,
    'fullname' => 'New User',
]);
$user->save();

User::query()->insert([
    'username' => 'new_user2',
    'password' => 'new_password2',
    'role_id' => 2,
    'fullname' => 'New User 2',
]);

Заключение

1. сначала миграция с описанием всех колонок и их связей
2. затем модель с описанием тех же колонок и связей

1. миграция с изменениями таблицы
2. отражение изменений в модели: новые связи или колонки

public function setAttribute($key, $value)
{
    if ($key === 'password') {
        $value = password_hash($value, PASSWORD_DEFAULT);
    }

    return parent::setAttribute($key, $value);
}