Använder kodningsstandarder med WordPress

Jag skriver en hel del om kodningsstandarder med WordPress och den betydelse jag tror att de har för individer, team och med att arbeta med kärnapplikationen, det vill säga WordPress i sig.

Under det senaste året eller så har jag gått bort från att främst arbeta med WordPress-kodningsstandarderna och har börjat använda PHP-standardrekommendationer för kodning.

Observera att jag inte sa att jag övergav WordPress-kodningsstandarderna eller att jag höjer PSR-rekommendationerna över dem, men jag har skäl för när jag använder var och en. Och för alla som arbetar med WordPress-baserade projekt tror jag att det är viktigt att känna igen när det är lämpligt att använda var och en.

Och det är syftet med detta inlägg.

Kodningsstandarder med WordPress

Innan jag diskuterar var och en av varianterna i kodningsstandarder, vill jag vara tydlig med att ingenting jag säger bör tas som en hård och snabb regel. I bästa fall kanske en tumregel. I värsta fall helt ignorerad, eller hur? 🙃

Allvarligt, men trots de vanliga ansträngningarna och diskussionspunkterna att argumentera för den ena standarden framför den andra, anser jag att det finns en tid och en plats för när var och en ska användas.

När detta skrivs arbetar jag med två projekt och ett som använder WordPress Coding Standards; de andra använder PSR.

Så här är det:

Beslutet handlar inte om vilken uppsättning kodningsstandarder som är bäst. Folk gillar att argumentera på den här punkten, och det är bra för dem. Jag gör inte. Istället försöker jag ta ställningen att vara så pragmatisk som möjligt.

Och för att göra det försöker jag använda en uppsättning frågor för att fatta beslut om vilka kodningsstandarder som ska användas

Ett filter för beslutsfattande

Innan jag ens börjar prata om de två typerna av standarder är det viktigt att inse att det finns en tankeprocess – filter genom vilken – du kan köra alla dina idéer för att fatta ett så välgrundat beslut som möjligt med tanke på ditt projekt.

Jag har gjort så gott jag kan för att fånga i vilken ordning jag överväger vilken uppsättning standarder jag ska använda och jag delar dem här. I ingen bestämd ordning.

• WordPress. Skriver du något som kommer att behöva vara kompatibelt med så många WordPress-installationer (inte trots PHP-versioner)?
• WordPress Arbetar du med att underhålla ett projekt som är skrivet för en äldre version av PHP eller vad som är skrivet med WordPress Coding Standards?
• WordPress. Har du ärvt ett projekt eller underhåller du ett projekt som inte har budgeten för att omstrukturera kodbasen?
• WordPress eller PSR. Arbetar du med ett team som använder detta som sin primära uppsättning kodningsstandarder?
• PSR. Kan du övertyga din klient att använda PHP7+?
• PSR. Har du full kontroll över miljön där projektet är utplacerat?
• PSR. Har du ett projekt som tidigare skrivits i en äldre version av PHP som har budget för en nyare server och refactoring?
• PSR. Vill du skriva till en kodbas som hjälper till att föra dina PHP-kunskaper in i en mer modern era samtidigt som du tar med dig WordPress?

Och till sist, en annan fråga jag skulle ställa är denna:

Vilka kodningsstandarder har du på ditt system, hur enkelt är det att konfigurera din IDE? Ge dig tid att ställa in det och svar på ovanstående frågeguide vilken uppsättning standarder du använder.

Ytterst är målet att göra det så enkelt som möjligt att avgöra vilken standard som ska användas.

Ett sista inlägg?

Innan jag avslutar den här serien vill jag ge en lista över ytterligare resurser som jag tror är användbara för dem som arbetar med WordPress i någon egenskap.

Kanske är du en erfaren utvecklare, kanske har du bara blivit standard, eller kanske är du någonstans mittemellan.

Oavsett så finns det något för oss alla, och om jag kan dela så mycket information som möjligt för att hjälpa dig att bli en bättre oberoende WordPress-utveckling, så kommer jag att uppnå en del av målet som jag har satt upp med just den här serien .

För nu, men fundera lite över konturerna av kodningsstandarderna ovan och se om det inte hjälper med att hantera några av dina befintliga projekt.

En anteckning om objektorienterad programmering

Notera också att jag tidigare i veckan började – eller återupptog, beroende på hur länge du har läst det här materialet – med objektorienterad programmering i WordPress. Så om du är intresserad av att hoppa in i det också, då kan du börja med det här inlägget (eftersom det också refererar till några av de andra).