Mercatino: Parte 8

Le convenzioni di programmazione non sono altro che alcune regole di stile, che nulla hanno a che fare con il funzionamento del programma stesso. Servono esclusivamente per rendere il codice leggibile e comprensibile nello stesso momento. Lo scopo finale è di rendere il codice più compatto possibile senza la necessità di commentare ogni riga.

A questo scopo usiamo, ad esempio variabili con un nome comprensibile e comunque possibilmente unico, ad esempio usando il prefisso vtp_. Similmente troviamo in vBulletin tantissime variabili che utilizzano simili convenzioni. Essendo vBulletin il codice base, dobbiamo essere certi di non interagire involontariamente con queste variabili, ad esempio riutilizzandoli per altri scopi all'interno dei nostri script.

Per rendere le nostre procedure isolate da quelle di vBulletin, diamo il prefisso vtp_. All'interno delle funzioni possiamo utilizzare liberamente le nostre personalissime scelte di variabili, a meno che non siano pubblicamente accessibili. All'interno delle funzioni possiamo usare $a - $h per stringhe e $i - $z per numerici, come lo fanno i veterani dei programmatori, sia perché non è necessario usare nomi troppo espliciti in piccoli frammenti di codice, sia perché nomi brevi sono più veloci nell'esecuzione del codice interpretato.

Una delle convenzioni meno chiare è la dischiarazione delle variabili con valori iniziali. Dato che le variabili PHP non hanno un tipo fisso, il valore iniziale è "empty", vuoto, "null". In alcuni casi, questo valore predefinito, ossia l'assenza totale di un valore, può creare errori nel codice. Soprattutto negli array (insiemi). Quindi è buona norma di inizializzare almeno gli array con un array vuoto, ad esempio:
In questo modo si evitano errori quando successivamente si assume che l'array sia stato valorizzato, ma dove in realtà non sono stati assegnati valori, perché una condizione non era vera. Questo genere di errore è particolarmente noioso nei plugin, perché invia una scritta di errore al browser, che annulla poi la corretta esecuzione della pagina, oppure mostra una pagina bianca, famoso inspiegabile errore di molti siti.