HOWTO · PHP

Eliminar valores duplicados de un array en PHP

Este artículo introduce cómo eliminar los valores duplicados de un array en PHP. Incluye la función array_unique().

En esta página

Para eliminar valores repetidos de un array de PHP, llama a array_unique() y pásale el array. Devuelve un array con el primer valor de cada grupo que considera igual. El resultado conserva las claves asociadas a esos primeros valores, por lo que eliminar duplicados no necesariamente produce índices numéricos consecutivos.

Elimina valores duplicados con array_unique()

La función acepta un array y un indicador de comparación opcional. La forma básica es array_unique($array). Por ejemplo, si una lista contiene "red", "blue", "red", la lista devuelta contiene el primer "red" y "blue". El array original no se ordena y la operación no cambia el orden de los valores conservados. Asigna el array devuelto si quieres seguir usando la versión sin duplicados. Los valores de cadena del ejemplo, red, blue y green, permanecen en inglés:

$colors = ["red", "blue", "red", "green", "blue"];
$uniqueColors = array_unique($colors);

Comprende qué valor y qué clave se conservan

Cuando varios valores se consideran iguales según el indicador seleccionado, array_unique() conserva el primero que encuentra y descarta los siguientes que coinciden. En un array indexado, eliminar un elemento deja un hueco en las claves. En un array asociativo, cada valor conservado mantiene su clave original. Esto resulta útil cuando las claves identifican registros o nombres, pero puede sorprender al código que espera que el resultado tenga los índices 0, 1, 2, ....

La función elimina valores duplicados; no ordena por valor ni por clave. Si importa el orden de salida, recuerda que los valores conservados mantienen su orden relativo original. Elige un indicador de comparación según cómo deban considerarse iguales los valores, no según el orden en que quieras mostrarlos.

Elige un indicador de comparación

El argumento opcional $flags selecciona el modo de comparación. El valor predeterminado, SORT_STRING, compara los valores como cadenas. SORT_REGULAR usa las reglas de comparación habituales de PHP, SORT_NUMERIC compara los valores numéricamente y SORT_LOCALE_STRING compara las cadenas según la configuración regional actual. Un indicador cambia qué valores cuentan como duplicados; no ordena el array devuelto. Por eso, los tipos mezclados pueden deduplicarse de manera distinta según el indicador. Usa el modo que corresponda al significado de los datos y no des por sentado que una comparación numérica reordenará los valores.

Reindexa el resultado cuando sea necesario

Si el código posterior necesita una lista con claves numéricas consecutivas, pasa el resultado sin duplicados a array_values(). Así se crea un nuevo array con índices numéricos que conserva el orden de los valores retenidos. Mantén las claves cuando tengan significado, como los identificadores de productos o las etiquetas; reindexa solo si el código que recibe el resultado espera una lista simple. Reindexar es un paso aparte: array_unique() no lo hace automáticamente.

Comprueba el resultado con un ejemplo de PHP

Ejecuta este ejemplo completo para revisar los valores conservados y el efecto de reindexarlos. Las etiquetas de salida que aparecen en el ejemplo, Unique values with original keys: y Same values with consecutive keys:, permanecen en inglés:

$items = ["first" => "pear", "second" => "plum", "third" => "pear", "fourth" => "lime"];
$uniqueItems = array_unique($items);
$listItems = array_values($uniqueItems);

echo "Unique values with original keys:\n";
print_r($uniqueItems);
echo "Same values with consecutive keys:\n";
print_r($listItems);

El primer resultado conserva las claves first, second y fourth; se elimina la entrada posterior pear. El resultado reindexado contiene esos mismos valores, en el mismo orden, con claves numéricas consecutivas. Esta diferencia ayuda a decidir si conviene conservar las claves de los registros o preparar una lista para código que espera índices numéricos habituales.