Мы все испытывали чувство страха после внесения изменений на наш веб-сайт, а затем получали белый экран или сломанную функциональность. Устранение таких неполадок может быть сложным, поскольку проблемы не всегда проявляются сразу. Вот где инструменты ведения журнала и отладки становятся бесценными для вашего веб-сайта WordPress.
К счастью, WordPress предлагает встроенную функцию отладки, которую легко включить, и которая может сэкономить вам время и головную боль при устранении неполадок на сайте. По умолчанию эта функция отключена, поэтому нам нужно включить ее, чтобы увидеть коды ошибок.
В этой статье мы расскажем вам, как включить отладку WordPress и как сохранить сгенерированные данные отладки в файле журнала для удобства просмотра.
Поиск и включение журнала отладки WordPress (wp-config.php)
Найти и отредактировать файл wp-config для включения отладочной функции просто. Доступ к нему можно получить через cPanel или FTP-клиент, такой как FileZilla. В нашем примере ниже мы используем FileZilla, который можно использовать и скачать бесплатно. Этот процесс использует константу PHP с именем WP_DEBUG. Она должна быть установлена на ‘ true ‘ в файле wp-config.php на вашем веб-сервере, о котором мы сейчас вам расскажем.
1: Используя данные для входа, предоставленные вашим веб-хостингом, подключитесь к своему серверу с FileZilla.
2: Найдите и скачайте файл wp-config.php. Обычно он находится в корневом каталоге вашего хостинг-пространства в папке public_html.
3: Из выбранного вами места загрузки откройте wp-config.php с помощью текстового редактора, например Notepad или Notepad++. Внутри файла найдите константу ‘ WP_DEBUG ‘ и установите следующую строку на ‘ true ‘.
define('WP_DEBUG', true);
4: Сохраните изменения и повторно загрузите их на свой веб-сервер, заменив старый файл новым.
Дополнительные константы PHP для отладки
Изменения, которые мы внесли в наш файл wp-config.php выше, включают режим журнала отладки WordPress. Есть две дополнительные строки, которые мы можем добавить, названные WP_DEBUG_DISPLAY и WP_DEBUG_LOG.
WP_DEBUG_DISPLAY
Если вы в настоящее время разрабатываете свой сайт WordPress и не возражаете против отображения кодов ошибок на фронтенде, вы можете включить WP_DEBUG_DISPLAY. Вы можете сделать это, изменив соответствующую строку в wp-config.php на «true» вместо «false». Поскольку эти коды ошибок отображают подробную информацию о вашем сайте, мы рекомендуем вам использовать WP_DEBUG_DISPLAY только во время разработки или в очень особых обстоятельствах.
WP_DEBUG_LOG При включении эта константа PHP позволит нам создать файл журнала отладки, в котором будут храниться все ошибки WordPress для просмотра и устранения неполадок. После включения местоположение файла журнала отладки WordPress должно находиться в папке wp-content.
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', true);
В приведенном выше примере установка WP_DEBUG_DISPLAY на «false» и WP_DEBUG_LOG на «true» означает, что все наши журналы ошибок теперь будут:
- Сгенерировано
- Скрыто от пользователей, просматривающих сайт
- Сохраняется на нашем веб-сервере для устранения неполадок с помощью созданного нами журнала отладки WP.
Теперь, когда мы лучше понимаем константы PHP и включили отладочное ведение журнала, давайте посмотрим, где находится ваш файл журнала. Просмотр вашего журнала отладки может быть выполнен путем доступа к файлу с вашего веб-сервера, поэтому давайте начнем.
Как просмотреть журнал отладки WordPress
После того, как мы внесем изменения в наш wp-config.php и заменим старый файл, ваш отладочный журнал WordPress будет находиться в ‘ /wp-content/debug.log ‘. Если вы не видите файл журнала сразу, не волнуйтесь, его создание может занять несколько минут. Иногда отключение и повторное подключение к FTP-серверу может решить эту проблему, если у вас возникли проблемы с его просмотром.
Щелкните правой кнопкой мыши по файлу и выберите «Загрузить». Теперь вы сможете открыть и просмотреть файл журнала в текстовом редакторе.
Разбираемся в журнале отладки WordPress
Теперь не все, что содержится в журнале отладки, является проблемой, которую нужно решить немедленно. Ваш файл будет содержать ошибки PHP, предупреждения и уведомления, предоставляя вам ценную информацию о том, что происходит на вашем веб-сайте WordPress.
Ошибки
Эти журналы критически важны и должны быть приоритетными. Ошибки в вашем журнале отладки предупреждают вас о проблемах, которые серьезно влияют на функциональность вашего веб-сайта и должны быть устранены как можно скорее.
Предупреждения
Предупреждения в вашем журнале отладки менее серьезны, чем ошибки. Они указывают на такие вещи, как недопустимый путь или отсутствующий файл. Эти предупреждения следует обрабатывать соответствующим образом, чтобы снизить риск возникновения более серьезных проблем в будущем.
Уведомления
Думайте об этом как о ‘FYI’ вашего веб-сайта, предупреждающем вас о менее важных проблемах, таких как неопределенные переменные в файлах тем и плагинах. Хотя эти проблемы не приведут к остановке работы вашего сайта, хорошей практикой будет применить все возможные исправления как можно скорее, чтобы предотвратить проблемы.
Пример
Вот пример из журнала, который я сгенерировал. Давайте пройдем процесс определения того, что произошло и важно ли это.
[28-May-2024 20:28:17 UTC] PHP Deprecated: Using ${var} in strings is deprecated, use {$var} instead in /home/website/public_html/wp-content/plugins/admin-notices-manager/includes/functions/core.php on line 136
Если вы не знакомы с кодом PHP, не волнуйтесь — вам не нужно знать, как писать код, чтобы получить хорошее представление о том, что происходит. Если мы посмотрим на пример выше, мы увидим время и тот факт, что предупреждение описано как «PHP Deprecated». Это указывает на устаревший код, который следует обновить, чтобы обеспечить совместимость с будущими версиями PHP.
Вы можете легко определить, какие части файла журнала являются предупреждениями или ошибками, обращая внимание на формулировку в первой части кода. Оттуда вы можете начать собирать воедино то, что пошло не так и как исправить проблему.
Установка плагина для автоматизации отладки отчетов WordPress
Существует несколько плагинов WordPress, которые могут упростить отладку WordPress. Если вы регулярно работаете над своим сайтом, возможность просматривать отчеты об отладке и коды ошибок на панели инструментов WordPress может помочь вам выявить и устранить проблемы на ранней стадии
Установка плагина отладки WordPress — это быстрое и простое решение для поддержания отладки и здоровья вашего веб-сайта на самом высоком уровне. Это может предоставить вам более полный отчет об отладке по сравнению с функциональностью отладки WordPress по умолчанию.
Есть несколько дополнительных факторов, которые следует учитывать при использовании плагина для отладки WordPress. Эти факторы включают:
- Стоимость плагина
- Влияние на производительность сервера
- Последствия для безопасности
- Потенциально избыточные уведомления
Многие плагины отладки позволяют вам устанавливать частоту уведомлений, которую можно увеличивать или уменьшать при необходимости.
Процесс установки плагина для отслеживания важных событий отладки быстрый, простой и бесплатный. Давайте рассмотрим этот процесс.
1: Войдите в панель управления вашего сайта WordPress и выберите «Плагины» > «Добавить новый плагин».
2: Найдите «Error Log Monitor» в поле поиска и установите плагин от Janis Elsts.
3: Обязательно включите плагин, выбрав «Активировать» после завершения процесса установки.
4: После активации вернитесь на панель инструментов, где вы увидите новое поле, отображающее все данные журнала ошибок PHP.
5: Настройте плагин, наведя курсор на область заголовка поля, а затем щелкнув появившийся текст «Настроить».
6: Не торопясь измените настройки, которые лучше всего соответствуют вашим предпочтениям, затем нажмите кнопку «Сохранить изменения», расположенную в нижней части окна.
Вот и все — теперь вы будете получать уведомления о журналах вашего сайта WordPress в соответствии с вашими потребностями и предпочтениями.
Улучшение общего ведения журнала WordPress
Хотя журнал отладки отлично показывает, что происходит на вашем сайте WordPress, он не всегда может рассказать вам много о том, как возникли эти проблемы. Возможность определить, какой пользователь изменил настройки или установил плагины, может значительно сократить время устранения неполадок и помочь предотвратить повторение этих проблем.
Вот тут-то и приходит на помощь WP Activity Log, предоставляя полный журнал событий на вашем сайте. В сочетании с инструментом отладки WordPress он создает мощную комбинацию для выявления и устранения проблем с вашим сайтом.
Вам даже не придется вручную переходить к каждому соответствующему плагину, когда вы захотите проверить журналы вашего веб-сайта. Используя бэкэнд WordPress (панель инструментов), вы можете увидеть все одним взглядом.
Любое из событий в журнале активности WP можно щелкнуть, чтобы открыть дополнительную информацию о журнале. Вы также можете развернуть его снова, чтобы открыть дополнительную информацию о событии и о том, какой пользователь его инициировал.
Заключение
Включение режима отладки WordPress и использование журнала отладки WP — это простой и эффективный способ отладки WordPress. С помощью настраиваемого ведения журнала и дополнительных сторонних плагинов вы можете легко быть в курсе всех изменений, внесенных на ваш сайт. Это также помогает вам выявлять любые проблемы, требующие внимания, без необходимости использовать FTP или cPanel для посещения местоположения журнала отладки WordPress.
Эти отчеты об ошибках и журналы можно настроить так, чтобы они лучше соответствовали статусу разработки вашего веб-сайта, с более подробными отчетами об ошибках, которые возможны во время разработки WordPress, и более тонким и безопасным протоколированием через файл debug.log после запуска вашего сайта. Когда журнал отладки WP используется вместе с таким программным обеспечением, как WP Activity Log, веб-мастера и администраторы получают более подробную информацию о состоянии своего веб-сайта и могут принимать превентивные меры или применять исправления, регистрируя все пользовательские события и изменения на веб-сайте.
Часто задаваемые вопросы по отладке WordPress
Несколько часто задаваемых вопросов могут возникнуть при использовании WP_DEBUG и других инструментов отладки в WordPress. Давайте рассмотрим некоторые из этих вопросов и ответы на них.
Стоит ли использовать плагин для отладки?
Использование плагина — отличный способ оптимизировать процесс отладки в WordPress. Вы по-прежнему можете вручную проверять журнал отладки WP, если хотите, но наличие плагина — это простой и удобный способ оставаться в курсе всех событий на вашем сайте. Плагины могут предоставлять уведомления в WordPress, но также могут отправлять вам по электронной почте подробные журналы.
Все ли в журнале отладки WordPress является ошибкой?
Не все, что включено в журнал отладки WP, является ошибкой. Некоторые из них являются предупреждениями и другими уведомлениями, которые не требуют немедленного внимания. Предупреждения и уведомления могут быть полезны при устранении более крупных проблем, поскольку они предоставляют дополнительный контекст и информацию.
Безопасно ли использовать WP_DEBUG на работающем сайте?
В большинстве случаев следует избегать использования WP_DEBUG на работающем сайте. Лучше всего использовать его на тестовом сайте, когда вы тестируете сайт перед его запуском. Если вы используете WP_DEBUG на работающем сайте, мы рекомендуем установить WP_DEBUG_DISPLAY на «false» и включить ведение журнала через WP_DEBUG_LOG. Это убережет ваш сайт от отображения ошибок на внешнем интерфейсе. Эти ошибки не только выглядят непрофессионально для посетителей, просматривающих ваш сайт, но и могут раскрыть конфиденциальную информацию о вашем сайте, включая потенциальные уязвимости, которые могут быть использованы.
Что такое константа SAVEQUERIES в WordPress?
Константа SAVEQUERIES — это константа PHP, которую можно включить в файле wp-config.php. При включении она регистрирует все запросы к базе данных, сделанные вашим сайтом WordPress, что может быть особенно полезно для оптимизации и устранения неполадок, связанных с базой данных WP. Использование SAVEQUERIES на работающем сайте может представлять угрозу безопасности, поскольку она регистрирует конфиденциальную информацию, включая пользовательские данные. Поэтому ее следует использовать с осторожностью и только в безопасной среде разработки.
Могу ли я регистрировать пользовательские сообщения в журнале отладки WordPress?
Функция error_log() позволяет вам создавать пользовательские сообщения в вашем журнале отладки WordPress. Это рекомендуется для более продвинутых пользователей и должно использоваться только в определенных обстоятельствах при попытке определить определенные проблемы. Эти журналы будут отображаться в вашем файле debug.log, расположенном в папке wp-content на вашем веб-сервере. С помощью error_log() вы можете регистрировать данные, такие как значения переменных, данные массива и условные журналы, которые могут помочь при отладке веб-сайта.