Как организовать модели данных и административный интерфейс в Yii
Как организовать модели данных и административный интерфейс в Yii — вопрос не про то, где нажать кнопку генератора CRUD, а про границы ответственности. Фреймворк даёт ActiveRecord, миграции, формы, виджеты таблиц и механизмы доступа, но порядок в проекте появляется только тогда, когда у каждой части есть понятная роль.
Ниже — практическая схема для команды, которая развивает админку на Yii. Она не привязана к конкретной версии фреймворка: названия классов и настройки могут отличаться, поэтому спорные места сверяйте с официальной документацией Yii и принятыми в проекте соглашениями.
Главная идея проста: сначала опишите предметную область и сценарии, затем соберите под них модели, миграции и экраны. Админка не должна быть копией всех таблиц базы — она должна помогать сотрудникам выполнять конкретные операции.
Модели данных и административный интерфейс в Yii: границы слоёв
Начать стоит с карты сущностей. Выпишите, какие объекты есть в проекте: заказы, статьи, пользователи, тарифы, заявки, справочники. Для каждой сущности отметьте жизненный цикл: создание, редактирование, публикация, архивирование, удаление. Это поможет понять, где нужна отдельная модель, а где достаточно справочника или вычисляемого представления.
В Yii удобно опираться на несколько слоёв. ActiveRecord отвечает за хранение и базовые связи, form model — за ввод и валидацию, сервисный слой — за операции, которые затрагивают несколько сущностей, а контроллер и представление — за экран и навигацию. Не обязательно вводить все слои сразу: для небольшого проекта часть из них может быть совмещена. Важно, чтобы смешение было осознанным, а не случайным.
| Слой | Задача | Что хранить | Чего избегать |
|---|---|---|---|
| ActiveRecord / сущность | Представление записи и базовые связи | Поля таблицы, простые правила, связи | Сложные сценарии, обращения к внешним API, права доступа |
| Form model | Ввод и валидация данных из формы | Правила валидации, сценарии создания и редактирования | Прямые SQL-запросы и бизнес-логика на несколько сущностей |
| Service / use case | Операции, которые меняют несколько сущностей | Порядок действий, транзакции, проверки | HTML, вывод, привязка к конкретному экрану |
| Admin controller / view | Экран, фильтры, действия | Навигация, таблицы, кнопки, права на действие | Валидация и бизнес-правила в шаблоне |
Таблица показывает не обязательную иерархию, а ориентир. Если модель одновременно валидирует форму, отправляет письма, проверяет права и рисует таблицу, её будет трудно менять. Если же разнести эти задачи, админка становится предсказуемее: ошибки локализуются, а новые сценарии не ломают старые.
- Какие сущности действительно самостоятельны, а какие являются справочниками или агрегатами.
- Какие связи обязательны, а какие нужны только для отчётов и редких проверок.
- Где заканчивается редактирование записи и начинается бизнес-операция со статусами и уведомлениями.
- Какие данные нельзя удалять физически, потому что на них ссылаются другие сущности.
- Какие действия должны быть доступны разным ролям, а какие стоит оставить только администратору.
Практический ориентир. Начните с 5–7 главных сущностей и их жизненного цикла. Если сущность нужна только для одного отчёта, возможно, это не отдельная модель, а представление или запрос. Такой подход помогает не раздувать схему раньше времени.
Ещё один практический приём — договориться о naming convention. Имена таблиц, моделей, форм и контроллеров должны читаться без догадок. Если сущность называется Article, то форма редактирования может называться ArticleForm, а админ-контроллер — AdminArticleController. Это не диктует фреймворк, но снижает когнитивную нагрузку.
Миграции, связи и валидация: фундамент без сюрпризов
Схему базы лучше вести через миграции. Тогда история изменений хранится в репозитории, а развёртывание на другом окружении не зависит от ручных действий. В миграциях описывайте таблицы, индексы и внешние ключи; наполнение справочников лучше выносить в отдельные seed-миграции или команды, чтобы не смешивать структуру и данные.
Связи в ActiveRecord стоит описывать явно: какие связи нужны для списка, какие — для карточки, где требуется промежуточная таблица. Если в админке часто показываются связанные записи, проверьте, не возникает ли N+1 запросов. Жадная загрузка и продуманные выборки обычно полезнее, чем попытка «оптимизировать» всё после запуска.
Валидация должна жить там, где принимается решение о корректности данных. Простые правила полей можно держать в модели или форме, сложные проверки — в сервисе. Важно не оставлять проверки только в JavaScript: браузерная валидация удобна для пользователя, но не заменяет серверную.
Осторожно с ручными правками. Если менять схему напрямую в базе, миграции перестают быть источником правды. На production такие действия требуют регламента, резервной копии и проверки на тестовой среде. Иначе следующее развёртывание может неожиданно расойтись с реальным состоянием базы.
Если проект растёт, полезно заранее договориться о резервных копиях, мониторинге медленных запросов и регламенте изменений. Подробнее о сопровождении хранилищ и производительности запросов — в материале «Администрирование баз данных: сопровождение хранилищ данных, резервных копий и производительности запросов».
Отдельно стоит продумать удаление. Физическое удаление подходит не для всех сущностей: иногда нужен архив или мягкое удаление, чтобы сохранить историю и не ломать связи. Это решение принимается по сценариям, а не по привычке.
Админ-интерфейс: сценарии вместо автоматического CRUD
Сгенерированный CRUD-экран удобен как заготовка, но редко остаётся удобным рабочим инструментом. Сотруднику важны не все поля таблицы, а конкретные действия: найти заявку, изменить статус, добавить комментарий, отправить на проверку, выгрузить список. Поэтому админку лучше проектировать от сценариев.
Разделите экраны на список и карточку. В списке обычно нужны фильтры, поиск, сортировка, пагинация и массовые действия. В карточке — поля, связи, история изменений и кнопки переходов. Если сущность сложная, можно сделать несколько карточек или вкладок под разные роли, но не стоит прятать важные действия в глубину меню.
- Опишите роль сотрудника и задачу, с которой он приходит в админку.
- Выберите минимальный набор полей для списка и карточки.
- Добавьте фильтры и поиск по тем признакам, которыми реально пользуются.
- Определите массовые действия и проверьте, безопасны ли они для выбранных записей.
- Предусмотрите историю изменений и понятные сообщения об ошибках.
В Yii для таблиц и форм есть готовые виджеты, которые ускоряют разработку. Но настройка отображения не должна превращаться в бизнес-логику: условия «показывать кнопку, если…» лучше выносить в политики доступа или сервисы. Тогда шаблон остаётся шаблоном, а правило можно протестировать отдельно.
Перед крупным обновлением зависимостей или модулей админки полезно иметь план: какие экраны затрагиваются, какие миграции нужны, что проверять после выката. Об этом — в статье «Как спланировать обновление сайта на Yii: зависимости, модули и резервная копия».
Доступы, аудит и порядок внедрения
Админка — это интерфейс с повышенными правами, поэтому доступы лучше настраивать с самого начала. Роли и разрешения удобно описывать через RBAC: например, роли «редактор», «модератор», «администратор» получают разные наборы действий. Принцип минимальных прав помогает снизить риск случайных изменений и упрощает проверку.
Проверяйте права не только на вход в раздел, но и на каждое действие: создание, редактирование, удаление, экспорт. Если в админке видны персональные данные, режим доступа, логирование и сроки хранения стоит сверить с требованиями, которые применимы к проекту. Это не универсальная настройка фреймворка, поэтому сомнительные случаи лучше согласовать с ответственным за данные и проверить в официальном источнике.
Аудит изменений полезен даже в небольшой команде. Запись о том, кто и когда изменил статус или важное поле, помогает разбирать инциденты. Не обязательно хранить полную историю всех полей: начните с ключевых сущностей и операций, которые действительно влияют на работу.
Порядок внедрения может быть таким. Сначала — карта сущностей и сценариев. Затем — миграции и модели с базовыми связями. После этого — формы и серверная валидация. Далее — экраны админки, фильтры и действия. В конце — роли, аудит, тестовые сценарии и резервное копирование. Такой порядок не догма, но он помогает не строить интерфейс поверх неясной модели данных.
Типичные ошибки похожи: одна модель отвечает за всё, валидация живёт в контроллере, шаблон знает слишком много о базе, а права проверяются только на входе в раздел. Исправлять это лучше постепенно: выделить форму, вынести повторяющуюся проверку, добавить политику доступа, закрыть опасное действие. Большие переделки без тестов и резервной копии повышают риск.
Частые вопросы
Нужно ли создавать отдельные модели для админки?
Не всегда. Для простых справочников достаточно ActiveRecord и аккуратно настроенных форм. Отдельные form models стоит вводить там, где сценарий создания или редактирования отличается от структуры таблицы: например, когда нужно загрузить файл, собрать данные из нескольких сущностей или проверить права. Админ-контроллеры при этом лучше держать отдельно от публичной части, чтобы не смешивать маршруты и доступы.
Как не превратить админку в хаос при росте проекта?
Помогает регулярная инвентаризация: список сущностей, ролей и сценариев, который команда пересматривает перед крупными изменениями. Держите схему в миграциях, валидацию — на сервере, права — в проверяемых правилах, а ключевые действия — в аудите. Если экран перестаёт соответствовать сценарию, его проще переделать, когда модель данных и доступы описаны явно.