Veja Também

• Números de ponto flutuante
• Precisão arbitrária / BCMath
• Número inteiro de comprimento arbitrário / GMP

Sintaxe

Int pode ser especificado em notação decimal (base 10), hexadecimal (base 16), octal (base 8) ou binária (base 2). O sinal de menos pode ser usado para indicar um int negativo.

Para usar a notação octal, preceda o número com um 0 (zero). A partir do PHP 8.1.0, a notação octal também pode ser precedida por 0o ou 0O. Para utilizar a notação hexadecimal, preceda o número com 0x. Para utilizar a notação binária, preceda o número com 0b.

A partir do PHP 7.4.0, inteiros literais podem conter sublinhados (_) entre os dígitos, para melhorar a sua leitura. Estes sublinhados serão removidos pelo analisador do PHP.

<?php
$a = 1234; // número decimal
$a = 0123; // número octal (equivalente a 83 em decimal)
$a = 0o123; // número octal (a partir do PHP 8.1.0)
$a = 0x1A; // número hexadecimal (equivalente a 26 em decimal)
$a = 0b11111111; // número binário (equivalente a 255 em decimal)
$a = 1_234_567; // número decimal (a partir do PHP 7.4.0)
?>

Formalmente, a estrutura para int literais é esta a partir do PHP 8.1.0 (anteriormente, os prefixos octal 0o ou 0O não eram permitidos, e antes do PHP 7.4.0 os sublinhados não eram permitidos):

decimal     : [1-9][0-9]*(_[0-9]+)*
            | 0

hexadecimal : 0[xX][0-9a-fA-F]+(_[0-9a-fA-F]+)*

octal       : 0[oO]?[0-7]+(_[0-7]+)*

binário     : 0[bB][01]+(_[01]+)*

inteiro     : decimal
            | hexadecimal
            | octal
            | binário

O tamanho de um int depende da plataforma, embora um valor máximo de cerca de dois bilhões seja o valor usual (são 32 bits com sinal). As plataformas de 64 bits geralmente têm um valor máximo de cerca de 9E18. O PHP não suporta int sem sinal. O tamanho int pode ser determinado usando a constante PHP_INT_SIZE, o valor máximo usando a constante PHP_INT_MAX e o valor mínimo usando a constante PHP_INT_MIN.

Overflow de inteiros

Se o PHP encontrar um número além dos limites do tipo int, ele será interpretado como um float. Assim, uma operação que resulte em um número além dos limites do tipo int, retornará um float.

<?php
$large_number = 50000000000000000000;
var_dump($large_number);         // float(5.0E+19)

var_dump(PHP_INT_MAX + 1);       // sistemas 32 bits: float(2147483648)
                                 // sistemas 64 bits: float(9.2233720368548E+18)
?>

Divisão de inteiros

Não existe operador de divisão int no PHP, para isso deve ser usada a função intdiv(). 1/2 produz o float 0.5. O valor pode ser convertido em um int para arredondar para zero ou pode ser usada a função round() para um controle mais preciso sobre o arredondamento.

<?php
var_dump(25/7);         // float(3.5714285714286)
var_dump((int) (25/7)); // int(3)
var_dump(round(25/7));  // float(4)
?>

Convertendo para inteiro

Para converter explicitamente um valor para int, utiliza-se um dos modificadores (int) ou (integer). Entretanto, na maioria dos casos, o modificador não é necessário, já que o valor será automaticamente convertido se um operador, função ou estrutura de controle requerer um int como argumento. Um valor também pode ser convertido para int utilizando a função intval().

Se um resource for convertido para um int, resultará no número único do recurso, atribuído ao resource pelo PHP em tempo de execução.

Veja também Manipulação de Tipos.

<?php

function foo($value): int {
  return $value;
}

var_dump(foo(8.1)); // Defasado: conversão implícita de float 8.1 para int perdendo precisão a partir do PHP 8.1.0
var_dump(foo(8.1)); // 8 antes do PHP 8.1.0
var_dump(foo(8.0)); // 8 em ambos os casos

var_dump((int) 8.1); // 8 em ambos os casos
var_dump(intval(8.1)); // 8 em ambos os casos
?>

<?php
echo (int) ( (0.1+0.7) * 10 ); // mostra 7!
?>