{"id":229969,"date":"2022-11-08T18:41:00","date_gmt":"2022-11-08T15:41:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229969"},"modified":"2022-11-09T19:30:43","modified_gmt":"2022-11-09T16:30:43","slug":"standard-di-codifica-di-base-tramite-psr-1","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/it\/standard-di-codifica-di-base-tramite-psr-1\/","title":{"rendered":"Standard di codifica di base tramite PSR-1"},"content":{"rendered":"\n

Ieri<\/a> ho parlato brevemente di una logica per l’utilizzo dei PSR<\/a> rispetto agli standard di codifica di WordPress<\/a> e del quando e del perch\u00e9 di entrambi. Ma questo non significa che non sia privo di punti di confusione soprattutto se stai appena iniziando con loro, giusto?<\/p>\n

Con questo, intendo: supponiamo che tu abbia lavorato con gli standard di codifica di WordPress per anni (perch\u00e9 posso relazionarmi) e ora c’\u00e8 questo insieme completamente nuovo di regole e linee guida da seguire. Ma non \u00e8 come una semplice questione di modificare alcuni spazi bianchi e rinominare i file.<\/p>\n

Ci sono altri punti da seguire, e ognuno \u00e8 delineato in un numero, letteralmente (PSR-1, PSR-2 e cos\u00ec via), di come dovrebbe funzionare qualcosa.<\/p>\n

Quindi, quando si tratta solo degli standard di codifica di base come delineato in PSR-1, quali sono alcune aree problematiche che potremmo incontrare come sviluppatori di WordPress?<\/p>\n

Standard di codifica di base (ed effetti collaterali)<\/h2>\n

Non ho intenzione di esaminare ciascuno dei documenti e ricostruire ci\u00f2 che possiamo gi\u00e0 imparare semplicemente leggendoli<\/a>, ma penso che ci sia qualcosa da dire per prendere qualcosa che molti di noi fanno o sperimentano e vedere come questo potrebbe cambiare all’interno il contesto di WordPress.<\/p>\n

Prendi gli effetti collaterali<\/strong> dallo standard di codifica di base (o PSR-1<\/a> ), ad esempio:<\/p>\n

\n

Un file DOVREBBE dichiarare nuovi simboli (classi, funzioni, costanti, ecc.) e non causare altri effetti collaterali, oppure DOVREBBE eseguire la logica con effetti collaterali, ma NON DOVREBBE fare entrambi.<\/p>\n

La frase "effetti collaterali" indica l’esecuzione di una logica non direttamente correlata alla dichiarazione di classi, funzioni, costanti, ecc., semplicemente dall’inclusione del file.<\/p>\n<\/blockquote>\n

Personalmente, trovo la seconda frase la chiave per comprendere ed evitare il pi\u00f9 possibile gli effetti collaterali nel nostro codice. Cio\u00e8, tutto ci\u00f2 che fanno le nostre classi dovrebbe essere autonomo o essere coeso con qualcosa che potrebbe essere stato iniettato in qualche modo.<\/p>\n

Indipendentemente da ci\u00f2, trovare codice che introduce un effetto collaterale e ripulirlo non dovrebbe essere troppo difficile. In effetti, user\u00f2 me stesso come esempio.<\/p>\n

Guarda questo particolare pezzo di codice<\/a> :<\/p>\n

<?php\n\nnamespace TAN;\nuse TANAdmin;\n\ninclude_once( 'admin\/class-toggle-admin-notices-node.php' );\ninclude_once( 'admin\/interfaces\/interface-asset.php' );\ninclude_once( 'admin\/class-javascript-assets.php' );\n\nadd_action( 'plugins_loaded', __NAMESPACE__. 'tan_start' );\n\/**\n * Initializes the JavaScript loader and the Administration Bar Node for\n * rendering the option to toggle admin notices.\n *\/\nfunction tan_start() {\n  \/\/ Code removed for brevity.\n}\n<\/code><\/pre>\n
Questo codice proviene direttamente da Toggle Admin Notice<\/a>. Certo, \u00e8 semplice e il repository<\/a> mostra una nota su come cambiarlo. Dimostra comunque il punto, giusto?<\/p>\n
Qual \u00e8 la soluzione? Questo si presenta sotto forma di Autoloading (che \u00e8 anche trattato in PSR-4<\/a> ). E se dovessi rifattorizzarlo, in modo che seguisse correttamente PSR-1? Quindi un modo per refactoring potrebbe essere simile a questo<\/a> :<\/p>\n
<?php\n\nnamespace TAN;\nuse TANAdmin;\n\ninclude_once 'inc\/autoload.php';\n\nadd_action( 'plugins_loaded', __NAMESPACE__. 'tan_start' );\n\/**\n * Initializes the JavaScript loader and the Administration Bar Node for\n * rendering the option to toggle admin notices.\n *\/\nfunction tan_start() {\n  \/\/ Code removed for brevity.\n}\n<\/code><\/pre>\n
\u00c8 un ottimo esempio? Probabilmente no. Ma c’\u00e8 di pi\u00f9 oltre a includere solo i file. Includere quei file significa che questo singolo file introduce una variet\u00e0 di effetti collaterali.<\/p>\n
Ci\u00f2 significa che solo questo file \u00e8 responsabile di fare molto di pi\u00f9 di quelle quattro righe di codice. Pensalo come incorporare tutto ci\u00f2 che implementano altri file. Diventa pi\u00f9 complesso a quel punto.<\/p>\n
Quindi prendi quell’idea e spostala in un sistema molto pi\u00f9 ampio e puoi vedere come e perch\u00e9 questo sarebbe problematico.<\/p>\n
Naturalmente, ci sono anche modi alternativi. E questo \u00e8 solo un esempio. Anche autoironico. Il punto non \u00e8 tanto mostrare un modo definitivo per farlo, ma iniziare a seminare pensieri su come progettiamo, pianifichiamo, costruiamo e incorporiamo le classi.<\/p>\n
E per quanto riguarda le visualizzazioni?<\/h3>\n
Quando si tratta di scrivere plug-in, sono parziale nel trattare ci\u00f2 che gli utenti vedranno come visualizzazioni.\u00a0<\/strong>Ma sembra esserci un problema qui: \u00e8 considerata una cattiva pratica includere file poich\u00e9 introduce effetti collaterali.<\/p>\n
Quindi non vogliamo produrre logica nelle nostre classi, ma vogliamo anche separare la presentazione dalla logica aziendale.<\/p>\n
\"Standard<\/a><\/p>\n
Cosa dobbiamo fare?<\/p>\n
\n
Il colpo di scena… \u00e8 che useremo la programmazione orientata agli oggetti per farlo. Progetteremo una classe che genera HTML utilizzando il modello PHP.<\/p>\n<\/blockquote>\n
Questo \u00e8 stato trattato in modo approfondito da qualcun altro<\/a> e consiglio vivamente di leggere quel particolare post per prendere l’idea degli effetti collaterali, evitarli e incorporare pratiche solide il pi\u00f9 possibile.<\/p>\n
\u2026E asset e file correlati?<\/h2>\n
Lo so: l’idea di allontanarsi dagli effetti collaterali (per non parlare di identificarli) pu\u00f2 essere strana all’inizio, specialmente se si pensa a certe cose che abbiamo fatto per cos\u00ec tanto tempo.<\/p>\n
E potrebbe sollevare domande come: includere file JavaScript o file CSS \u00e8 sbagliato? Questo \u00e8 probabilmente un argomento per un altro post. Ricorda, tuttavia, che ci sono funzioni API di base direttamente correlate a ci\u00f2 e potrebbero far parte di una classe strettamente responsabile di farlo.<\/p>\n
Se lo scopo di una classe \u00e8 quello di fare esattamente questo e solo quello e utilizza le funzioni API per farlo, direi che probabilmente va bene.<\/p>\n
Ma per ora divago su questo (e forse \u00e8 un argomento per i commenti o, ancora, un altro post).<\/p>\n
Invece, mantieni le tue lezioni snelle e propositive. Dovrebbero fare come afferma PSR-1<\/a> ed evitare di fare cose come "[dichiarare] nuove classi, funzioni, costanti, ecc." e "[esecuzione] logica con effetti collaterali".<\/p>\n
Fonte di registrazione:  tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Mantieni le tue lezioni mirate. Evita cose come “[dichiarare] nuove classi, funzioni, costanti, ecc.” e “[esecuzione] logica con effetti collaterali”.<\/p>\n","protected":false},"author":1,"featured_media":166224,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[720],"tags":[1168],"class_list":["post-229969","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-sviluppatore","tag-affiai-it"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/posts\/229969","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/comments?post=229969"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/posts\/229969\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/media\/166224"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/media?parent=229969"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/categories?post=229969"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/it\/wp-json\/wp\/v2\/tags?post=229969"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}