Руководство по исправлению распространенных ошибок WordPress

WordPress — гибкая система, но иногда при установке или эксплуатации возникают сбои. Большинство проблем связано с неправильной конфигурацией файлов, базы данных или окружения сервера. Это руководство поможет вам самостоятельно диагностировать и устранить типичные ошибки.

Что понадобится

  • Доступ к файловому менеджеру хостинга или FTP-клиент (например, FileZilla).
  • Доступ к phpMyAdmin или другому инструменту управления базами данных.
  • Текстовый редактор (блокнот, VS Code, Sublime Text).
  • Логин и пароль от панели управления хостингом.
  • Базовые знания: как открыть терминал (если есть SSH-доступ).

Пошаговая инструкция по диагностике проблемы

Прежде чем искать конкретное решение, выполните общую проверку:

  1. Очистите кеш браузера и кеш плагинов — иногда ошибка временная.
  2. Проверьте адрес сайта — возможно, вы перешли по неверной ссылке.
  3. Временно отключите все плагины — переименуйте папку wp-content/plugins через FTP (например, в plugins_old). Если сайт заработает, проблема в одном из плагинов — включайте их по одному.
  4. Переключите тему по умолчанию (Twenty Twenty-Four) — если ошибка связана с темой.
  5. Включите отладку 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 — изучите его содержимое. Не забудьте отключить отладку на рабочем сайте.

Возможные ошибки и их решения

1. Ошибка соединения с базой данных

Причина: Неверные данные в wp-config.php или проблемы с сервером БД.

Решение:

  • Откройте файл wp-config.php и проверьте параметры:
    • DB_NAME — имя базы данных.
    • DB_USER — пользователь базы.
    • DB_PASSWORD — пароль.
    • DB_HOST — обычно localhost, но может отличаться (уточните в панели хостинга).
  • Убедитесь, что пользователь БД имеет все права на базу (через phpMyAdmin: Привилегии → Редактировать → Отметить "Все").
  • Если доступен SSH, сбросьте пароль MySQL:
    SET PASSWORD FOR 'username'@'localhost' = PASSWORD('newpassword');
    Замените username и localhost на свои данные.

2. Пустая страница или "Headers already sent"

Причина: Лишние пробелы или символы BOM в файлах wp-config.php или functions.php.

Решение:

  • Откройте wp-config.php в текстовом редакторе (лучше используйте редактор кода, а не Word).
  • Убедитесь, что первая строка содержит только <?php (без пробелов перед ним).
  • После закрывающего тега ?> не должно быть никаких символов (рекомендуется вообще удалить ?> в конце файла — это безопасно).
  • Проверьте, не сохранил ли редактор файл в кодировке UTF-8 с BOM. Пересохраните в UTF-8 без BOM.

3. Ошибка "Your PHP installation appears to be missing the MySQL extension"

Причина: Модуль PHP для работы с MySQL не установлен или не включён.

Решение:

  • В панели хостинга выберите версию PHP и убедитесь, что включены расширения mysqli и pdo_mysql.
  • Если управляете сервером самостоятельно (Ubuntu/Debian), установите модуль:
    sudo apt update
sudo apt install php-mysql
sudo systemctl restart apache2   # или nginx + php-fpm
  • Проверьте, что файл php.ini содержит строку extension=mysqli.

4. Вместо сайта отображается список файлов

Причина: Веб-сервер не обрабатывает index.php как главный файл.

Решение:

  • Создайте (или отредактируйте) файл .htaccess в корне сайта и добавьте:
    DirectoryIndex index.php index.html
  • Если используете nginx, проверьте настройки index index.php; в конфигурации сервера.

5. Сайт отображает "кашу" из PHP-кода

Причина: PHP не обрабатывается сервером — значит, интерпретатор не установлен или не настроен.

Решение:

  • Убедитесь, что файлы имеют расширение .php.
  • На хостинге проверьте, что выбрана версия PHP в панели управления.
  • Если вы настраиваете сервер вручную, установите PHP и модули для веб-сервера (например, libapache2-mod-php для Apache).
  • Перезапустите веб-сервер.

6. Не загружаются изображения или медиафайлы

Причина: Неправильные права на папку wp-content/uploads или ограничение размера файла в PHP.

Решение:

  • Установите права 755 на папку uploads и её подпапки (через FTP или команду chmod -R 755 wp-content/uploads).
  • Увеличьте лимиты в php.ini или через wp-config.php:
    @ini_set('upload_max_filesize', '64M');
@ini_set('post_max_size', '64M');
@ini_set('memory_limit', '256M');
  • Если используется Rich Text Editor, не перетаскивайте изображения в редактор — используйте кнопку "Добавить медиафайл".

7. Ошибка при запуске скрипта установки (install.php)

Причина: Неверные права записи или отсутствие файла wp-config.php.

Решение:

  • Если скрипт не может создать файл конфигурации, создайте его вручную (см. шаг 3 установки). Возможно, папка, куда вы загружаете WordPress, недоступна для записи — установите права 755 или 777 временно на корневую папку сайта.
  • Убедитесь, что имя базы данных, пользователь и пароль введены без ошибок.

Полезные советы

  • Регулярно обновляйте WordPress, темы и плагины — многие ошибки исправляются с выходом новых версий.
  • Используйте дочернюю тему при внесении изменений в шаблон — это предотвратит потерю правок при обновлении родительской темы.
  • Делайте резервные копии файлов и базы данных перед любыми манипуляциями.
  • Проверяйте логи сервера (обычно доступны в панели хостинга: Error Log) — там часто указана точная причина ошибки.
  • Если ошибка появилась после установки плагина или темы — удалите его через FTP (папки wp-content/plugins/nazvanie или wp-content/themes/nazvanie).
  • При использовании команд в SSH для скачивания WordPress напрямую на сервер выполните:
    wget https://wordpress.org/latest.tar.gz
tar -xzvf latest.tar.gz
  • Для создания базы данных через командную строку MySQL:
    CREATE DATABASE wordpress CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'wordpressuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wordpress.* TO 'wordpressuser'@'localhost';
FLUSH PRIVILEGES;

Соблюдая эти рекомендации, вы сможете устранить большинство неполадок WordPress без обращения в поддержку. Если проблема остаётся, обратитесь к своему хостинг-провайдеру — возможно, ограничения на стороне сервера.