Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Схема PHP: Eloquent (ORM)

Для изменения структуры базы данных Eloquent использует специальный язык, который абстрагирует нас от специфики конкретной СУБД. Он позволяет создавать и менять таблицы, не опираясь на SQL синтаксис конкретной базы данных.

Для создания таблицы используется метод create($name, $fn), где первый параметр это имя таблицы, второй – функция, внутри которой определяется её структура.

<?php

Capsule::schema()->create('users', function (Blueprint $table) {
    $table->id();
    $table->string('email')->unique();
    $table->string('first_name');
    $table->string('password');
    $table->string('last_name');
    $table->timestamps();
});

В Eloquent используется соглашение, что имя таблицы это имя сущности, записанное строчными буквами во множественном числе. Только в таком случае Eloquent сможет автоматически связать класс с таблицей. Вот некоторые примеры:

Класс Таблица
User users
Article articles
ArticleLike article_likes

Из последнего примера видно, что имя класса состоящее из нескольких слов, меняет свой формат с CamelCase на snake_case.

Структура таблицы описывается в анонимной функции, в которую передаётся объект $table. Этот объект содержит множество методов, каждый из которых его меняет. Затем, Eloquent использует этот объект для генерации правильного SQL-запроса.

Метод Описание
id() Автоинкрементируемый первичный ключ типа эквивалентного UNSIGNED BIGINT
bigInteger($userId) Эквивалент BIGINT
boolean($name) Эквивалент BOOLEAN
string($name, $length) Эквивалент VARCHAR соответствующей длины

По умолчанию поля создаются как not null.

Здесь приведена лишь малая часть того, что умеет делать Eloquent. За описанием остальных методов, лучше обратиться к официальной документации.

Отдельно стоит выделить метод $table->timestamps(), добавляющий в таблицу два поля: updated_at и created_at. ORM автоматически изменяет эти поля, записывая в них дату создания и обновления сущности. Это довольно удобное соглашение, которое принято во многих фреймворках на разных языках.

В дополнение к типам колонок перечисленным выше, Eloquent предоставляет методы-модификаторы, которые можно использовать во время создания таблиц. Например, модификатор nullable() убирает ограничение not null.

<?php

Schema::table('users', function (Blueprint $table) {
    $table->string('email')->nullable();
    $table->integer('friends_count')->default(0);
});
Метод Описание
nullable Позволяет использовать NULL как значение
default($value) Задаёт значение по умолчанию
useCurrent Для колонок типа TIMESTAMP устанавливает значение по умолчанию, равное CURRENT_TIMESTAMP

Ещё из полезного — это создание индексов. Самый распространённый случай – добавление уникального индекса на такие поля как email:

<?php

Schema::table('users', function (Blueprint $table) {
    $table->string('email')->unique();
});

Кроме уникального индекса существует несколько других, которые нужны для поддержания целостности данных или для ускорения доступа. Подробнее о них в курсах по SQL.


Самостоятельная работа

  1. Откройте и изучите файл src/config/schema.php. Обратите внимание на проверку hasTable, она нужна для обеспечения идемпотентности.

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты

Для полного доступа к курсу нужен базовый план

Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.

Получить доступ
1000
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно

  • 130 курсов, 2000+ часов теории
  • 1000 практических заданий в браузере
  • 360 000 студентов
Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff
Рекомендуемые программы
профессия
Занимайтесь созданием сайтов, веб-приложений, сервисов и их интеграцией с внутренними бизнес-системами на бекенд-языке PHP
10 месяцев
с нуля
Старт 28 ноября

Используйте Хекслет по-максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Отправляя форму, вы принимаете «Соглашение об обработке персональных данных» и условия «Оферты», а также соглашаетесь с «Условиями использования»