Белый экран WordPress после установки плагина — одна из частых проблем, с которой сталкиваются владельцы сайтов. Он может возникать из-за несовместимости кода, ошибок PHP или превышения лимитов памяти. В этом материале разберём, как найти точную причину, убрать белый экран и вернуть работоспособность сайта, не теряя данные.
Основные причины
| Причина | Что это значит |
|---|---|
| Конфликт плагинов | Новый плагин вступает в конфликт с другим активным плагином или текущей темой из-за несовместимости функций, одинаковых названий классов или переопределения хуков. |
| Ошибка в коде плагина | Плагин содержит синтаксические ошибки PHP (например, пропущенная точка с запятой), вызывает несуществующую функцию или загружает файл с ошибками, что приводит к фатальной ошибке интерпретатора. |
| Нехватка памяти PHP | Плагин потребляет больше оперативной памяти, чем выделено для PHP-процессов сервером (часто по умолчанию 32M или 64M), вызывая "Allowed memory size exhausted". |
| Устаревшая версия PHP | Плагин рассчитан на более новую версию PHP и использует функции или синтаксис, недоступные в старой версии, установленной на хостинге. |
| Поврежденные файлы плагина | Архив плагина был неполностью загружен или распакован, файлы повреждены, что мешает его корректному подключению. |
| Отсутствующая зависимость | Плагин требует стороннюю библиотеку, расширение PHP (например, ionCube Loader, Imagick) или другой плагин для работы, которые не установлены на сервере. |
| Неверные права доступа | После установки плагин изменил права на папки или файлы, заблокировав выполнение скриптов или ухудшив доступ к критичным директориям. |
| Конфликт в файле .htaccess | Плагин автоматически добавил правила в файл .htaccess, которые конфликтуют с существующими директивами или синтаксически неверны. |
Что проверить сначала
- Проверьте, отображается ли белый экран на всем сайте или только в админке/на определенных страницах — это сужает круг подозреваемых плагинов.
- Просмотрите последние записи в логах ошибок сервера (error_log) через FTP или панель хостинга — там может быть прямое указание на файл и строку плагина.
- Временно переименуйте папку /wp-content/plugins/, например, в plugins_backup, чтобы отключить все плагины сразу — если белый экран исчез, причина точно в одном из них.
- Проверьте через phpinfo() или в настройках хостинга текущую версию PHP и сравните с минимальными требованиями установленного плагина.
- Убедитесь, что лимит памяти PHP не исчерпан — увеличьте его в wp-config.php директивой define('WP_MEMORY_LIMIT', '256M'); и проверьте, исчезла ли ошибка.
- Попробуйте включить режим отладки WordPress: добавьте в wp-config.php строки define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); и затем воспроизведите ситуацию, чтобы записать ошибку в /wp-content/debug.log.
- Проверьте целостность загруженного плагина — сравните размер и контрольные суммы файлов с теми, что в официальном репозитории, или перезапишите плагин свежим архивом.
- Если есть доступ к админке через Recovery Mode (режим восстановления), используйте его для деактивации проблемного плагина без FTP.
- Просмотрите файл .htaccess в корне сайта на наличие нестандартных правил, добавленных плагином, и временно закомментируйте их.
- Проверьте наличие файлов с BOM-символами в плагине — некоторые редакторы добавляют лишние символы в начале PHP-файлов, что ломает вывод заголовков.
Пошаговое решение
- Подключитесь к сайту по FTP или через файловый менеджер панели хостинга. Перейдите в папку /wp-content/plugins/ и найдите директорию последнего установленного плагина. Переименуйте её, добавив в конец _disabled (например, problem-plugin_disabled).
- Обновите сайт в браузере. Если белый экран исчез и сайт загружается, проблема локализована. Если нет — повторите переименование для других недавно добавленных плагинов или переименуйте всю папку plugins для отключения всех плагинов.
- Откройте файл wp-config.php (находится в корне сайта) и перед строкой "That's all, stop editing!" добавьте: define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); Сохраните файл.
- Верните переименованную папку плагина к исходному названию (чтобы активировать его) и повторите действие, вызвавшее ошибку (например, зайдите на страницу сайта). Затем откройте файл /wp-content/debug.log — в нём будет записана детальная ошибка с указанием файла и строки.
- Проанализируйте запись в debug.log. Если встречается "Allowed memory size of X bytes exhausted", увеличьте лимит памяти: в том же wp-config.php добавьте строку define('WP_MEMORY_LIMIT', '256M'); (или больше, если необходимо). Если ошибка указывает на вызов неопределенной функции, проверьте версию PHP и при необходимости обновите её в панели управления хостингом до 7.4 или 8.0+.
- Если ошибка связана с синтаксисом PHP (Parse error), удалите проблемный плагин через FTP, скачайте его свежую версию с официального источника (репозитория WordPress или сайта разработчика) и установите заново.
- При подозрении на конфликт с темой временно отключите текущую тему: переименуйте папку активной темы в /wp-content/themes/ (например, добавьте _off). WordPress автоматически переключится на стандартную тему. Если после этого белый экран исчез, проблема в теме — обновите её или смените.
- Проверьте файл .htaccess в корне сайта. Найдите правила, добавленные плагином (часто помечены комментарием # BEGIN PluginName), и закомментируйте их, поставив # в начале каждой строки. После проверки работоспособности сайта можно удалить проблемные правила или скорректировать.
- Через панель хостинга или FTP установите корректные права доступа: папки — 755, файлы — 644. Особенно проверьте папки /wp-content, /wp-content/plugins и файлы внутри них. Некорректные права могут вызывать ошибку 500, маскирующуюся под белый экран.
- Если ни одно из решений не помогло, восстановите сайт из резервной копии, сделанной до установки плагина. Затем обновите WordPress, все темы и плагины до актуальных версий. Протестируйте установку плагина на тестовой копии сайта (staging).
- После решения проблемы обязательно отключите режим отладки, заменив true на false в строках WP_DEBUG и WP_DEBUG_LOG в файле wp-config.php, чтобы debug.log не разрастался и не создавал угроз безопасности.
- Для предотвращения повторов перед установкой любого плагина проверяйте его совместимость с вашей версией WordPress и PHP, дату последнего обновления, количество активных установок и отзывы. Делайте резервную копию сайта перед каждой установкой.
Проверить ошибку WordPress
Введите ошибку WordPress, PHP, плагина, темы, REST API или кратко опишите проблему сайта.
FAQ
Можно ли убрать белый экран, не имея доступа к FTP?
Да, если включён режим восстановления WordPress (Recovery Mode). После нескольких фатальных ошибок WordPress отправляет на email администратора ссылку для входа в специальную сессию, из которой можно деактивировать проблемный плагин. Также можно использовать панель управления хостингом, например, файловый менеджер cPanel или исправить проблему через WP-CLI, если он поддерживается.
Что делать, если белый экран появился, а название плагина я не помню?
Переименуйте всю папку /wp-content/plugins/, чтобы отключить все плагины разом. Затем возвращайте папки по одной, обновляя сайт после каждого переименования, пока белый экран снова не появится — так вычислите виновный. Одновременно проверьте файлы логов, они часто содержат путь к проблемному плагину.
Безопасно ли переименовывать папку плагина для отключения?
Да, это стандартный и безопасный способ. При переименовании WordPress не видит плагин и не подключает его. Все настройки плагина сохранятся в базе данных и восстановятся автоматически, когда вы вернёте папке исходное имя и активируете плагин.
Как включить WP_DEBUG, если белый экран не даёт войти в админку?
WP_DEBUG включается правкой файла wp-config.php, который доступен только через FTP или файловый менеджер хостинга. Доступ в админку для этого не требуется. Скачайте файл, откройте в текстовом редакторе, добавьте нужные define-строки и загрузите обратно.
Может ли белый экран возникать из-за кэширования?
Да, особенно если используется плагин кэширования. После отключения проблемного плагина обязательно очистите весь кэш: серверный (например, через кнопку в панели управления), кэш браузера и кэш CDN, если он есть. Иногда старые закэшированные страницы продолжают показывать белый экран.
Как предотвратить белый экран в будущем?
Всегда создавайте полную резервную копию сайта (файлов и базы данных) перед установкой или обновлением плагинов. Используйте тестовую среду (staging) для проверки новых расширений. Выбирайте плагины от надёжных разработчиков с большим количеством активных установок, регулярными обновлениями и положительными отзывами. Поддерживайте актуальными версии WordPress, тем и PHP.
Итог
Белый экран после установки плагина — решаемая проблема, если действовать методично. Главное — спокойствие и пошаговый подход: изолировать плагин, прочитать логи, устранить корень ошибки и не забыть о резервных копиях на будущее. Восстановив сайт, вы получите ценный опыт диагностики и сможете быстрее справляться с подобными сбоями. Регулярное обслуживание и осторожный выбор плагинов сведут риск появления белого экрана к минимуму.