Eliminar elemento de array PHP por valor: cómo funciona

PHP eliminar elemento de array por valor (no clave): cómo funciona internamente

Imagina que estás escribiendo un script en PHP, procesando una lista de productos, y de repente necesitas eliminar del array un artículo con un precio o nombre específico. Sabes exactamente el valor — por ejemplo, "manzana" — pero no tienes idea de en qué índice se encuentra. ¿Te suena familiar? Si es así, no estás solo: la pregunta "PHP eliminar elemento de array por valor (no clave)" acumula miles de visitas en Stack Overflow. Y no es casualidad.

En PHP no existe una función nativa array_remove_by_value(). Por eso los desarrolladores se las ingenian: algunos escriben un bucle, otros usan array_search junto con unset, y otros aplican array_diff o array_filter. Pero, ¿qué sucede internamente? ¿Qué método es más rápido? ¿Y por qué el mismo código puede funcionar de manera diferente en distintas versiones de PHP?

En este artículo no solo te daremos una solución lista para usar — exploraremos a fondo cada enfoque, analizaremos su rendimiento y sus trampas. Además, te mostraremos un caso real de la vida de un desarrollador backend. ¡Vamos allá!

El método clásico: array_search + unset

La respuesta más popular en Stack Overflow es esta:

<?php\n$array = ['manzana', 'pera', 'naranja', 'pera'];\n$value = 'pera';\n\nif (($key = array_search($value, $array)) !== false) {\n    unset($array[$key]);\n}\n?>

Este código encuentra la primera ocurrencia del valor y la elimina. Pero analicemos qué sucede realmente aquí.

Cómo funciona array_search

array_search() realiza una búsqueda lineal. PHP recorre el array desde el principio hasta el final, comparando cada valor con el buscado. La comparación por defecto es no estricta (==), lo que significa que 1 y '1' se consideran iguales. Si necesitas una comparación estricta (===), pasa el tercer parámetro true:

<?php\n$array = [0, '0', 1];\n$key = array_search('0', $array, true); // devuelve 1 (el string '0'), no 0\n?>

Si no se encuentra el valor, la función devuelve false. Por eso la verificación !== false es obligatoria; de lo contrario, unset($array[0]) eliminaría el primer elemento si el valor tuviera la clave 0.

Trampa: unset no reindexa el array

Después de unset, el array sigue siendo asociativo: las claves numéricas no se reorganizan. Si necesitas un array denso con índices consecutivos, usa array_values():

<?php\n$array = ['manzana', 'pera', 'naranja'];\nunset($array[1]);\n$array = array_values($array); // ['manzana', 'naranja'] con claves 0 y 1\n?>

Pero recuerda: array_values() crea un nuevo array, lo que aumenta el consumo de memoria.

Eliminar todas las ocurrencias: array_diff

Si necesitas eliminar todas las ocurrencias de un valor, usar array_search en un bucle no es la mejor idea. array_diff() es mucho más elegante:

<?php\n$array = ['manzana', 'pera', 'naranja', 'pera'];\n$array = array_diff($array, ['pera']);\n// Resultado: ['manzana', 'naranja'] (las claves se conservan)\n?>

La función devuelve un nuevo array del que se han eliminado todos los elementos que coinciden con los valores del segundo array. Internamente, PHP usa una tabla hash para el segundo array, por lo que la operación se ejecuta en O(n + m), donde n es el tamaño del primer array y m el del segundo.

Importante: array_diff compara los valores como strings ((string) $elem1 === (string) $elem2). Con tipos mixtos, esto puede dar resultados inesperados:

<?php\n$array = [0, '0', false];\n$result = array_diff($array, [0]);\n// Resultado: