Collections no PHP e seu uso no Laravel
Ao desenvolver aplicações modernas com PHP, uma das tarefas mais comuns é manipular arrays — filtrando, transformando ou agrupando dados.... Leia mais
Entendendo a Função list() no PHP
A função list() do PHP é uma forma prática de atribuir múltiplos valores de um array a variáveis individuais. Neste artigo, vamos explorar como essa função funciona, seus usos mais comuns e alternativas modernas disponíveis no PHP.
O Que é a Função list()?
A função list() permite extrair valores de um array e atribuí-los a variáveis individuais de maneira simplificada.
Sintaxe Básica:
list($var1, $var2, $var3) = array(valor1, valor2, valor3);
Cada variável recebe o valor correspondente da posição do array.
Exemplo de Uso:
$dados = ["Maria", 30, "Desenvolvedora"];
list($nome, $idade, $profissao) = $dados;
echo "Nome: $nome, Idade: $idade, Profissão: $profissao";
Saída:
Nome: Maria, Idade: 30, Profissão: Desenvolvedora
Importante: list() Só Funciona com Arrays Indexados
A função list() não funciona com arrays associativos. Se você tentar usá-la com um array associativo, os valores não serão extraídos corretamente.
Exemplo que não funciona:
$dados = ["nome" => "Carlos", "idade" => 25];
list($nome, $idade) = $dados; // Erro: valores indefinidos
Ignorando Valores no list()
Se você quiser pular certos valores do array, pode omitir variáveis dentro de list().
$dados = ["Ana", "Feminino", 28];
list($nome, , $idade) = $dados;
echo "Nome: $nome, Idade: $idade";
Saída:
Nome: Ana, Idade: 28
Uso Combinado com explode()
list() é muito útil ao trabalhar com strings separadas por delimitadores, como datas.
$data = "2025-03-11";
list($ano, $mes, $dia) = explode("-", $data);
echo "Ano: $ano, Mês: $mes, Dia: $dia";
Saída:
Ano: 2025, Mês: 03, Dia: 11
Alternativa Moderna: Desestruturação com []
Desde o PHP 7.1, podemos usar [] para desestruturar arrays, substituindo list().
$valores = [10, 20, 30];
[$a, $b, $c] = $valores;
echo "A: $a, B: $b, C: $c";
Saída:
A: 10, B: 20, C: 30
Essa sintaxe é mais intuitiva e moderna.
A função list() é útil para atribuir múltiplos valores de um array a variáveis de forma rápida. Entretanto, se estiver usando PHP 7.1 ou superior, prefira [] por ser uma alternativa mais moderna e legível.
Se gostou deste artigo, compartilhe com outros desenvolvedores e continue acompanhando mais dicas de PHP!
