Usuwanie elementu z tablicy w PHP: unset, array_splice

Aby usunąć element z tablicy w PHP po kluczu, użyj unset($array[$key]). Element znika, pozostałe klucze zostają dokładnie takie, jakie były, a usunięcie nieistniejącego klucza nie jest błędem.

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

Spójrz na drugi wynik: klucze to teraz 0, 2, 3. unset nigdy nie numeruje od nowa.

Numerowanie tablicy od nowa po unset

Lista z luką w kluczach sprawia później kłopoty: pętla for ($i = 0; ...) trafia na brakujący indeks, a json_encode zapisuje obiekt JSON zamiast tablicy. array_values() znów daje czyste klucze.

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

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

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

Usuwanie po pozycji przez array_splice

array_splice($array, $offset, $length) usuwa $length elementów od pozycji $offset, numeruje klucze od nowa i zwraca to, co usunęło. Ujemny offset liczy od końca. W tym samym wywołaniu może też wstawić elementy zastępcze.

<?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 działa na pozycjach, a nie kluczach: na tablicy asocjacyjnej usuwa według miejsca w kolejności i zachowuje klucze tekstowe. Strona array_slice porównuje ją z array_slice, które kopiuje fragment bez zmiany oryginału.

Usuwanie elementu po wartości

array_diff($array, [$value]) zwraca tablicę bez wszystkich elementów równych $value, zachowując klucze pozostałych. Aby usunąć tylko pierwsze dopasowanie, znajdź jego klucz przez array_search i usuń go.

<?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 porównuje wartości jako stringi, więc array_diff([1, "1", 2], [1]) usuwa i liczbę całkowitą, i string. Gdy warunek to coś więcej niż „równe tej wartości”, użyj array_filter z callbackiem.

Usuwanie pierwszego lub ostatniego elementu

array_shift() usuwa pierwszy element, a array_pop() ostatni. Obie zwracają usunięty element, co przydaje się przy kolejkach i stosach.

<?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 numeruje klucze liczbowe od 0. array_pop nie musi, bo luka powstaje na końcu.

Usuwanie kilku kluczy naraz

unset przyjmuje kilka elementów w jednym wywołaniu. Aby usunąć listę kluczy, którą masz w tablicy, odwróć ją przez array_flip(), żeby nazwy stały się kluczami, i przekaż do 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)));

Częsty błąd: unset z array_search, gdy wartości brakuje

array_search zwraca false, gdy nic nie znajdzie, a false użyte jako klucz tablicy staje się 0. Ta linia usuwa więc pierwszy element za każdym razem, gdy wartości nie ma w tablicy:

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

Zawsze zapisuj wynik array_search i porównuj go z !== false, zanim użyjesz go jako klucza. Zwykłe if ($key) też nie wystarczy: dopasowanie pod indeksem 0 również jest traktowane jak fałsz.