Действия API в PHP: от простого switch до фреймворков

Пример 1: Роутер с поддержкой middleware (аутентификация)

// Middleware для проверки токена
class AuthMiddleware {
    public function __invoke($request, $handler) {
        $authHeader = $request->getHeaderLine('Authorization');
        if (strpos($authHeader, 'Bearer ') !== 0) {
            $response = new Response(401);
            $response->getBody()->write(json_encode(['error' => 'Unauthorized']));
            return $response->withHeader('Content-Type', 'application/json');
        }
        $token = substr($authHeader, 7);
        // проверка токена...
        $request = $request->withAttribute('user_id', 1);
        return $handler->handle($request);
    }
}

// Применение в Slim
$app->group('/api', function ($group) {
    $group->get('/users', 'UserController:index');
    $group->post('/users', 'UserController:store');
})->add(new AuthMiddleware());
  

Результат: при запросе без токена возвращается 401 Unauthorized; с валидным токеном - нормальный ответ.
  

Пояснение: middleware оборачивает обработку запроса, добавляя проверку аутентификации. Это позволяет отделить общую логику от действий контроллера.

Пример 2: Использование PSR-15 RequestHandler (нативный PHP)

use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\RequestHandlerInterface;
use Zend\Diactoros\ServerRequestFactory;

class UserHandler implements RequestHandlerInterface {
    public function handle(ServerRequestInterface $request): ResponseInterface {
        $method = $request->getMethod();
        $path = $request->getUri()->getPath();
        if ($method === 'GET' && $path === '/users') {
            $data = getUsers(); // функция из БД
            $response = new Response(200);
            $response->getBody()->write(json_encode($data));
            return $response->withHeader('Content-Type', 'application/json');
        }
        if ($method === 'POST' && $path === '/users') {
            $body = $request->getBody()->getContents();
            $user = json_decode($body, true);
            $id = createUser($user);
            $response = new Response(201);
            $response->getBody()->write(json_encode(['id' => $id]));
            return $response;
        }
        return new Response(404);
    }
}

$request = ServerRequestFactory::fromGlobals();
$handler = new UserHandler();
$response = $handler->handle($request);
// отправка ответа
  

Результат: GET /users возвращает список, POST /users создает нового пользователя. Другие методы или пути дают 404.
  

Пояснение: данный пример демонстрирует полную реализацию на основе стандартов PSR-7/15 без фреймворка. Требуются библиотеки diactoros и http-response. Проблемы: необходимо самостоятельно реализовывать роутинг, обработку ошибок, CORS.

Пример 3: Действия через регулярные выражения и callable

class Router {
    protected $routes = [];

    public function add($method, $pattern, callable $handler) {
        $this->routes[] = ['method' => $method, 'pattern' => $pattern, 'handler' => $handler];
    }

    public function dispatch($method, $uri) {
        foreach ($this->routes as $route) {
            if ($route['method'] !== $method) continue;
            if (preg_match($route['pattern'], $uri, $matches)) {
                $params = array_slice($matches, 1);
                return call_user_func_array($route['handler'], $params);
            }
        }
        throw new \Exception('Route not found', 404);
    }
}

$router = new Router();
$router->add('GET', '#^/users/(\d+)$#', function($id) {
    return json_encode(['user_id' => $id]);
});
$router->add('POST', '#^/users$#', function() {
    $input = json_decode(file_get_contents('php://input'), true);
    return json_encode(['created' => $input['name']]);
});

try {
    echo $router->dispatch($_SERVER['REQUEST_METHOD'], parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));
} catch (\Exception $e) {
    http_response_code($e->getCode());
    echo json_encode(['error' => $e->getMessage()]);
}
  

Пример запроса: GET /users/42 -> {"user_id":42}
POST /users с body {"name":"Alice"} -> {"created":"Alice"}
  

Пояснение: простой самописный роутер с замыканиями. Подходит для понимания маршрутизации. Недостатки: нет поддержки параметров по умолчанию, сложно добавить middleware.

Пример 4: Группировка действий через именованные контроллеры (на Laravel-стиль)

class UserController {
    public function index() { /* GET /users */ }
    public function store() { /* POST /users */ }
    public function show($id) { /* GET /users/{id} */ }
    public function update($id) { /* PUT /users/{id} */ }
    public function destroy($id) { /* DELETE /users/{id} */ }
}

// Регистрация через reflection
$controller = new UserController();
$method = $_SERVER['REQUEST_METHOD'];
$uri = $_SERVER['REQUEST_URI'];
// ... логика определения метода и параметров
$reflection = new ReflectionMethod($controller, $method);
if ($reflection->getNumberOfRequiredParameters() > 0) {
    $id = getPathVariable($uri); // вытаскиваем id
    echo $controller->$method($id);
} else {
    echo $controller->$method();
}
  

Результат: при обращении к /users/7 методом DELETE вызовется UserController::destroy(7).
  

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