Обработка форм в 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 улучшают работу в браузере, а сервер применяет собственные правила.
<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
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
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
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
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
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(). Примеры выше работают во всех трёх ветках.
Чек-лист обработчика формы
- Выберите HTTP-метод и ожидаемый тип тела. Для неподдерживаемого метода верните
405и заголовокAllow. - Читайте поля из явного источника. Проверьте наличие обязательных полей, тип каждого значения, длину, диапазон и допустимые варианты.
- Для изменения данных проверьте права и CSRF-токен там, где запрос опирается на cookie сессии. Выполняйте действие после всех проверок.
- Передавайте значения в SQL параметрами. При выводе в HTML экранируйте их через
htmlspecialchars()с явными флагами и кодировкой. - Проверьте обычную отправку, отсутствующее поле, строку
'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 передавайте его параметром.