مثال
از تابع filter_input_array() برای فیلتر کردن سه متغیر POST استفاده کنید.
متغیرهای POST دریافتی نام، سن و ایمیل است:
$filters = آرایه (
"نام" => آرایه ("filter"=>FILTER_CALLBACK،
"flags"=>FILTER_FORCE_ARRAY،
"options"=>"ucwords"
)،
"سن" => آرایه ( "filter"=>FILTER_VALIDATE_INT،
"options"=>آرایه("min_range"=>1,"max_range"=>120)
)،
"ایمیل" => FILTER_VALIDATE_EMAIL
);
print_r(filter_input_array(INPUT_POST, $filters));
?>
خروجی کد بالا این خواهد بود:
آرایه
(
[نام] => پیتر
[سن] => 41
[ایمیل] => peter@example.com
)
تعریف و استفاده
تابع filter_input_array() متغیرهای خارجی را دریافت می کند (به عنوان مثال از ورودی فرم) و به صورت اختیاری آنها را فیلتر می کند.
این تابع برای بازیابی/فیلتر کردن مقادیر زیادی به جای آن مفید است
چندین بار filter_input() را فراخوانی می کند.
نحو
filter_input_array(نوع، تعریف، افزودن_خالی)
مقادیر پارامتر
| پارامتر | توضیح |
|---|---|
| نوع | لازم است. نوع ورودی که باید بررسی شود. می تواند یکی از موارد زیر باشد:
|
| تعریف | اختیاری. آرایه ای از آرگومان های فیلتر را مشخص می کند. یک کلید آرایه معتبر یک نام متغیر است و یک مقدار معتبر یک نام فیلتر یا شناسه یا آرایه ای است که فیلتر، پرچم ها و گزینه ها را مشخص می کند. این پارامتر همچنین می تواند یک نام/شناسه فیلتر واحد باشد. سپس تمام مقادیر موجود در آرایه ورودی توسط فیلتر مشخص شده | فیلتر می شوند
| add_empty | اختیاری. یک مقدار بولی TRUE کلیدهای از دست رفته را به صورت NULL به مقدار برگشتی اضافه می کند. مقدار پیش فرض TRUE | است
جزئیات فنی
| مقدار بازگشتی: | آرایه ای با مقادیر متغیرهای موفقیت، FALSE در شکست |
|---|---|
| نسخه PHP: | 5.2+ |
| تغییر PHP: | PHP 5.4 - پارامتر add_empty اضافه شد |
❮ مرجع کامل فیلتر PHP