عرض مصدر PHP/precedence operators

<noinclude>{{DISPLAYTITLE:أولوية العوامل في PHP}}</noinclude>
المقصود بأولوية العوامل هو تحديد مدى "قوة" ربط العامل لتعبيرين مع بعضهما البعض. فعلى سبيل المثال في التعبير: 1‎ + 5 * 3 يكون الجواب 16 وليس 18 لأن لعامل الضرب (*) الأولوية على عامل الجمع (+). يمكن استخدام الأقواس لتحديد الأولوية حسب الحاجة. فمثلًا: ناتج التعبير ‎(1 + 5) * 3 هو 18.

عندما تتساوى العوامل في أولويتها فإن الخاصية التجميعية (associativity) هي التي تحدد كيفية تجميع العوامل. فمثلًا خاصية التجميع للعامل "-" يسارية، لذا فإن التعبير ‎1 - 2 - 3 يصبح ‎(1 - 2) - 3 ويكون الناتج ‎-4، أما العامل "=" فخاصية تجميعه يمينية، لذا يجمع التعبير ‎<code>$a = $b = $c</code> بالشكل التالي: <code>‎$a = ($b = $c)‎</code>.

لا يمكن استخدام العوامل جنبًا إلى جنب عندما تمتلك أولوية متساوية ولا تمتلك خاصية تجميعية، فمثلًا التعبير 1 < 2 > 1 هو تعبير غير مقبول في PHP، أما التعبير ‎1 <= 1 == 1 يعدّ تعبيرًا صحيحًا، لأنّ العامل "==" يمتلك أولوية أدنى من العامل ‎<=‎ .

قد يؤدي استخدام الأقواس -حتى عند انعدام الحاجة إليها- إلى زيادة مقروئية الشيفرة وذلك بتحديد المجموعات بشكل واضح بدلًا من الاعتماد على أولوية العوامل وخواصها التجميعية المضمنة.

يعرض الجدول التالي قائمة بالعوامل مرتبةً حسب الأولوية من الأعلى إلى الأدنى. تمتلك العوامل الموجودة في السطر ذاته أولوية متساوية، وفي هذه الحالة تحدد الخاصية التجميعية طريقة التجميع.
{| class="wikitable"
!الخاصية التجميعية
!العامل
!معلومات إضافية
|-
|غير تجميعية
|<code>clone new</code>
|[[PHP/cloning objects|clone]] و [[PHP/OOPs|new]]
|-
|يسارية
|<code>‎[‎</code>
|<code>[[PHP/array|array()‎]]</code>
|-
|يمينية
|<code>**</code>
|[[PHP/arithmetic operators|عوامل حسابية]]
|-
|يمينية
|<code>‎++ -- ~ (int) (float) (string) (array) (object) (bool) @‎</code>
|عوامل [[PHP/Operators/type|الأنواع]] وعوامل [[PHP/Operators/increment|الزيادة والنقصان]]
|-
|غير تجميعية
|<code>instanceof</code>
|[[PHP/Operators/type|عوامل الانواع]]
|-
|يمينية
|<code>!</code>
|[[PHP/Operators/logical|العوامل المنطقية]]
|-
|يسارية
|<code>* / %</code>
|[[PHP/arithmetic operators|العوامل الحسابية]]
|-
|يسارية
|<code>+ - .</code>
|العوامل [[PHP/arithmetic operators|الحسابية]] وعوامل [[PHP/Operators/string|السلاسل النصية]]
|-
|يسارية
|<code><< >></code>
|[[PHP/bitwise operators|عوامل الأعداد الثنائية]]
|-
|غير تجميعية
|<code>‎‎< <= > >=‎</code>
|[[PHP/comparison operators|عوامل المقارنة]]
|-
|يسارية
|<code>&</code>
|عوامل [[PHP/bitwise operators|الأعداد الثنائية]] و<nowiki/>[[PHP/References|المراجع]]
|-
|يسارية
|<code>^</code>
|[[PHP/bitwise operators|عوامل الأعداد الثنائية]]
|-
|يسارية
|<code><nowiki>|</nowiki></code>
|[[PHP/bitwise operators|عوامل الأعداد الثنائية]]
|-
|يسارية
|<code>&&</code>
|[[PHP/Operators/logical|العوامل المنطقية]]
|-
|يسارية
|<code><nowiki>||</nowiki></code>
|[[PHP/Operators/logical|العوامل المنطقية]]
|-
|يمينية
|<code>??</code>
|[[PHP/comparison operators|عوامل المقارنة]]
|-
|يسارية
|<code>? :</code>
|[[PHP/comparison operators|عامل ثلاثي]]
|-
|يمينية
|<code><nowiki>‎‎= += -= *= **= /= .= %= &= |= ^= <<= >>=‎</nowiki></code>
|[[PHP/assignment operators|عوامل الإسناد]]
|-
|يسارية
|<code>and</code>
|[[PHP/Operators/logical|العوامل المنطقية]]
|-
|يسارية
|<code>xor</code>
|[[PHP/Operators/logical|العوامل المنطقية]]
|-
|يسارية
|<code>or</code>
|[[PHP/Operators/logical|العوامل المنطقية]]
|}
'''المثال 1: الخاصية التجميعية'''
<syntaxhighlight lang="php">

<?php
$a = 3 * 3 % 5; // (3 * 3) % 5 = 4
// الخاصية التجميعية للعامل الثلاثي مختلفة عن لغتي سي و سي بلس بلس.
$a = true ? 0 : true ? 1 : 2; // (true ? 0 : true) ? 1 : 2 = 2

$a = 1;
$b = 2;
$a = $b += 3; // $a = ($b += 3) -> $a = 5, $b = 5
?></syntaxhighlight>

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

'''المثال 2: ترتيب غير معرّف للمعالجة'''
<syntaxhighlight lang="php">

<?php
$a = 1;
// قد يطبع 2 أو 3
echo $a + $a++;

$i = 1;
// قد يعين الفهرس 1 أو 2
$array[$i] = $i++;
?></syntaxhighlight>

'''المثال 3: العوامل <code>+</code> و <code>-</code> و <code>.</code> تمتلك الأولوية ذاتها'''
<syntaxhighlight lang="php">

<?php
$x = 4;
// قد يعطي هذا السطر نتائج غير متوقعة
echo "x minus one equals " . $x-1 . ", or so I hope\n";
// لأنه سيعالج مثل السطر التالي
echo (("x minus one equals " . $x) - 1) . ", or so I hope\n";
// يمكن فرض الأولوية المطلوبة باستخدام الأقواس
echo "x minus one equals " . ($x-1) . ", or so I hope\n";
?>
</syntaxhighlight>

مخرجات المثال السابق هي:
<syntaxhighlight lang="php">

-1, or so I hope
-1, or so I hope
x minus one equals 3, or so I hope
</syntaxhighlight>

ملاحظة: على الرغم من امتلاك العامل <code>=</code> أولوية أدنى من غالبية العوامل، إلا أنّ PHP تسمح باستخدام تعابير مشابهة للتعبير: <code>if (!$a = foo())</code>‎ إذ تسند القيمة المعادة من الدالة <code>foo()‎</code> إلى المتغير <code>‎$a</code>.

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