array_unique() w PHP: usuwanie duplikatów z tablicy

array_unique($array) zwraca tablicę bez powtórzonych wartości. Pierwsze wystąpienie każdej wartości zostaje, pod swoim oryginalnym kluczem, a późniejsze kopie są odrzucane.

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

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

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

Pierwszy wynik zachowuje klucze 0, 1, 3: pozycje, na których każda wartość pojawiła się po raz pierwszy. Otocz wywołanie przez array_values(), gdy chcesz czystej listy, na przykład przed json_encode.

Jak array_unique decyduje, że dwie wartości są takie same

Domyślnie każda wartość jest zamieniana na string i porównywane są stringi. Dlatego 1, "1" i 1.0 liczą się jako ta sama wartość, a wygrywa pierwsza. Drugi argument zmienia sposób porównania.

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

Przy domyślnej fladze "01" przetrwa, bo string "01" to nie string "1". Przy SORT_REGULAR zostaje odrzucone, bo "01" == 1 jest prawdą. Luźne porównanie pozwala też, by wartość logiczna true pasowała do każdej niepustej wartości. Przy mieszanych typach sprawdź wynik, zanim na nim polegasz; zasady wyjaśnia strona o operatorach porównania.

Usuwanie duplikatów bez rozróżniania wielkości liter

array_unique rozróżnia wielkość liter: "PHP" i "php" są różne. Aby traktować je jako duplikaty, ale zachować oryginalny zapis pierwszego, znajdź unikalne klucze na kopii małymi literami i zostaw te klucze z oryginału.

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

array_map buduje kopię małymi literami z tymi samymi kluczami, array_unique zostawia klucze pierwszych wystąpień, a array_intersect_key wybiera te klucze z oryginalnej tablicy. Dla tekstu z polskimi znakami, akcentami czy japońskiego użyj mb_strtolower zamiast strtolower.

array_unique na tablicy wielowymiarowej

Bez flagi array_unique zamienia każdy wiersz na string "Array", więc wszystkie wiersze wyglądają identycznie i zostaje tylko pierwszy, z ostrzeżeniem „Array to string conversion” dla każdego wiersza. Przekaż SORT_REGULAR, aby porównywać całe wiersze. Aby zostawić jeden wiersz na wartość jednego pola, prostsze jest array_column z null i kluczem indeksu.

<?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')));

Drugie podejście zostawia ostatni wiersz dla każdego e-maila, bo każdy późniejszy wiersz nadpisuje wcześniejszy pod tym samym kluczem. Klucz indeksu szczegółowo wyjaśnia strona array_column.

Znajdowanie i liczenie powtórzonych wartości

array_count_values() zwraca, ile razy pojawia się każda wartość. Przefiltruj to po licznikach większych od jednego, a dostaniesz duplikaty.

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

Ostatnie sprawdzenie to popularny jednolinijkowiec, który sprawdza, czy tablica w ogóle ma duplikaty.

Szybsze unikalne wartości dla dużych tablic

array_unique przed porównaniem zamienia każdą wartość na string, co przy tysiącach wartości jest w porządku. Dla dużej listy liczb całkowitych lub stringów szybsze jest odwrócenie tablicy: wartości stają się kluczami, a klucze są z definicji unikalne.

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

Czasy zmieniają się między uruchomieniami, ale wersja z odwróceniem jest zwykle kilka razy szybsza. Działa tylko dla wartości, które mogą być kluczami tablicy (liczby całkowite i stringi), a stringi liczbowe, takie jak "5", wracają jako liczby całkowite.