PHPTime

Обработка форм в PHP: $_GET, $_POST, валидация и защита

PHP разбирает строку запроса и тело обычной HTML-формы в суперглобальные массивы. В обработчике нужно выбрать источник данных, проверить тип и значение каждого поля, а при выводе экранировать данные для нужного контекста. Ниже — примеры для форм поиска, POST-запросов и JSON.

Форма в PHP: когда использовать GET и POST

Метод задаётся атрибутом method элемента form. Ключом в PHP становится атрибут name поля. Поле без имени, отключённое поле и неотмеченный чекбокс обычно отсутствуют в отправленных данных. Отмеченный чекбокс без явно заданного value отправляет строку on.

ЗадачаМетодГде читать данные
Поиск, фильтры, сортировкаGET$_GET
Отправка обычной формыPOST$_POST
Форма с загрузкой файлаPOST, multipart/form-dataПоля в $_POST, файлы в $_FILES
Запрос с JSONНапример, POST с application/jsonПоток php://input

Параметры GET входят в адрес, поэтому поиск и фильтры можно сохранить в закладки. Пароли и токены передавайте в теле запроса через HTTPS. Для действий с побочными эффектами, например изменения профиля, используйте POST и проверяйте права пользователя на сервере.

Минимальная форма поиска отправляется в текущий обработчик. Атрибуты required и maxlength улучшают работу в браузере, а сервер применяет собственные правила.

HTML
<form method="get">
  <label>Запрос <input name="q" required maxlength="120"></label>
  <button type="submit">Найти</button>
</form>

Как читать запрос в PHP: $_GET, $_POST и $_REQUEST

$_GET содержит параметры строки запроса при любом HTTP-методе. $_POST PHP заполняет при POST с типом application/x-www-form-urlencoded или multipart/form-data. Метод проверяйте по $_SERVER['REQUEST_METHOD']. Пустой $_POST возможен и при POST, например при отправке JSON или превышении post_max_size.

$_REQUEST объединяет данные из нескольких источников. Его состав и порядок перезаписи совпадающих ключей зависят от request_order и, если эта директива не задана, от variables_order. В зависимости от настройки туда могут попадать и cookie. Обработчик формы проще читать, когда каждое поле берётся из явно указанного массива.

Обычное поле HTML-формы приходит строкой. Имя со скобками, например tags[], даёт массив. Клиент может отправить массив и вместо ожидаемого скалярного поля. Поэтому проверяйте тип перед вызовом trim(), strlen() и других строковых функций.

PHP
<?php
declare(strict_types=1);

$rawQuery = $_GET['q'] ?? null;

if ($rawQuery !== null && !is_string($rawQuery)) {
    http_response_code(400);
    exit('Параметр поиска должен быть строкой.');
}

// При первом открытии страницы поле может отсутствовать.
$query = trim($rawQuery ?? '');

Оператор ?? задаёт значение по умолчанию при отсутствующем ключе или null. Он оставляет массив как есть. strict_types регулирует скалярную типизацию при вызовах из файла. Проверка содержимого суперглобальных массивов остаётся задачей обработчика.

Валидация формы: обязательность, формат и диапазон

Сначала убедитесь, что поле пришло в ожидаемом типе. Затем нормализуйте его там, где это допустимо, и проверьте правила приложения. Для email можно удалить пробелы по краям. Для пароля пробелы могут быть частью значения. Для значения из выпадающего списка проверяйте принадлежность к разрешённому набору через in_array($value, $allowed, true).

PHP
<?php
declare(strict_types=1);

$emailInput = $_POST['email'] ?? null;
$countInput = $_POST['count'] ?? null;
$errors = [];

$email = is_string($emailInput) ? trim($emailInput) : '';
if (filter_var($email, FILTER_VALIDATE_EMAIL) === false) {
    $errors['email'] = 'Введите корректный email.';
}

// Ноль допустим. Сравниваем результат с false строго.
$count = is_string($countInput)
    ? filter_var($countInput, FILTER_VALIDATE_INT, [
        'options' => ['min_range' => 0, 'max_range' => 100],
    ])
    : false;

if ($count === false) {
    $errors['count'] = 'Введите целое число от 0 до 100.';
}

if ($errors !== []) {
    http_response_code(422);
}
// Сохраняйте данные только при пустом массиве ошибок.

FILTER_VALIDATE_EMAIL проверяет синтаксис адреса. Доступ пользователя к почте подтверждается отдельным действием, например переходом по ссылке из письма. Для текстовых полей определите, в чём измеряется лимит. strlen() считает байты, mb_strlen($value, 'UTF-8') с расширением mbstring — символы, а grapheme_strlen() с расширением intl — графемы, которые ближе к видимым пользователю символам.

