Tipi di dati PHP: int, float, string, bool, array, null

PHP ha otto tipi che usi tutti i giorni: int, float, string, bool, array, object, null, più callable per le funzioni che passi in giro. Una variabile non ha un tipo fisso; ce l'ha il suo valore attuale. var_dump($x) mostra sia il tipo sia il valore, e gettype($x) restituisce il tipo come stringa.

<?php
$values = [42, 3.14, "hello", true, [1, 2, 3], null, new stdClass()];

printf("%-8s %-10s %s\n", "gettype", "debug", "value");
foreach ($values as $value) {
    printf("%-8s %-10s %s\n", gettype($value), get_debug_type($value), json_encode($value));
}

La prima colonna è gettype(), la seconda get_debug_type(). Sostituisci un valore con uno tuo ed esegui di nuovo. Su alcuni nomi non sono d'accordo: gettype dice integer, double e boolean per ragioni storiche, mentre get_debug_type usa i nomi delle dichiarazioni di tipo (int, float, bool) e per un oggetto restituisce il nome della classe.

I tipi PHP in breve

Ispezionare i valori con var_dump

var_dump è lo strumento per vedere cosa hai davvero. Stampa il tipo, il valore e, per le stringhe, la lunghezza in byte:

<?php
var_dump(10);
var_dump(10.0);
var_dump("10");
var_dump(true);
var_dump(null);
var_dump(["id" => 7, "tags" => ["php", "web"]]);
var_dump("café");   // 5 bytes: é takes two bytes in UTF-8

echo stamperebbe 10 per i primi tre e nasconderebbe la differenza. La lunghezza in string(5) "café" conta i byte, ed è per questo che strlen e mb_strlen danno risultati diversi per il testo non ASCII.

Interi e float

Un intero è un numero senza decimali. I letterali possono usare gli underscore per leggibilità, e la notazione esadecimale, ottale e binaria. Un float è qualsiasi numero con il punto decimale o un esponente, e come in ogni linguaggio memorizza la maggior parte dei decimali in modo approssimato:

<?php
$population = 8_100_000_000;   // underscores are ignored
var_dump($population);
var_dump(0xFF, 0b1010, 0o17);  // hex, binary, octal
var_dump(PHP_INT_MAX);
var_dump(PHP_INT_MAX + 1);     // too big: becomes a float

var_dump(7 / 2);               // / returns a float when needed
var_dump(8 / 2);               // and an int when the result is whole
var_dump(intdiv(7, 2));        // integer division

var_dump(0.1 + 0.2);
var_dump(0.1 + 0.2 == 0.3);
var_dump(abs((0.1 + 0.2) - 0.3) < PHP_FLOAT_EPSILON);

Non confrontare mai i float con ==; confronta la differenza con una piccola tolleranza, oppure arrotonda prima entrambi i lati. Per i soldi, memorizza i centesimi come interi.

Booleani e quali valori sono false

Un bool è true o false. Dove PHP si aspetta una condizione (if, while, !), qualsiasi valore viene convertito in bool, e un breve elenco di valori conta come falso: false, 0, 0.0, "", "0", [] e null. Tutto il resto è vero. La tabella mostra ogni valore con il suo tipo, la conversione in bool e se è numerico:

Le sorprese sono "0.0", " " e "null": tutte e tre sono stringhe non vuote diverse da "0", quindi sono vere, e if ($value) esegue il suo corpo per loro.

Array, oggetti e null

Un array contiene un mix qualsiasi di valori sotto chiavi intere o stringa. Un oggetto è un'istanza di una classe; stdClass è la classe vuota di PHP per oggetti al volo, e (object) trasforma un array in uno di essi. null significa "nessun valore":

<?php
$user = ["name" => "Ada", "roles" => ["admin", "editor"]];
echo gettype($user), ": ", $user["name"], "\n";

$point = new stdClass();
$point->x = 3;
$point->y = 4;
echo get_debug_type($point), ": ", $point->x, ",", $point->y, "\n";

$config = (object) ["debug" => true];
echo get_debug_type($config), ": debug is ", var_export($config->debug, true), "\n";

class Product
{
    public function __construct(public string $name, public float $price) {}
}
$p = new Product("Lamp", 25.0);
echo get_debug_type($p), ": {$p->name}\n";

$nothing = null;
var_dump($nothing, is_null($nothing));

Verificare un tipo con le funzioni is_*

Ogni tipo ha una funzione di test che restituisce true o false. is_numeric è diversa da is_int: accetta anche le stringhe numeriche, che è ciò che vuoi quando controlli l'input di un form.

<?php
$tests = [5, 5.0, "5", "5.5", " 5", "abc", true, null];

printf("%-7s %-6s %-8s %-9s %-10s\n", "value", "is_int", "is_float", "is_string", "is_numeric");
foreach ($tests as $t) {
    printf(
        "%-7s %-6s %-8s %-9s %-10s\n",
        var_export($t, true),
        is_int($t) ? "yes" : "",
        is_float($t) ? "yes" : "",
        is_string($t) ? "yes" : "",
        is_numeric($t) ? "yes" : ""
    );
}

Altre: is_bool, is_array, is_object, is_null, is_callable, is_iterable, e $x instanceof ClassName per una classe specifica.

Conversione automatica e strict types

PHP converte i tipi automaticamente quando un operatore ne richiede uno diverso. Una stringa numerica usata in un calcolo diventa un numero, e . trasforma i numeri in stringhe. Una stringa che non è affatto numerica non si può sommare, e PHP 8 lancia un TypeError:

<?php
var_dump("10" + 5);        // int(15)
var_dump("1.5" * 2);       // float(3)
var_dump(10 . " items");   // string
var_dump("10" == "1e1");   // both numeric strings: compared as numbers
var_dump(100 == "1e2");

try {
    var_dump("abc" + 1);
} catch (TypeError $e) {
    echo "TypeError: ", $e->getMessage(), "\n";
}

Anche i parametri tipizzati convertono, a meno che il file non inizi con declare(strict_types=1);. In quel caso una chiamata con il tipo scalare sbagliato fallisce invece di essere convertita:

<?php
declare(strict_types=1);

function addVat(float $net): float
{
    return $net * 1.2;
}

echo addVat(100), "\n";          // int to float is still allowed

try {
    echo addVat("100"), "\n";    // a string is not converted in strict mode
} catch (TypeError $e) {
    echo "TypeError: ", $e->getMessage(), "\n";
}

Per convertire di proposito, fai un cast: (int) "42", (float) "3.5", (string) 10, (bool) "0". La pagina sul type casting tratta ogni cast e i suoi casi limite.

Errore comune: confrontare tipi diversi con ==

Siccome == converte prima di confrontare, due valori di tipo diverso possono risultare "uguali" in modi che causano bug, come "1e1" == "10" (entrambi sono il numero 10) o null == false. Usa ===, che richiede anche lo stesso tipo, a meno che tu non voglia la conversione:

<?php
$pairs = [["1e1", "10"], [null, false], [0, ""], ["abc", 0], [1.0, 1]];

foreach ($pairs as [$a, $b]) {
    $show = var_export($a, true) . " vs " . var_export($b, true);
    printf("%-16s ==  %-6s ===  %s\n", $show, var_export($a == $b, true), var_export($a === $b, true));
}

PHP 8 ha corretto il caso peggiore: "abc" == 0 prima era true e ora è false, perché una stringa non numerica viene confrontata come stringa. Le tabelle complete sono nella pagina sugli operatori di confronto.