Нативные инструменты отладки WordPress, не требующие IDE

Последнее обновление Дек 3, 2022

Содержание

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

Однако, если вы хотите продолжить предыдущую статью, вот краткий список всего, что было написано до сих пор:

Поскольку мы готовимся перейти к разговору о более сложных темах, таких как отладка и IDE, в первую очередь стоит отметить инструменты, которые у нас есть, которые мы можем установить в WordPress, которые помогут нам с отладкой во время разработки.

Кроме того, эти проблемы не связаны строго с проблемами PHP. К ним также относятся проблемы с JavaScript. И чтобы сделать еще один шаг вперед, есть способы, с помощью которых мы можем настроить WordPress изначально, чтобы он выдавал ошибки непосредственно в наш браузер.

Поэтому, прежде чем мы рассмотрим журналы ошибок, IDE, Xdebug и т. д., мы посмотрим, что мы можем сделать в самом WordPress.

Нативные инструменты отладки WordPress

Собственные инструменты отладки WordPress представляют собой комбинацию двух вещей:

параметры, которые мы можем установить в файле конфигурации WordPress, которые позволяют нам видеть информацию, записываемую на экран,
несколько плагинов, которые помогут нам работать с файлами PHP и JavaScript из области администрирования WordPress.

Что касается второго пункта выше, я хочу прояснить, что существует множество доступных плагинов для чего-то подобного; тем не менее, я хочу, чтобы установка была как можно более компактной, чтобы нас не завалило слишком большим количеством информации.

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

С учетом сказанного, давайте начнем.

Конфигурация WordPress

Прежде чем беспокоиться о конфигурации, сам WordPress предоставляет несколько различных параметров, которые мы можем настроить в wp-config.phpфайле. Они хорошо задокументированы в Кодексе, но по опыту работы с электронными письмами других людей я знаю, что просеивать информацию может быть довольно сложно.

Во-первых, важно отметить следующее (цитата из Кодекса WordPress):

WP_DEBUG — это константа PHP (постоянная глобальная переменная), которую можно использовать для запуска режима «отладки» во всем WordPress. Предполагается, что по умолчанию оно равно false, и обычно устанавливается в значение true в файле wp-config.php на разрабатываемых копиях WordPress.

Это предполагает, что вы понимаете константы PHP. Если нет, ознакомьтесь с руководством здесь (это довольно просто). Вкратце это так:

Константа — это идентификатор (имя) простого значения.

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

Во-первых, в wp-config.phpфайле вам нужно изменить строку , которая гласит:

<?php
define( 'WP_DEBUG', false );

К этому :

<?php
define( 'WP_DEBUG', true );

Но это еще не все. Есть еще несколько вещей, которые можно добавить, чтобы улучшить процесс отладки:

<?php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );

Если вы следуете в разделе Но что означает каждая строка? Вот самое краткое объяснение, которое я могу дать прямо сейчас:

WP_DEBUG. Это отобразит любые ошибки и предупреждения, выдаваемые PHP при запуске WordPress. Запуск приложения сам по себе не должен вызвать никаких проблем; однако запуск его вместе с различными плагинами может быть другой историей в зависимости от качества плагина.
WP_DEBUG_LOG. Это одна из моих любимых констант, и она подробно записывает все выходные данные в журнал. Я собираюсь рассказать об этом в следующем посте, но пока знайте, что это то, что, по моему мнению, всегда должно быть установлено в вашей среде разработки.
WP_DEBUG_DISPLAY. Это тот, который вы можете установить в true или false (хотя я предпочитаю true). Он дополняет предыдущую настройку, позволяя вам видеть сообщения в браузере, которые также записываются в блог. Я не знаю, будет ли это чем-то, что вы найдете полезным или нет. Если вы не готовы просматривать трассировку стека и более подробную информацию, вы можете рассмотреть возможность установки для этого параметра значения true.
отображение_ошибок. Кодекс упоминает, что вы можете установить это значение равным false, но я думаю, что оно должно быть установлено как true, чтобы включить ошибки и предупреждения.
СКРИПТ_ОТЛАДКА. Ядро WordPress использует уменьшенные версии файлов CSS и JavaScript. Отключение этого параметра позволит вам просматривать все содержимое файлов в исходном виде. Это особенно полезно, если вы собираетесь внести свой вклад в Core или работать с JavaScript, включенным в Core.
ЭКОНОМИЯ. На мой взгляд, это несколько более продвинутая настройка. Короче говоря, он будет принимать все запросы, которые выполняются к базе данных, и сохранять их в массив PHP, который вы сможете позже проанализировать. Это

Теперь, когда мы рассмотрели настройку WordPress, что насчет плагинов?

Плагины для отладки

Когда я говорю, что в репозитории полно плагинов для этого, я имею в виду именно это. На самом деле, если вы новичок в разработке WordPress, я бы не рекомендовал искать что-то для установки.

Это может быстро стать ошеломляющим, вы рискуете не понять, что делают некоторые из них, и, возможно, приведете вас по пути, на котором вы в конечном итоге сломаете свою установку.

Вместо этого я рекомендую взглянуть на следующие плагины (конечно, сначала прочитать их описание), а затем перейти к ним:

Бар отладки. Этот плагин сам по себе добавляет меню в панель администратора, которое позволит вам увидеть запрос, кеш и другую информацию. Для этого требуется, чтобы WP_DEBUG и SAVEQUERIES были включены, как описано выше.
Сценарий панели отладки и зависимости стилей. Это дополнение к вышеуказанному плагину, которое позволит вам отлаживать дополнительные стили JavaScript и CSS, которые работают в контексте WordPress.
Консоль панели отладки. Этот плагин следует использовать с осторожностью. По крайней мере, он позволяет запускать PHP и MySQL из самого WordPress. Я не рекомендую этот плагин, если вы не очень хорошо владеете одним из двух языков. Тем не менее, если да, это то, что может быть полезным для прототипирования функции или запроса, прежде чем встраивать его в ваш плагин.

Изучение журналов ошибок

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

Кроме того, мы рассмотрим, что необходимо для использования плагинов, описанных в этом посте. После этого мы перейдем к еще более продвинутому инструментарию.

Но шаг за шагом, верно?

А пока настройте свою установку, как описано выше, установите связанные плагины, а затем сделайте все возможное, чтобы изучить, как они работают, что вы можете увидеть на экране и как это может повлиять и положительно повлиять на вашу разработку.

Да, может быть немного кривой обучения. Но именно поэтому мы делаем это медленно. Нам предстоит многому научиться, и у нас достаточно времени, чтобы охватить всю необходимую информацию.

Источник записи: tommcfarlin.com