Создание API на PHP с отдачей JSON: от простых решений до фреймворков

Расширенные примеры кода

Дополнительные примеры демонстрируют более сложные сценарии, такие как обработка запросов с параметрами, аутентификация и пагинация.

<?php
// index.php
header('Content-Type: application/json');
header('Access-Control-Allow-Origin: *');
header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE');
header('Access-Control-Allow-Headers: Content-Type');

$method = $_SERVER['REQUEST_METHOD'];
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$uri = rtrim($uri, '/');

// Роутер
$routes = [
    'GET' => [
        '/api/users' => 'getUsers',
        '/api/users/(\d+)' => 'getUser'
    ],
    'POST' => [
        '/api/users' => 'createUser'
    ]
];

$response = ['error' => 'Not Found'];
$status = 404;

foreach ($routes[$method] ?? [] as $pattern => $handler) {
    $regex = '#^' . $pattern . '$#';
    if (preg_match($regex, $uri, $matches)) {
        array_shift($matches); // удаляем полное совпадение
        $response = call_user_func_array($handler, $matches);
        $status = 200;
        break;
    }
}

http_response_code($status);
echo json_encode($response);

function getUsers() {
    return [
        ['id' => 1, 'name' => 'Alice'],
        ['id' => 2, 'name' => 'Bob']
    ];
}

function getUser($id) {
    // Имитация поиска
    return ['id' => (int)$id, 'name' => 'User' . $id];
}

function createUser() {
    $input = json_decode(file_get_contents('php://input'), true);
    if (empty($input['name'])) {
        http_response_code(400);
        return ['error' => 'Name is required'];
    }
    return ['id' => 3, 'name' => $input['name']];
}

$ curl -X POST http://localhost:8000/api/users -d '{"name":"Charlie"}' -H "Content-Type: application/json"
{"id":3,"name":"Charlie"}

Пояснение: реализован простой роутер с использованием регулярных выражений, поддержка CORS через заголовки, валидация входных данных через php://input и json_decode.

<?php
use Psr\Http\Message\ServerRequestInterface as Request;
use Psr\Http\Message\ResponseInterface as Response;
use Slim\Factory\AppFactory;
use Firebase\JWT\JWT;
use Firebase\JWT\Key;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();
$app->addErrorMiddleware(true, true, true);

$secretKey = 'mySecretKey123';

// Middleware для проверки токена
$authMiddleware = function (Request $request, $handler) use ($secretKey) {
    $authHeader = $request->getHeaderLine('Authorization');
    if (empty($authHeader) || !str_starts_with($authHeader, 'Bearer ')) {
        $response = new \Slim\Psr7\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($secretKey, 'HS256'));
        $request = $request->withAttribute('userId', $decoded->sub);
    } catch (\Exception $e) {
        $response = new \Slim\Psr7\Response();
        $response->getBody()->write(json_encode(['error' => 'Invalid token']));
        return $response->withStatus(401)->withHeader('Content-Type', 'application/json');
    }
    return $handler->handle($request);
};

// Маршрут для получения токена (логин)
$app->post('/api/login', function (Request $request, Response $response) use ($secretKey) {
    $body = $request->getParsedBody();
    $username = $body['username'] ?? '';
    $password = $body['password'] ?? '';
    // Проверка учетных данных (имитация)
    if ($username === 'admin' && $password === '123') {
        $payload = [
            'iss' => 'myapp',
            'sub' => 1,
            'iat' => time(),
            'exp' => time() + 3600
        ];
        $token = JWT::encode($payload, $secretKey, 'HS256');
        $response->getBody()->write(json_encode(['token' => $token]));
        return $response->withHeader('Content-Type', 'application/json');
    }
    $response->getBody()->write(json_encode(['error' => 'Invalid credentials']));
    return $response->withStatus(401)->withHeader('Content-Type', 'application/json');
});

// Защищенный маршрут
$app->get('/api/profile', function (Request $request, Response $response) {
    $userId = $request->getAttribute('userId');
    $response->getBody()->write(json_encode(['id' => $userId, 'name' => 'Admin']));
    return $response->withHeader('Content-Type', 'application/json');
})->add($authMiddleware);

$app->run();

$ curl -X POST http://localhost:8000/api/login -d "username=admin&password=123"
{"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."}
$ curl -H "Authorization: Bearer eyJ0eXAi..." http://localhost:8000/api/profile
{"id":1,"name":"Admin"}

Пояснение: используется библиотека firebase/php-jwt. Создан middleware для проверки Bearer-токена. Маршрут /api/login выдает токен после успешной аутентификации. Защищенный маршрут /api/profile требует валидного токена.

// routes/api.php
Route::get('/users', function (Request $request) {
    $query = App\Models\User::query();
    
    if ($request->has('name')) {
        $query->where('name', 'like', '%' . $request->name . '%');
    }
    if ($request->has('email')) {
        $query->where('email', $request->email);
    }
    
    $perPage = $request->get('per_page', 15);
    $users = $query->paginate($perPage);
    
    return UserResource::collection($users);
});

// UserResource.php
public function toArray($request)
{
    return [
        'id' => $this->id,
        'name' => $this->name,
        'email' => $this->email,
    ];
}

$ curl "http://localhost/api/users?name=Ali&per_page=5"
{
  "data": [
    {"id":1,"name":"Alice","email":"alice@example.com"},
    {"id":21,"name":"Alison","email":"alison@example.com"}
  ],
  "links": {
    "first": "http://localhost/api/users?name=Ali&page=1",
    "last": "http://localhost/api/users?name=Ali&page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "http://localhost/api/users",
    "per_page": 5,
    "to": 1,
    "total": 2
  }
}

Пояснение: в Laravel используется Query Builder с условными фильтрами. Метод paginate() автоматически добавляет пагинацию. UserResource трансформирует модели. Результат содержит метаданные пагинации.