Tipos de datos en PHP: int, float, string, bool, array, null

PHP tiene ocho tipos que usas a diario: int, float, string, bool, array, object, null, más callable para las funciones que pasas de un sitio a otro. Una variable no tiene un tipo fijo; lo tiene su valor actual. var_dump($x) muestra el tipo y el valor, y gettype($x) devuelve el tipo como cadena.

<?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 primera columna es gettype() y la segunda get_debug_type(). Cambia un valor por uno tuyo y vuelve a ejecutarlo. Difieren en algunos nombres: gettype dice integer, double y boolean por razones históricas, mientras que get_debug_type usa los nombres de las declaraciones de tipo (int, float, bool) y da el nombre de la clase en un objeto.

Los tipos de PHP de un vistazo

Inspeccionar valores con var_dump

var_dump es la herramienta para ver lo que tienes de verdad. Imprime el tipo, el valor y, en las cadenas, la longitud en bytes:

<?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 imprimiría 10 para los tres primeros y ocultaría la diferencia. La longitud en string(5) "café" cuenta bytes, y por eso strlen y mb_strlen dan resultados distintos con texto no ASCII.

Enteros y floats

Un entero es un número sin decimales. Los literales pueden usar guiones bajos para leerse mejor, y notación hexadecimal, octal y binaria. Un float es cualquier número con punto decimal o exponente, y como en cualquier lenguaje guarda la mayoría de los decimales de forma aproximada:

<?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);

Nunca compares floats con ==; compara la diferencia con una tolerancia pequeña, o redondea antes los dos lados. Para dinero, guarda céntimos enteros como integers.

Booleanos y qué valores son false

Un bool es true o false. Donde PHP espera una condición (if, while, !), cualquier valor se convierte a bool, y una lista corta de valores cuenta como false: false, 0, 0.0, "", "0", [] y null. Todo lo demás es true. La tabla muestra cada valor con su tipo, su conversión a bool y si es numérico:

Las sorpresas son "0.0", " " y "null": las tres son cadenas no vacías distintas de "0", así que son true, y if ($value) ejecuta su cuerpo con ellas.

Arrays, objetos y null

Un array guarda cualquier mezcla de valores bajo claves enteras o de texto. Un objeto es una instancia de una clase; stdClass es la clase vacía de PHP para objetos rápidos, y (object) convierte un array en uno. null significa "sin valor":

<?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));

Comprobar un tipo con las funciones is_*

Cada tipo tiene una función de comprobación que devuelve true o false. is_numeric es distinta de is_int: también acepta cadenas numéricas, que es lo que quieres al validar datos de un formulario.

<?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" : ""
    );
}

Otras: is_bool, is_array, is_object, is_null, is_callable, is_iterable, y $x instanceof ClassName para una clase concreta.

Conversión automática de tipos y strict types

PHP convierte los tipos automáticamente cuando un operador necesita otro distinto. Una cadena numérica usada en aritmética se convierte en número, y . convierte los números en cadenas. Una cadena que no es numérica en absoluto no se puede sumar, y PHP 8 lanza 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";
}

Los parámetros tipados también convierten, salvo que el archivo empiece por declare(strict_types=1);. Entonces una llamada con un tipo escalar incorrecto falla en lugar de convertirse:

<?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";
}

Para convertir a propósito, haz un cast: (int) "42", (float) "3.5", (string) 10, (bool) "0". La página de conversión de tipos explica cada cast y sus casos límite.

Error frecuente: comparar tipos distintos con ==

Como == convierte antes de comparar, dos valores de tipos distintos pueden ser "iguales" de formas que causan bugs, como "1e1" == "10" (los dos son el número 10) o null == false. Usa ===, que además exige el mismo tipo, salvo que quieras la conversión:

<?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 corrigió el peor caso: "abc" == 0 antes era true y ahora es false, porque una cadena no numérica se compara como cadena. Las tablas completas están en la página de operadores de comparación.