Бібліотеки для плагінів WordPress, частина 2
Учора я розпочав коротку серію дописів про інструменти, які, на мою думку, створюють високоякісний код у проекті WordPress (зокрема ті, які є плагінами, створеними з використанням об’єктно-орієнтованого підходу).
Якщо ви не читали публікацію, перший набір згаданих інструментів є таким:
Є ще близько п’яти інструментів, які я люблю використовувати в своїх проектах. Отже, ось наступні три, а останні два – у наступній публікації.
Бібліотеки для плагінів WordPress, продовження
Як згадувалося раніше, я вважаю ці інструменти корисними, коли працюю над об’єктно-орієнтованими плагінами WordPress. Крім того, вони, природно, розподілені між кількома публікаціями, щоб кожна була короткою та зосередженою.
PHP CodeSniffer
Якщо ви читаєте цей блог протягом певного часу, ви, швидше за все, читали допис або принаймні згадували щось про PHP CodeSniffer. Це те, що я думаю, якщо нічого іншого, кожен розробник WordPress повинен встановити у своїй IDE.
Зі сторінки сховища проекту:
PHP_CodeSniffer токенізує файли PHP, JavaScript і CSS і виявляє порушення визначеного набору стандартів кодування.
Тепер, щодо правил, це інша річ. Деякі люди віддають перевагу стандартам кодування WordPress ; деякі віддають перевагу PSR2, інші віддають перевагу іншим наборам правил. Справа не стільки в тому, що ви віддаєте перевагу, якщо ви або ваша команда послідовні.
І саме в цьому вам допомагає ця бібліотека. Крім того, це не завадить, що ви можете інтегрувати у свою IDE (припускаючи, що це один із найпопулярніших редакторів).
PHPCPD
PHPCPD — це проста бібліотека, яка аналізує ваш код, щоб виявити повторюваний код, який зазвичай виникає внаслідок копіювання та вставлення з іншого місця (навіть якщо це ваша база коду). Ідея бібліотеки полягає в тому, щоб зменшити повторюваний код.
І це не стає набагато ясніше , ніж це :
phpcpd — це детектор копіювання/вставлення (CPD) для коду PHP.
Іншими словами, це один крок до того, щоб допомогти вам зберегти його СУХИМ.
PHPMND
Якщо одна з цілей, до якої ми прагнемо в нашому коді, полягає в тому, щоб зробити його максимально читабельним для інших, які можуть підібрати базу коду, розгалужити його або зробити свій внесок у нього (особливо у відкритому вихідному коді), тоді нам потрібно переконатися, що всі наших цінностей мають значущі цінності.
Використання чисел, які мають для нас значення, але не описують, що саме робить код, є важливим, але це не те, що ми робимо, чи не так? А може, це тільки я.
Але тут у гру вступає PHPMND .
phpmnd — це інструмент, який допомагає виявляти магічні числа в коді PHP. За замовчуванням 0 і 1 не вважаються магічними числами.
Це проста бібліотека, але вона використовується в поєднанні з бібліотеками в цій публікації, а попередня публікація може допомогти постійно підвищувати якість коду, який ви додаєте до своїх репозиторіїв.
Ще один набір інструментів
Як згадувалося в попередній публікації, мета, над якою я працюю, полягає в тому, як об’єднати все це у composer.jsonфайл, який ви зможете використовувати у своєму проекті.
Пам’ятайте також, що залежно від проекту вам може знадобитися вибрати версію бібліотеки на основі версії PHP, яку ви використовуєте.