Если вы разрабатываете интернет-магазин на Yii2, рано или поздно придётся сделать удобную админку для управления заказами. Без неё менеджеры не смогут менять статусы, искать заказы или просматривать детали. В этой статье я покажу, как быстро собрать такую панель с помощью встроенного генератора Gii и доработать её под реальные задачи. Опытные разработчики найдут здесь практические советы по кастомизации, а новички — пошаговый план действий.

Digital-студия WNDER

Зачем вообще нужна админка для заказов

Представьте: клиенты оформляют заказы, а вы смотрите в базу данных и вручную меняете статусы через 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").

Правило: Всегда используйте POST для действий, изменяющих данные. Это защитит от случайных переходов по ссылкам и CSRF.

Полезные лайфхаки для админки заказов

Вот несколько приёмов, которые сэкономят время и нервы:

  • Используйте beforeAction для проверки прав. Если у вас несколько ролей, настройте RBAC и проверяйте доступ к действиям.
  • Добавьте экспорт в CSV. Менеджеры любят выгружать заказы в Excel. Yii2 имеет готовые расширения, например, kartik-v/yii2-grid с экспортом.
  • Логируйте изменения статусов. Создайте отдельную таблицу order_logs и записывайте туда, кто и когда изменил статус. Это поможет разбираться в спорных ситуациях.
  • Кешируйте тяжёлые запросы. Если заказов много, GridView может тормозить. Используйте yii\data\ActiveDataProvider с пагинацией и не забывайте про индексы в базе.

Сравним основные подходы к созданию админки:

Подход Плюсы Минусы
Генератор Gii Быстро, стандартный код, легко доработать Может быть избыточным для простых задач
Ручное написание CRUD Полный контроль, минимальный код Дольше, можно допустить ошибки
Готовые расширения (например, yii2-admin) Много функций из коробки Нужно адаптировать под свои модели

Что в итоге

Создание админ-панели для заказов на Yii2 — задача, которая решается за пару часов с помощью Gii и небольшой доработки. Главное — сразу продумать права доступа, удобные фильтры и быстрые действия. Не бойтесь кастомизировать сгенерированный код: Yii2 гибок и позволяет легко добавлять свои фичи. Надеюсь, этот гайд поможет вам сделать админку, которой будет удобно пользоваться каждый день.

Студия WNDER