Contexto numérico

Esse é contexto quando da utilização de operadores aritméticos.

Esse contexto ocorre se um dos operandos é um float (e não interpretável como int), se ambos os operandos são interpretados como float, ou se o resultado é um float. Se não, se os operandos são interpretados como int, ou o resultado é um int. A partir do 8.0.0, se um dos operandos não pode ser reinterpretado, um erro do tipo TypeError é lançado.

Contextos string

Esse contexto ocorre ao se utilizar echo, print, interpolação de strings, o operador de concatenação.

Nesse contexto, o valor será interpretado como string. Se o valor não puder ser interpretado, então TypeError é lançado. Anteriormente ao 7.4.0, um alerta E_RECOVERABLE_ERROR era emitido.

Contextos lógicos

Este contexto ocorre em instruções condicionais, no uso do operador ternário, ou em uma operação lógica.

Nesse contexto, o valor será interpretado como bool.

Contextos inteiros e string

Este contexto ocorre quando utilizando operadores bitwise.

Este contexto ocorre se todos os operandos são do tipo string, ou o valor retornado é string. Se não, os operados são interpretados como int, ou o resultado é um int. A partir do PHP 8.0.0, se um dos operandos não puder ser reinterpretado, então TypeError é lançado.

Contextos de comparação

Este contexto ocorre quando utilizando operadores de comparação.

As conversões de tipo que ocorrem nesse contexto são explicados na tabela de sobre comparação entre vários tipos, explicadas aqui.

Contextos de função

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 do tipo informado. Duas alternativas existem. A primeira: se o valor é do tipo int e o tipo declarado é float, então o inteiro é convertido num número de ponto flutuante. A segunda alternativa: se o tipo declarado é um escalar, e o valor é conversível no tipo escalar, juntamente com o modo de conversão coercivo no estado ativo (o padrão), o valor pode ser convertido no valor escalar. Veja abaixo uma descrição detalhada desse comportamento.

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

Conversão explícita (cast)

Converte o valor do tipo para o tipo escolhido através da escrita do tipo entre parênteses, antes do valor a ser convertido.

<?php
$foo = 10;           // $foo é int
$bar = (bool) $foo;  // $bar é bool
?>

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

Note:

(integer) converte igual a (int). (boolean) converte igual a (bool). (binary) converte igual a (string). (double) e (real) converte igual a (float). Esses casts alternativas não são recomendados, ainda que existentes.

Note:

Espaços são ignorados dentro dos parênteses de um cast. Portanto, as linhas seguintes são equivalentes:

<?php
$foo = (int) $bar;
$foo = ( int ) $bar;
?>

<?php
$binary = (binary) $string;
$binary = b"binary string";
?>

Note: Em vez de converter uma variável para string, é possível empacotar a variável dentro de aspas.

<?php
$foo = 10;            // $foo é int
$str = "$foo";        // $str é string
$fst = (string) $foo; // $fst também é string

// Isto imprive "são iguais"
if ($fst === $str) {
    echo "são iguais";
}
?>

Não é tão óbvio o que acontece quando convertendo entre certos tipos. Para mais informações, veja as seções:

• Convertendo para boolean
• Convertendo para integer
• Convertendo para float
• Convertendo para string
• Convertendo para array
• Convertendo para object
• Convertendo para resource
• Convertendo para NULL
• A tabela de conversão de tipos

Note: 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:

<?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.