المصفوفات متعددة الأبعاد في 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) الصفوف الثلاثة مع الحقول الستة داخلها، ولهذا تطبع 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']));