Rimuovere un elemento da un array PHP: unset, array_splice

Per rimuovere un elemento da un array PHP tramite la sua chiave, usa unset($array[$key]). L'elemento sparisce, le altre chiavi restano esattamente com'erano, e fare unset di una chiave che non esiste non è un errore.

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

Guarda il secondo risultato: le chiavi ora sono 0, 2, 3. unset non rinumera mai.

Reindicizzare l'array dopo unset

Una lista con un buco nelle chiavi crea problemi più avanti: un ciclo for ($i = 0; ...) incontra l'indice mancante, e json_encode scrive un oggetto JSON invece di un array. array_values() ti ridà chiavi pulite.

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

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

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

Rimuovere per posizione con array_splice

array_splice($array, $offset, $length) rimuove $length elementi a partire dalla posizione $offset, rinumera le chiavi e restituisce ciò che ha rimosso. Un offset negativo conta dalla fine. Nella stessa chiamata può anche inserire elementi sostitutivi.

<?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 lavora sulle posizioni, non sulle chiavi: su un array associativo rimuove in base al posto nell'ordine e mantiene le chiavi stringa. La pagina su array_slice lo confronta con array_slice, che copia una parte senza modificare l'originale.

Rimuovere un elemento per valore

array_diff($array, [$value]) restituisce l'array senza ogni elemento uguale a $value, mantenendo le chiavi degli altri. Per rimuovere solo la prima corrispondenza, trova la sua chiave con array_search e fai 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 confronta i valori come stringhe, quindi array_diff([1, "1", 2], [1]) rimuove sia l'intero sia la stringa. Quando la condizione è più di "uguale a questo valore", usa array_filter con una callback.

Rimuovere il primo o l'ultimo elemento

array_shift() rimuove il primo elemento e array_pop() l'ultimo. Entrambe restituiscono l'elemento rimosso, il che le rende comode per code e pile.

<?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 rinumera le chiavi numeriche da 0. array_pop non ne ha bisogno, perché il buco è alla fine.

Rimuovere più chiavi insieme

unset accetta più elementi in una sola chiamata. Per rimuovere una lista di chiavi che hai in un array, invertila con array_flip() così i nomi diventano chiavi, poi passala ad 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)));

Errore comune: unset con array_search quando il valore manca

array_search restituisce false quando non trova nulla, e false usato come chiave di array diventa 0. Quindi questa riga elimina il primo elemento ogni volta che il valore non è nell'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);

Salva sempre il risultato di array_search e confrontalo con !== false prima di usarlo come chiave. Neanche un semplice if ($key) basta: anche una corrispondenza all'indice 0 è falsy.