PHP array_unique(): удаление повторяющихся значений

array_unique($array) возвращает массив без повторяющихся значений. Первое вхождение каждого значения остаётся под исходным ключом, а последующие копии отбрасываются.

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

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

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

Первый результат сохраняет ключи 0, 1, 3: позиции, где каждое значение встретилось впервые. Оберните вызов в array_values(), когда нужен чистый список, например перед json_encode.

Как array_unique решает, что значения одинаковые

По умолчанию каждое значение приводится к строке, и сравниваются строки. Поэтому 1, "1" и 1.0 считаются одним значением, и побеждает первое. Второй аргумент меняет способ сравнения.

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

По умолчанию "01" остаётся, потому что строка "01" не равна строке "1". С SORT_REGULAR оно отбрасывается, потому что "01" == 1 истинно. Нестрогое сравнение ещё и позволяет логическому true совпасть с любым непустым значением. Со смешанными типами проверяйте вывод, прежде чем на него полагаться; правила объяснены на странице об операторах сравнения.

Удаление дубликатов без учёта регистра

array_unique учитывает регистр: "PHP" и "php" разные. Чтобы считать их дубликатами, но сохранить исходное написание первого, найдите уникальные ключи на копии в нижнем регистре и оставьте эти ключи из оригинала.

<?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 строит копию в нижнем регистре с теми же ключами, array_unique оставляет ключи первых вхождений, а array_intersect_key выбирает эти ключи из исходного массива. Для текста с диакритикой или японского используйте mb_strtolower вместо strtolower.

array_unique для многомерного массива

Без флага array_unique приводит каждую строку к строке "Array", поэтому все строки выглядят одинаково и остаётся только первая, а для каждой строки выдаётся предупреждение "Array to string conversion". Передайте SORT_REGULAR, чтобы сравнивать строки целиком. Чтобы оставить одну строку на значение одного поля, проще array_column с null и ключом индекса.

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

Второй способ оставляет последнюю строку для каждого email, потому что каждая следующая строка перезаписывает предыдущую под тем же ключом. Ключ индекса подробно объяснён на странице array_column.

Поиск и подсчёт повторяющихся значений

array_count_values() возвращает, сколько раз встречается каждое значение. Отфильтруйте счётчики больше единицы, и получите дубликаты.

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

Последняя проверка это распространённый однострочник, который выясняет, есть ли в массиве дубликаты вообще.

Быстрые уникальные значения для больших массивов

array_unique приводит каждое значение к строке перед сравнением, и для тысяч значений это нормально. Для большого списка целых чисел или строк быстрее перевернуть массив: значения становятся ключами, а ключи уникальны по определению.

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

Время меняется от запуска к запуску, но вариант с переворотом обычно в несколько раз быстрее. Он работает только для значений, которые могут быть ключами массива (целые числа и строки), а числовые строки вроде "5" возвращаются целыми числами.