عرض مصدر PHP/assignment operators

<noinclude>{{DISPLAYTITLE:عوامل الإسناد في PHP}}</noinclude>
العامل "=" هو عامل الإسناد الأساسي. قد تظنّ للوهلة الأولى أن هذا العامل يعني "المساواة"، ولكنّه ليس كذلك. وظيفة هذا العامل هي ربط قيمة التعبير الموجود على جانبه الأيمن بالتعبير الموجود على الجانب الأيسر.

يأخذ تعبير الإسناد القيمة المسندة، بمعنى أن قيمة "‎<code>$a = 3</code>" هي 3، ويتيح لنا هذا القيام بأمور معقدة، في المثال التالي تساوي قيمة المتغير <code>‎$a</code> العدد 9، وأخذ المتغير <code>‎$b</code> القيمة 4:
<syntaxhighlight lang="php">

<?php
$a = ($b = 4) + 5;
?>
</syntaxhighlight>

إضافة إلى عامل الإسناد، هناك «عوامل مندمجة» (combined) لجميع [[PHP/Operators/bitwise|العمليات الحسابية الخاصة بالأعداد الثنائية]] وتوحيد المصفوفات وعوامل السلاسل النصية، والتي تتيح استخدام قيمة التعبير ومن ثم تعيين نتيجة ذلك التعبير كقيمة له. مثال:
<syntaxhighlight lang="php">

<?php

$a = 3;
$a +=5 // $a = 8
// $a = $a + 5
// تعطي نفس النتيجة
$b = "Hello ";

$b .= "There!"; // $b = "Hello There!";
// $b = $b . "There!"
// تعطي نفس النتيجة

?>
</syntaxhighlight>

لاحظ أن عملية الإسناد تنسخ القيمة الأصلية إلى الجديدة (الإسناد بالقيمة)؛ لذا فإن تغيير إحدى القيم لا يؤثر على الأخرى إطلاقًا. وقد يكون هذا الأمر مفيدًا في بعض الحالات التي تحتاج فيها إلى نسخ مصفوفة كبيرة مثلًا إلى داخل حلقة صغيرة.

تستثنى الكائنات من عملية الإسناد بالقيمة في PHP 5 حيث تكون عملية الإسناد بالمرجعية، ويمكن نسخ الكائنات باستخدام الكلمة المفتاحية <code>[[PHP/OOP/cloning|clone]]</code>.

== الإسناد بالمرجعية ==
يمكن إجراء عملية الإسناد بالمرجعية باستخدام الصيغة <code>‎"$var = &$othervar;‎"</code>‎، وتعني عملية الإسناد هذه أن كلا المتغيرين يشيران إلى البيانات ذاتها، ولا تُنسخ المعلومات إلى أي مكان.

'''المثال 1: الإسناد بالمرجعية'''

سنسند في المثال الآتي المتغير <code>‎$a</code> إلى <code>‎$b</code> بالمرجعية، ثم سنُغيّر قيمة المتغير <code>‎$a</code> إلى 4 وسنجد بعدئذٍ أنَّ قيمة المتغير <code>‎$b</code> أصبحت 4 أيضًا:
<syntaxhighlight lang="php">

<?php
$a = 3;
// $b هو مرجع للمتغير $a
$b = &$a;


print "$a\n"; // تطبع 3
print "$b\n"; // تطبع 3

$a = 4; // تغيير قيمة $a

print "$a\n"; // تطبع 4
print "$b\n"; // تطبع 4 أيضًا
?>
</syntaxhighlight>

في الإصدار 5 وما بعده من PHP أصبحت القيمة المعادة من العامل <code>[[PHP/OOPs|new]]</code> مرجعية بصورة تلقائية؛ لذا فإن الإسناد المرجعي للنتيجة المستحصلة من <code>[[PHP/OOPs|new]]</code> ستؤدي إلى ظهور رسالة من نوع E_DEPRECATED في PHP 5.3 وما بعده، ورسالة من نوع E_STRICT في الإصدارات السابقة.

فعلى سبيل المثال، تؤدي الشيفرة التالية إلى ظهور رسالة تحذيرية:
<syntaxhighlight lang="php">

<?php
class C {}

/* ستظهر رسالة الخطأ هذه من السطر التالي
* Deprecated: Assigning the return value of new by reference is deprecated in...
*/
$o = &new C;
?>
</syntaxhighlight>

يمكن الحصول على المزيد من المعلومات حول المراجع وطرق استخدامها في قسم [[PHP/References|References]] ضمن هذا الدليل.

== مصادر ==
* [http://php.net/manual/en/language.operators.assignment.php صفحة Assignment Operators في توثيق PHP الرسمي.]
[[تصنيف:PHP|{{SUBPAGENAME}}]]
[[تصنيف:PHP Operators|{{SUBPAGENAME}}]]