Власні інструменти налагодження WordPress, які не потребують IDE

Останнє оновлення Гру 3, 2022

Зміст

Власні інструменти налагодження WordPress

Якщо ви щойно приєдналися до сайту та шукаєте вміст спеціально для The Independent WordPress Developer, я рекомендую прочитати попередню публікацію – принаймні – щоб підготуватися до вмісту в цій публікації.

Однак якщо ви хочете наздогнати попередню статтю, ось короткий перелік усього, що було написано до цього моменту:

Коли ми готуємося перейти до обговорення більш складних тем, таких як налагодження та 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, і зазвичай у файлі wp-config.php для розробників WordPress встановлюється значення true.

Це передбачає, що ви розумієте константи 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.
display_errors. У Кодексі згадується, що ви можете встановити значення false, але я думаю, що для цього потрібно встановити значення true, щоб увімкнути помилки та попередження.
SCRIPT_DEBUG. Ядро WordPress використовує мінімізовані версії файлів CSS і JavaScript. Якщо вимкнути цей параметр, ви зможете переглядати весь вміст файлів у вихідному вигляді. Це особливо корисно, якщо ви збираєтеся робити внесок у Core або працювати з JavaScript, включеним у Core.
ЗБЕРЕЖЕННЯ ЗАПИТІВ. На мій погляд, це трохи розширеніший параметр. Коротше кажучи, він візьме всі запити, які виконуються до бази даних, і збереже їх у масиві PHP, який ви зможете пізніше проаналізувати. Це

Тепер, коли ми розглянули налаштування WordPress, що з плагінами?

Плагіни для налагодження

Коли я кажу, що репозиторій повний плагінів для цього, я маю на увазі це. Насправді, якщо ви новачок у розробці WordPress, я б не радив шукати речі для встановлення.

Це може швидко стати приголомшливим, ви ризикуєте не зрозуміти, що роблять деякі з них, і потенційно спрямує вас на шлях, на якому ви зрештою зіпсуєте інсталяцію.

Замість цього я рекомендую переглянути наступні плагіни (звичайно, спочатку прочитавши їх опис), а потім перейти звідти:

Панель налагодження. Лише цей плагін додає меню до панелі адміністратора, яке дозволить вам переглядати запит, кеш та іншу інформацію. Для цього потрібно ввімкнути WP_DEBUG і SAVEQUERIES, як зазначено вище.
Налагодження сценаріїв і стилів списку рядків. Це доповнення до вищезазначеного плагіна, яке дозволить вам налагоджувати подальші стилі JavaScript і CSS, які працюють у контексті WordPress.
Консоль панелі налагодження. Цей плагін слід використовувати без вагань. Принаймні, це дозволяє вам виконувати PHP і MySQL із самого WordPress. Я не рекомендую цей плагін, якщо ви не дуже добре володієте однією з двох мов. І все-таки, якщо ви так, це те, що може бути потужним для створення прототипу функції чи запиту перед тим, як вбудовувати їх у ваш плагін.

Перегляд журналів помилок

У наступній публікації ми почнемо дивитися на те, що необхідно для вивчення журналу помилок, який генерує WordPress, і як зрозуміти інформацію, яку ми бачимо.

Крім того, ми розглянемо, що необхідно для використання плагінів, описаних у цій публікації. Після цього ми перейдемо до ще більш просунутих інструментів.

Але крок за кроком, чи не так?

Наразі налаштуйте інсталяцію, як описано вище, встановіть пов’язані плагіни, а потім зробіть усе можливе, щоб дослідити, як вони працюють, що ви можете бачити на екрані та як це може вплинути та позитивно принести користь вашому розвитку.

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

Джерело запису: tommcfarlin.com