Работа с POST-запросами: массив $_POST и его применение

Расширенные примеры использования $_POST

Пример 1: Обработка вложенных массивов из формы

Если имена полей содержат квадратные скобки с ключами, PHP создаёт многомерный массив. Например, для структуры данных пользователя:

<form method="post">
  <input name="user[name]" value="Иван">
  <input name="user[email]" value="ivan@example.com">
  <input type="submit">
</form>

// var_dump($_POST) выведет:
array(1) {
  ["user"]=>
  array(2) {
    ["name"]=> string(8) "Иван"
    ["email"]=> string(17) "ivan@example.com"
  }
}

// Доступ:
$name = $_POST['user']['name'] ?? '';
$email = filter_var($_POST['user']['email'] ?? '', FILTER_VALIDATE_EMAIL);

Такой подход удобен для группировки связанных данных, но требует многоуровневой проверки существования ключей.

Пример 2: Массовая фильтрация всех POST-параметров

Иногда нужно применить один и тот же фильтр ко всем полям. Используйте array_map с пользовательской функцией:

$clean = [];
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $clean = array_map(function($value) {
        if (is_array($value)) {
            return array_map('htmlspecialchars', $value);
        }
        return htmlspecialchars($value, ENT_QUOTES, 'UTF-8');
    }, $_POST);
}
print_r($clean);

Array
(
    [username] => <script>alert('xss')</script>
)

Пояснение: функция рекурсивно обрабатывает вложенные массивы (например, для checkbox с []).

Пример 3: Функция для безопасного извлечения POST-данных с проверкой

Создание универсальной функции упрощает повторное использование и централизует безопасность:

function post(string $key, $default = null, int $filter = FILTER_DEFAULT) {
    if (!array_key_exists($key, $_POST)) {
        return $default;
    }
    $value = $_POST[$key];
    if ($filter !== FILTER_DEFAULT) {
        $value = filter_var($value, $filter);
    }
    return $value;
}

// Использование:
$age = post('age', 0, FILTER_VALIDATE_INT);
$name = post('name', '');

Пример 4: Работа с multipart/form-data и $_POST + $_FILES

При загрузке файлов форма должна содержать enctype="multipart/form-data". Важно: в этом режиме php://input недоступен, но обычные поля формы по-прежнему попадают в $_POST. Проверка метода запроса:

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['avatar'])) {
    $name = $_POST['username'] ?? 'anonymous';
    // ... загрузка файла
}

Пример 5: Использование $_POST с AJAX-запросами (application/x-www-form-urlencoded)

Если клиент отправляет данные как URL-encoded строку (например, $.post()), $_POST заполняется стандартно. Пример на JavaScript:

fetch('/handler.php', {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: 'name=Анна&age=30'
});

// PHP:
echo $_POST['name'] ?? 'не указано';

Анна

Пример 6: Валидация нескольких полей с выводом ошибок

Типичный сценарий: проверить все поля формы и собрать сообщения об ошибках.

$errors = [];
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $name = $_POST['name'] ?? '';
    $email = $_POST['email'] ?? '';
    
    if (trim($name) === '') {
        $errors[] = 'Имя обязательно';
    }
    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        $errors[] = 'Некорректный email';
    }
    
    if (empty($errors)) {
        // сохранение данных
    }
}

Пример 7: Имитация POST-запроса для тестирования

В PHP можно вручную установить $_POST для unit-тестов:

$_SERVER['REQUEST_METHOD'] = 'POST';
$_POST = ['login' => 'test', 'pass' => '123'];
// теперь код обработчика будет работать как при реальном POST

Но помните, что это имитация, и она не заменяет интеграционное тестирование.