Convenzioni

Per rendere la guida chiara e facilmente consultabile, in ogni sezione verranno adottate alcune convenzioni stilistiche e funzionali. 

Queste regole permetteranno di mantenere una struttura coerente e uniforme in tutto il percorso, offrendo un’esperienza di lettura stabile e prevedibile.

Codice e pseudocodice

I frammenti di codice sorgente sono mostrati all’interno di blocchi appositi con il supporto per l’evidenziazione del codice (Syntax Highlighting).

<?php
// Questo è un esempio di codice
echo 'Ciao Guida di base a PHP'; //Output: Ciao Guida di base a PHP

Durante la guida verranno introdotti moltissimi argomenti. Alcuni di essi possono essere meglio compresi se spiegati in modo semplificato utilizzando uno pseudocodice. In questi casi, i frammenti di codice saranno riportati in uno spazio preformattato. Lo pseudocodice non è un codice funzionante ma illustra a grandi linee i concetti trattati nello specifico argomento.

In questo esempio di pseudocodice viene illustrata una struttura di controlli if-else:

if (condizione) {
    codice da eseguire in caso di condizione veritiera
} else {
    codice da eseguire in caso di condizione non veritiera
}

Evidenziazione

Nella guida, la maggior parte dei comandi, delle strutture, dei costrutti e delle variabili presenti all’esterno dei blocchi di codice sono evidenziati tramite un carattere e un colore speciale. Ad esempio una variabile $variabile viene così evidenziata.

Funzioni e sintassi

Quando una funzione importante è analizzata per la prima volta sarà spiegata la sua sintassi attraverso un blocco di codice preformattato. La sintassi così riportata avrà informazioni sugli argomenti (tra parentesi). Inoltre, se la funzione ritorna un valore particolare, lo stesso verrà riportato come variabile.

La sintassi, nella maggior parte delle volte, non rappresenta un codice direttamente eseguibile ma vuol essere un riferimento mnemonico per lo studente.

In questo esempio, la funzione funzione_di_prova viene descritta tramite i suoi due argomenti.

funzione_di_prova($argomento1, $argomento2);

In questo caso, la funzione viene messa in evidenza, ma l’attenzione è posta sul fatto che può accettare più argomenti, permettendo quindi di elaborare contemporaneamente diversi valori. In questo caso, verranno utilizzati tre puntini (...).

funzione_con_diversi_argomenti($argomento1, $argomento2, ...);

Infine, con questo tipo di evidenziazione si pone l’attenzione sul ritorno della funzione, in questo caso memorizzato nella variabile $ritorno.

$ritorno = funzione_con_ritorno($argomento);

Indentazione

L’indentazione è una convenzione grafica che permette di migliorare la leggibilità del codice utilizzando degli spazi. PHP non prescrive particolari condizioni di indentazione. Tuttavia, per convenzione stilistica, i blocchi di codice sono normalmente separati da 4 caratteri di tipo spazio. In passato si utilizzavano le battute di tab ma questo tipo di indentazione potrebbe creare problemi, specialmente tra sistemi diversi. Nella programmazione moderna, invece, è preferibile utilizzare quattro caratteri di spazio per indentare il codice.

if (condizione) {
    // Quattro spazi
    if (altra condizione) {
        // Otto spazi
    }
}

Tuttavia, è sempre bene non eccedere con l’indentazione poiché, indirettamente, questo suggerisce che il codice non è pienamente ottimizzato. Inoltre, qualsiasi eccesso di indentazione può rendere il codice poco leggibile.