Как работает action в Yii2?

Как работает действие (Action) в Yii2

Action (Действие) — это фундаментальная концепция Yii2, представляющая собой отдельную единицу логики, обрабатывающую HTTP-запрос. Каждое действие ассоциировано с контроллером и отвечает за обработку конкретного запроса, возвращая ответ пользователю.

Основные принципы работы

1. Маршрутизация и вызов действия При поступлении запроса Yii2 парсит URL для определения маршрута (например, site/index). Роутер находит соответствующий контроллер и действие, затем вызывает метод runAction():

   // Пример маршрута, ведущего к SiteController::actionIndex()
   // URL: /site/index
   
   class SiteController extends \yii\web\Controller
   {
       public function actionIndex()
       {
           return $this->render('index');
       }
   }
   

2. Создание и конфигурация действий Действия могут быть объявлены как inline-действия (методы контроллера) или как отдельные классы. Отдельные классы действий полезны для повторного использования логики:

   // Inline-действие
   public function actionView($id) { /* ... */ }
   
   // Отдельный класс действия
   class UpdateAction extends \yii\base\Action
   {
       public $modelClass;
       
       public function run($id)
       {
           $model = $this->findModel($id);
           // ... логика обновления
       }
   }
   
   // Подключение в контроллере
   public function actions()
   {
       return [
           'update' => UpdateAction::class,
       ];
   }
   

3. Жизненный цикл выполнения При вызове действия происходит:

   • Проверка прав доступа (beforeAction())
   • Выполнение основной логики (run() или метод действия)
   • Завершающие операции (afterAction())

   class BaseController extends Controller
   {
       public function beforeAction($action)
       {
           if (!parent::beforeAction($action)) {
               return false; // Прерываем выполнение
           }
           // Общая логика для всех действий
           return true;
       }
   }
   

Ключевые аспекты работы действий

Параметры действия Действия могут принимать параметры из запроса, которые автоматически инжектируются через аргументы метода или свойства класса:

// Автоматическое связывание параметров
public function actionUpdate($id, $category = null)
{
    // $id получит значение из $_GET['id']
    // $category получит $_GET['category'] или null
}

Типы ответов Действие может возвращать различные типы ответов:

public function actionData()
{
    // Рендеринг шаблона
    return $this->render('view', ['data' => $data]);
    
    // JSON-ответ
    return $this->asJson(['status' => 'success']);
    
    // Перенаправление
    return $this->redirect(['site/index']);
    
    // Сырые данные
    return 'Hello World';
}

Фильтры и поведение Действия могут быть обернуты в фильтры для реализации сквозной функциональности:

public function behaviors()
{
    return [
        'access' => [
            'class' => AccessControl::class,
            'only' => ['update', 'delete'],
            'rules' => [
                ['allow' => true, 'roles' => ['@']],
            ],
        ],
        'cache' => [
            'class' => PageCache::class,
            'only' => ['index'],
            'duration' => 60,
        ],
    ];
}

Стандартные действия и REST

В Yii2 предусмотрены встроенные действия для CRUD-операций и RESTful API:

// Использование CRUD-действий в REST-контроллере
class UserController extends \yii\rest\ActiveController
{
    public $modelClass = 'app\models\User';
    
    public function actions()
    {
        return [
            'index' => [
                'class' => 'yii\rest\IndexAction',
                'modelClass' => $this->modelClass,
            ],
            'view' => [
                'class' => 'yii\rest\ViewAction',
                'modelClass' => $this->modelClass,
            ],
        ];
    }
}

Производительность и лучшие практики

1. Минимизация логики в действиях — основную бизнес-логику следует выносить в сервисные классы
2. Использование отдельных классов действий для сложной повторяющейся логики
3. Корректная обработка исключений через try-catch или обработчики ошибок Yii2
4. Оптимизация запросов к БД через eager loading и кэширование

Расширение функциональности

Действия можно расширять через события и поведения:

class LogAction extends Action
{
    public function run()
    {
        $this->trigger(ActionEvent::BEFORE_RUN);
        $result = parent::run();
        $this->trigger(ActionEvent::AFTER_RUN);
        return $result;
    }
}

Action в Yii2 — это гибкий и мощный механизм для организации endpoint'ов приложения, который обеспечивает четкое разделение ответственности, поддерживает повторное использование кода и предоставляет множество точек расширения для реализации сложной бизнес-логики.