AJAX и PHP: как правильно обрабатывать действия на сервере

Пример 1: Обработка JSON и возврат разных статусов

Сервер принимает JSON, валидирует и возвращает успех или ошибку с кодом HTTP.

// client.js
fetch('api.php', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: 'test@test.com', password: '123456' })
})
.then(response => {
  if (!response.ok) throw new Error('HTTP ' + response.status);
  return response.json();
})
.then(data => console.log(data))
.catch(err => console.error(err));

// api.php
<?php
$input = json_decode(file_get_contents('php://input'), true);
if (!$input || empty($input['email']) || empty($input['password'])) {
    http_response_code(400);
    echo json_encode(['error' => 'Email and password required']);
    exit;
}
// Валидация
if (!filter_var($input['email'], FILTER_VALIDATE_EMAIL)) {
    http_response_code(422);
    echo json_encode(['error' => 'Invalid email format']);
    exit;
}
// Успех
http_response_code(200);
echo json_encode(['status' => 'ok', 'user' => $input['email']]);
?>

// Результат при успехе:
// HTTP 200
// {"status":"ok","user":"test@test.com"}
// При ошибке:
// HTTP 400
// {"error":"Email and password required"}

Пример 2: Обработка ошибок валидации с отображением на клиенте

Сервер возвращает массив ошибок, клиент выводит их в форму.

<?php
// validation.php
$errors = [];
if (empty($_POST['username'])) $errors[] = 'Имя обязательно';
if (strlen($_POST['password'] ?? '') < 6) $errors[] = 'Пароль должен быть не менее 6 символов';
if ($errors) {
    http_response_code(422);
    echo json_encode(['success' => false, 'errors' => $errors]);
} else {
    echo json_encode(['success' => true, 'message' => 'OK']);
}
?>

// Возможный ответ:
// HTTP 422
// {"success":false,"errors":["Имя обязательно","Пароль должен быть не менее 6 символов"]}

На клиенте обработка:

.then(data => {
  if (!data.success) {
    data.errors.forEach(err => {
      let p = document.createElement('p');
      p.textContent = err;
      document.getElementById('errors').appendChild(p);
    });
  }
});

Пример 3: Использование PHP-сессии и авторизации в AJAX

Сервер проверяет сессию перед выполнением действия. Если пользователь не авторизован, возвращает 401.

<?php
session_start();
if (!isset($_SESSION['user_id'])) {
    http_response_code(401);
    echo json_encode(['error' => 'Unauthorized']);
    exit;
}
// Действие доступно только авторизованным
$user_id = $_SESSION['user_id'];
echo json_encode(['status' => 'ok', 'user_id' => $user_id]);
?>

// Если нет сессии:
// HTTP 401
// {"error":"Unauthorized"}
// Если сессия есть:
// HTTP 200
// {"status":"ok","user_id":42}

Пример 4: RESTful эндпоинт с маршрутизацией по action

Единый файл обрабатывает несколько действий (list, create, update, delete) в зависимости от параметра action.

<?php
$action = $_GET['action'] ?? '';
switch ($action) {
    case 'list':
        // список товаров
        $data = ['items' => ['Товар 1', 'Товар 2']];
        break;
    case 'create':
        // создание
        $data = ['id' => 3, 'name' => 'Новый товар'];
        break;
    default:
        http_response_code(404);
        $data = ['error' => 'Action not found'];
}
header('Content-Type: application/json');
echo json_encode($data);
?>

// GET /api.php?action=list
// HTTP 200
// {"items":["Товар 1","Товар 2"]}
// GET /api.php?action=unknown
// HTTP 404
// {"error":"Action not found"}

Пример 5: Отправка данных с помощью XMLHttpRequest (старый стиль)

Классический XMLHttpRequest по-прежнему работает и может использоваться в legacy проектах.

var xhr = new XMLHttpRequest();
xhr.open('POST', 'handler.php', true);
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
xhr.onload = function() {
  if (xhr.status === 200) {
    var response = JSON.parse(xhr.responseText);
    console.log(response);
  }
};
xhr.send('action=update&id=1&value=100');

// Ответ от сервера (handler.php):
// {"status":"ok","updated":1}

Пример 6: Обработка множественных запросов с очередью (Promise.all)

Иногда нужно выполнить несколько AJAX запросов параллельно и дождаться их завершения.

Promise.all([
  fetch('api.php?action=one').then(r => r.json()),
  fetch('api.php?action=two').then(r => r.json())
]).then(([data1, data2]) => {
  console.log('First:', data1);
  console.log('Second:', data2);
}).catch(err => console.error('Один из запросов упал:', err));

// Результат (пример):
// First: { result: "action one" }
// Second: { result: "action two" }