حذف عنصر من مصفوفة في PHP: unset وarray_splice

لحذف عنصر من مصفوفة PHP بمفتاحه، استخدم unset($array[$key]). يختفي العنصر، وتبقى المفاتيح الأخرى كما كانت تمامًا، وحذف مفتاح غير موجود ليس خطأً.

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

انظر إلى النتيجة الثانية: المفاتيح الآن 0, 2, 3. لا تعيد unset الترقيم أبدًا.

إعادة فهرسة المصفوفة بعد unset

القائمة التي فيها فجوة في مفاتيحها تسبب مشكلات لاحقًا: تصطدم حلقة for ($i = 0; ...) بالفهرس المفقود، وتكتب json_encode كائن JSON بدل مصفوفة. تعطيك array_values() مفاتيح نظيفة من جديد.

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

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

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

الحذف بالموضع بـ array_splice

تحذف array_splice($array, $offset, $length) عدد $length من العناصر بدءًا من الموضع $offset، وتعيد ترقيم المفاتيح، وتعيد ما حذفته. والإزاحة السالبة تُعدّ من النهاية. وتستطيع أيضًا إدراج عناصر بديلة في الاستدعاء نفسه.

<?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 على المواضع، لا المفاتيح: على مصفوفة ترابطية تحذف حسب المكان في الترتيب، وتحتفظ بالمفاتيح النصية. وتقارنها صفحة array_slice بـ array_slice، التي تنسخ جزءًا دون تغيير الأصل.

حذف عنصر بقيمته

تعيد array_diff($array, [$value]) المصفوفة دون كل عنصر يساوي $value، محتفظة بمفاتيح البقية. ولحذف أول تطابق فقط، جد مفتاحه بـ array_search واحذفه بـ 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 القيم على أنها نصوص، لذا تحذف array_diff([1, "1", 2], [1]) العدد الصحيح والنص كليهما. وعندما يكون الشرط أكثر من «يساوي هذه القيمة»، استخدم array_filter مع دالة استدعاء.

حذف العنصر الأول أو الأخير

تحذف array_shift() العنصر الأول وتحذف array_pop() العنصر الأخير. وكلتاهما تعيد العنصر الذي حذفته، وهذا يجعلهما مفيدتين للطوابير والمكدسات.

<?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 ترقيم المفاتيح الرقمية من 0. ولا تحتاج array_pop إلى ذلك، لأن الفجوة في النهاية.

حذف عدة مفاتيح معًا

تقبل unset عدة عناصر في استدعاء واحد. ولحذف قائمة من المفاتيح لديك في مصفوفة، اقلبها بـ array_flip() لتصبح الأسماء مفاتيح، ثم مرّرها إلى 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)));

خطأ شائع: unset مع array_search عندما تكون القيمة مفقودة

تعيد array_search القيمة false عندما لا تجد شيئًا، وfalse المستخدمة مفتاحًا في مصفوفة تصبح 0. لذا يحذف هذا السطر العنصر الأول كلما لم تكن القيمة في المصفوفة:

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

خزّن دائمًا نتيجة array_search وقارنها بـ !== false قبل استخدامها مفتاحًا. ولا تكفي if ($key) البسيطة أيضًا: التطابق عند الفهرس 0 خاطئ منطقيًا كذلك.