PHP на сервере LinuxWindows

PHP 8.1+: Deprecated — Passing null to parameter must be of type string

  • Обновлено
  • Чтение ≈ 2 минуты

Краткий ответ

В PHP 8.1 передача null во встроенные функции объявлена устаревшей. Проверяйте значения и используйте оператор ??.

В этой статье
  1. Что означает сообщение
  2. Причины и признаки
  3. Пошаговое решение
  4. На что обратить внимание

#Что означает сообщение

Сообщение
Deprecated: Passing null

В PHP 8.1 передача null во встроенные функции объявлена устаревшей. Проверяйте значения и используйте оператор ??.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Значение nullПредупреждение показывает передачу null во встроенную функциюОбработать null до вызова
Старый кодПроблема в устаревшей функции собственного приложенияИсправить типы по PHP 8.1+
Пустой вводНеобязательное поле формы отсутствуетЯвно обработать значение по умолчанию
БиблиотекаПредупреждение находится внутри vendorОбновить библиотеку

#Пошаговое решение

  1. Найдите вызов, передающий null во встроенную функциюВ журнале PHP 8.1+ найдите предупреждение Deprecated: Passing null to parameter #... и файл со строкой. Откройте этот вызов в редакторе: например trim($name) или strlen($text). Новые версии PHP предупреждают о null для параметров встроенных функций с не-null типами. Не отключайте вывод предупреждений как замену исправления кода.
  2. Установите смысл отсутствующего значенияОпределите, почему переменная равна null: отсутствует поле формы, ключ SQL, результат разбора JSON или необязательный аргумент. Для строкового поля, где отсутствие равно пустой строке, подходит $name = trim($value ?? "");. Если отсутствие запрещено, проверяйте $value === null и выдавайте понятную ошибку ввода, вместо тихой подмены. Не приводите к строке данные с непредусмотренными типами.
  3. Проверьте сторонний код и совместимость библиотекЕсли предупреждение находится в vendor/ или установленной теме/модуле, узнайте версию пакета и проверьте официальное обновление с поддержкой PHP 8.1+. Не редактируйте vendor вручную — изменения будут потеряны при следующем composer install. Для собственных функций используйте корректные объявления ?string только там, где их код обрабатывает null. Сохраните тестовые случаи для пустой строки и отсутствующего значения.
  4. Повторите выполнение без подавления ошибокПроведите тест с заполненным и пустым входом, убедитесь, что итоговые строки и числа корректны и предупреждение больше не пишется в журнал. Если проблема скрыта только за отключением E_DEPRECATED, исправление не выполнено. Проверьте соседние подобные вызовы в том же модуле и зафиксируйте версию PHP, на которой проводилась проверка.

#На что обратить внимание

Не скрывайте все сообщения PHP как единственное исправление: проблема может стать ошибкой в будущих версиях. Проверяйте поведение на тестовом окружении перед обновлением рабочего сайта.

Так эту ошибку тоже называют

PHP Parse error: syntax error, unexpected T_STRING — причины и решение Найдите пропущенную точку с запятой, скобку или кавычку в указанной строке. Сайты, серверы и хостинг PHP на сервере Linux Allowed memory size PHP Fatal error: Allowed memory size exhausted — причины и решение `Fatal error: Allowed memory size of N bytes exhausted (tried to allocate M bytes)` означает, что PHP-скрипт превысил лимит памяти, заданный `memory_limit`. Причина — ли… Сайты, серверы и хостинг PHP на сервере PHPWordPressLinux PHP: Warning: Undefined variable / Undefined array key — причины и решение Предупреждения возникают при обращении к необъявленной переменной или несуществующему ключу массива. Проверяйте isset(), ?? и инициализируйте переменные. Сайты, серверы и хостинг PHP на сервере LinuxWindows PHP: Call to undefined function mb_strlen() — не установлено расширение mbstring — причины и решение «Call to undefined function mb_strlen()» в PHP означает, что не установлено или не включено расширение mbstring. Установите пакет phpX.Y-mbstring, раскомментируйте exten… Сайты, серверы и хостинг PHP на сервере LinuxWindows PHP: Cannot modify header information — headers already sent — причины и решение «Cannot modify header information — headers already sent» в PHP возникает, когда вывод начался раньше вызова header(), setcookie() или session_start(). Найдите место выв… Сайты, серверы и хостинг PHP на сервере LinuxWindows

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.