توابع filter_input_array() در PHP
تعریف و نحوه استفاده
توابع filter_input_array() ورودیهای چندگانهای را از خارج از اسکریپت دریافت میکند و آنها را فیلتر میکند.
این تابع نیازی به فراخوانی مجدد filter_input() ندارد، برای فیلتر کردن چندین متغیر ورودی بسیار مفید است.
این تابع میتواند ورودیها را از منابع مختلف دریافت کند:
- INPUT_GET
- INPUT_POST
- INPUT_COOKIE
- INPUT_ENV
- INPUT_SERVER
- INPUT_SESSION (هنوز پیادهسازی نشده)
- INPUT_REQUEST (هنوز پیادهسازی نشده)
اگر موفق شود، دادههای فیلتر شده را برمیگرداند، اگر شکست بخورد، false را برمیگرداند.
نحوه استفاده
filter_input(input_type, args)
پارامتر | توضیحات |
---|---|
input_type | ضروري. نوع ورودی را تعیین میکند. به لیست بالایی که نوعهای ممکن را نشان میدهد، مراجعه کنید. |
args |
اختیار، فیلتر پارامتر آرایے کو مقرر کرتی ہے۔ قانونی آرایہ کلچ کی کلچ کا نام ہوتی ہے، قانونی ویلو کا ویلو فیلتر آئیڈ ہوتی ہے، یا فیلتر، پرچنگ اور اختیار کا آرایہ مقرر کرتی ہے۔ اس پارامتر بھی ایک واحد فیلتر آئیڈ کا ہو سکتا ہے، اگر ایسا ہو تو انٹر آری کی سبھی ویلوئز مذکورہ فیلتر کے ذریعے فیلتر کی جائیں گی。 |
توجیہ اور وضاحیات
توجیہ:دیکھیئےکامپلٹ PHP فیلتر مرجع دستنوشت، اس فنکشن کے ساتھ استعمال کئے جاسکتے ہوئے فیلتر دیکھیئے۔
مثال
اس مثال میں، ہم filter_input_array() فنکشن استعمال کرکے تین POST متغیر کو فیلتر کرتے ہیں۔ اس سے متعلق پوسٹ متغیر نام، عمر اور ای میل آدرس ہیں:
<?php $filters = array ( "نام" => array ( "فیلتر"=>FILTER_CALLBACK, "پرچنگ"=>FILTER_FORCE_ARRAY, "اختیار"=>"ucwords" ), "عمر" => array ( "فیلتر"=>FILTER_VALIDATE_INT, "اختیار"=>array ( "مین_رنج"=>1, "مکس_رنج"=>120 ) ), "ایمیل"=> FILTER_VALIDATE_EMAIL, ); print_r(filter_input_array(INPUT_POST, $filters)); ?>
خروج جیسا که:
آرایہ ( [نام] => پیٹر [عمر] => 41 [ایمیل] => peter@example.com )