عرض مصدر PHP/external variables

<noinclude>{{DISPLAYTITLE:المتغيرات من مصادر خارجية في PHP}}</noinclude>
== نماذج HTML‏ (GET و POST) ==
عند إرسال نموذج إلى شيفرة PHP، فإن المعلومات القادمة من ذاك النموذج صبح متاحًا بصورة تلقائية للشيفرة. وهناك عدد من الطرائق التي يمكن من خلالها الوصول إلى هذه المعلومات، فعلى سبيل المثال:

'''المثال 1: [[HTML/form|نموذج]] HTML بسيط'''
<syntaxhighlight lang="html">

<form action="foo.php" method="post">
    Name:  <input type="text" name="username" /><br />
    Email: <input type="text" name="email" /><br />
    <input type="submit" name="submit" value="Submit me!" />
</form>
</syntaxhighlight>
منذ الإصدار 5.4.0 أصبح هناك طريقتان للوصول إلى البيانات التابعة لنموذج HTML. والطرائق المتاحة حاليًا مدرجة أدناه:

'''المثال 2: الوصول إلى البيانات التابعة لنموذج HTML بسيط من نوع POST'''
<syntaxhighlight lang="php">

<?php
echo $_POST['username'];
echo $_REQUEST['username'];
?>
</syntaxhighlight>

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

'''المثال 3: الطرائق القديمة للوصول إلى مدخلات المستخدم'''
<syntaxhighlight lang="php">

<?php
  // انتبه: لم تعد هذه الطرق مدعومة في الوقت الحاضر
  // الطرق الصحيحة مبيّنة أعلاه

  // حُذفت هذه الدالة في الإصدار 5.4.0 من اللغة
   import_request_variables('p', 'p_');
   echo $p_username;
  // حُذفت المتغيّرات الطويلة المعرفة مسبقًا في الإصدار 5.4.0 من اللغة
   echo $HTTP_POST_VARS['username'];
  // register_globals
  // حُذفت هذه الخاصّية في الإصدار 5.4.0 من اللغة.
   echo $username;
?>
</syntaxhighlight>

يكون التعامل مع النماذج من نوع GET مشابهًا لما سبق باستثناء استخدام المتغير GET المعرّف مسبقًا. يمكن استخدام هذا المتغيّر أيضًا مع سلاسل الاستعلام النصية (QUERY_STRING، وهي المعلومات التي تأتي بعد علامة '?' في عنوان URL). فعلى سبيل المثال يحتوي العنوان http://www.example.com/test.php?id=3 على معلومات GET يمكن الوصول إليها باستخدام ‎<code>[[PHP/Reserved Variables/get|$_GET['id']]]</code>‎. راجع أيضًا <code>[[PHP/Reserved Variables/request|‎$_REQUEST]]</code>.

ملاحظة: تتحوّل النقاط والفراغات في أسماء المتغيرات إلى شرطات سفلية. مثال: ‎<code><input name="a.b" />‎</code> يصبح: ‎<code>$_REQUEST["a_b"]‎</code>.

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

'''المثال 4: متغيرات أكثر تعقيدًا في النماذج'''
<syntaxhighlight lang="php">

<?php
if ($_POST) {
    echo '<pre>';
    echo htmlspecialchars(print_r($_POST, true));
    echo '</pre>';
}
?>
<form action="" method="post">
    Name:  <input type="text" name="personal[name]" /><br />
    Email: <input type="text" name="personal[email]" /><br />
    Beer: <br />
    <select multiple name="beer[]">
        <option value="warthog">Warthog</option>
        <option value="guinness">Guinness</option>
        <option value="stuttgarter">Stuttgarter Schwabenbräu</option>
    </select><br />
    <input type="submit" value="submit me!" />
</form>
</syntaxhighlight>

=== أسماء المتغيرات عند استخدام صورة لإرسال المعلومات ===
يمكن استخدام صورة بدلًا عن زر الإرسال الاعتيادي لغرض إرسال معلومات النموذج، وذلك باستخدام وسم مثل:
<syntaxhighlight lang="html">

<input type="image" src="image.gif" name="sub" />
</syntaxhighlight>

وعندما ينقر المستخدم على مكان معين في الصورة يُلحق بالمعلومات المرسلة إلى الخادوم متغيران إضافيان هما <code>sub_x</code> و <code>sub_y</code>. يتضمن هذان المتغيّران إحداثيات المكان الذي نقر عليه المستخدم ضمن الصورة. تحتوي الأسماء الحقيقية لهذه المتغيرات على نقطة بدلًا عن الشرطة السفلية، ولكن PHP تحوّل النقطة إلى شرطة سفلية تلقائيًا.

== كعكات HTTP ==
تدعم PHP كعكات HTTP (أي HTTP Cookies) كمّا عُرِّفَت في معيار  RFC 6265. الكعكات (cookies) هي طريقة لحفظ البيانات في متصفح المستخدم، مما يسمح بتعقب والتعرّف على المستخدمين العائدين إلى الموقع في وقت لاحق. يمكن ضبط الكعكات باستخدام الدالة <code>[[PHP/Function/setcookie|setcookie()]]</code>‎. تعدّ الكعكات جزءًا من ترويسة HTTP؛ لذا يجب استدعاء الدالة <code>[[PHP/Function/setcookie|setcookie()‎]]</code> قبل إرسال أي مخرجات إلى المتصفح، وهذا الأمر ينطبق كذلك على الدالة <code>[[PHP/Function/header|header()‎]]</code>. تصبح المعلومات التابعة للكعكة متاحةً في مصفوفات بيانات الكعكات مثل <code>‎[[PHP/Reserved Variables/cookie|$_COOKIE]]</code> إضافة إلى <code>[[PHP/Reserved Variables/request|‎$_REQUEST]]</code>. راجع صفحة <code>[[PHP/Function/setcookie|setcookie()]]</code>‎ في هذا الدليل للاطلاع على المزيد من التفاصيل والأمثلة.

