Supprimer un élément d'un tableau PHP : unset, array_splice

Pour supprimer un élément d'un tableau PHP par sa clé, utilisez unset($array[$key]). L'élément disparaît, les autres clés restent exactement comme elles étaient, et supprimer une clé qui n'existe pas n'est pas une erreur.

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

Regardez le second résultat : les clés sont maintenant 0, 2, 3. unset ne renumérote jamais.

Réindexer le tableau après unset

Une liste avec un trou dans ses clés pose problème plus tard : une boucle for ($i = 0; ...) tombe sur l'index manquant, et json_encode écrit un objet JSON au lieu d'un tableau. array_values() vous redonne des clés propres.

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

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

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

Supprimer par position avec array_splice

array_splice($array, $offset, $length) supprime $length éléments à partir de la position $offset, renumérote les clés et renvoie ce qu'elle a supprimé. Une position négative compte depuis la fin. Elle peut aussi insérer des éléments de remplacement dans le même appel.

<?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 travaille sur des positions, pas sur des clés : sur un tableau associatif, elle supprime selon la place dans l'ordre, et garde les clés de type chaîne. La page array_slice la compare à array_slice, qui copie une partie sans modifier l'original.

Supprimer un élément par sa valeur

array_diff($array, [$value]) renvoie le tableau sans aucun élément égal à $value, en gardant les clés des autres. Pour ne supprimer que la première correspondance, trouvez sa clé avec array_search et supprimez-la.

<?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 compare les valeurs comme des chaînes, donc array_diff([1, "1", 2], [1]) supprime à la fois l'entier et la chaîne. Quand la condition va au-delà de « égal à cette valeur », utilisez array_filter avec un callback.

Supprimer le premier ou le dernier élément

array_shift() supprime le premier élément et array_pop() le dernier. Les deux renvoient l'élément supprimé, ce qui les rend pratiques pour des files et des piles.

<?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 renumérote les clés numériques depuis 0. array_pop n'en a pas besoin, puisque le trou est à la fin.

Supprimer plusieurs clés à la fois

unset accepte plusieurs éléments en un appel. Pour supprimer une liste de clés que vous avez dans un tableau, inversez-la avec array_flip() pour que les noms deviennent des clés, puis passez-la à 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)));

Erreur fréquente : unset avec array_search quand la valeur manque

array_search renvoie false quand elle ne trouve rien, et false utilisé comme clé de tableau devient 0. Cette ligne supprime donc le premier élément chaque fois que la valeur n'est pas dans le tableau :

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

Stockez toujours le résultat d'array_search et comparez-le avec !== false avant de l'utiliser comme clé. Un simple if ($key) ne suffit pas non plus : une correspondance à l'index 0 est aussi évaluée à faux.