Ловушки PHP 8.3–8.5: типы, безопасность и состояние приложения
PHP может привести строку к числу, принять массив вместо ожидаемого поля или сохранить данные прошлого запроса в долгоживущем воркере. Разберём, как сделать эти границы явными и где поставить проверки, которые защищают приложение.
1. Строгие типы начинаются после разбора входа
В PHP 8.3–8.5 добавляйте declare(strict_types=1) в новые файлы приложения. Для скалярных аргументов пользовательской функции режим определяется файлом, из которого её вызывают. Если библиотека объявила строгий режим у себя, код вызывающей стороны всё ещё может работать с приведением типов. Параметр int задаёт контракт функции, а правила разбора строки из HTTP-запроса задаёт приложение.
Берите данные из конкретного источника: параметры строки запроса из $_GET, поля обычной формы из $_POST, JSON из тела запроса. Состав $_REQUEST зависит от конфигурации. Даже у поля, которое интерфейс отправляет как строку, проверьте форму значения: PHP может разобрать параметр как массив.
<?php
declare(strict_types=1);
// Идентификатор должен быть положительным целым в диапазоне PHP.
$rawId = $_GET['id'] ?? null;
$id = is_string($rawId)
? filter_var($rawId, FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]])
: false;
if ($id === false) {
http_response_code(400);
exit('Некорректный идентификатор');
}
// Здесь $id имеет тип int.При разборе JSON используйте json_decode($body, true, 512, JSON_THROW_ON_ERROR). Обработайте JsonException на границе запроса и отдельно проверьте структуру и типы полей. Синтаксически корректный JSON может содержать число, список или null, даже если обработчик ожидает объект. Ограничьте размер тела до декодирования.
2. Неявные сравнения и проверки на пустоту
После нормализации сравнивайте значения через === и !==. Для in_array() и array_search() передавайте true третьим аргументом, чтобы учитывать тип. Возвращаемое значение array_search() проверяйте через === false: совпадение может быть найдено по ключу 0.
empty() считает пустыми и строку '0', и число 0. Если ноль допустим, проверка должна соответствовать контракту поля. Например, обязательную непустую строку можно проверить через is_string($value) && $value !== ''. Когда в частичном обновлении отсутствие ключа означает «оставить как есть», а явный null означает «очистить», используйте array_key_exists(). И isset(), и оператор ?? объединяют эти два случая.
3. Экранирование вывода и защита от XSS
Проверяйте данные по правилам предметной области при вводе. Экранируйте их при выводе, когда уже известен контекст. Например, имя пользователя можно хранить обычной строкой, выводить в HTML с экранированием и передавать через JSON API с помощью JSON-кодировщика. Если сохранить имя сразу в виде HTML-сущностей, один и тот же текст придётся по-разному восстанавливать для разных потребителей.
<?php
declare(strict_types=1);
$name = $_GET['name'] ?? '';
$name = is_string($name) ? $name : '';
// Экранируем значение для текстового узла HTML.
echo '<p>', htmlspecialchars($name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), '</p>';htmlspecialchars() подходит и для обычного значения HTML-атрибута, заключённого в кавычки. У атрибутов, которые задают адрес, дополнительно проверяйте допустимые схемы и назначения. Избегайте передачи пользовательских строк во встроенный JavaScript, CSS и атрибуты обработчиков событий. В шаблонизаторе оставляйте автоэкранирование включённым и учитывайте контекст, который он поддерживает.
Если пользователю разрешено сохранять форматированный HTML, пропускайте его через поддерживаемый HTML-санитайзер с правилами для тегов, атрибутов и схем. strip_tags() с перечнем разрешённых тегов сохраняет атрибуты этих тегов, поэтому для такой задачи его недостаточно.
4. PDO: параметры для значений, фиксированные варианты для SQL
Передавайте значения через подготовленные запросы. В примере $pdo — настроенное подключение с режимом исключений, а $id — целое из первого раздела. Явная привязка полезна там, где драйверу важно передать именно целое.
// Выбираем записи только из текущего рабочего пространства.
$stmt = $pdo->prepare(
'SELECT id, title FROM articles WHERE id = :id AND workspace_id = :workspace'
);
$stmt->bindValue(':id', $id, PDO::PARAM_INT);
$stmt->bindValue(':workspace', $workspaceId, PDO::PARAM_INT);
$stmt->execute();
$article = $stmt->fetch(PDO::FETCH_ASSOC);$workspaceId в этом примере берётся из контекста авторизованного пользователя после проверки членства. Параметризация защищает структуру запроса, а условие по рабочему пространству ограничивает выборку. Если чтение разрешено только определённым ролям, проверяйте право на операцию отдельно.
Заполнитель обозначает значение. Для имени столбца и направления сортировки выберите готовый фрагмент из списка в коде, например сопоставьте newest с created_at DESC. Для IN создавайте отдельный заполнитель на каждый элемент, ограничивайте размер списка и заранее решите, какой результат возвращать для пустого списка.
5. Динамические подключения и вызовы
Имя модуля из запроса удобно использовать как ключ в таблице маршрутов. Файл или обработчик при этом выбирается из закрытого перечня. basename() выделяет последний компонент пути, оставляя пользователю возможность выбрать любое имя, которое пройдёт такую обработку. Разрешённый список сразу выражает нужное правило: какие модули вообще доступны по этому маршруту.
<?php
declare(strict_types=1);
// Пути заданы приложением и находятся вне каталога загрузок.
$pages = [
'home' => __DIR__ . '/../views/home.php',
'help' => __DIR__ . '/../views/help.php',
];
$page = $_GET['page'] ?? 'home';
if (!is_string($page) || !isset($pages[$page])) {
http_response_code(404);
exit('Страница не найдена');
}
require $pages[$page];Тот же принцип работает для динамических вызовов: отображайте имена операций на заранее зарегистрированные обработчики и проверяйте разрешения перед вызовом. Для обмена данными с клиентом используйте JSON и проверяйте его структуру. unserialize() может восстанавливать объекты и запускать их магические методы, поэтому входящий запрос не должен попадать в эту функцию.
6. PHP-FPM, сессии и долгоживущие воркеры
В типичной конфигурации PHP-FPM процесс обслуживает несколько запросов по очереди, а пользовательские переменные и обычные статические свойства инициализируются заново для каждого запроса. OPcache сохраняет скомпилированный код. Данные в сессии, БД и кэше живут отдельно. Держите в $_SESSION небольшой набор значений, которые действительно нужны между запросами.
Стандартный файловый обработчик удерживает блокировку открытой сессии. Долгий запрос может задержать другие запросы с тем же идентификатором сессии. Если запись закончена, вызовите session_write_close() до долгого обращения к внешнему сервису. Изменения $_SESSION после закрытия в эту запись уже не попадут. После входа обновляйте идентификатор сессии, задавайте для cookie Secure, HttpOnly и подходящий SameSite. Для браузерных операций, меняющих состояние и использующих cookie для авторизации, проверяйте CSRF-токен.
В долгоживущем HTTP-воркере или обработчике очереди контейнер зависимостей, статические свойства и объекты могут пережить обработку запроса или задания. Храните текущего пользователя, рабочее пространство и локаль в контексте конкретного запроса. Завершайте транзакции и освобождайте ресурсы даже при исключении. Ошибка хорошо видна в тесте, где один воркер подряд обрабатывает запросы двух пользователей с разными правами.
7. Ошибки и производительность в рабочей среде
В рабочей среде выключите display_errors и включите log_errors. На верхней границе обработчика отдавайте клиенту подходящий HTTP-статус и короткое сообщение. В журнал пишите идентификатор запроса и контекст, необходимый для диагностики. Исключите пароли, токены и полные тела запросов из этих записей.
Для замера длительности участка кода используйте монотонные часы hrtime(true), для пика памяти PHP — memory_get_peak_usage(true). Смотрите также число SQL-запросов и время ожидания внешних сервисов. Например, медленный список с десятками однотипных запросов внутри цикла стоит разбирать с выборки данных. Если растёт память на экспорте, проверьте, загружает ли драйвер весь результат в буфер и собирает ли приложение весь файл в строку.
8. Чек-лист перед выпуском
- Проверьте HTTP-обработчики на отсутствующее поле, массив вместо строки, ноль и выход за допустимый диапазон.
- Убедитесь, что шаблоны экранируют вывод, а форматированный пользовательский HTML проходит санитайзер.
- Просмотрите SQL на параметризацию значений и ограничения по правам. Для сортировки и имён столбцов проверьте фиксированные варианты.
- Найдите динамические
requireи вызовы функций. Их цели должны выбираться из списка, заданного приложением. - Проверьте параметры cookie, обновление идентификатора сессии после входа и CSRF-защиту операций записи.
- Прогоните два запроса разных пользователей через один долгоживущий воркер и проверьте, что контекст и транзакции очищаются после ошибок.
- Воспроизведите штатную ошибку в тестовой среде с рабочими настройками. Клиент должен получить короткий ответ, а журнал — данные для поиска причины без секретов.
Частые вопросы
Нужно ли включать strict_types во всех PHP-файлах?
В новом коде приложения его стоит объявлять последовательно. При внедрении в существующем проекте начните с тестов на местах вызова и нормализуйте HTTP-ввод до передачи в типизированные функции. Для скалярных аргументов пользовательских функций важен режим файла, где производится вызов.
Можно ли экранировать пользовательский текст один раз перед сохранением?
Храните текст в форме, удобной для приложения, и экранируйте при выводе. Для текста на HTML-странице подходит htmlspecialchars(), а для ответа JSON используйте json_encode(). Если приложение принимает форматированный HTML, обработайте его HTML-санитайзером.
Почему подготовленный запрос PDO не принимает имя столбца как параметр?
Параметры представляют значения, а имя столбца относится к структуре SQL. Сопоставьте значение фильтра или сортировки с фиксированным именем столбца либо готовым выражением, заданным в коде.