إضافة عناصر إلى مصفوفة فارغة في PHP: ماذا يحدث تحت الغطاء؟

سحر الحاوية الفارغة: كيف تجعل PHP تعمل لصالحك

تخيل: أنت تكتب سكريبت PHP وتحتاج إلى جمع بيانات — مثل معرفات المنتجات من سلة التسوق. تقوم بإنشاء مصفوفة فارغة، ثم تضيف إليها عناصر داخل حلقة. قد يبدو الأمر بسيطًا، لكن هذه اللحظة — إضافة عناصر إلى مصفوفة PHP فارغة — تثير آلاف الأسئلة على Stack Overflow. لماذا؟ لأن المبتدئين غالبًا ما يخلطون بين الصيغ، بينما يريد المطورون المحترفون فهم ما يحدث "تحت الغطاء".

في هذه المقالة، لن نعرض فقط كيفية كتابة الكود بشكل صحيح. سننظر داخل نواة PHP (Zend Engine)، ونحلل الفرق بين $arr[] = $value و array_push()، ونكتشف المفاجآت التي يخبئها PHP 8.1. هل أنت مستعد؟ هيا بنا!

السؤال الأكثر شيوعًا: كيف تضيف عنصرًا؟

إذا كنت مبتدئًا، فمن المحتمل أن أول ما يخطر ببالك هو كتابة شيء مثل:

<?php\n$myArray = array(); // مصفوفة فارغة\n$myArray[] = 'العنصر الأول';\n$myArray[] = 'العنصر الثاني';\nprint_r($myArray);\n?>

هذا الكود سيطبع:

Array\n(\n    [0] => العنصر الأول\n    [1] => العنصر الثاني\n)

هل يعمل؟ نعم. لكن لماذا؟ دعنا نحلل ما يفعله عامل التشغيل [] في الواقع.

عامل التشغيل $arr[] = $value: سريع وأنيق

عندما تكتب $arr[] = $value، فإن PHP لا يستدعي أي دوال. بدلاً من ذلك، يصل مباشرة إلى بنية البيانات الداخلية للمصفوفة (zend_array في مصطلحات Zend Engine).

ماذا يحدث تحت الغطاء:

\n
• يتحقق PHP مما إذا كانت المصفوفة موجودة. إذا لم تكن موجودة، يقوم بإنشاء واحدة جديدة (لكن من الأفضل دائمًا تهيئتها صراحة: $arr = []).
\n
• يضيف العنصر إلى نهاية المصفوفة، مع تعيين المفتاح الرقمي التالي تلقائيًا (0، 1، 2...).
\n
• إذا كانت المصفوفة فارغة — يحصل العنصر الأول على المفتاح 0.
\n
• لا توجد تكاليف إضافية لاستدعاء الدوال. هذه هي الطريقة الأكثر كفاءة في الأداء.
\n

نصيحة: استخدم $arr[] = ... دائمًا عندما تحتاج فقط إلى إضافة عنصر إلى النهاية. إنها سريعة وقابلة للقراءة ولا تتطلب استيراد دوال.

array_push(): عندما تحتاج إلى إضافة عدة عناصر دفعة واحدة

الطريقة الشائعة الثانية هي دالة array_push():

<?php\n$myArray = [];\narray_push($myArray, 'الأول', 'الثاني', 'الثالث');\nprint_r($myArray);\n?>

النتيجة ستكون نفسها. لكن هناك تفاصيل دقيقة:

\n
• array_push() تأخذ المصفوفة كمرجع وتضيف جميع القيم الممررة إلى النهاية.
\n
• ترجع العدد الجديد من العناصر في المصفوفة (بدءًا من PHP 7.3).
\n
• تحت الغطاء: تستدعي الدالة الإجراء الداخلي zend_hash_next_index_insert لكل عنصر. هذا يعني أنه إذا كنت تضيف عنصرًا واحدًا، فإن array_push() تعمل بشكل أبطأ قليلاً من $arr[] = ... بسبب التكاليف الإضافية لاستدعاء الدالة.
\n

متى تستخدم: فقط إذا كنت بحاجة إلى إضافة عدة عناصر دفعة واحدة (2 أو أكثر). لعنصر واحد — انسَ array_push واستخدم [].

المصفوفة الفارغة والمفاتيح: ماذا لو كانت المفاتيح غير رقمية؟

ماذا تفعل إذا كنت تريد إضافة عنصر بمفتاح محدد؟ على سبيل المثال، مصفوفة ترابطية:

<?php\n$user = [];\n$user['name'] = 'أحمد';\n$user['age'] = 30;\n?>

هنا أيضًا الأمر بسيط. عامل التشغيل [] مع مفتاح داخل الأقواس المربعة ($arr['key'] = value) يعمل كتعيين. إذا كان المفتاح غير موجود — يتم إنشاؤه. إذا كان موجودًا — يتم استبداله.

لكن كن حذرًا: إذا كتبت بالخطأ $user[] = 'قيمة' بجانب مصفوفة ترابطية، سيضيف PHP مفتاحًا رقميًا