PHP: Eloquent (ORM)
2026-02-26 18:59 Diff
https://ru.hexlet.io/courses/php-orm-eloquent/lessons/schema/theory_unit

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

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

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

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

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

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

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

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

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

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

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