Variabili PHP: dichiarazione, scope, global e static

Una variabile PHP è un nome che inizia con $, e la crei assegnandole un valore: $name = "Ada";. Non c'è una parola chiave di dichiarazione né un tipo da indicare, perché è il valore a decidere il tipo. Più avanti puoi assegnarle un valore di tipo diverso.

<?php
$name = "Ada";
$age = 36;
$height = 1.65;
$isAdmin = true;

echo "$name is $age years old\n";

$age = $age + 1;           // update the value
$age++;                    // add one more
echo "Two birthdays later: $age\n";

$age = "thirty-eight";     // the type can change too
echo "Now a string: $age\n";

Regole per i nomi delle variabili

Il nome di una variabile inizia con $, poi una lettera o un underscore, poi lettere, cifre o underscore qualsiasi. Le lettere non ASCII contano come lettere, quindi $名前 è valido, anche se la norma sono i nomi ASCII. I nomi distinguono maiuscole e minuscole.

Quindi $city, $City e $CITY sono tre variabili diverse. Usa snake_case ($first_name) o camelCase ($firstName), e mantieni un solo stile per progetto. Gli standard di codifica PSR lasciano volutamente libera la scelta dei nomi delle variabili; il codice Laravel e Symfony usa per lo più camelCase.

Usare le variabili nelle stringhe

Dentro le virgolette doppie PHP sostituisce le variabili con i loro valori; dentro le virgolette singole no. Racchiudi la variabile tra graffe quando è seguita direttamente da lettere o quando accedi a un elemento di un array con una chiave stringa:

<?php
$fruit = "apple";
$basket = ["count" => 4];

echo "I like $fruit pie\n";
echo 'I like $fruit pie' . "\n";              // single quotes: printed as written
echo "Two {$fruit}s please\n";                // braces separate the name
echo "There are {$basket['count']} left\n";   // array key inside a string
echo "Joined: " . $fruit . " and pear\n";     // concatenation with .

La pagina sulle stringhe tratta in dettaglio virgolette, concatenazione e interpolazione.

Variabili non definite e valori predefiniti

Leggere una variabile mai assegnata dà null, e il tuo PHP stampa un warning:

Warning: Undefined variable $discount in /home/index.php on line 3

Controlla prima con isset, oppure usa l'operatore di null coalescing ?? per fornire un valore predefinito. Entrambi funzionano senza warning:

<?php
$price = 50;

$discount = $discount ?? 0;    // use 0 when $discount is not set
echo "Price: " . ($price - $discount) . "\n";

if (isset($coupon)) {
    echo "Coupon: $coupon\n";
} else {
    echo "No coupon given\n";
}

$coupon = null;
var_dump(isset($coupon));      // a variable holding null counts as not set

$x ??= 0; è la forma breve di $x = $x ?? 0;. Il caso tipico sono i valori di form e URL: $page = $_GET['page'] ?? 1;.

Lo scope delle variabili nelle funzioni

Le variabili definite fuori da una funzione non sono visibili al suo interno, e quelle create dentro una funzione spariscono quando la funzione termina. È la sorpresa più comune per chi arriva da JavaScript:

<?php
$taxRate = 0.2;

function priceWithTax($price)
{
    // $taxRate does not exist here, so ?? falls back to 0
    return $price * (1 + ($taxRate ?? 0));
}

function priceWithTaxFixed($price, $rate)
{
    return $price * (1 + $rate);   // pass what the function needs
}

echo priceWithTax(100), "\n";
echo priceWithTaxFixed(100, $taxRate), "\n";

Senza il ?? 0, la prima funzione darebbe un warning per $taxRate non definita. Passare i valori come parametri rende le funzioni prevedibili e facili da testare, ed è la prima strada da prendere. La pagina sulle funzioni tratta parametri e valori di ritorno.

La parola chiave global e $GLOBALS

Quando una funzione deve proprio usare una variabile globale, dichiarala con global, oppure passa dall'array $GLOBALS, che contiene ogni variabile globale per nome:

<?php
$visits = 0;
$siteName = "Bakery";

function countVisit()
{
    global $visits;      // now $visits refers to the global variable
    $visits++;
}

function title()
{
    return "Welcome to " . $GLOBALS['siteName'];
}

countVisit();
countVisit();
echo "Visits: $visits\n";
echo title(), "\n";

Le variabili globali rendono il codice più difficile da seguire, perché qualsiasi funzione può modificarle. Compaiono nel codice più vecchio e nei plugin WordPress (global $wpdb;); nel codice nuovo, passa i valori come parametri o usa una classe.

Le variabili static conservano il valore

Una variabile static dentro una funzione viene creata una volta sola e conserva il suo valore tra le chiamate. Resta comunque locale: il codice fuori dalla funzione non la vede.

<?php
function nextTicket(): int
{
    static $number = 100;   // runs only on the first call
    $number++;
    return $number;
}

echo nextTicket(), "\n";
echo nextTicket(), "\n";
echo nextTicket(), "\n";

function expensiveLookup(string $key): string
{
    static $cache = [];
    if (!isset($cache[$key])) {
        echo "(computing $key) ";
        $cache[$key] = strtoupper($key);
    }
    return $cache[$key];
}

echo expensiveLookup("php"), "\n";
echo expensiveLookup("php"), "\n";   // second call uses the cache

Variabili variabili ($$name)

$$name usa il valore di $name come nome di un'altra variabile. Funziona, ma gli array fanno quasi sempre lo stesso lavoro in modo più chiaro:

<?php
$field = "color";
$$field = "blue";        // creates $color
echo $color, "\n";

// The clearer way to have names chosen at runtime:
$settings = [];
$settings[$field] = "blue";
echo $settings["color"], "\n";

Copia o riferimento

Assegnare una variabile a un'altra copia il valore, array compresi. Metti & davanti per far puntare invece entrambi i nomi allo stesso valore:

<?php
$a = [1, 2, 3];
$b = $a;          // copy
$b[] = 4;
echo "a has " . count($a) . ", b has " . count($b) . "\n";

$c = &$a;         // reference: $c and $a are the same array
$c[] = 99;
echo "a has " . count($a) . " after changing c\n";

function addBonus(int &$points)
{
    $points += 10;
}
$score = 5;
addBonus($score);
echo "Score: $score\n";

unset($b);
var_dump(isset($b));

Gli oggetti si comportano diversamente: assegnare un oggetto copia un riferimento allo stesso oggetto, quindi le modifiche fatte tramite una variabile sono visibili anche dall'altra. Usa clone per una copia vera.

Errore comune: una variabile impostata dentro un if o un ciclo

PHP non ha lo scope di blocco, quindi una variabile creata dentro if, for o foreach esiste ancora dopo. È comodo, ma nasconde un bug: quando il blocco non viene eseguito, la variabile non è mai stata creata.

<?php
$orders = [];   // try [120, 80] here

$message = "No orders yet";   // set a default before the loop
foreach ($orders as $amount) {
    $message = "Last order: $amount";
}
echo $message, "\n";

foreach ([1, 2, 3] as $n) {
    $last = $n;
}
echo "Still visible after the loop: $last\n";

Senza la riga con il valore predefinito, un $orders vuoto lascerebbe $message non definita e stamperebbe un warning. Dai un valore a ogni variabile prima del blocco che potrebbe impostarla.