מערכים רב ממדיים ב-PHP: מערכים מקוננים ולולאות

מערך רב ממדי הוא מערך שהאיברים שלו הם מערכים. קוראים אותו עם זוג סוגריים לכל רמה: $grid[1][2] הוא שורה 1, עמודה 2, ו-$users[0]['name'] הוא השם ברשומה הראשונה.

<?php
$grid = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9],
];

echo $grid[1][2], "\n";   // row 1, column 2

$users = [
    ['name' => 'Ada',   'role' => 'admin'],
    ['name' => 'Linus', 'role' => 'editor'],
];

echo $users[0]['name'], "\n";
echo $users[1]['role'], "\n";

$grid[2][0] = 70;         // change a nested value
echo implode(' ', $grid[2]), "\n";

הצורה השנייה, רשימת רשומות עם שדות בעלי שם, היא זו שתפגשו הכי הרבה: זה מה ששאילתת מסד נתונים, תשובת JSON מפוענחת או קובץ CSV מפוענח נותנים לכם בדרך כלל. כל רשומה היא מערך אסוציאטיבי.

יצירת מערכים מקוננים

הקינון יכול להגיע לכל עומק שצריך, והרמות יכולות לערבב מפתחות מספריים ומפתחות מחרוזת. מערך הגדרות הוא דוגמה נפוצה: אזורים עם שם, שכל אחד מחזיק הגדרות או רשימות.

<?php
$config = [
    'db' => [
        'host' => 'localhost',
        'port' => 3306,
    ],
    'admins' => ['ada', 'grace'],
    'features' => [
        'search' => ['enabled' => true, 'limit' => 20],
    ],
];

echo $config['db']['host'], "\n";
echo $config['admins'][1], "\n";
echo $config['features']['search']['limit'], "\n";

הוספת שורות וערכים מקוננים

$rows[] = [...] מוסיף שורה שלמה. $arr['key'][] = $value מוסיף בתוך רשימה מקוננת, ו-PHP יוצרת את המערך הפנימי בפעם הראשונה, כך שקיבוץ ערכים לא דורש שום הכנה.

<?php
$orders = [
    ['customer' => 'Ada',   'item' => 'book'],
    ['customer' => 'Linus', 'item' => 'pen'],
    ['customer' => 'Ada',   'item' => 'lamp'],
];

$orders[] = ['customer' => 'Grace', 'item' => 'mug'];   // add a row

$byCustomer = [];
foreach ($orders as $order) {
    $byCustomer[$order['customer']][] = $order['item'];  // inner array created on first use
}

print_r($byCustomer);

מעבר על מערך רב ממדי בלולאה

השתמשו ב-foreach אחת לכל רמה. ברשימת רשומות, לולאה אחת מספיקה בדרך כלל כי קוראים את השדות לפי שם. ברשת, הלולאה הפנימית עוברת על התאים של כל שורה.

<?php
$students = [
    ['name' => 'Ada',   'scores' => [90, 85, 99]],
    ['name' => 'Linus', 'scores' => [70, 88, 79]],
];

foreach ($students as $student) {
    $average = array_sum($student['scores']) / count($student['scores']);
    echo $student['name'], ": ", round($average, 1), "\n";
}

$grid = [[1, 2, 3], [4, 5, 6]];
foreach ($grid as $r => $row) {
    foreach ($row as $c => $cell) {
        echo "[$r][$c]=$cell ";
    }
    echo "\n";
}

בניית טבלת HTML ממערך

מערך של שורות ממופה ישירות לטבלת HTML: המפתחות של השורה הראשונה הופכים לכותרת, וכל שורה הופכת ל-<tr>. הריצו אותו והלשונית Page תציג את הטבלה; שנו ערך או הוסיפו שורה והריצו שוב.

<?php
$products = [
    ['name' => 'Keyboard', 'price' => 49.99, 'stock' => 12],
    ['name' => 'Mouse',    'price' => 19.50, 'stock' => 0],
    ['name' => 'Monitor',  'price' => 189.00, 'stock' => 4],
];
?>
<style>
  table { border-collapse: collapse; font-family: sans-serif; }
  th, td { border: 1px solid #ccc; padding: 6px 12px; text-align: left; }
  .out { color: #b00; }
</style>
<table>
  <tr>
    <?php foreach (array_keys($products[0]) as $heading): ?>
      <th><?= htmlspecialchars(ucfirst($heading)) ?></th>
    <?php endforeach; ?>
  </tr>
  <?php foreach ($products as $product): ?>
    <tr class="<?= $product['stock'] === 0 ? 'out' : '' ?>">
      <td><?= htmlspecialchars($product['name']) ?></td>
      <td><?= number_format($product['price'], 2) ?></td>
      <td><?= $product['stock'] ?></td>
    </tr>
  <?php endforeach; ?>
</table>

הצורה foreach (...): ... endforeach; היא אותה לולאה בכתיב לתבניות, כך שה-HTML נשאר קריא.

קבלת עמודה אחת מכל השורות

array_column() שולפת שדה אחד מכל שורה לרשימה שטוחה. העבירו ארגומנט שלישי כדי שהתוצאה תקבל מפתחות לפי שדה אחר, וכך רשימת רשומות הופכת לטבלת חיפוש.

<?php
$users = [
    ['id' => 3, 'name' => 'Ada',   'email' => 'ada@example.com'],
    ['id' => 7, 'name' => 'Linus', 'email' => 'linus@example.com'],
    ['id' => 9, 'name' => 'Grace', 'email' => 'grace@example.com'],
];

print_r(array_column($users, 'name'));
print_r(array_column($users, 'email', 'id'));   // id => email

$byId = array_column($users, null, 'id');       // id => whole row
echo $byId[7]['name'], "\n";

מיון שורות לפי שדה

usort() ממיינת את השורות עם פונקציית השוואה. אופרטור החללית <=> מחזיר -1, 0 או 1, וזה בדיוק מה ש-usort() מצפה לו. החליפו בין $a ל-$b כדי למיין בסדר יורד.

<?php
$players = [
    ['name' => 'Ada',   'points' => 120],
    ['name' => 'Linus', 'points' => 95],
    ['name' => 'Grace', 'points' => 140],
];

usort($players, fn($a, $b) => $b['points'] <=> $a['points']);   // highest first

foreach ($players as $rank => $player) {
    echo $rank + 1, ". {$player['name']} ({$player['points']})\n";
}

echo count($players), " rows, ", count($players, COUNT_RECURSIVE), " elements in total\n";

count($players, COUNT_RECURSIVE) סופרת את 3 השורות ועוד את 6 השדות שבתוכן, ולכן היא מדפיסה 9.

טעות נפוצה: קריאה של מפתח עמוק שאולי חסר

קריאה של $config['cache']['ttl'] כשאין מפתח cache מדפיסה Warning: Undefined array key "cache", ואחריה Warning: Trying to access array offset on null לרמה הבאה. האופרטור ?? בודק את כל השרשרת בבת אחת ואף פעם לא מזהיר, ולכן זו הדרך הבטוחה לקרוא ערכים מקוננים אופציונליים.

<?php
$config = ['db' => ['host' => 'localhost']];

$ttl  = $config['cache']['ttl'] ?? 60;          // missing at the first level
$port = $config['db']['port'] ?? 3306;          // missing at the second level
$host = $config['db']['host'] ?? '127.0.0.1';   // present

echo "$ttl $port $host\n";
var_dump(isset($config['db']['host']));