PauloRB.dev

Entendendo a Função list() no PHP

Por Paulo RB em 11/03/2025

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!