Share
În această serie, analizăm WordPress PHP Coding Standards pentru a înțelege în continuare modul în care trebuie scris codul WordPress de calitate.
Sigur, toate acestea sunt documentate în WordPress Coding Standards și este un site pe care fiecare dezvoltator WordPress ar trebui să aibă marcaj și la îndemână atunci când lucrează pe o temă, un plugin sau o aplicație; cu toate acestea, dacă sunteți doar obtinerea în dezvoltarea WordPress, atunci este important să înțelegeți rațiunea ca să De ce convențiile sunt așa cum sunt ele.
În acest articol, vom analiza utilizarea citatelor singulare și a citatelor duble în mod special atunci când se ocupă cu șiruri de caractere.
Acesta poate fi cel mai scurt articol, cel mai simplu din seria, dar ar trebui să acopere câteva nuanțe importante deoarece se referă la lucrul cu citate simple, citate duble și șiruri de caractere în WordPress.
Înainte de a discuta despre șiruri de caractere în legătură cu WordPress, este important să înțelegeți modul în care limbajul PHP interpretează șiruri de caractere atunci când acestea sunt simple citate sau dublate.
În primul rând, modul cel mai simplu și mai simplu de a defini un șir în PHP este să îl înfășurați pur și simplu cu ghilimele simple (adică "caracterul"),.
Ca și în majoritatea limbajelor de programare, există sunteți modalități de a scăpa de personaje, astfel încât să puteți scrie o literă stringală. De exemplu, dacă doriți să scrieți: "String-ul în PHP este ușor", ca un șir, atunci puteți face acest lucru:
"String-ul în PHP este ușor."
Vedea? Backslash-urile vor instrui PHP să scrie singură citatul, mai degrabă decât să termine șirul real.
Cel de-al doilea lucru care trebuie luat în considerare este că dacă aveți o variabilă, va fi nu să fie înlocuite atunci când sunt cotate în cotații unice. De exemplu, presupuneți că aveți o variabilă numită numele $ și conține valoarea "Envato".
Mai exact, în cod, ar arăta astfel:
$ name = 'Envato'
Dacă ar trebui să încorporați numele $ variabilă într-un alt șir, "Envato" nu ar fi înlocuit.
$ name = 'Envato'; echo 'Eu scriu pentru numele $. Este foarte distractiv.';
Acest lucru ar echivala doar: Îmi scriu numele $. Este foarte distractiv.
Iată în cazul în care încep să vină la îndemână dublu-citate.
Direct de la manualul PHP:
Dacă șirul este închis în dublu-cotații ("), PHP va interpreta mai multe secvențe de evacuare pentru caractere speciale.
Puteți citi mai multe despre caracterele de evacuare și despre alte informații din manualul PHP, dar să presupunem că am fost nevoiți să reluăm unele dintre șirurile pe care le-am definit mai sus.
Primul nostru exemplu, care este cel cu citat unic scapat, ar putea fi acum definit astfel:
"String-ul în PHP este ușor."
Cel de-al doilea exemplu ar putea fi făcut un pas mai departe: nu numai că secvența de evacuare nu mai este necesară, dar și variabila va fi evaluată:
$ name = 'Envato'; echo "scriu pentru numele de $. Este o mulțime de distracție.";
A doua linie va reda literalmente: Îi scriu lui Envato. Este foarte distractiv.
Deci, cu această acoperire ca o introducere, să vorbim despre specificul de șiruri de caractere în WordPress. Adevărul este că, dacă aveți o înțelegere puternică cu privire la toate cele de mai sus, nu este mult mai mult să adăugați altceva decât câteva cazuri unice.
În conformitate cu convențiile de codare PHP, regula generală de urmat este de a utiliza întotdeauna citate simple pentru a defini șirurile dvs..
Deoarece o mare parte din munca făcută în WordPress include și scrierea marcării în un șir PHP, este mai bine să plasați acele șiruri în citate simple, astfel încât atributele elementului HTML să fie închise în citate dublă.
De exemplu:
$ html = 'WordPress';
Evident, cele de mai sus oferă o experiență mult mai curată de citire decât necesitatea de a plasa mai multe caractere de evadare pentru a se ocupa de citatele duble, cu tălpile și așa mai departe.
Dacă aveți de-a face cu marcarea care trebuie să se întindă pe mai multe linii sau în cazul în care creați mai multe elemente, dintre care unele sunt elementele copilului altora, recomand întotdeauna indentarea codului astfel încât să citească ca un document HTML.
De exemplu:
$ nume = 'Tom McFarlin'; $ html = '„; $ html. = '". $ nume. '„; $ html. =„;
Este important să rețineți că acest lucru nu face parte din standardele de codificare WordPress - această convenție este una pe care eu o găsesc pur și simplu utilă atunci când vine vorba de menținerea codului - totuși, amintiți-vă că uneltele cotate nu să evalueze valoarea unei variabile.
Ca atare, este important să rețineți că, în acest caz, folosim concatenarea șirului pentru a include definiția variabilei.
La fel ca și în cazul citatelor duble în PHP, este important să rețineți că există momente în care este mai preferabil să le folosiți mai ales când trebuie să evaluați o variabilă.
Folosind exemplul din codul de mai sus, îl vom adapta după cum urmează:
$ nume = 'Tom McFarlin'; $ html = ""; $ html. ="numele $"; $ html. ="„;
Observați că am înlocuit toate citatele simple cu ghilimele duble și că nu mai trebuie să efectuăm nici o concatenare a șirului cu numele $ deoarece aceasta va fi evaluată.
De asemenea, este important să rețineți că, deși este discutabil mai frecvente pentru a vedea ghilimele duble aplicate atributelor HTML, citatele simple funcționează chiar bine, mai ales în scenariile de genul asta.
Când lucrați cu șiruri de caractere și diferite limbi de programare - și anume HTML - poate deveni puțin complicat în ceea ce privește felul în care vă inserează codul.
De exemplu, spuneți că utilizați PHP pentru a scrie JavaScript, care este responsabil pentru redarea unor coduri HTML. În acest scenariu, veți scrie multe citări.
Deși este posibil să purtați pur și simplu stilurile dvs. de citare, acest lucru nu va funcționa 100% din timp.
Chiar și standardele de codare:
O excepție de la aceasta este JavaScript, care uneori necesită citate duble sau simple.
Deși există momente în care s-ar putea să nu reușiți să faceți acest lucru, aceasta întărește ideea că trebuie să ne străduim să păstrăm fiecare limbaj de programare în stilul propriu de fișiere și să îi includem când și unde este necesar.
Da, dar WordPress le face extrem de ușor de gestionat și, deși acest lucru intră din punct de vedere tehnic, este strâns legat de exact ceea ce discutăm în acest articol.
Problema principală este că există momente în care putem scrie în mod dinamic atributele HTML ale marcajului nostru care au valori pe care nu le putem anticipa. În astfel de cazuri, trebuie să reușim să scăpăm de aceste date.
Din fericire, WordPress oferă esc_attr funcţie. Pur și simplu, această funcție va lua un șir de intrare și va codifica caracterele pentru a vă asigura că acestea sunt redate corect în browser.
Practic vorbind, ați folosi-o exact așa cum Codex-ul demonstrează:
echo "„;
Pentru mai multe informații, asigurați-vă că revizuiți articolul Codex.
Deci, ca regulă generală, trebuie să rămânem cu ajutorul citatelor unice dacă nu veți evalua un șir de caractere sau veți reveni și veți repeta codul HTML, JavaScript sau chiar CSS înapoi la apelant.
La fel cum standardele de codare afirmă:
Nu trebuie să evitați aproape niciodată citate într-un șir, pentru că puteți doar să alterați stilul de citare.
Deci, pe măsură ce lucrați cu șiruri de caractere în activitatea viitoare, țineți cont de aceste principii și ar putea merge de-a lungul modului de a vă asigura că șirurile dvs. sunt la fel de curate și ușor de înțeles cu putință în contextul proiectelor bazate pe WordPress.
Accentsconagua