PHP Element aus Array entfernen: unset, array_splice

Um ein Element über seinen Schlüssel aus einem PHP-Array zu entfernen, verwendest du unset($array[$key]). Das Element ist weg, die anderen Schlüssel bleiben genau, wie sie waren, und einen Schlüssel zu entfernen, der nicht existiert, ist kein Fehler.

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

Schau dir das zweite Ergebnis an: Die Schlüssel sind jetzt 0, 2, 3. unset nummeriert nie neu.

Das Array nach unset neu indizieren

Eine Liste mit einer Lücke in den Schlüsseln macht später Ärger: Eine Schleife for ($i = 0; ...) trifft auf den fehlenden Index, und json_encode schreibt ein JSON-Objekt statt eines Arrays. array_values() gibt dir wieder saubere Schlüssel.

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

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

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

Über die Position mit array_splice entfernen

array_splice($array, $offset, $length) entfernt $length Elemente ab Position $offset, nummeriert die Schlüssel neu und liefert, was es entfernt hat. Ein negativer Offset zählt vom Ende. Es kann im selben Aufruf auch Ersatzelemente einfügen.

<?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 arbeitet mit Positionen, nicht mit Schlüsseln: Bei einem assoziativen Array entfernt es nach Platz in der Reihenfolge und behält String-Schlüssel. Die Seite zu array_slice vergleicht es mit array_slice, das einen Teil kopiert, ohne das Original zu ändern.

Ein Element über den Wert entfernen

array_diff($array, [$value]) liefert das Array ohne jedes Element, das gleich $value ist, und behält die Schlüssel der übrigen. Um nur den ersten Treffer zu entfernen, suchst du seinen Schlüssel mit array_search und rufst unset auf.

<?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 vergleicht Werte als Strings, also entfernt array_diff([1, "1", 2], [1]) sowohl die Ganzzahl als auch den String. Wenn die Bedingung mehr ist als „gleich diesem Wert“, verwendest du array_filter mit einem Callback.

Das erste oder letzte Element entfernen

array_shift() entfernt das erste Element und array_pop() das letzte. Beide liefern das entfernte Element zurück, was sie praktisch für Warteschlangen und Stacks macht.

<?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 nummeriert numerische Schlüssel ab 0 neu. array_pop muss das nicht, weil die Lücke am Ende liegt.

Mehrere Schlüssel auf einmal entfernen

unset akzeptiert mehrere Elemente in einem Aufruf. Um eine Liste von Schlüsseln zu entfernen, die du in einem Array hast, drehst du sie mit array_flip() um, sodass die Namen zu Schlüsseln werden, und übergibst sie dann an 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)));

Typischer Fehler: unset mit array_search, wenn der Wert fehlt

array_search liefert false, wenn es nichts findet, und false als Array-Schlüssel wird zu 0. Diese Zeile löscht also das erste Element, sobald der Wert nicht im Array steht:

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

Speichere das Ergebnis von array_search immer und vergleiche es mit !== false, bevor du es als Schlüssel verwendest. Ein einfaches if ($key) reicht auch nicht: Ein Treffer an Index 0 ist ebenfalls falsy.