WordPress логи — логирование ошибок и действий на сайте
Диагностика проблем, возникающих на сайте WordPress, может оказаться сложной. Наглядный способ проследить появление ошибок и получить обратную связь – использование журнала логов. Изучение записей в логах позволит выяснить причину проблемы и устранить ее.
Где хранится лог ошибок ВордПресс и как его посмотреть
Первый шаг к исправлению ошибок на сайте – выяснить, при каких обстоятельствах они возникают. Кроме того, периодически могут появляться неявные ошибки и системные предупреждения, о которых вы не знаете, поскольку ваши действия их никогда не вызывали, но посетители сайта могли это заметить.
Чтобы просмотреть ошибки и предупреждения, необходимо записать их в специальный файл журнала. Ведение журнала логов является хорошей практикой, особенно если сайт находится в стадии разработки. Возможно, вам не удастся понять причину ошибки, когда она впервые возникнет, но как только вы получите больше информации при последующей работе, логи в журнале окажутся очень полезными для анализа ситуации.
Фактический журнал логов хранится в файле с именем debug.log в каталоге содержимого вашего сайта wp-content на сервере хостинг-провайдера. Как посмотреть логи? Один из способов просмотра и очистки журнала – прямой доступ к этому файлу. Скачайте файл с помощью файлового менеджера и откройте его любым текстовым редактором. Можно воспользоваться плагинами, которые упрощают работу с логами.
Можно ли удалять логи? Файл с отладочной информацией и уведомлениями об ошибках со временем может разрастись до внушительных размеров. Поэтому, если ваш сайт работает нормально, то старые логи можно удалить, чтобы освободить рабочее пространство.
Как включить/выключить логирование
Чтобы включить создание лог-журнала для сайта на WordPress, понадобится внести изменения в системный файл wp-config.php, который расположен на сервере хостинга.
- Запустите файловый менеджер и подключитесь к удаленному серверу со своей учетной записью, который вам предоставил хостинг-провайдер.
- Перейдите в корневой каталог, где установлен ваш сайт.
- Сделайте резервную копию файла wp-config.php, чтобы восстановить систему после завершения отладки.
Откройте файл wp-config.php на удаленном сервере, вставьте или отредактируйте строки, которые управляют созданием логов:
define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );
define( ‘WP_DEBUG_LOG’, true );
Большинство сайтов на WordPress уже имеют запись для константы WP_DEBUG, установленную в значение false, поэтому вам нужно изменить это значение на true. Строка с WP_DEBUG_LOG может отсутствовать, поэтому придется ее добавить, эта команда активирует создание журнала логов для сайта. Константа WP_DEBUG_DISPLAY, установленная в значение false, поможет скрыть запись логов от посетителей сайта. Убедитесь, что каждая константа определена в файле только один раз.
Лог действий в WordPress
После того как запись логов включена, перейдите в папку содержимого сайта на WordPress. Обычно она называется wp-content, если вы не переименовали ее ранее. Откройте файл журнала debug.log, перейдите в конец и найдите строки с метками времени, соответствующими вашим недавним действиям над сайтом.
Каждый раз, когда возникает предупреждение или ошибка в работе сайта, WordPress генерирует уведомление, которое записывается в журнал логов с отметкой времени в формате UTC. По этим причинам на работающем сайте рекомендуется оставить WP_DEBUG включенным. Устраните выявленные проблемы, при необходимости восстановите оригинальный файл wp-config.php.
Ведение логов на сайте полезно, поскольку позволяет выяснить, какие именно действия вызывают ошибки, какие действия пользователей или администраторов сайта чаще всего провоцируют их возникновение. Кроме того, в логах фиксируется вся информация об изменениях на сайте, что позволяет отслеживать динамику сайта.
Плагины для логирования действий
Разработано несколько специальных плагинов, позволяющих просмотреть журнал логов напрямую из админки WordPress. Вы можете установить их прямо в админпанели в разделе «Плагины»
Activity Log – популярный плагин с большим количеством активных установок. Позволяет записать хронологию действий пользователей, их вход в админку и выход. Будут зафиксированы последние действия со страницами и записями, удаление и установка тем и плагинов.
WP Security Audit Log – плагин для мониторинга действий пользователей в админке сайта. Можно использовать для ведения лог-журнала электронного магазина WooCommerce и отслеживать изменение состояния продукта. Плагин создает предупреждение о безопасности, когда в системе создается новый пользователь, и позволяет отследить подозрительную активность, прежде чем это станет проблемой безопасности.
WP Log Viewer – плагин создает виджет панели администратора и позволяет включить/отключить запись лога одним щелчком мыши, при этом не требуется вручную редактировать файл wp-config.php. Можно выполнить фильтрацию ошибок, очистить журнал, сортировать записи по дате или провести поиск ошибок по времени. Пользовательские ошибки обозначаются разными цветами.
Error Log Monitor – этот плагин добавляет виджет, который видим только для администраторов. Он отображает последние сообщения из журнала логов, а также умеет отправлять уведомления по электронной почте о новых возникших ошибках. Частота уведомлений и количество отображаемых записей в журнале настраивается. Плагин оптимизирован для работы с очень большими лог-файлами.
iPipe – надёжный хостинг-провайдер с опытом работы более 15 лет.
- Виртуальные серверы с NVMe SSD дисками от 299 руб/мес
- Безлимитный хостинг на SSD дисках от 142 руб/мес
- Выделенные серверы в наличии и под заказ
- Регистрацию доменов в более 350 зонах
Журналы (Logs) данных и ошибок в WooCommerce
Начиная с версии 2.7 в WooCommerce внедрили новый метод логирования данных и ошибок. Это удобно для отслеживания процессов в системе и диагностики проблем.
Использование
Идем в консоль сайта, далее раздел WooCommerce / Статус. Далее вкладка Журналы (Log).
Выбираем нужный журнал. Например если это какой-то плагин, то обычно журнал будет начинаться с названия этого плагина. Либо как на снимке может быть лог обновления БД:
Режим записи журнала в БД
Можно существенно улучшить наглядность журналов и удобство работы с данными если активировать режим записи в БД вместо файлов.
Для этого в wp-config.php можно добавить константу:
define( 'WC_LOG_HANDLER', 'WC_Log_Handler_DB' );После этого журнал станет удобней и будет доступен поиск по данным:
Разработка
Класс называется WC_Logger , вызывается функцией wc_get_logger();
$logger = wc_get_logger(); // $context may hold arbitrary data. // If you provide a "source", it will be used to group your logs. // More on this later. $context = array( 'source' => 'my-extension-name' ); $logger->debug( 'Detailed debug information', $context ); $logger->info( 'Interesting events', $context ); $logger->notice( 'Normal but significant events', $context ); $logger->warning( 'Exceptional occurrences that are not errors', $context ); $logger->error( 'Runtime errors that do not require immediate', $context ); $logger->critical( 'Critical conditions', $context ); $logger->alert( 'Action must be taken immediately', $context ); $logger->emergency( 'System is unusable', $context ); // The `log` method accepts any valid level as its first argument. $logger->log( 'debug', 'Внедряем это в свой плагин и получаем удобную систему лога данных и ошибок в магазине.
Частично мы уже внедрили это в плагине WooMS для интеграции МойСклад и WooCommerce. Но далее планируем развивать эту идею.
Отладка в WordPress
Отладка кода важна для любого проекта. WordPress поставляется с системами отладки, разработанными для упрощения процесса, а также для стандартизации кода в ядре, плагинах и темах. На этой странице описываются различные инструменты отладки в WordPress и способы повышения продуктивности кода, а также повышения его общего качества и функциональности. Для не программиста или обычного пользователя эти параметры могут использоваться для отображения подробной информации об ошибке.
WP_DEBUG
WP_DEBUG это константа PHP , используемая для установки режима отладки в WordPress. По умолчанию она имеет значение «false», но может быть установлена как «true» в файле конфигурации wp-config.php на сайтах, на которых проводится отладка.
define( 'WP_DEBUG', true ); define( 'WP_DEBUG', false );
Заметка: значения true и false в примере не заключены в кавычки или апострофы, поскольку являются булевыми (правда/ложь) значениями. Не заключайте их в кавычки (например 'false' ), иначе они станут восприниматься как строковые значения. Не рекомендуется включать WP_DEBUG или другие инструменты отладки на рабочих сайтах, отладку рекомендуется производить при локальном тестировании или на разрабатываемых сайтах. Наверх ↑
PHP ошибки, предупреждения, и заметки
Включение WP_DEBUG приведет к отображению всех ошибок, предупреждений и заметок PHP. Скорее всего это изменит поведение по умолчанию PHP, при котором могут отображаться только фатальные ошибки или белый экран. Отображение всех уведомлений и предупреждений PHP часто приводит к сообщениям об ошибках для того, что может быть и не сломано, но нарушает надлежащие правила проверки данных в PHP. Эти предупреждения легко исправить разработчикам, если соответствующий код был идентифицирован. Заметка: Не стоит самостоятельно заниматься исправлением кода ядра, плагинов, тем. Сообщите о проблеме разработчикам соответствующих компонентов, чтобы они внесли исправления в будущих версиях. Наверх ↑
Устаревшие функции и аргументы
Включение WP_DEBUG также будет вызывать уведомления об устаревших функциях и аргументах в WordPress, которые используются на вашем сайте. Это функции или аргументы функций, которые еще не были удалены из основного кода, но должны быть удалены в ближайшем будущем. Уведомления об устаревании часто указывают на новую функцию, которую следует использовать вместо этого. Наверх ↑
WP_DEBUG_LOG
WP_DEBUG_LOG это дополнение к WP_DEBUG которое позволяет сохранять ошибки в файл debug.log. Это полезно если вы хотите посмотреть ошибки позже или посмотреть то, что не выводится на экран (например для AJAX запросов или работы wp-cron). Заметьте, что запись в лог производится внутренней функцией PHP error_log() , она очень удобна для отладки событий AJAX. При установке в значение true , журнал будет сохраняться как wp-content/debug.log на вашем сайте. Вы можете задать альтернативное имя, для сохранения его в другом месте.
define( 'WP_DEBUG_LOG', true ); -или- define( 'WP_DEBUG_LOG', '/tmp/wp-errors.log' );
Заметка: Для работы WP_DEBUG_LOG нужно включить WP_DEBUG (true). Вы можете независимо от этого отключить WP_DEBUG_DISPLAY . Наверх ↑
WP_DEBUG_DISPLAY
WP_DEBUG_DISPLAY это другое дополнение для WP_DEBUG , которое контролирует вывод сообщений отладки в HTML код страницы (на экран). Значение по умолчанию — ‘true’, что позволяет видеть ошибки и предупреждения на экране, в момент их возникновения. Установка значения как false спрячет все ошибки, что можно использовать вместе с WP_DEBUG_LOG , чтобы просмотреть ошибки из файла позже.
define( 'WP_DEBUG_DISPLAY', false );
Заметка: Для работы WP_DEBUG_LOG нужно включить WP_DEBUG (true). Вы можете независимо от этого использовать WP_DEBUG_LOG Наверх ↑
SCRIPT_DEBUG
SCRIPT_DEBUG это константа, позволяющая использовать версии для разработки CSS и JavaScript файлов ядра, вместо их оптимизированных версий, которые используются по умолчанию. Константа полезна при тестировани изменений в стандартных файлах .js и .css. По умолчанию — false. define( 'SCRIPT_DEBUG', true ); Наверх ↑
SAVEQUERIES
Определение SAVEQUERIES будет сохранять запросы к СУБД в массив, который можно проанализировать. При определении константы как true, будут сохраняться все запросы, время исполнения, функция вызова запроса.
define( 'SAVEQUERIES', true );
Массив сохраняется в глобальном $wpdb->queries . Заметка: Это сильно снижает производительность вашего сайта. Наверх ↑
Пример файла wp-config.php для отладки
Следующий код в файле wp-config.php включит запись всех ошибок, предупреждений и заметок PHP в файл debug.log внутри папки wp-content. Он также отключит вывод на экран (в код страницы):
// Включить отладку WP_DEBUG define( 'WP_DEBUG', true ); // Включить журнал /wp-content/debug.log define( 'WP_DEBUG_LOG', true ); // Отключить вывод на экран define( 'WP_DEBUG_DISPLAY', false ); @ini_set( 'display_errors', 0 ); // Использовать версии JS и CSS для разработчика (при тестировании изменений в них) define( 'SCRIPT_DEBUG', true );
Заметка: Это нужно вставить перед /* Это всё, дальше не редактируем. Успехов! */ в файл wp-config.php . Наверх ↑
Плагины для отладки
- Query Monitor
- Debug Bar
- Log Deprecated Notices
Внешние ссылки
- Генератор файла «wp-config.php»
- Плагин «No White Screen»: показывает ошибку вместо белого экрана
Как настроить логи ошибок в WordPress
Хотите настроить журналы ошибок WordPress в файле wp-config? Файл wp-config WordPress не только управляет настройками вашего сайта WordPress, но и является очень полезным инструментом отладки, который поможет вам найти и исправить ошибки. В этом руководстве мы покажем вам, как настроить журналы ошибок WordPress в файле wp-config.
Когда и почему следует настраивать журналы ошибок WordPress в WP-Config?
Файл wp-config.php — это файл конфигурации WordPress, который содержит важные настройки WordPress. Эти настройки сообщают Веб-сайт как подключиться к вашей базе данные WordPress, какой базовый префикс таблицы данные использовать и генерировать ключи аутентификации для защиты вашего сайта WordPress.
Помимо настроек WordPress по умолчанию, файл wp-config также можно использовать для установки нескольких других настроек. Он также может включать режим отладки WordPress и сохранять журналы ошибок WordPress.
Это поможет вам найти ошибки WordPress, определив плагины или скрипты, которые их вызывают. Затем вы можете найти исправление этих ошибок WordPress.
При этом давайте посмотрим, как включить и настроить журналы ошибок WordPress в файле wp-config.
Настройка журналов ошибок WordPress в файле WP-Config
Сначала вам нужно будет отредактировать файл wp-config.php. Вы можете получить к нему доступ, войдя в свой Веб-сайт с использованием FTP-клиент или приложение File Manager в cPanel.
Вы найдете файл wp-config.php в корневом каталоге вашего компьютера. Веб-сайт. Откройте файл в любом текстовом редакторе и найдите строку с надписью «Это все, хватит редактировать! Счастливый блоггинг.
Перед этой строкой вам нужно будет добавить следующий код:
define( 'WP_DEBUG' , true );
Возможно, этот код уже есть в вашем файле wp-config.php и имеет значение false. В этом случае вам просто нужно изменить его на «true».
Только эта строка активирует режим отладки WordPress. Однако недостатком использования только этой отладки является то, что вы увидите ошибки и предупреждения WordPress в области панели инструментов, а также на интерфейсе вашего веб-сайта.
Если вы хотите, чтобы ошибки были сохранены, вам также необходимо добавить следующий код в файл wp-config.php чуть ниже строки WP_DEBUG.
define( 'WP_DEBUG_LOG' , true );
Не забудьте сохранить изменения и загрузить файл wp-config.php на свой сайт.
Проверка журналов ошибок WordPress
Сначала вы должны посетить свой сайт WordPress и перейти к страницам, на которых появляются ошибки или предупреждения. После этого вам нужно будет войти на свой веб-сайт с помощью FTP-клиента или приложения для управления файлами в cPanel.
После входа в систему перейдите в / wp-content / и внутри вы найдете файл с именем debug.log.
Вы можете скачать, просмотреть или отредактировать этот файл. Он будет содержать все зарегистрированные ошибки, предупреждения и уведомления WordPress.
Мы надеемся, что эта статья поможет вам узнать, как настроить журналы ошибок WordPress в WP-Config.