المصفوفات في PHP: الإنشاء والوصول والمرور والطباعة

تخزّن المصفوفة في PHP قائمة من القيم تحت مفاتيح. أنشئ واحدة بالأقواس المربعة، $fruits = ['apple', 'banana', 'cherry'];، واقرأ عنصرًا بفهرسه، $fruits[0]. تبدأ الفهارس من 0، وتعطي count($fruits) عدد العناصر.

<?php
$fruits = ['apple', 'banana', 'cherry'];

echo $fruits[0], "\n";        // first element
echo $fruits[2], "\n";        // third element
echo count($fruits), "\n";    // number of elements

$fruits[] = 'date';           // add to the end
$fruits[1] = 'blueberry';     // change an element

print_r($fruits);

كل مصفوفة في PHP خريطة مرتبة: كل قيمة تقع تحت مفتاح. عندما لا تختار المفاتيح، ترقّمها PHP 0, 1, 2... فتحصل على مصفوفة مفهرسة. وعندما تختارها بنفسك (['name' => 'Ada'])، تحصل على مصفوفة ترابطية. وكلتاهما من النوع array نفسه.

إنشاء مصفوفة

الأقواس المربعة هي الصيغة المعتادة. وarray() هي الكتابة الأقدم وتنتج الشيء نفسه تمامًا. تبني range() قائمة من الأعداد أو الحروف، وتكرر array_fill() قيمة واحدة.

<?php
$empty   = [];
$numbers = [10, 20, 30];
$old     = array('a', 'b', 'c');      // same as ['a', 'b', 'c']
$mixed   = [1, 'two', 3.5, true, null];

$oneToFive = range(1, 5);
$letters   = range('a', 'e');
$zeros     = array_fill(0, 3, 0);

echo implode(', ', $oneToFive), "\n";
echo implode(', ', $letters), "\n";
echo implode(', ', $zeros), "\n";
var_dump($empty === []);
echo count($mixed), "\n";

يمكن لمصفوفة PHP أن تحمل قيمًا من أنواع مختلفة معًا، بما فيها مصفوفات أخرى. والمصفوفة المكوّنة من مصفوفات هي مصفوفة متعددة الأبعاد، وهي الطريقة المعتادة لحمل صفوف من البيانات.

الحصول على العنصر الأول والأخير

ليس في PHP فهارس سالبة. لا تعني $arr[-1] «الأخير»: بل تبحث عن مفتاح اسمه -1، وعندما لا يوجد تطبع PHP Warning: Undefined array key -1. استخدم array_key_first() وarray_key_last()، وهما تعملان أيضًا عندما لا تبدأ المفاتيح من 0.

<?php
$queue = ['Ada', 'Grace', 'Linus', 'Margaret'];

$first = $queue[array_key_first($queue)];
$last  = $queue[array_key_last($queue)];
echo "First: $first, last: $last\n";

// Same result by position
echo $queue[count($queue) - 1], "\n";

// The last two elements
print_r(array_slice($queue, -2));

تعيد end($queue) أيضًا القيمة الأخيرة، لكنها تحرّك المؤشر الداخلي للمصفوفة أثرًا جانبيًا، لذا فالأسلوب المعتمد على المفاتيح هو الخيار الأوضح.

طباعة مصفوفة

لا تعمل echo $arr: فهي تطبع الكلمة Array وتحذيرًا. اختر المخرجات المناسبة للمهمة:

• print_r($arr) لعرض مقروء أثناء تصحيح الأخطاء.
• var_dump($arr) لترى أيضًا نوع كل قيمة وطولها.
• implode(', ', $arr) لتحويل القيم إلى نص واحد للعرض.
• json_encode($arr) لإرسال المصفوفة إلى JavaScript أو إلى واجهة برمجية.

<?php
$scores = [90, 72, 85];

print_r($scores);
var_dump($scores);
echo implode(', ', $scores), "\n";
echo json_encode($scores), "\n";

تشرح صفحة print_r وvar_dump خيارات التنسيق، بما فيها طباعة مصفوفة داخل HTML.

المرور على مصفوفة

foreach هي الحلقة المصنوعة للمصفوفات: تعطيك كل قيمة، والمفتاح أيضًا إن طلبته. وتعمل حلقة for مع فهرس أيضًا للمصفوفات المفهرسة التي تبدأ مفاتيحها من 0 دون فجوات.

<?php
$languages = ['PHP', 'Python', 'Go'];

foreach ($languages as $language) {
    echo "I know $language\n";
}

foreach ($languages as $i => $language) {
    echo ($i + 1) . ". $language\n";
}

for ($i = 0; $i < count($languages); $i++) {
    echo strtolower($languages[$i]), "\n";
}

المصفوفات تُنسخ ولا تُشارك

إسناد مصفوفة إلى متغير آخر، أو تمريرها إلى دالة، يعطي نسخة. تغيير النسخة يترك الأصل كما هو. أضف & إلى المعامل عندما يجب أن تغيّر الدالة مصفوفة المستدعي.

<?php
$a = [1, 2, 3];
$b = $a;          // a copy
$b[] = 4;

echo count($a), " ", count($b), "\n";

function addItem(array &$list, string $item): void
{
    $list[] = $item;
}

$cart = ['milk'];
addItem($cart, 'bread');
print_r($cart);

دوال المصفوفات حسب المهمة

تأتي PHP بأكثر من 70 دالة للمصفوفات. هذه هي الأكثر استخدامًا، ولكل منها صفحتها:

مفاتيح تندمج بصمت

مفاتيح المصفوفة إما أعداد صحيحة أو نصوص، وتحوّل PHP بعض المفاتيح نيابة عنك. النص الذي يشبه عددًا عشريًا صحيحًا، مثل "1"، يصبح العدد الصحيح 1، فتكون $a["1"] و$a[1] الخانة نفسها. أما "01" و"1.5" فتبقيان نصين. لهذا قد تنتهي مصفوفة مبنية من مُدخلات نموذج أو من ملف CSV بعدد عناصر أقل مما توقعت.

<?php
$a = [];
$a[1]    = 'int one';
$a["1"]  = 'string one';   // same key as 1, overwrites it
$a["01"] = 'zero one';     // stays the string "01"

var_dump($a);
echo count($a), "\n";