عرض مصدر PHP/predefined variables

<noinclude>{{DISPLAYTITLE:المتغيرات المعرفة مسبقًا في PHP}}</noinclude>
تقدّم PHP عددًا كبيرًا من المتغيرات المعرّفة مسبقًا ضمن الشيفرات العاملة بهذه اللغة، ولكن لا يمكن توثيق الكثير من هذه المتغيّرات بشكل كامل لأنّها تعتمد على الخادم الذي تعمل عليه الشيفرة، ونسخة الخادم وإعداداته، وعوامل أخرى. بعض هذه المتغيّرات غير متوفّر عند تشغيل PHP في سطر الأوامر. للحصول على قائمة بهذه المتغيرات يمكنك الاطلاع على قسم [[PHP/Reserved Variables|المتغيّرات المحجوزة والمعرّفة مسبقًا]]. 

تحذير: في الإصدار 4.2.0 وما بعده من PHP أصبح الموجّه <code>register_globals</code> يحمل القيمة <code>off</code>، وهو من التغييرات الكبيرة في PHP. فامتلاك هذا الموجّه لقيمة <code>off</code> يؤثر على مجموعة المتغيرات المعرّفة مسبقًا والموجودة ضمن النطاق العام. على سبيل المثال للوصول إلى المتغير <code>DOCUMENT_ROOT</code> يجب استخدام ‎<code>$_SERVER['DOCUMENT_ROOT']</code>‎ بدلاً من <code>‎$DOCUMENT_ROOT</code>، أو استخدام <code>['‎$_GET['id</code> من العنوان http://www.example.com/test.php?id=3 بدلاً من ‎<code>$id</code>، أو استخدام ‎<code>$_ENV['HOME']</code>‎ بدلاً من <code>‎$HOME</code>.

للمزيد من المعلومات المرتبطة بهذا التغيير، راجع قسم الإعدادات الخاصّ بالموجه register_globals، [[PHP/Security/globals|والقسم الخاص بالأمان مع استخدام المتغيرات العامة]]، إضافة إلى تصريحات الإطلاق (Release Announcements) الخاصة بالإصدارين 4.1.0 و 4.2.0 من PHP.

يفضّل استخدام المتغيرات المحجوزة والمعرّفة مسبقًا في PHP مثل المصفوفات ذوات النطاق العام العالي (superglobals).

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

أدناه قائمة بذوات النطاق العام العالي، وللاطلاع على قائمة مفصّلة بمحتويات هذه المصفوفات وللحصول على المزيد من المعلومات حول المتغيرات المعرّفة مسبقًا في PHP وخصائصها، يمكن الاطلاع على [[PHP/Reserved Variables|قسم المتغيرات المحجوزة والمعرّفة مسبقًا]]. يمكن أيضاً ملاحظة أنّ المتغيّرات القديمة الطويلة والمعرّفة مسبقًا (<code>‎$HTTP_*_VARS</code>) ما زالت موجودةً حتى الآن. في الإصدار 5.0.0 من PHP وما بعده يمكن تعطيل المصفوفات المتغيّرة الطويلة والمعرّفة مسبقًا وذلك بواسطة الموجّه <code>register_long_arrays</code>.

ملاحظة: لا يمكن استخدام ذوات النطاق العام العالي [[PHP/Variables/variable|كمتغيرات للمتغيرات]] (variable variables) ضمن الدوال أو توابع الأصناف.

ملاحظة: على الرغم من إمكانية وجود كلّ من ذوات النطاق العام العالي و <code>HTTP_*_VARS</code> في نفس الوقت، فإنّهما ليسا متطابقين؛ لذا فإن تغيير قيمة أحدهما لن يؤثّر على قيمة الآخر.

في حال عدم تعيين متغيّرات معيّنة في الموجّه <code>variables_order</code> فإن المصفوفات المعرّفة مسبقًا والتي تلائم هذه المتغيّرات ستترك فارغة أيضًا.

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