Разбираемся с миграциями

Миграция Files

<?php

use Illuminate\Database\Schema\Blueprint;
use Vesp\Services\Migration;

// Класс должен расширять Vesp\Services\Migration
class Files extends Migration
{
    // Функция внесения изменений
    public function up(): void
    {
        // Создаём таблицу для файлов
        $this->schema->create(
            'files',
            function (Blueprint $table) {
                $table->id(); // Первичный ключ Unsigned Big Integer с автоинкрементом
                // Дальше колонки Varchar  
                $table->string('file'); 
                $table->string('path');
                // Следующие 2 колонки могут быть null при создании записи
                // То есть, они не являются обязательными
                $table->string('title')->nullable();
                $table->string('type')->nullable();
                $table->smallInteger('width')->unsigned()->nullable();
                $table->smallInteger('height')->unsigned()->nullable();
                $table->integer('size')->unsigned()->nullable();
                // колонка с типом JSON появилась только в MySQL 5.7
                $table->json('metadata')->nullable(); 
                // Специальная команда Eloquent, которая добавляет 2 колонки:
                // created_at и updated_at для сохранения времени создания и 
                // последнего изменения записи
                $table->timestamps();
            }
        );
    }

    // Функция отката изменений
    public function down(): void
    {
        // Просто удаляем таблицу
        $this->schema->drop('files');
    }
}

Миграция Users

<?php

use Illuminate\Database\Schema\Blueprint;
use Vesp\Services\Migration;

class Users extends Migration
{

    public function up(): void
    {
        // Первым делом создаём таблицу для хранения групп пользователей
        $this->schema->create(
            'user_roles',
            function (Blueprint $table) {
                // Первичный ключ
                $table->id();
                // Название группы должно быть уникальным
                $table->string('title')->unique();
                // Права доступа группы могут быть null
                $table->json('scope')->nullable();
                // Стандартные колонки с датами
                $table->timestamps();
            }
        );

        // Теперь таблица пользователей
        $this->schema->create(
            'users',
            function (Blueprint $table) {
                $table->id();
                // Уникальное имя пользователя
                $table->string('username')->unique();
                // Обязательный пароль (мы его захэшируем, конечно)
                $table->string('password');
                // Следующие 2 колонки не обязательны
                $table->string('fullname')->nullable();
                $table->string('email')->nullable();
                // Связь с таблицей группы пользователей (расскажу ниже)
                $table->foreignId('role_id')
                    ->constrained('user_roles')->onDelete('cascade');
                // Статус записи индексируется отдельно
                $table->boolean('active')->default(true)->index();
                $table->timestamps();
            }
        );

        // Таблица "сессий" пользователя
        $this->schema->create(
            'user_tokens',
            function (Blueprint $table) {
                // Здесь первичным ключом является строчный токен
                $table->string('token')->primary();
                // Свзяь с таблицей пользователей
                $table->foreignId('user_id')
                    ->constrained('users')->onDelete('cascade');
                // Срок годности токена
                $table->timestamp('valid_till')->index();
                // Ip адрес пользователя
                $table->string('ip', 16)->nullable();
                // Статус записи
                $table->boolean('active')->default(true);
                $table->timestamps();

                // Комбинированный индекс для быстрого поиска 
                // активных токенов пользователя
                $table->index(['token', 'user_id', 'active']);
            }
        );
    }

    // Функция отката изменений
    public function down(): void
    {
        // Просто удаляем все 3 таблицы в обратном порядке
        $this->schema->drop('user_tokens');
        $this->schema->drop('users');
        $this->schema->drop('user_roles');
    }
}

• тип колонки BIGINT
• атрибутом UNSIGNED, то есть значение не может быть меньше 0 и это даёт возможность сохранять больше положительных значений - аж до 2*64 степени - 1
• ключ PRIMARY, то есть первичный уникальный
• и еще она AUTO_INCREMENT, то есть значения увеличиваются автоматически на 1 в каждой новой записи

$table->foreignId('role_id')
    ->constrained('user_roles')
    ->onUpdate('restrict')
    ->onDelete('cascade');

Сиды

<?php

use Phinx\Seed\AbstractSeed;
use App\Models\UserRole;

class UserRoles extends AbstractSeed
{
    public function run(): void
    {
        // Просто массив с группами
        $roles = [
            'Administrator' => [
                // И их правами
                'scope' => ['profile', 'users'],
            ],
            'User' => [
                'scope' => ['profile'],
            ],
        ];

        // Дальше проходим по массиву
        foreach ($roles as $title => $data) {
            // Если группы с таким нзавнием нет
            if (!$group = UserRole::query()->where('title', $title)->first()) {
                // То создаём
                $group = new UserRole(['title' => $title]);
            }
            // И обновляем ей свойства
            $group->fill($data);
            $group->save();
        }
    }
}

public function getDependencies(): array
{
    return ['UserRoles'];
}

Заключение