Действия (Actions) средствами PHP для обработки запросов

Расширенные примеры работы с действиями в PHP

Invokable action с PSR-7 и DI-контейнером

// src/Action/CreateUserAction.php
use Psr\Http\Message\ServerRequestInterface as Request;
use Psr\Http\Message\ResponseInterface as Response;

class CreateUserAction {
    public function __construct(
        private UserService $userService,
        private Validator $validator
    ) {}

    public function __invoke(Request $request, Response $response, array $args): Response {
        $data = $request->getParsedBody();
        $errors = $this->validator->validate($data, [
            'email' => 'required|email',
            'password' => 'required|min:8'
        ]);

        if ($errors) {
            $response->getBody()->write(json_encode(['errors' => $errors]));
            return $response->withStatus(422)->withHeader('Content-Type', 'application/json');
        }

        $user = $this->userService->register($data);
        $response->getBody()->write(json_encode(['id' => $user->getId()]));
        return $response->withStatus(201)->withHeader('Content-Type', 'application/json');
    }
}

// Загрузка в роутере (Slim 4)
$container->set(CreateUserAction::class, function ($c) {
    return new CreateUserAction(
        $c->get(UserService::class),
        $c->get(Validator::class)
    );
});
$app->post('/users', CreateUserAction::class);

Пример ответа:
HTTP/1.1 201 Created
Content-Type: application/json
{"id":42}

В этом примере действие получает PSR-7 запрос и ответ, выполняет валидацию и возвращает JSON. Контейнер явно настраивает создание действия, что позволяет легко подменять зависимости в тестах.

Действие как middleware (промежуточное ПО)

// src/Action/AuthMiddleware.php
class AuthMiddleware {
    public function __construct(private TokenService $tokenService) {}

    public function __invoke(Request $request, RequestHandler $handler): Response {
        $token = $request->getHeaderLine('Authorization');
        if (!$this->tokenService->isValid($token)) {
            $response = new Response(401);
            $response->getBody()->write('Unauthorized');
            return $response;
        }
        return $handler->handle($request->withAttribute('user_id', $this->tokenService->getUserId($token)));
    }
}

Invokable класс может выступать в роли middleware, что позволяет строить цепочки обработки запроса. Это нестандартное использование, но в некоторых архитектурах (например, в Slim 4) middleware и action это одно и то же.

Действие в виде callable для фильтрации данных

$cleanData = array_filter($inputData, new class (2) {
    private int $minLength;
    public function __construct(int $minLength) {
        $this->minLength = $minLength;
    }
    public function __invoke($item): bool {
        return strlen($item) >= $this->minLength;
    }
});

Этот пример показывает, как invokable класс может быть использован не только в веб-обработке, но и в обычном коде для array_filter. Класс захватывает параметр $minLength и действует как предикат.

Действие как обработчик событий

// src/Listener/UserRegisteredListener.php
class UserRegisteredListener {
    public function __construct(private Logger $logger) {}
    public function __invoke(UserRegisteredEvent $event): void {
        $this->logger->info('User registered: ' . $event->getUserId());
    }
}

В событийно-ориентированных системах (например, Symfony Event Dispatcher) обработчики событий часто реализуются как invokable объекты. Это дает возможность легко подключать логирование, уведомления и другие действия.