Реализация обработки входящих запросов в PHP админпанели

Пример 1: Полная реализация роутера с регулярными выражениями

Роутер, который поддерживает параметры и проверку HTTP-методов.

<?php
class Router
{
    protected array $routes = [];

    public function add(string $pattern, $handler, array $methods = ['GET']): void
    {
        $this->routes[] = [
            'pattern' => $this->convertToRegex($pattern),
            'handler' => $handler,
            'methods' => $methods
        ];
    }

    private function convertToRegex(string $pattern): string
    {
        // {id} -> ([^/]+)
        $regex = preg_replace('/\{([a-zA-Z_]+)\}/', '([^/]+)', $pattern);
        return '#^' . $regex . '$#';
    }

    public function handle(ServerRequestInterface $request): void
    {
        $path = $request->getUri()->getPath();
        $method = $request->getMethod();
        foreach ($this->routes as $route) {
            if (preg_match($route['pattern'], $path, $matches) && in_array($method, $route['methods'])) {
                array_shift($matches); // удаляем полное совпадение
                // вызываем обработчик с параметрами
                $handler = $route['handler'];
                if (is_callable($handler)) {
                    call_user_func_array($handler, $matches);
                } elseif (is_string($handler)) {
                    // разбиваем Controller@method
                    list($class, $method) = explode('@', $handler);
                    $controller = new $class;
                    call_user_func_array([$controller, $method], $matches);
                }
                return;
            }
        }
        http_response_code(404);
        echo 'Route not found';
    }
}

// Использование
$router = new Router();
$router->add('/admin/users/{id}', 'UserController@show', ['GET']);
$router->add('/admin/users/{id}/edit', 'UserController@edit', ['GET', 'POST']);
$router->handle($request);

Результат: при запросе GET /admin/users/42 будет вызван UserController::show(42).

Пример 2: Обработка загрузки файлов в админке с валидацией

При загрузке аватаров или изображений через админку необходимо проверять тип, размер и перемещать файл.

// upload.php
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['avatar'])) {
    $file = $_FILES['avatar'];
    $allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];
    $maxSize = 2 * 1024 * 1024; // 2 MB
    $errors = [];
    
    if ($file['error'] !== UPLOAD_ERR_OK) {
        $errors[] = 'Ошибка загрузки файла.';
    }
    if (!in_array($file['type'], $allowedTypes)) {
        $errors[] = 'Допустимы только JPEG, PNG, GIF.';
    }
    if ($file['size'] > $maxSize) {
        $errors[] = 'Размер файла превышает 2 MB.';
    }
    
    if (empty($errors)) {
        $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
        $newName = uniqid('avatar_', true) . '.' . $ext;
        $destination = __DIR__ . '/uploads/' . $newName;
        if (move_uploaded_file($file['tmp_name'], $destination)) {
            // сохраняем путь в БД
            echo 'Файл загружен: ' . $newName;
        } else {
            echo 'Не удалось сохранить файл.';
        }
    } else {
        foreach ($errors as $error) {
            echo '<p class="error">' . htmlspecialchars($error) . '</p>';
        }
    }
}

Результат: при успешной загрузке выводится сообщение с именем файла; при ошибке – список ошибок.

Пример 3: Обработка AJAX-запросов в админке (JSON API)

Админка часто использует асинхронные запросы для обновления данных. Пример обработки POST с JSON:

// ajax_handler.php
header('Content-Type: application/json');
$input = json_decode(file_get_contents('php://input'), true);

if (json_last_error() !== JSON_ERROR_NONE) {
    http_response_code(400);
    echo json_encode(['error' => 'Invalid JSON']);
    exit;
}

$action = $input['action'] ?? '';
$data = $input['data'] ?? [];

// Валидация и выполнение
switch ($action) {
    case 'toggle_active':
        $userId = (int)$data['user_id'] ?? 0;
        // запрос к БД
        $result = ['success' => true, 'active' => !$oldActive];
        echo json_encode($result);
        break;
    default:
        http_response_code(400);
        echo json_encode(['error' => 'Unknown action']);
}

Пример ответа: {"success":true,"active":false}

Цель:

Пример 4: Middleware проверки прав доступа

Создадим простую прослойку, которая проверяет, авторизован ли пользователь и имеет ли роль admin.

// Middleware/AuthMiddleware.php
class AuthMiddleware
{
    public function handle(callable $next): void
    {
        session_start();
        if (!isset($_SESSION['user_id']) || $_SESSION['role'] !== 'admin') {
            http_response_code(401);
            echo 'Доступ запрещён';
            exit;
        }
        $next();
    }
}

// Применение в роутере
$middleware = new AuthMiddleware();
$handler = function() use ($router) {
    $router->handle($request);
};
$middleware->handle($handler);

Результат: если сессия не содержит admin роли, отдаётся 401 и сообщение.