نعلم جميعاً أن لكل متغير مجال محدد ( PHP VARIABLE SCOPES ) ولا يمكن استخدام المتغير إلا في نطاقه, ونعرف أن المتغيرات الشاملة ( PHP GLOBAL VARIABLES ) لا يمكن استخدامها داخل الدوال إلا باستخدام كلمة global . لكن ماذا إذا أردت استخدام المتغيرات الشاملة كوسيط لدالة function argument .
يمكن تمرير المتغيرات الشاملة كوسائط للدوال باستخدام مرجع reference للمتغير وليس استخدام المتغير نفسه عن طريق وضع علامة & قبل وسائط الدالة.
كما تعلم أنه يمكن تمرير قيم الوسائط للدالة ( php passing arguments by value ) وهذه الطريقة تستخدم الوسائط دون تغيير قيمتها الأصلية
أنظر الكود التالي
<?php function fix_names($n1, $n2, $n3){ $n1 = ucfirst($n1); $n2 = ucfirst($n2); $n3 = ucfirst($n3); echo $n1 . " " . $n2 . " " . $n3; } $a1 = "william"; $a2 = "henry"; $a3 = "gates"; fix_names($a1, $a2, $a3); echo '<br>'; echo $a1 . " " . $a2 . " " . $a3; ?>شرح الكود :
1- في السطر رقم 2 قمنا بتعريف الدالة fix_names ومررنا إليها المتغيرات n1,n2,n3
2- في السطر رقم 3,4,5 قمنا بتطبيق الدالة ( PHP UCFIRST ) التي ستقوم بتحويل الأحرف الأولى لقيم المتغيرات إلى أحرف كبيرة.
3- في السطر رقم 6 طلبنا طباعة قيم المتغيرات بعد التحويل.
4- في السطر رقم 8,9,10 قمنا بتعريف المتغيرات a1,a2,a3 .
5- ثم في السطر رقم 11 قمنا بتطبيق الدالة fix_names على هذه المتغيرات, فيتم طباعة المتغيرات مع تغيير الأحرف الأولى لها .
6- أما في اسطر رقم 13 قمنا بطباعة المتغيرات a1,a2,a3 فتكون النتيجة هي القيم الأصلية دون تغيير.
بالتالي تمرير قيم الوسائط إلى الدوال يحافظ على قيم الوسائط دون تغيير , على عكس تمرير الوسائط بالمرجعية ( Passing By reference )
أنظر الكود التالي
<?php function fix_names(&$n1, &$n2, &$n3){ $n1 = ucfirst($n1); $n2 = ucfirst($n2); $n3 = ucfirst($n3); echo $n1 . " " . $n2 . " " . $n3; } $a1 = "william"; $a2 = "henry"; $a3 = "gates"; fix_names($a1, $a2, $a3); echo '<br>'; echo $a1 . " " . $a2 . " " . $a3; ?>شرح الكود
1- في السطر رقم 2 قمنا بإنشاء دالة ( PHP FUNCTIONS ) وهي fix_names باستخدام الوسائط arguments وهي n1, n2,n3 بالإضافة إلى وضع & قبل كل وسيط. هذه الدالة تقوم بتحويل الحرف الأول لأي متغير من النوع string إلى حرف كبير Capital letter باستخدام الدالة مسبقة الإعداد في بي إتش بي ( PHP UCFIRST ).
2- ثم في السطر رقم 8,9,10 قمنا بتعريف ثلاثة متغيرات a1 , a2, a3 لتنفيذ الدالة fix_names عليهم
3- ثم في السطر رقم 11 قمنا باستدعاء الدالة fix_names وتم تمرير الثلاثة متغيرات كوسائط لهذه الدالة, فقامت الدالة بتحويل الحرف الأول ولكن حتى هذه اللحظة لن يتم طباعة النتيجة لأننا لم نطلب الطباعة داخل الدالة في الأساس.
4- ثم في السطر رقم 12 طلبنا طباعة المتغيرات الثلاث باستخدام echo , فكانت النتيجة واحدة مما يوضح أن تمرير الوسائط للدوال بالمرجعية يقوم بتغيير القيمة الأصلية لها على عكس تمرير قيم الوسائط.
[highlight background=”” color=””]لاحظ : تم إضافت مجموعة الـ (a1 , a2, a3) باستخدام التسلسل ( PHP STRING CONCATENATION ) عن طريق الـ period ( . )[/highlight]
أيضاً من الاستخدامات المفيدة لتمرير الماغيرات بالمرجعية, هو استخدامها مع جملة ( PHP Foreach As ).
فكما نعلم أن جملة foreach as تقوم بعمل التكرار الحلقي على قيم المصفوفات بحيث يتم تخصيص كل قيمة لمتغير ثم الاستفادة من هذا المتغير فيما بعد, لكن دون التأثير على القيم الأصلية داخل المصفوفة.
ماذا إن أردت تغيير القيم الأصلية للمصفوفة عند استخدام foreach as ؟
نعلم جميعاً أن جملة foreach as تكتب بهذه الصيغة :
<?php foreach ($array as $value){ // code here } ?>الآن إذا أردنا تغيير القيم الأصلية للمصفوفة يجب علينا تمرير القيم بالمرجعية عن طريقة إضافة علام ( & ) قبل value$ كما يظهر في الصيغة التالية :
<?php foreach ($array as &$value){ // code here } ?>لتوضيح الفكرة سنقوم بعمل مصفوفة لمجموعة من الأسماء تبدأ بالأحرف الكبيرة ثم سنمرر هذه الاسماء بالمرجعية إلى جملة foreach as لتحويل حالة جميع الأحرف إلى الأحرف الكبيرة
<?php $names = array ("Mohamed","Ahmed","Mahmoud"); foreach($names as &$name){ $name = strtoupper ($name); } echo "<pre>"; print_r($names); echo"</pre>"; ?>الأن عن إضافة علامة ( & ) إلى القيمة عند كتابة جملة foreach as سيتم عمل مرجع ( Reference ) للقيم الأصلية داخل المصفوفة , وبالتالي عند تطبيق الدالة ()strtoupper سيتم تحويل حالة جميع الأحرف إلى أحرف كبيرة.
[button title=”عرض نتيجة الكود” link=”https://makiomar.com/php_example/passing_by_reference/foreach_pass_by_reference.php” target=”_blank” size=”” color=”” class=””]