PHP array_unique(): remover valores duplicados

array_unique($array) retorna o array sem os valores duplicados. A primeira ocorrência de cada valor fica, sob a chave original, e as cópias seguintes são descartadas.

<?php
$tags = ["php", "arrays", "php", "tips", "arrays", "php"];

$unique = array_unique($tags);
print_r($unique);

print_r(array_values($unique)); // renumbered 0, 1, 2

O primeiro resultado mantém as chaves 0, 1, 3: as posições em que cada valor apareceu pela primeira vez. Envolva a chamada em array_values() quando quiser uma lista limpa, por exemplo antes do json_encode.

Como o array_unique decide que dois valores são iguais

Por padrão, cada valor é convertido em string e as strings são comparadas. Então 1, "1" e 1.0 contam como o mesmo valor, e o primeiro vence. O segundo argumento muda a comparação.

<?php
$mixed = [1, "1", 1.0, true, "01", 2];

var_dump(array_unique($mixed));                // compared as strings
var_dump(array_unique($mixed, SORT_REGULAR));  // compared with ==
var_dump(array_unique(["10", "1e1", "010"], SORT_NUMERIC));

Com o padrão, "01" sobrevive porque a string "01" não é a string "1". Com SORT_REGULAR ela é descartada, porque "01" == 1 é verdadeiro. A comparação frouxa também deixa o booleano true bater com qualquer valor não vazio. Confira a saída antes de confiar nela com tipos misturados; a página sobre operadores de comparação explica as regras.

Remover duplicados ignorando maiúsculas e minúsculas

O array_unique diferencia maiúsculas de minúsculas: "PHP" e "php" são diferentes. Para tratá-los como duplicados mas manter a grafia original do primeiro, encontre as chaves únicas numa cópia em minúsculas e mantenha essas chaves do original.

<?php
$languages = ["PHP", "Python", "php", "Go", "python", "GO", "Rust"];

$keys = array_unique(array_map('strtolower', $languages));
$result = array_values(array_intersect_key($languages, $keys));

print_r($result);

O array_map monta uma cópia em minúsculas com as mesmas chaves, o array_unique mantém as chaves das primeiras ocorrências, e o array_intersect_key pega essas chaves do array original. Para texto acentuado ou japonês, use mb_strtolower no lugar de strtolower.

array_unique num array multidimensional

Sem flag, o array_unique converte cada linha na string "Array", então todas as linhas parecem idênticas e só a primeira sobrevive, com um aviso "Array to string conversion" para cada linha. Passe SORT_REGULAR para comparar linhas inteiras. Para manter uma linha por valor de um único campo, array_column com null e uma chave de índice é mais simples.

<?php
$signups = [
    ["email" => "ada@example.com", "plan" => "free"],
    ["email" => "bob@example.com", "plan" => "pro"],
    ["email" => "ada@example.com", "plan" => "free"],
    ["email" => "ada@example.com", "plan" => "pro"],
];

// Exact duplicate rows removed
print_r(array_unique($signups, SORT_REGULAR));

// One row per email: the last row for each email wins
print_r(array_values(array_column($signups, null, 'email')));

A segunda abordagem mantém a última linha de cada e-mail porque cada linha posterior sobrescreve a anterior sob a mesma chave. A página sobre array_column explica a chave de índice em detalhe.

Encontrar e contar valores duplicados

O array_count_values() retorna quantas vezes cada valor aparece. Filtre isso para contagens acima de um e você tem os duplicados.

<?php
$votes = ["red", "blue", "red", "green", "blue", "red"];

$counts = array_count_values($votes);
print_r($counts);

$duplicates = array_keys(array_filter($counts, fn($n) => $n > 1));
echo "Duplicated: " . implode(", ", $duplicates) . "\n";

echo count($votes) === count(array_unique($votes))
    ? "No duplicates\n"
    : "Has duplicates\n";

A última verificação é uma linha comum para testar se um array tem algum duplicado.

Valores únicos mais rápidos para arrays grandes

O array_unique converte cada valor em string antes de comparar, o que não é problema para milhares de valores. Para uma lista grande de inteiros ou strings, inverter o array é mais rápido: os valores viram chaves, e chaves são únicas por definição.

<?php
$ids = [];
for ($i = 0; $i < 200000; $i++) {
    $ids[] = $i % 1000;
}

$start = hrtime(true);
$a = array_unique($ids);
$t1 = (hrtime(true) - $start) / 1e6;

$start = hrtime(true);
$b = array_keys(array_flip($ids));
$t2 = (hrtime(true) - $start) / 1e6;

echo count($a), " unique values with array_unique\n";
echo count($b), " unique values with array_keys(array_flip())\n";
printf("array_unique: %.1f ms, array_flip: %.1f ms\n", $t1, $t2);

Os tempos mudam a cada execução, mas a versão com flip costuma ser várias vezes mais rápida. Ela só funciona para valores que podem ser chaves de array (inteiros e strings), e strings numéricas como "5" voltam como inteiros.