Пример 1: JSON ответ с поддержкой JSONP и CORS

Сценарий: API эндпоинт, который может вызываться с другого домена. Если передан параметр callback, ответ оборачивается в функцию для JSONP. Добавляются CORS заголовки.

header('Access-Control-Allow-Origin: *');
header('Access-Control-Allow-Methods: GET');
header('Access-Control-Allow-Headers: Content-Type');

$data = ['name' => 'Иван', 'age' => 30];
$json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);

if (isset($_GET['callback'])) {
    $callback = $_GET['callback'];
    // проверка безопасности
    if (!preg_match('/^[a-zA-Z_$][0-9a-zA-Z_$]*$/', $callback)) {
        http_response_code(400);
        echo 'Invalid callback';
        exit;
    }
    header('Content-Type: application/javascript; charset=utf-8');
    echo $callback . '(' . $json . ');';
} else {
    header('Content-Type: application/json; charset=utf-8');
    echo $json;
}
exit;
  

Результат: При запросе /api.php?callback=myFunc заголовки будут:

HTTP/2 200
Access-Control-Allow-Origin: *
Content-Type: application/javascript; charset=utf-8

myFunc({"name":"Иван","age":30});
  

Пример 2: Потоковая передача большого файла с управлением памятью

Когда файл слишком велик для полного чтения в память, используется чтение по частям с fread() и сбросом буфера.

$file = '/var/logs/bigfile.log';
$filename = 'bigfile.log';

header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $filename . '"');
header('Content-Length: ' . filesize($file));

$handle = fopen($file, 'rb');
if ($handle) {
    while (!feof($handle)) {
        $chunk = fread($handle, 8192);
        echo $chunk;
        ob_flush();
        flush();
    }
    fclose($handle);
}
exit;
  

Результат: Файл будет отправлен клиенту частями, что снижает потребление памяти на сервере. Важно убедиться, что output_buffering отключён или настроен правильно.

Пример 3: Ответ с использованием PSR-7 Response и эмиттера

Современный подход через PSR-7 интерфейсы. Для примера используется библиотека nyholm/psr7 и эмиттер laminas/laminas-httphandlerrunner.

require 'vendor/autoload.php';

use Nyholm\Psr7\Response;
use Laminas\HttpHandlerRunner\Emitter\SapiEmitter;

$data = ['status' => 'ok', 'timestamp' => time()];
$body = json_encode($data, JSON_UNESCAPED_UNICODE);

$response = new Response(
    200,
    ['Content-Type' => 'application/json; charset=utf-8'],
    $body
);

$emitter = new SapiEmitter();
$emitter->emit($response);
  

Результат: Эмиттер отправляет заголовки и тело, используя стандартный SAPI. Этот код не зависит от глобальных функций и упрощает тестирование.

Пример 4: Ответ с ошибкой 500 и логированием

Если в скрипте возникает непредвиденная ситуация, следует вернуть правильный код ошибки и залогировать детали.

try {
    // опасная операция
    $result = someRiskyFunction();
    sendJsonResponse($result);
} catch (\Throwable $e) {
    error_log($e->getMessage() . ' in ' . $e->getFile() . ':' . $e->getLine());
    http_response_code(500);
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode(['error' => 'Внутренняя ошибка сервера']);
    exit;
}
  

Результат: Клиент получает HTTP 500 с JSON ошибкой, а разработчик видит детали в логах. Не следует раскрывать пользователю внутренние сообщения.

Пример 5: Отправка изображения из базы данных (BLOB)

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

$imageData = $db->query('SELECT data, mime_type FROM images WHERE id = ?', [$id])->fetchColumn();
if (!$imageData) {
    http_response_code(404);
    exit;
}

header('Content-Type: ' . $imageData['mime_type']);
header('Content-Length: ' . strlen($imageData['data']));
header('Cache-Control: public, max-age=86400');
echo $imageData['data'];
exit;
  

Результат: Браузер отображает изображение, если mime_type корректен (image/png, image/jpeg). Проблема: большие BLOB могут нагружать память; для больших файлов лучше использовать потоковые запросы к БД.

Пример 6: Ответ с поддержкой сжатия gzip

Если клиент поддерживает gzip, можно сжать вывод для уменьшения трафика. В PHP есть встроенная обработка ob_gzhandler.

if (substr_count($_SERVER['HTTP_ACCEPT_ENCODING'] ?? '', 'gzip')) {
    ob_start('ob_gzhandler');
} else {
    ob_start();
}

echo 'Содержимое ответа, которое будет автоматически сжато.';
$output = ob_get_clean();
header('Content-Length: ' . strlen($output));
echo $output;
exit;
  

Результат: Заголовок Content-Encoding: gzip будет добавлен автоматически, если был вызван ob_gzhandler. Важно не применять двойное сжатие (например, если веб-сервер уже сжимает).