Веб-сервисы на PHP: от простого REST к сложным интеграциям

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

Пример 1: REST API с аутентификацией JWT на Slim

Установите пакет firebase/php-jwt и создайте middleware.

composer require firebase/php-jwt

<?php
// middleware/AuthMiddleware.php
namespace App\Middleware;

use Firebase\JWT\JWT;
use Firebase\JWT\Key;
use Psr\Http\Message\ServerRequestInterface as Request;
use Psr\Http\Server\RequestHandlerInterface as Handler;
use Slim\Psr7\Response;

class AuthMiddleware
{
    private $secretKey = 'your-secret-key-here';

    public function __invoke(Request $request, Handler $handler): Response
    {
        $authHeader = $request->getHeaderLine('Authorization');
        if (empty($authHeader) || !str_starts_with($authHeader, 'Bearer ')) {
            $response = new Response();
            $response->getBody()->write(json_encode(['error' => 'Unauthorized']));
            return $response->withStatus(401)->withHeader('Content-Type', 'application/json');
        }

        $token = substr($authHeader, 7);
        try {
            $decoded = JWT::decode($token, new Key($this->secretKey, 'HS256'));
            $request = $request->withAttribute('user_id', $decoded->sub);
            return $handler->handle($request);
        } catch (\Exception $e) {
            $response = new Response();
            $response->getBody()->write(json_encode(['error' => 'Token invalid']));
            return $response->withStatus(401)->withHeader('Content-Type', 'application/json');
        }
    }
}

Примените middleware к защищённым маршрутам:

$app->get('/api/profile', function ($request, $response) {
    $userId = $request->getAttribute('user_id');
    // ... получение данных пользователя
    $data = ['id' => $userId, 'name' => 'John'];
    $response->getBody()->write(json_encode($data));
    return $response->withHeader('Content-Type', 'application/json');
})->add(new \App\Middleware\AuthMiddleware());

Результат GET-запроса с неправильным токеном:

{"error":"Token invalid"}

Пример 2: Обработка входящих JSON-данных в чистом PHP

Создайте эндпоинт для создания пользователя:

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST' && $_SERVER['REQUEST_URI'] === '/api/users') {
    $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;
    }
    $name = isset($input['name']) ? trim($input['name']) : '';
    if (empty($name)) {
        http_response_code(422);
        echo json_encode(['error' => 'Name is required']);
        exit;
    }
    // Сохранение в БД (пример с PDO)
    $pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '');
    $stmt = $pdo->prepare('INSERT INTO users (name) VALUES (:name)');
    $stmt->execute(['name' => $name]);
    $id = $pdo->lastInsertId();
    http_response_code(201);
    echo json_encode(['id' => $id, 'name' => $name]);
}

Отправка запроса через curl:

curl -X POST http://localhost:8080/api/users -H "Content-Type: application/json" -d '{"name":"Alice"}'
{"id":1,"name":"Alice"}

Пример 3: Веб-сервис с передачей файлов через multipart/form-data

Используем микрофреймворк Slim для загрузки изображения.

$app->post('/api/upload', function (Request $request, Response $response) {
    $uploadedFiles = $request->getUploadedFiles();
    if (empty($uploadedFiles['avatar'])) {
        $response->getBody()->write(json_encode(['error' => 'No file uploaded']));
        return $response->withStatus(400)->withHeader('Content-Type', 'application/json');
    }
    $avatar = $uploadedFiles['avatar'];
    if ($avatar->getError() !== UPLOAD_ERR_OK) {
        $response->getBody()->write(json_encode(['error' => 'Upload failed']));
        return $response->withStatus(500)->withHeader('Content-Type', 'application/json');
    }
    $newFilename = uniqid() . '-' . $avatar->getClientFilename();
    $avatar->moveTo('uploads/' . $newFilename);
    $response->getBody()->write(json_encode(['filename' => $newFilename]));
    return $response->withHeader('Content-Type', 'application/json');
});

Проверка через curl:

curl -X POST -F "avatar=@/path/to/photo.jpg" http://localhost:8080/api/upload
{"filename":"657f3a2b1c0d4-photo.jpg"}

Пример 4: Веб-сервис с графическим интерфейсом (RAML/OpenAPI)

Генерация документации с помощью swagger-php.

composer require zircote/swagger-php

Добавьте аннотации к контроллеру:

/**
 * @OA\Get(
 *     path="/api/status",
 *     @OA\Response(response="200", description="Returns server status")
 * )
 */
public function status() { ... }

Генерация спецификации:

vendor/bin/openapi --output public/swagger.json src/