O PHP não requer a tipagem explícita em declarações de variáveis. Nesse caso, o tipo de uma variável é determinado pelo valor armazenado. Ou seja, se uma string é armazenada numa variável $var, então $var terá o tipo string. Se após isso um valor int for armazenado em $var, ela será do tipo int.
O PHP pode tentar converter o tipo de um valor em outro automaticamente em alguns contextos. Esses contextos são:
Numérico
String
Lógico
Inteiro e string
Comparação
Função
Nota:
Quando um valor precisa ser interpretado como um tipo diferente, o valor em si não se altera, apenas uma "cópia" é convertida.
Para forçar uma variável a ser avaliada como um certo tipo, consulte a seção sobre conversão de tipo. Se for necessário mudar o tipo de uma variável, consulte a função settype().
Este contexto é utilizado em operadores aritméticos.
Neste contexto, se um dos operandos for um float (ou não interpretável como int), ambos os operandos serão interpretados como float, e o resultado será um float. Caso contrário, os operandos serão interpretados como int, e o resultado também será um int. A partir do PHP 8.0.0, se um dos operandos não puser ser interpretado, um TypeError é lançado.
Este contexto ocorre ao se utilizar echo, print, interpolação de strings ou o operador de concatenação.
Neste contexto, o valor será interpretado como string.
Se o valor não puder ser interpretado, um TypeError é lançado.
Anteriormente ao 7.4.0, um E_RECOVERABLE_ERROR era emitido.
Este contexto ocorre em instruções condicionais, no uso do operador ternário, ou em uma operação lógica.
Neste contexto, o valor será interpretado como bool.
Este contexto ocorre ao utilizar operadores binários.
Neste contexto, se todos os operandos forem do tipo string, o resultado também será uma string. Caso contrário, os operados serão interpretados como int, e o resultado também será um int. A partir do PHP 8.0.0, se um dos operandos não puder ser interpretado, um TypeError é lançado.
Este contexto ocorre ao utilizar operadores de comparação.
As conversões de tipo que ocorrem neste contexto são explicadas na tabela de comparações entre vários tipos.
Este contexto ocorre quando um valor é um parâmetro tipado ou quando uma propriedade ou valor retornado de uma função declara um tipo.
Nesse contexto, o valor precisa ser do tipo informado. Existem duas exceções. A primeira é: se o valor for do tipo int e o tipo declarado for um float, o inteiro será convertido num número de ponto flutuante. A segunda é: se o tipo declarado for um tipo escalar, ou ser o valor for conversível a um tipo escalar e o modo de tipagem coercitiva estiver ativo (o padrão), o valor pode ser convertido para um valor escalar aceito. Veja abaixo uma descrição deste comportamento.
Funções internas
convertem automaticamente null para tipos escalares.
Este comportamento foi DESCONTINUADO a partir do PHP 8.1.0.
Declaração de tipo int: o valor é convertido para int quando a conversão for bem definida. Por exemplo, quando uma string é numérica.
Declaração de tipo float: o valor é convertido para float quando a conversão for bem definida. Por exemplo, quando uma string é numérica.
Declaração de tipo string: o valor é convertido para string.
Quando strict_types está desativado, declarações de tipos escalares
estão sujeitas a conversões implícitas e limitadas.
Se o tipo exato do valor não é parte da união, então o tipo final da conversão
é escolhido na seguinte ordem de preferência:
Existe uma exceção, no caso do valor ser uma string, e ambos int e float serem partes
da união, o tipo preferido será determinado pela semântica de
strings
numéricas.
Por exemplo, para "42" o tipo int é escolhido,
enquanto que para "42.0" o tipo escolhido é float.
Nota:
Tipos que não fazem parte da lista acima não são elegíveis para destinos da conversão implícita. Em particular, não ocorrem conversões implícitas para os tipos null, false e true.
Exemplo #1 Exemplo de tipos sendo convertidos em um tipo parte da união
<?php
// int|string
42 --> 42 // tipo exato
"42" --> "42" // tipo exato
new ObjectWithToString --> "Resultado de __toString()"
// e objero não compatível com int, padrão para string
42.0 --> 42 // float compatível com int
42.1 --> 42 // float compatível com int
1e100 --> "1.0E+100" // float muito grande para int, padrão para string
INF --> "INF" // float muito grande para int, padrão para string
true --> 1 // bool compatível com int
[] --> TypeError // array não é compatível com int ou string
// int|float|bool
"45" --> 45 // string numérica int
"45.0" --> 45.0 // string numérica float
"45X" --> true // string não numérica, padrão para bool
"" --> false // string não numérica, padrão para bool
"X" --> true // string não numérica, padrão para bool
[] --> TypeError // array não é compatível com int, float ou bool
?>Converte o valor do tipo para o tipo escolhido através da escrita do tipo entre parênteses, antes do valor a ser convertido.
Exemplo #2 Conversão de tipo
<?php
$foo = 10; // $foo é um inteiro
$bar = (bool) $foo; // $bar é um booleano
var_dump($bar);
?>As conversões previstas são:
(int) - converte para int(bool) - converte para bool(float) - converte para float(string) - converte para string(array) - converte para array(object) - converte para object(unset) - converte para NULL
A conversão (void)
também está disponível a partir do PHP 8.5.0, mas não é uma conversão de valor.
Ela é usada como uma instrução para descartar explicitamente o resultado de uma expressão.
(integer) é um sinônimo de (int).
(boolean) é um sinônimo de (bool).
(binary) é um sinônimo de (string).
(double) e (real) são sinônimos de
(float).
Essas conversões alternativas não usam o nome canônico de tipo e foram descontinuadas a partir do PHP 8.5.0.
A conversão (real) foi descontinuada a partir do PHP 7.4.0
e removida a partir do PHP 8.0.0.
A conversão (unset) foi descontinuada a partir do PHP 7.2.0.
Observe que a conversão (unset) tem o mesmo efeito que
informar o valor NULL para a variável ou chamada de função.
A conversão (unset) foi removida no PHP 8.0.0.
A conversão (binary) e o prefixo b existem
para compatibilidade futura. Atualmente, (binary) e
(string) são idênticos. No entanto, isso pode mudar
e não deve ser considerado estável.
Nota:
Espaços são ignorados dentro dos parênteses de uma conversão. Portanto, as linhas seguintes são equivalentes:
<?php $foo = (int) $bar; $foo = ( int ) $bar; ?>
Convertendo string e variáveis para strings binárias:
<?php
$binary = (binary) $string;
$binary = b"binary string";
?>Em vez de converter uma variável para string, é possível delimitar a variável entre aspas.
Exemplo #3 Diferentes mecanismos de conversão
<?php
$foo = 10; // $foo é int
$str = "$foo"; // $str é string
$fst = (string) $foo; // $fst também é string
// Isto exibe "são iguais"
if ($fst === $str) {
echo "são iguais", PHP_EOL;
}
?>Não é tão óbvio o que acontece ao converter entre certos tipos. Para mais informações, veja as seções:
(void)Nota:
O PHP suporta a indexação de string utilizando a mesma sintaxe de arrays, de forma que o exemplo seguinte é válido em todas as versões do PHP:
Exemplo #4 Usando índice de array com uma string
<?php $a = 'car'; // $a é uma string $a[0] = 'b'; // $a ainda é uma string echo $a; // bar ?>Veja a seção sobre Acesso a caracteres da string para mais informações.
Uneven division of an integer variable by another integer variable will result in a float by automatic conversion -- you do not have to cast the variables to floats in order to avoid integer truncation (as you would in C, for example):
$dividend = 2;
$divisor = 3;
$quotient = $dividend/$divisor;
print $quotient; // 0.66666666666667Cast operators have a very high precedence, for example (int)$a/$b is evaluated as ((int)$a)/$b, not as (int)($a/$b) [which would be like intdiv($a,$b) if both $a and $b are integers].
The only exceptions (as of PHP 8.0) are the exponentiation operator ** [i.e. (int)$a**$b is evaluated as (int)($a**$b) rather than ((int)$a)**$b] and the special access/invocation operators ->, ::, [] and () [i.e. in each of (int)$a->$b, (int)$a::$b, (int)$a[$b] and (int)$a($b), the cast is performed last on the result of the variable expression].Casting objects to arrays is a pain. Example:
<?php
class MyClass {
private $priv = 'priv_value';
protected $prot = 'prot_value';
public $pub = 'pub_value';
public $MyClasspriv = 'second_pub_value';
}
$test = new MyClass();
echo '<pre>';
print_r((array) $test);
/*
Array
(
[MyClasspriv] => priv_value
[*prot] => prot_value
[pub] => pub_value
[MyClasspriv] => second_pub_value
)
*/
?>
Yes, that looks like an array with two keys with the same name and it looks like the protected field was prepended with an asterisk. But that's not true:
<?php
foreach ((array) $test as $key => $value) {
$len = strlen($key);
echo "{$key} ({$len}) => {$value}<br />";
for ($i = 0; $i < $len; ++$i) {
echo ord($key[$i]) . ' ';
}
echo '<hr />';
}
/*
MyClasspriv (13) => priv_value
0 77 121 67 108 97 115 115 0 112 114 105 118
*prot (7) => prot_value
0 42 0 112 114 111 116
pub (3) => pub_value
112 117 98
MyClasspriv (11) => second_pub_value
77 121 67 108 97 115 115 112 114 105 118
*/
?>
The char codes show that the protected keys are prepended with '\0*\0' and private keys are prepended with '\0'.__CLASS__.'\0' so be careful when playing around with this.Type casting in expressions is executed first.
The casting is assigned to the value, not to the expression result.
Examples:
<?php
$string = "777";
var_dump( $string === 777 ); // FALSE
var_dump( (int) $string === 777 ); // TRUE
var_dump( ( (int) $string ) === 777 ); // TRUE
var_dump( (int) ( $string === 777 ) ); // 0
?>If you want to convert a string automatically to float or integer (e.g. "0.234" to float and "123" to int), simply add 0 to the string - PHP will do the rest.
e.g.
$val = 0 + "1.234";
(type of $val is float now)
$val = 0 + "123";
(type of $val is integer now)