HOWTO · PHP
Como converter um número inteiro em uma string em PHP
Este artigo introduz como converter um número inteiro em uma string em PHP.
Nesta página
O PHP oferece várias maneiras de converter um inteiro em uma string. A mais direta é o cast explícito (string), e a função interna strval() faz o mesmo trabalho. O PHP também converte um inteiro implicitamente sempre que uma string é esperada — dentro de uma string com aspas duplas ou quando você une valores com o operador de concatenação — portanto, a interpolação e a concatenação não precisam de uma chamada de conversão separada. Cada método é demonstrado abaixo, seguido por orientações sobre qual deles preferir.
Converter um inteiro em uma string com o cast (string)
O cast declara o tipo de destino no próprio código. Coloque (string) antes de um literal inteiro ou de uma variável que contenha um e o PHP retorna sua representação em string, pronta para ser armazenada ou passada para qualquer lugar que exija uma string.
Execute este exemplo:
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
<?php
$variable = 10;
$string1 = (string)$variable;
echo "The variable is converted to a string and its value is $string1.\n";
?>
The variable is converted to a string and its value is 10.
Como o cast é explícito, a intenção fica visível e o resultado realmente é uma string — confirme com gettype($string1) ou var_dump(). Isso faz de (string) a escolha idiomática quando você precisa de um valor de string genuíno, e não apenas de um valor impresso. No exemplo preservado, a mensagem exibida permanece em inglês: “The variable is converted to a string and its value is 10.” significa que o inteiro foi convertido e impresso dentro da frase.
Converter um inteiro em uma string com strval()
A strval() é a função interna do PHP para converter um valor em string. Passe a variável como parâmetro — strval($variable) — e ela retorna a forma em string; para um inteiro, são os mesmos dígitos produzidos pelo cast (string).
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
<?php
$variable = 10;
$string1 = strval($variable);
echo "The variable is converted to a string and its value is $string1.\n";
?>
The variable is converted to a string and its value is 10.
strval() não pode ser usada com um array ou um objeto. Se isso acontecer, a função retorna o nome do tipo do parâmetro passado.Converter um inteiro em uma string dentro de uma string com aspas duplas
O PHP analisa variáveis embutidas em strings com aspas duplas e substitui seus valores — um recurso chamado interpolação de variáveis. Quando a variável contém um inteiro, o PHP o converte automaticamente em string, portanto nenhuma conversão explícita é necessária.
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
<?php
$variable = 10;
echo "The variable is converted to a string and its value is $variable.\n";
?>
The variable is converted to a string and its value is 10.
A interpolação funciona somente em strings com aspas duplas (e blocos heredoc): '$variable' dentro de aspas simples é texto literal e imprime $variable, não 10. Para manter o valor convertido em vez de apenas imprimi-lo, atribua a string interpolada — $string1 = "$variable"; produz a mesma "10" obtida com o cast.
Converter um inteiro em uma string com concatenação
O operador . une strings, e a conversão automática de tipos do PHP converte um operando inteiro para você, portanto a concatenação também é um caminho de conversão implícita. O artigo Concatenação de strings em PHP aborda o operador com mais detalhes.
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
<?php
$variable = 10;
$string1 = "The variable is converted to a string and its value is ".$variable.".";
echo $string1."\n";
?>
The variable is converted to a string and its value is 10.
Quando a conversão é tudo de que você precisa, concatene o inteiro com "" — uma string sem caracteres — em qualquer um dos lados. Tanto "".$variable quanto $variable."" produzem "10":
<?php
$variable = 10;
echo "".$variable."\n";
echo $variable.""."\n";
?>
10
10
Escolher o método de conversão correto
Use o cast (string) ou strval() quando precisar de um valor de string real — para armazená-lo, passá-lo a uma função ou API que espera uma string, ou reutilizá-lo depois. Ambos tornam a conversão explícita; o cast é a forma idiomática e marginalmente mais rápida, enquanto strval() soa natural quando seu código já trabalha por meio de chamadas de função. Dispense ambos quando quiser apenas embutir o inteiro em uma saída maior: a interpolação e a concatenação com . já produzem a string no local, portanto uma etapa de conversão separada não acrescenta nada. Lembre-se dos limites — a interpolação exige strings com aspas duplas, e strval() não aceita arrays e objetos — e, para resultados formatados, uma função como sprintf("%d", $variable) oferece o maior controle sobre o texto final.