Eliminar un elemento de un array en PHP: unset, array_splice

Para eliminar un elemento de un array de PHP por su clave, usa unset($array[$key]). El elemento desaparece, las demás claves se quedan exactamente como estaban, y hacer unset de una clave que no existe no es un error.

<?php
$user = ["name" => "Ada", "email" => "ada@example.com", "password" => "secret"];

unset($user["password"]);
print_r($user);

$colors = ["red", "green", "blue", "yellow"];
unset($colors[1]);
print_r($colors);

Mira el segundo resultado: ahora las claves son 0, 2, 3. unset nunca renumera.

Reindexar el array después de unset

Una lista con un hueco en sus claves da problemas más adelante: un bucle for ($i = 0; ...) se encuentra con el índice que falta, y json_encode escribe un objeto JSON en lugar de un array. array_values() te devuelve unas claves limpias.

<?php
$colors = ["red", "green", "blue", "yellow"];
unset($colors[1]);

echo json_encode($colors), "\n";

$colors = array_values($colors);
echo json_encode($colors), "\n";

Eliminar por posición con array_splice

array_splice($array, $offset, $length) elimina $length elementos a partir de la posición $offset, renumera las claves y devuelve lo que eliminó. Un desplazamiento negativo cuenta desde el final. En la misma llamada también puede insertar elementos de reemplazo.

<?php
$queue = ["a", "b", "c", "d", "e"];

$removed = array_splice($queue, 1, 2);
print_r($removed);
print_r($queue);

// Remove the second to last element
array_splice($queue, -2, 1);
print_r($queue);

// Replace one element with two
$letters = ["x", "y", "z"];
array_splice($letters, 1, 1, ["Y1", "Y2"]);
print_r($letters);

array_splice trabaja con posiciones, no con claves: en un array asociativo elimina según el lugar que ocupa en el orden, y conserva las claves de texto. La página de array_slice la compara con array_slice, que copia una parte sin cambiar el original.

Eliminar un elemento por valor

array_diff($array, [$value]) devuelve el array sin todos los elementos iguales a $value, conservando las claves del resto. Para eliminar solo la primera coincidencia, busca su clave con array_search y elimínala con unset.

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

// Every "draft"
print_r(array_diff($tags, ["draft"]));

// Several values at once
print_r(array_values(array_diff($tags, ["draft", "tips"])));

// Only the first "draft"
$key = array_search("draft", $tags);
if ($key !== false) {
    unset($tags[$key]);
}
print_r($tags);

array_diff compara los valores como cadenas, así que array_diff([1, "1", 2], [1]) elimina tanto el entero como la cadena. Cuando la condición es algo más que "igual a este valor", usa array_filter con un callback.

Eliminar el primer o el último elemento

array_shift() elimina el primer elemento y array_pop() el último. Las dos devuelven el elemento eliminado, lo que las hace prácticas para colas y pilas.

<?php
$tasks = ["write", "test", "deploy"];

$first = array_shift($tasks);
$last = array_pop($tasks);

echo "First: $first\n";
echo "Last: $last\n";
print_r($tasks);

array_shift renumera las claves numéricas desde 0. array_pop no lo necesita, porque el hueco queda al final.

Eliminar varias claves a la vez

unset acepta varios elementos en una llamada. Para eliminar una lista de claves que tienes en un array, inviértela con array_flip() para que los nombres se conviertan en claves, y pásala a array_diff_key().

<?php
$row = ["id" => 7, "name" => "Ada", "token" => "x1", "salt" => "y2", "role" => "admin"];

$copy = $row;
unset($copy["token"], $copy["salt"]);
print_r($copy);

$hidden = ["token", "salt", "role"];
print_r(array_diff_key($row, array_flip($hidden)));

Error frecuente: unset con array_search cuando el valor no está

array_search devuelve false cuando no encuentra nada, y false usado como clave de array se convierte en 0. Así que esta línea borra el primer elemento siempre que el valor no esté en el array:

<?php
$fruits = ["apple", "banana", "cherry"];

// "grape" is not there, array_search returns false, false becomes key 0
unset($fruits[array_search("grape", $fruits)]);
print_r($fruits); // apple is gone

// Correct: check the result with !== false
$fruits = ["apple", "banana", "cherry"];
$key = array_search("grape", $fruits);
if ($key !== false) {
    unset($fruits[$key]);
}
print_r($fruits);

Guarda siempre el resultado de array_search y compáralo con !== false antes de usarlo como clave. Un simple if ($key) tampoco basta: una coincidencia en el índice 0 también es falsy.