מערכים אסוציאטיביים ב-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);

בשפות אחרות אותו מבנה נקרא dictionary, map או hash. ב-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]", שקל לטעות בה.