Типичные ошибки: empty() считает строку '0' пустой, приведение (int) может превратить строку '12abc' в число 12, а проверка if (!$count) отвергает допустимый ноль. Для поля со списком проверьте, что получен массив, ограничьте число элементов и проверьте каждый элемент. Если важно, чтобы ключи шли подряд от нуля, используйте array_is_list().

PHP input: как прочитать JSON из php://input

Для запроса с Content-Type: application/json прочитайте сырое тело через php://input и декодируйте его с JSON_THROW_ON_ERROR. HTML-форму с multipart/form-data разбирайте через $_POST и $_FILES. При стандартной настройке enable_post_data_reading поток php://input для такого POST недоступен.

PHP
<?php
declare(strict_types=1);

if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
    header('Allow: POST');
    http_response_code(405);
    exit;
}

// Отделяем параметры заголовка от типа содержимого.
$contentType = strtolower(trim(explode(';', $_SERVER['CONTENT_TYPE'] ?? '', 2)[0]));
if ($contentType !== 'application/json') {
    http_response_code(415);
    exit('Ожидается application/json.');
}

$body = file_get_contents('php://input', false, null, 0, 16_385);
if ($body === false) {
    http_response_code(500);
    exit('Не удалось прочитать тело запроса.');
}
if (strlen($body) > 16_384) {
    http_response_code(413);
    exit('Тело запроса слишком большое.');
}

try {
    $data = json_decode($body, false, 32, JSON_THROW_ON_ERROR);
} catch (JsonException) {
    http_response_code(400);
    exit('Некорректный JSON.');
}

if (!$data instanceof stdClass || !is_string($data->name ?? null)) {
    http_response_code(422);
    exit('Ожидается объект с текстовым полем name.');
}

http_response_code(204);

Здесь лимит тела составляет 16 КиБ, а допустимая глубина JSON — 32. Декодирование в объект позволяет различать {} и []. Проверка типа поля после декодирования обязательна: синтаксически корректный JSON может содержать число, массив или null вместо строки.

PHP htmlspecialchars: как безопасно вывести значение поля

Валидируйте данные при приёме, а экранируйте в момент вывода. Для HTML-текста и значений обычных атрибутов в кавычках подходит htmlspecialchars() с ENT_QUOTES | ENT_SUBSTITUTE и явной кодировкой UTF-8. Первый флаг экранирует оба вида кавычек, второй заменяет недопустимые последовательности символом замены. Кодировка ответа должна совпадать с кодировкой, указанной в функции.

PHP
<?php
declare(strict_types=1);

