المصفوفات الترابطية في PHP: أزواج المفتاح والقيمة

تخزّن المصفوفة الترابطية كل قيمة تحت مفتاح تختاره، مكتوبة على شكل key => value: $user = ['name' => 'Ada', 'age' => 36];. اقرأ قيمة بـ $user['name']، وأضف قيمة أو غيّرها بالإسناد إلى مفتاحها: $user['email'] = 'ada@example.com';.

<?php
$user = [
    'name' => 'Ada',
    'age'  => 36,
    'city' => 'London',
];

echo $user['name'], "\n";
echo $user['age'], "\n";

$user['email'] = 'ada@example.com';   // add a pair
$user['city']  = 'Paris';             // change a value

print_r($user);

في لغات أخرى تُسمى البنية نفسها قاموسًا أو خريطة أو جدول تجزئة. وفي PHP هي مصفوفة عادية مفاتيحها نصوص بدل 0, 1, 2.

إضافة الأزواج وتغييرها وحذفها

الإسناد إلى مفتاح غير موجود يضيفه في النهاية. والإسناد إلى مفتاح موجود يستبدل قيمته ويُبقي موضعه. وتحذف unset() زوجًا.

<?php
$stock = ['apples' => 10, 'pears' => 4];

$stock['plums'] = 7;      // new key: added at the end
$stock['apples'] = 12;    // existing key: value replaced
$stock['pears']--;        // change in place
unset($stock['plums']);   // remove a pair

print_r($stock);

لا تفيد array_push() هنا: فهي لا تستطيع إلا إلحاق قيم بمفاتيح رقمية. لإضافة عدة أزواج معًا، استخدم array_merge($stock, $more)، حيث تفوز القيم الجديدة، أو $stock + $more، حيث تحتفظ المفاتيح الموجودة بقيمها؛ وتقارن صفحة array_merge بين الاثنين.

المرور على المفاتيح والقيم

تمر foreach ($array as $key => $value) على الأزواج بترتيب إضافتها. احذف $key => عندما لا تحتاج إلا إلى القيم.

<?php
$capitals = [
    'France'  => 'Paris',
    'Japan'   => 'Tokyo',
    'Brazil'  => 'Brasília',
];

foreach ($capitals as $country => $capital) {
    echo "The capital of $country is $capital.\n";
}

foreach ($capitals as $capital) {
    echo mb_strtoupper($capital), "\n";
}

الحصول على كل المفاتيح أو كل القيم

تعيد array_keys() المفاتيح قائمةً عادية وتعيد array_values() القيم، وكلتاهما مُعاد فهرستها من 0. وأعطِ array_keys() وسيطًا ثانيًا فتعيد فقط المفاتيح التي تحمل تلك القيمة، وهكذا تجد كل مفتاح لقيمة ما.

<?php
$grades = ['Ada' => 'A', 'Linus' => 'B', 'Grace' => 'A'];

print_r(array_keys($grades));
print_r(array_values($grades));
print_r(array_keys($grades, 'A'));    // keys whose value is 'A'

echo array_search('B', $grades), "\n"; // first key with value 'B'

لمفتاح واحد، تعيد array_search() أول تطابق، أو false عندما لا يوجد. وتشرح صفحة array_search لماذا يجب أن تقارن تلك النتيجة بـ !== false.

التحقق من وجود مفتاح

isset($arr['key']) هو الفحص المعتاد والأسرع، لكنه يعيد false عندما يكون المفتاح موجودًا ويحمل null. أما array_key_exists('key', $arr) فتعيد true في هذه الحالة. وللقراءة مع قيمة بديلة، يفعل العامل ?? الأمرين معًا.

<?php
$settings = ['theme' => 'dark', 'font' => null];

var_dump(isset($settings['theme']));
var_dump(isset($settings['font']));            // null counts as not set
var_dump(array_key_exists('font', $settings)); // the key is there

$size = $settings['size'] ?? 14;               // default when missing
echo $size, "\n";

الترتيب حسب المفتاح أو القيمة

ترتّب ksort() حسب المفتاح وترتّب asort() حسب القيمة، وكلتاهما تُبقي كل مفتاح مرتبطًا بقيمته. وترتّب krsort() وarsort() ترتيبًا عكسيًا. لا تستخدم sort() على مصفوفة ترابطية: فهي ترمي المفاتيح وتعيد الترقيم من 0.

<?php
$population = ['Tokyo' => 37, 'Delhi' => 32, 'Shanghai' => 29, 'Cairo' => 22];

ksort($population);       // A to Z by city
print_r($population);

arsort($population);      // largest value first
print_r($population);

sort($population);        // keys are lost
print_r($population);

كل هذه الدوال ترتّب في المكان نفسه وتعيد true، لذا فإن $sorted = ksort($arr) تعطيك true لا مصفوفة. والترتيبات المخصصة تستخدم uasort() وuksort().

القلب والعدّ والتحويل إلى JSON

بعض الأسطر القصيرة تتكرر كثيرًا مع بيانات المفتاح والقيمة: تبادل array_flip() بين المفاتيح والقيم، وتعدّ array_count_values() مرات ظهور كل قيمة، وتحوّل json_encode() المصفوفة إلى كائن JSON.

<?php
$codes = ['red' => '#f00', 'green' => '#0f0', 'blue' => '#00f'];

print_r(array_flip($codes));           // look up a name by code

$votes = ['yes', 'no', 'yes', 'yes', 'no'];
print_r(array_count_values($votes));   // value => how many times

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

خطأ شائع: قراءة مفتاح غير موجود

قراءة مفتاح مفقود تعيد null، لكن PHP لديك تطبع تحذيرًا أيضًا:

<?php
$user = ['name' => 'Ada'];
echo $user['phone'];

Warning: Undefined array key "phone" in /var/www/html/index.php on line 3

أعطِ القراءة قيمة افتراضية بـ ??، الذي لا يحذّر أبدًا، أو افحص بـ isset() أولًا عندما تحتاج الحالة المفقودة إلى فرع خاص بها.

<?php
$user = ['name' => 'Ada', 'email' => 'ada@example.com'];

$phone = $user['phone'] ?? 'no phone on file';
echo $phone, "\n";

if (isset($user['email'])) {
    echo "Send mail to {$user['email']}\n";
}

داخل نص بين علامتي تنصيص مزدوجتين، ضع البحث بين أقواس معقوصة، "{$user['email']}". ومن دونها لا تقبل PHP إلا الصيغة دون علامات تنصيص "$user[email]"، وهي سهلة الخطأ.