Tipos de dados PHP: int, float, string, bool, array, null

O PHP tem oito tipos que você usa todo dia: int, float, string, bool, array, object, null, mais callable para funções que você passa adiante. Uma variável não tem tipo fixo; o valor atual dela tem. var_dump($x) mostra o tipo e o valor, e gettype($x) retorna o tipo como string.

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

A primeira coluna é gettype(), a segunda get_debug_type(). Troque um valor por um seu e rode de novo. As duas discordam em alguns nomes: gettype diz integer, double e boolean por razões históricas, enquanto get_debug_type usa os nomes das declarações de tipo (int, float, bool) e dá o nome da classe para um objeto.

Os tipos do PHP num relance

Inspecionar valores com var_dump

var_dump é a ferramenta para ver o que você realmente tem. Ele imprime o tipo, o valor e, para strings, o tamanho em 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 imprimiria 10 para os três primeiros e esconderia a diferença. O tamanho em string(5) "café" conta bytes, e é por isso que strlen e mb_strlen diferem em texto fora do ASCII.

Inteiros e floats

Um inteiro é um número sem casas decimais. Literais podem usar underscores para facilitar a leitura, e notação hexadecimal, octal e binária. Um float é qualquer número com ponto decimal ou expoente e, como em qualquer linguagem, guarda a maioria dos decimais 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 compare floats com ==; compare a diferença com uma pequena tolerância, ou arredonde os dois lados antes. Para dinheiro, guarde centavos inteiros como integers.

Booleanos e quais valores são falsos

Um bool é true ou false. Onde o PHP espera uma condição (if, while, !), qualquer valor é convertido para bool, e uma pequena lista de valores conta como falso: false, 0, 0.0, "", "0", [] e null. Todo o resto é verdadeiro. A tabela mostra cada valor com seu tipo, sua conversão para bool e se ele é numérico:

As surpresas são "0.0", " " e "null": as três são strings não vazias diferentes de "0", então são verdadeiras, e if ($value) executa o bloco para elas.

Arrays, objetos e null

Um array guarda qualquer mistura de valores sob chaves inteiras ou string. Um objeto é uma instância de uma classe; stdClass é a classe vazia do PHP para objetos rápidos, e (object) transforma um array num objeto. null significa "nenhum 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));

Verificar um tipo com as funções is_*

Cada tipo tem uma função de teste que retorna true ou false. is_numeric é diferente de is_int: ela aceita strings numéricas também, que é o que você quer ao verificar dados de formulário.

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

Outras: is_bool, is_array, is_object, is_null, is_callable, is_iterable, e $x instanceof ClassName para uma classe específica.

Conversão automática e strict types

O PHP converte tipos automaticamente quando um operador precisa de outro tipo. Uma string numérica usada em aritmética vira número, e . transforma números em strings. Uma string que não é numérica de jeito nenhum não pode ser somada, e o PHP 8 lança um 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";
}

Parâmetros tipados também convertem, a menos que o arquivo comece com declare(strict_types=1);. Aí uma chamada com o tipo escalar errado falha em vez de ser convertida:

<?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 converter de propósito, faça um cast: (int) "42", (float) "3.5", (string) 10, (bool) "0". A página sobre conversão de tipos cobre todos os casts e seus casos extremos.

Erro comum: comparar tipos diferentes com ==

Como o == converte antes de comparar, dois valores de tipos diferentes podem ser "iguais" de formas que causam bugs, como "1e1" == "10" (os dois são o número 10) ou null == false. Use ===, que também exige o mesmo tipo, a menos que você queira a conversão:

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

O PHP 8 corrigiu o pior caso: "abc" == 0 era true e agora é false, porque uma string não numérica é comparada como string. As tabelas completas estão na página sobre operadores de comparação.