function escapeHtml(string $value): string
{
    // Экранируем значение для HTML-текста и атрибутов в кавычках.
    return htmlspecialchars($value, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}

header('Content-Type: text/html; charset=UTF-8');
$input = $_GET['q'] ?? '';
$query = is_string($input) ? $input : '';
?>
<p>Запрос: <?= escapeHtml($query) ?></p>
<input name="q" value="<?= escapeHtml($query) ?>">

Храните обычный текст в исходном виде после нормализации. Экранирование при записи и повторно в шаблоне приводит к двойному преобразованию. Для SQL используйте подготовленные запросы PDO с параметрами. Для JavaScript и CSS применяйте правила соответствующего контекста. При выводе пользовательского адреса в href сначала проверьте допустимую схему, затем экранируйте значение атрибута. strip_tags() удаляет теги и не заменяет контекстное экранирование.

Защита POST-формы: CSRF, права и ограничения

Если браузер отправляет cookie сессии, защищайте операции изменения данных CSRF-токеном, привязанным к сессии. Сгенерируйте его при показе формы, передайте скрытым полем и сравните на сервере до действия. Настройка cookie SameSite дополняет эту проверку. Права на конкретную запись проверяйте отдельно, даже при действительном токене.

PHP
<?php
declare(strict_types=1);

session_start();
$method = $_SERVER['REQUEST_METHOD'] ?? '';

if ($method === 'POST') {
    $expected = $_SESSION['csrf'] ?? null;
    $submitted = $_POST['csrf'] ?? null;

    if (!is_string($expected) || !is_string($submitted)
        || !hash_equals($expected, $submitted)) {
        http_response_code(403);
        exit('Токен формы недействителен.');
    }

    // Здесь проверяются права и поля перед выполнением действия.
    http_response_code(204);
    exit;
}

if ($method !== 'GET') {
    header('Allow: GET, POST');
    http_response_code(405);
    exit;
}

$_SESSION['csrf'] ??= bin2hex(random_bytes(32));
?>
<form method="post">
  <input type="hidden" name="csrf" value="<?= htmlspecialchars($_SESSION['csrf'], ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8') ?>">
  <button type="submit">Отправить</button>
</form>

После успешного сохранения из браузерной формы обычно возвращают 303 See Other с переходом на GET-страницу результата. Обновление этой страницы не отправит форму повторно. Если повтор операции сам по себе опасен, предусмотрите контроль дубликатов на уровне приложения или базы.

Согласуйте серверный лимит тела запроса и post_max_size PHP. При превышении post_max_size массивы $_POST и $_FILES могут оказаться пустыми. При достижении max_input_vars PHP может отбросить часть полей. Для загрузки дополнительно учитывайте upload_max_filesize, проверяйте UPLOAD_ERR_OK и размер файла. Определяйте допустимый MIME-тип по содержимому через finfo, а имя для хранения назначайте на сервере.

Отличия PHP 8.3, 8.4 и 8.5

  • PHP 8.3. Появилась json_validate() для проверки синтаксиса JSON без декодирования. Если обработчику нужны поля, достаточно одного вызова json_decode() с JSON_THROW_ON_ERROR. Предварительная проверка привела бы к повторному разбору тела.
  • PHP 8.4. Появилась request_parse_body() для разбора application/x-www-form-urlencoded и multipart/form-data, в том числе при PUT или PATCH. Она возвращает пару массивов полей и файлов и читает тело запроса, поэтому вызывайте её до чтения php://input. Для JSON используйте отдельный разбор через json_decode().
  • PHP 8.5. Появилась filter_var_array() задолго до этой ветки, и обработчики по-прежнему могут проверять поля по одному через filter_var(). Примеры выше работают во всех трёх ветках.

Чек-лист обработчика формы

  1. Выберите HTTP-метод и ожидаемый тип тела. Для неподдерживаемого метода верните 405 и заголовок Allow.
  2. Читайте поля из явного источника. Проверьте наличие обязательных полей, тип каждого значения, длину, диапазон и допустимые варианты.
  3. Для изменения данных проверьте права и CSRF-токен там, где запрос опирается на cookie сессии. Выполняйте действие после всех проверок.
  4. Передавайте значения в SQL параметрами. При выводе в HTML экранируйте их через htmlspecialchars() с явными флагами и кодировкой.
  5. Проверьте обычную отправку, отсутствующее поле, строку '0', массив вместо строки, неверный токен, слишком большое тело и повторную отправку.

Частые вопросы

Почему $_POST пустой, хотя запрос отправлен методом POST?

Проверьте Content-Type, размер тела и имена полей. PHP заполняет $_POST для обычных URL-кодированных и multipart-форм. JSON читают из php://input. При превышении post_max_size данные формы могут быть отброшены.

Чем $_REQUEST отличается от $_GET и $_POST?

$_GET содержит параметры строки запроса, а $_POST — поля разобранного тела POST-формы. $_REQUEST объединяет источники в порядке, заданном конфигурацией PHP. В обработчике выбирайте источник явно, чтобы одинаковые ключи не подменяли друг друга.

Когда применять htmlspecialchars к данным формы?

Вызывайте htmlspecialchars при вставке значения в HTML-текст или в обычный атрибут, заключённый в кавычки. Укажите ENT_QUOTES | ENT_SUBSTITUTE и UTF-8. Перед сохранением проверяйте значение по правилам приложения, а в SQL передавайте его параметром.

Справка по теме

Ещё в разделе «Справочник PHP»

Операторы PHP: сравнение, ??, ?->, тернарный оператор и match

Операторы и условия PHP 8.3–8.5 на коротких примерах. Как работают сравнение, не равно, ??, ?->, тернарный оператор, if else, switch case и match.

9 мин

Отладка PHP: var_dump, Xdebug и PhpStorm

Практическая отладка PHP 8.3–8.5: проверка данных через var_dump, настройка Xdebug в PhpStorm и VS Code, точки останова и разбор ошибок подключения.

9 мин

Отправка почты из PHP: mail(), PHPMailer и Symfony Mailer

Как отправить письмо из PHP 8.3–8.5 через mail(), PHPMailer и Symfony Mailer. Рабочие примеры, настройка SMTP, UTF-8 и разбор ошибок доставки.

9 мин

Поиск в массиве PHP: in_array, array_search, array_filter

Как искать значения и ключи в массивах PHP 8.3–8.5: строгое сравнение, фильтрация, сохранение ключей и примеры с array_map и array_merge.

9 мин