WordPress білий екран смерті: як виправити фатальні помилки PHP

Білий екран насправді є хорошою новиною

Коли WordPress показує порожню білу сторінку — іноді це називають Білим екраном смерті (WSOD) — це здається катастрофою. Але майже завжди це можна виправити менш ніж за 30 хвилин. Білий екран просто означає, що PHP аварійно завершив роботу до того, як зміг щось відобразити. Причина майже завжди одна з п'яти.

Крок 1: Перевірте, чи проблема на фронтенді чи в адмінці

Перейдіть на yoursite.com/wp-admin.

• Адмінка завантажується нормально → проблема у вашій темі
• Адмінка теж порожня → це плагін або критична помилка PHP
• Адмінка показує повідомлення про помилку → чудово, ви маєте з чим працювати

Крок 2: Увімкніть режим налагодження

WordPress приховує помилки за замовчуванням. Відкрийте 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 на наявність фактичної помилки.

Крок 3: Найпоширеніші причини

Причина 1: Конфлікт плагінів

Тимчасово перейменуйте папку плагінів через FTP або файловий менеджер:

/wp-content/plugins → /wp-content/plugins-disabled

Перезавантажте сайт. Якщо він відновився, значить у вас конфлікт плагінів. Увімкніть плагіни один за одним, щоб знайти той, що ламає сайт.

Причина 2: Помилка теми

Перемкніться на стандартну тему (Twenty Twenty-Three) через базу даних або FTP — перейменуйте папку вашої активної теми:

/wp-content/themes/your-theme → /wp-content/themes/your-theme-broken

WordPress перейде на тему за замовчуванням.

Причина 3: Ліміт пам'яті PHP

Додайте це до wp-config.php:

define('WP_MEMORY_LIMIT', '256M');

Або додайте це до .htaccess:

php_value memory_limit 256M

Причина 4: Пошкоджені файли ядра

Повторно завантажте чисті файли ядра WordPress (завантажте з wordpress.org). Не чіпайте wp-content або wp-config.php.

Причина 5: Несумісність версії PHP

Ваш хост оновив PHP, і ваша тема або плагіни несумісні. Перевірте панель керування хостингом — спробуйте тимчасово повернутися до попередньої версії PHP.

Що вам скаже журнал налагодження

Поширені шаблони помилок:

Помилка	Причина
Call to undefined function	Плагін або тема викликає видалену функцію
Allowed memory size exhausted	Занадто малий ліміт пам'яті
Parse error: syntax error	Хтось редагував PHP-файл і зламав синтаксис
Class not found	Відсутня залежність плагіна або проблема з порядком завантаження
Fatal error: Uncaught TypeError	Проблема сумісності з PHP 8

Якщо нічого з цього не допомогло

Якщо ви виконали всі кроки, але білий екран залишився, журнал налагодження (wp-content/debug.log) покаже точний файл і номер рядка помилки. Ось як діяти далі самостійно:

• Відкрийте debug.log і знайдіть рядок, що починається з PHP Fatal error. Там буде вказано файл і рядок (наприклад, /wp-content/plugins/example-plugin/index.php на рядку 42).
• Якщо помилка вказує на плагін — тимчасово вимкніть цей плагін (через папку plugins-disabled або через базу даних). Якщо на тему — перемкніться на стандартну тему.
• Якщо помилка пов'язана з PHP 8 (наприклад, Uncaught TypeError або Deprecated), спробуйте знизити версію PHP через панель хостингу (наприклад, до 7.4).
• Якщо проблема в базі даних (наприклад, Table '...' doesn't exist), увійдіть у phpMyAdmin, виберіть базу даних і виконайте CHECK TABLE для всіх таблиць; якщо знайдуться помилки, скористайтесь REPAIR TABLE.

Зазвичай цього достатньо, щоб локалізувати та виправити причину.

Якщо ви спробували кроки вище і все ще не вийшло (або не хочете робити це самі) — ось тоді ми можемо допомогти. Ми діагностуємо і виправимо помилку. Отримати допомогу.