إن كنت ترغب في إسناد عدد من المتغيرات إلى متغير كعكة واحد، فيمكنك إسناده كمصفوفة، فمثلًا:
<syntaxhighlight lang="php">

<?php
  setcookie("MyCookie[foo]", 'Testing 1', time()+3600);
  setcookie("MyCookie[bar]", 'Testing 2', time()+3600);
?>
</syntaxhighlight>

ستنشئ الشيفرة السابقة كعكتين منفصلتين على الرغم من كون <code>MyCoookie</code> مصفوفة واحدة. إن كنت ترغب في تعيين كعكة واحدة مع متغيّرات متعددة فعليك باستخدام الدالة <code>[[PHP/Function/serialize|serialize()‎]]</code> أو <code>[[PHP/Function/explode|explode()‎]]</code> على القيمة قبل إسنادها.
لاحظ أن الكعكة الجديدة ستحلّ محل الكعكة القديمة في المتصفح إن كانت تحمل الاسم نفسها، إلا إذا كان المسار (path) أو النطاق (domain) مختلفين. لذا، في حال استخدام الكعكات في تطبيق يتضمن سلة تسوق فستحتاج إلى استخدام عدّاد وتمريره مع الكعكة.

'''المثال 5: مثال عن <code>[[PHP/Function/setcookie|setcookie()‎]]</code>'''
<syntaxhighlight lang="php">

<?php
if (isset($_COOKIE['count'])) {
    $count = $_COOKIE['count'] + 1;
} else {
    $count = 1;
}
setcookie('count', $count, time()+3600);
setcookie("Cart[$count]", $item, time()+3600);
?></syntaxhighlight>

== النقاط في أسماء المتغيّرات الخارجية ==
لا تغير PHP في العادة أسماء المتغيرات التي تمرّر إلى الشيفرة، ولكن يجب الانتباه إلى أن النقطة ليست حرفًا مقبولاً في أسماء متغيرات PHP. ولمعرفة السبب لاحظ المثال التالي:
<syntaxhighlight lang="php">

<?php
$varname.ext;  // اسم متغير غير صحيح
?>
</syntaxhighlight>
ما يراه مفسر اللغة هنا هو متغير يحمل الاسم <code>‎$varname</code> يتبعه معامل ربط السلاسل النصية تتبعه السلسلة النصّية المجرّدة (أي سلسلة نصية غير محاطة بعلامات اقتباس ولا تطابق أيًّا من المفاتيح أو الكلمات المحجوزة المعروفة) <code>ext.</code>.

من الواضح أنّ هذه ليست النتيجة المطلوبة، لهذا من المهم جدًّا الانتباه إلى أن PHP تبدّل وبصورة تلقائية أي نقطة في أسماء المتغيرات القادمة من خارج الشيفرة إلى شرطات سفلية.

== تحديد أنواع المتغيرات ==
تحدّد PHP أنواع المتغيرات وتحوّلها (بصورة عامة) حسب الحاجة، ولهذا السبب يصعب تحديد نوع المتغيّر في وقت معين. تتضمن PHP مجموعة من الدوال التي تساعد في التعرف على نوع المتغير مثل <code>[[PHP/Function/gettype|gettype()]]</code>‎ و <code>[[PHP/Function/is-array|is_array()]]</code>‎ و <code>[[PHP/Function/is-float|is_float()‎]]</code> و <code>[[PHP/Function/is-int|is_int()]]</code>‎ و <code>[[PHP/Function/is-object|is_object()]]</code>‎ و <code>[[PHP/Function/is-string|is_string()]]</code>‎. راجع أيضًا [[PHP/Types|الفصل الخاص بالأنواع]].

ونظراً لكون HTTP بروتوكولًا نصّيًان فإن الغالبية العظمى من المحتوى (إن لم يكن كلّه) الذي يصل إلى المصفوفات ذوات النطاق العام العالي (superglobals) مثل <code>[[PHP/Reserved Variables/post|‎$_POST]]</code> و <code>[[PHP/Reserved Variables/get|‎$_GET]]</code> تبقى على هيئة سلاسل نصية. لن تحاول PHP تغيير القيم إلى نوع معين. في المثال التالي تحتوي ‎<code>$_GET["var1"]</code>‎ على السلسلة النصية <code>"null"</code> وتحتوي ‎<code>$_GET["var2"]</code>‎ على السلسلة النصية <code>"123"</code>.<syntaxhighlight lang="php">
/index.php?var1=null&var2=123
</syntaxhighlight>

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.4.0
|حذف كل من Register Globals و Magic Quotes و register_long_arrays
|-
|5.3.0
|أصبح كل من Register Globals و Magic Quotes و register_long_arrays عناصر مهملة
|-
|4.2.0
|أصبح الموجه register_globals يحمل القيمة off.
|-
|4.1.0
|أتيحت المصفوفات ذوات النطاق العام العالي مثل  ‎$_POST و ‎$_GET.
|}

== مصادر ==
* [http://php.net/manual/en/language.variables.external.php صفحة Variables From External Sources في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Variables]]