تأخذ الدالة filter_input_array() مدخلات متعددة (مثل مدخلات النموذج) من خارج البرنامج النصي وتقوم بتصفيتها.
هذه الوظيفة مفيدة لتصفية متغيرات الإدخال المتعددة دون استدعاء filter_input() بشكل متكرر.
يمكن لهذه الوظيفة أن تأخذ مدخلات من مصادر مختلفة:
INPUT_GET
INPUT_POST
INPUT_COOKIE
INPUT_ENV
INPUT_SERVER
INPUT_SESSION (لم يتم تنفيذه بعد)
INPUT_REQUEST (لم يتم تنفيذه بعد)
في حالة النجاح، يتم إرجاع البيانات التي تمت تصفيتها كمصفوفة. إذا فشلت، ترجع FALSE.
filter_input_array(input_type, filter_args)
| المعلمة | يصف |
|---|---|
| input_type | مطلوب. يحدد نوع الإدخال. انظر قائمة الأنواع المحتملة أعلاه. |
| filter_args | خياري. يحدد مجموعة من معلمات التصفية. مفاتيح المصفوفة القانونية هي أسماء متغيرة، والقيم القانونية هي معرفات المرشحات، أو المصفوفات التي تحدد المرشحات والأعلام والخيارات. يمكن أن تكون هذه المعلمة أيضًا معرف مرشح واحد، إذا كان الأمر كذلك، فسيتم تصفية جميع القيم في مصفوفة الإدخال بواسطة المرشح المحدد. يمكن أن يكون معرف عامل التصفية اسم معرف (مثل FILTER_VALIDATE_EMAIL) أو رقم معرف (مثل 274). |
نصيحة: راجع الدليل المرجعي الكامل لمرشح PHP لمعرفة المرشحات التي يمكن استخدامها مع هذه الوظيفة.
في هذا المثال، نستخدم الدالة filter_input_array() لتصفية ثلاثة متغيرات POST. متغيرات POST المستلمة هي الاسم والعمر وعنوان البريد الإلكتروني:
<?php$filters = array ("name" => array ("filter"=>FILTER_CALLBACK, "flags"=>FILTER_FORCE_ARRAY, "options"=>"ucwords" ), "age" => array ("filter"= >FILTER_VALIDATE_INT, "options"=>المصفوفة ( "min_range"=>1, "max_range"=>120 ) ), "email"=> FILTER_VALIDATE_EMAIL, );print_r(filter_input_array(INPUT_POST, $filters));?>يبدو إخراج الكود كما يلي:
مصفوفة ( [الاسم] => بيتر [العمر] => 41 [البريد الإلكتروني] => [email protected] )