Если вы разрабатываете интернет-магазин на Yii2, рано или поздно придётся сделать удобную админку для управления заказами. Без неё менеджеры не смогут менять статусы, искать заказы или просматривать детали. В этой статье я покажу, как быстро собрать такую панель с помощью встроенного генератора Gii и доработать её под реальные задачи. Опытные разработчики найдут здесь практические советы по кастомизации, а новички — пошаговый план действий.
Зачем вообще нужна админка для заказов
Представьте: клиенты оформляют заказы, а вы смотрите в базу данных и вручную меняете статусы через SQL. Согласитесь, неудобно. Админ-панель решает три задачи: просмотр списка заказов с фильтрами, редактирование деталей (статус, комментарий, данные клиента) и быстрые действия (например, подтвердить оплату). Yii2 предоставляет готовые инструменты, которые экономят дни работы.
Создаём модель и CRUD с помощью Gii
Начнём с базы. Убедитесь, что в базе есть таблица orders с полями: id, customer_name, total, status, created_at. Если таблицы нет — создайте миграцию или добавьте вручную. Дальше используем Gii — встроенный генератор кода Yii2. Зайдите в админку Gii (обычно по адресу /gii) и сгенерируйте модель Orders из таблицы orders. Затем сгенерируйте CRUD для этой модели. Gii создаст контроллер, представления и модель поиска. Это уже 80% работы.
После генерации проверьте, что в модели Orders есть правила валидации для всех полей. Например, status должен быть целым числом или строкой из списка. Вот пример:
public function rules()
{
return [
[['customer_name', 'total', 'status'], 'required'],
[['total'], 'number'],
[['status'], 'in', 'range' => [0, 1, 2]], // 0 - новый, 1 - оплачен, 2 - отправлен
[['created_at'], 'safe'],
];
}
Настраиваем контроллер и представления
Сгенерированный контроллер OrdersController уже содержит действия index, view, create, update, delete. Но для админки обычно нужно ограничить доступ. Добавьте поведение AccessControl в контроллер, чтобы только авторизованные пользователи с ролью администратора могли управлять заказами. Пример:
use yii\filters\AccessControl;
public function behaviors()
{
return [
'access' => [
'class' => AccessControl::class,
'rules' => [
[
'allow' => true,
'roles' => ['@'], // только авторизованные
],
],
],
];
}
В представлении index.php добавьте удобные фильтры. Gii уже создал GridView с поиском по всем полям. Но часто нужно фильтровать по статусу и дате. В модели поиска OrdersSearch добавьте правила для фильтрации по диапазону дат. Например, так:
// в OrdersSearch.php
public $date_from;
public $date_to;
public function rules()
{
return [
[['id', 'status'], 'integer'],
[['customer_name', 'created_at', 'date_from', 'date_to'], 'safe'],
];
}
public function search($params)
{
$query = Orders::find();
$dataProvider = new ActiveDataProvider(['query' => $query]);
$this->load($params);
if (!$this->validate()) {
return $dataProvider;
}
$query->andFilterWhere(['id' => $this->id])
->andFilterWhere(['status' => $this->status])
->andFilterWhere(['like', 'customer_name', $this->customer_name]);
if ($this->date_from) {
$query->andWhere(['>=', 'created_at', $this->date_from]);
}
if ($this->date_to) {
$query->andWhere(['<=', 'created_at', $this->date_to]);
}
return $dataProvider;
}
Теперь в представлении добавьте поля для ввода дат. Это можно сделать через ActiveForm или просто HTML-инпуты. Не забудьте подключить DatePicker, если хотите красивый календарь.
Добавляем быстрые действия и кастомизацию
Менеджерам часто нужно менять статус заказа в один клик. Сделаем кнопки в колонке действий GridView. Например, кнопку "Подтвердить оплату", которая меняет статус на "оплачен". Для этого создайте отдельное действие в контроллере:
public function actionConfirm($id)
{
$model = $this->findModel($id);
$model->status = 1; // оплачен
if ($model->save(false)) {
Yii::$app->session->setFlash('success', 'Заказ подтверждён');
}
return $this->redirect(['index']);
}
В GridView добавьте кнопку:
[
'class' => 'yii\grid\ActionColumn',
'template' => '{view} {update} {confirm}',
'buttons' => [
'confirm' => function ($url, $model) {
return Html::a('Подтвердить', ['confirm', 'id' => $model->id], [
'class' => 'btn btn-xs btn-success',
'data-confirm' => 'Вы уверены?',
'data-method' => 'post',
]);
},
],
],
Не забудьте защитить действие от CSRF-атак — используйте POST-запросы (как в примере с data-method="post").
Полезные лайфхаки для админки заказов
Вот несколько приёмов, которые сэкономят время и нервы:
- Используйте
beforeActionдля проверки прав. Если у вас несколько ролей, настройте RBAC и проверяйте доступ к действиям. - Добавьте экспорт в CSV. Менеджеры любят выгружать заказы в Excel. Yii2 имеет готовые расширения, например,
kartik-v/yii2-gridс экспортом. - Логируйте изменения статусов. Создайте отдельную таблицу
order_logsи записывайте туда, кто и когда изменил статус. Это поможет разбираться в спорных ситуациях. - Кешируйте тяжёлые запросы. Если заказов много,
GridViewможет тормозить. Используйтеyii\data\ActiveDataProviderс пагинацией и не забывайте про индексы в базе.
Сравним основные подходы к созданию админки:
| Подход | Плюсы | Минусы |
|---|---|---|
| Генератор Gii | Быстро, стандартный код, легко доработать | Может быть избыточным для простых задач |
| Ручное написание CRUD | Полный контроль, минимальный код | Дольше, можно допустить ошибки |
| Готовые расширения (например, yii2-admin) | Много функций из коробки | Нужно адаптировать под свои модели |
Что в итоге
Создание админ-панели для заказов на Yii2 — задача, которая решается за пару часов с помощью Gii и небольшой доработки. Главное — сразу продумать права доступа, удобные фильтры и быстрые действия. Не бойтесь кастомизировать сгенерированный код: Yii2 гибок и позволяет легко добавлять свои фичи. Надеюсь, этот гайд поможет вам сделать админку, которой будет удобно пользоваться каждый день.

