ورودی فیلتر (filter_input)
تابع filter_input مقدار «متغیر (Variable)» بیرونی را می گیرد و فیلتر می کند. مثل ناظم مدرسه که فرم ها را می بیند و غلط ها را رد می کند.
تعریف و کاربرد
filter_input() یک مقدار ورودی ناامن را می خواند و در صورت نیاز اعتبارسنجی می کند. این ورودی ها می توانند از GET، POST، COOKIE، SERVER یا ENV باشند.
سینتکس
filter_input(type, variable, filter, options)
پارامترها: type نوع ورودی؛ variable نام متغیر؛ filter شناسه یا نام فیلتر؛ options پرچم ها یا گزینه ها.
مثال: بررسی ایمیل GET و اعتبارسنجی
<?php
if (!filter_input(INPUT_GET, "email", FILTER_VALIDATE_EMAIL)) {
echo("Email is not valid");
} else {
echo("Email is valid");
}
?>
گام های عملی
- منبع را تعیین کن؛ مثلا
INPUT_GET. - نام متغیر را بده؛ مثلا
email. - فیلتر مناسب را انتخاب کن؛ مثلا ایمیل.
جزئیات بازگشتی
خروجی می تواند مقدار معتبر باشد. در شکست، FALSE است. اگر متغیر نباشد، NULL برمی گردد. نسخه پشتیبانی: PHP 5.2+.
نکته: فیلتر پیش فرض FILTER_DEFAULT است و معمولا کاری انجام نمی دهد.
پیوندهای مفید
- مرجع فیلتر PHP برای دیدن فیلترها و پرچم ها.
- filter_has_var() برای چک کردن وجود ورودی.
- ورودی فیلتر برای مرور همین صفحه.
- W3Schools: filter_input() منبع توضیحات و نمونه.
جمع بندی سریع
filter_inputورودی ناامن را می خواند و می سنجد.- نوع ورودی را با
INPUT_*مشخص کن. - در نبود متغیر، خروجی
NULLاست. - در خطا، مقدار
FALSEمی آید.