Ошибка 400 Bad Request в PHP: полный разбор и методы решения

Расширенные примеры и практические сценарии

Пример 1: Полный обработчик с логированием и разбором JSON

<?php
// api_handler.php
// Включаем строгий режим и сохраняем тело запроса
$rawBody = file_get_contents('php://input');
$logEntry = [
  'time' => date('Y-m-d H:i:s'),
  'method' => $_SERVER['REQUEST_METHOD'],
  'uri' => $_SERVER['REQUEST_URI'],
  'headers' => getallheaders(),
  'body' => $rawBody
];
file_put_contents('/var/log/api_requests.log', json_encode($logEntry) . "\n", FILE_APPEND);

if (empty($rawBody)) {
  http_response_code(400);
  echo json_encode(['error' => 'Empty request body']);
  exit;
}

$data = json_decode($rawBody, true);
if (json_last_error() !== JSON_ERROR_NONE) {
  http_response_code(400);
  echo json_encode([
    'error' => 'Invalid JSON',
    'detail' => json_last_error_msg()
  ]);
  exit;
}

// Проверка обязательных полей
$required = ['name', 'email'];
$missing = array_diff($required, array_keys($data));
if (!empty($missing)) {
  http_response_code(400);
  echo json_encode(['error' => 'Missing fields', 'fields' => array_values($missing)]);
  exit;
}

// Успешная обработка
http_response_code(200);
echo json_encode(['status' => 'ok']);
?>

Пример вывода при неверном JSON:
{"error":"Invalid JSON","detail":"Syntax error"}

Пример 2: Отладка с помощью cURL для воспроизведения 400

# Отправить корректный запрос
curl -X POST https://example.com/api \
  -H "Content-Type: application/json" \
  -d '{"name":"test","email":"test@test.com"}'

# Отправить запрос с неверным JSON
curl -X POST https://example.com/api \
  -H "Content-Type: application/json" \
  -d '{name: test}'

# Отправить запрос без обязательного заголовка
curl -X POST https://example.com/api \
  -d '{"name":"test"}'

Результат для последнего (без Content-Type):
{"error":"Expected Content-Type: application/json"}
(если сервер проверяет заголовок)

Пример 3: Настройка Nginx для корректной обработки больших заголовков

# /etc/nginx/nginx.conf (в секции http)
proxy_buffers 8 16k;
proxy_buffer_size 32k;
large_client_header_buffers 4 16k;
client_max_body_size 20M;
client_header_buffer_size 4k;

Пояснение: параметр large_client_header_buffers предотвращает 400 при URI длиннее 8КБ (по умолчанию).

Пример 4: Обработка 400 на стороне клиента (JavaScript)

fetch('/api', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'test' })
}).then(response => {
  if (response.status === 400) {
    response.json().then(err => {
      console.error('400 Bad Request:', err);
      // показать пользователю сообщение
    });
  }
});

В консоли: 400 Bad Request: {error: "Invalid JSON"}

Пример 5: Регистрация ошибки 400 в базе данных с деталями

<?php
function logBadRequest($errorDetail) {
  $pdo = new PDO('mysql:host=localhost;dbname=errors', 'user', 'pass');
  $stmt = $pdo->prepare("INSERT INTO http_errors (status, url, body, error, ip, time) VALUES (?, ?, ?, ?, ?, NOW())");
  $stmt->execute([
    400,
    $_SERVER['REQUEST_URI'],
    file_get_contents('php://input'),
    $errorDetail,
    $_SERVER['REMOTE_ADDR']
  ]);
}

// Использование:
$raw = file_get_contents('php://input');
$json = json_decode($raw);
if (!$json) {
  logBadRequest('Invalid JSON: ' . json_last_error_msg());
  http_response_code(400);
  exit;
}
?>

Пример 6: Проверка и фильтрация Upload с помощью проверок MIME-типа и размера

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['document'])) {
  $file = $_FILES['document'];
  $allowedMimes = ['application/pdf', 'image/png'];
  $finfo = finfo_open(FILEINFO_MIME_TYPE);
  $mime = finfo_file($finfo, $file['tmp_name']);
  finfo_close($finfo);

  if (!in_array($mime, $allowedMimes)) {
    http_response_code(400);
    exit('Invalid file type');
  }
  if ($file['size'] > 5 * 1024 * 1024) {
    http_response_code(400);
    exit('File too large (max 5MB)');
  }
  // обработка
}
?>

Если загружен .exe: HTTP 400 с текстом "Invalid file type"