Biblioteki dla wtyczek WordPress, część 2
Wczoraj rozpocząłem krótką serię wpisów dotyczących narzędzi, które moim zdaniem służą do pisania wysokiej jakości kodu w projekcie WordPress (w szczególności te, które są wtyczkami zbudowanymi przy użyciu podejścia obiektowego).
Jeśli nie przeczytałeś posta, pierwszy zestaw wymienionych narzędzi jest następujący:
Jest jeszcze około pięciu innych narzędzi, które lubię używać w swoich projektach. Oto kolejne trzy, a ostatnie dwa pojawią się w następnym poście.
Biblioteki dla wtyczek WordPress, ciąg dalszy
Jak wcześniej wspomniałem, narzędzia te są dla mnie przydatne, gdy pracuję nad obiektowymi wtyczkami do WordPressa. Co więcej, są one naturalnie rozłożone na kilka postów, aby każdy z nich był krótki i skoncentrowany.
PHP CodeSniffer
Jeśli czytasz tego bloga przez dłuższy czas, prawdopodobnie przeczytałeś post lub przynajmniej wspomniałeś coś o PHP CodeSniffer. To jest coś, co myślę, że każdy programista WordPress powinien zainstalować w swoim IDE.
Ze strony repozytorium projektu:
PHP_CodeSniffer tokenizuje pliki PHP, JavaScript i CSS oraz wykrywa naruszenia określonego zestawu standardów kodowania.
Teraz, jeśli chodzi o zasady, to inna sprawa. Niektórzy wolą WordPress Coding Standards ; niektórzy wolą PSR2, inni wolą inne zestawy reguł. Nie chodzi o to, co wolisz, o ile Ty lub Twój zespół jesteście konsekwentni.
I w tym właśnie pomaga ta konkretna biblioteka. Dodatkowo nie zaszkodzi, że możesz zintegrować się ze swoim IDE (zakładając, że jest to jeden z bardziej popularnych edytorów).
PHPCPD
PHPCPD to prosta biblioteka, która analizuje twój kod w celu wykrycia zduplikowanego kodu – który zwykle pochodzi z kopiowania i wklejania z innego miejsca (nawet jeśli jest to twoja baza kodu). Ideą biblioteki jest redukcja duplikatów kodu.
I nie jest to dużo jaśniejsze niż to :
phpcpd to wykrywacz kopiowania/wklejania (CPD) kodu PHP.
Innymi słowy, jest to jeden krok, aby pomóc Ci utrzymać go w stanie suchym.
PHPMND
Jeśli jednym z celów, do których dążymy w naszym kodzie, jest uczynienie go jak najbardziej czytelnym dla innych, którzy mogą posiąść bazę kodu, rozwidlić ją lub wnieść do niej swój wkład (zwłaszcza w przypadku open source), musimy upewnić się, że wszystkie naszych wartości mają wartości znaczące.
Używanie liczb, które mają dla nas znaczenie, ale nie opisują, co robi kod, jest ważne, ale nie jest to coś, co robimy, prawda? A może to tylko ja.
Ale tu właśnie pojawia się PHPMND.
phpmnd to narzędzie, które pomaga wykrywać magiczne liczby w kodzie PHP. Domyślnie 0 i 1 nie są uważane za liczby magiczne.
Jest to prosta biblioteka, ale używana w połączeniu z bibliotekami w tym poście, a poprzedni wpis może pomóc w ciągłym podnoszeniu jakości kodu, który wnosisz do swoich repozytoriów.
Jeszcze jeden zestaw narzędzi
Jak wspomniano w poprzednim poście, celem, nad którym pracuję, jest włączenie ich wszystkich do composer.jsonpliku, którego można użyć w swoim projekcie.
Pamiętaj też, że w zależności od projektu może być konieczne wybranie wersji biblioteki na podstawie używanej wersji PHP.