آموزش کار با تابع ()filter_var در PHP
دستور استفاده از تابع ()filter_var در PHP
filter_var(var, filtername, options)
شرح کاربرد تابع ()filter_var در PHP
تابع ()filter_var در PHP یک متغیر را بر اساس فیلتر مشخص شده، فیلتر و اعتبارسنجی می کند.
مثال کاربردیتابع ()filter_var در PHP بررسی آیا متغیر $email، یک آدرس معتبر ایمیل را شامل می شود یا خیر:
< ?php
$email = "john.doe@example.com";
if (!filter_var($email, FILTER_VALIDATE_EMAIL) === false) {
echo("$email is a valid email address");
} else {
echo("$email is not a valid email address");
}
? >
خروجی:
john.doe@example.com is a valid email address
پارامتر ارسالی به تابع
پارامتر
شرح
var
الزامی. متغیری که قرار است محتوای آن فیلتر شود.
filtername
اختیاری. ID یا شناسه ی فیلتر مورد استفاده را مشخص می کند. مقدار پیش فرض این پارامتر بر روی FILTER_DEFAULT تنظیم می شود که محتوای متغیر ورودی را اعتبارسنجی نمی کند.
options
اختیاری. یک یا چند option/flag جهت استفاده مشخص می کند. مطلوب است flag و option های تمامی فیلترها را مطالعه نمایید.
جزئیات و اطلاعات تخصصی
خروجی تابع
ویرایش زبان PHP
در صورت موفقیت در انجام عملیات مربوطه، داده های فیلتر شده را برمی گرداند و در غیر این صورت مقدار بولی FALSE را برمی گرداند.
+5.2.0
مثال زیر آدرس ایمیل را پس از پاک سازی و حذف تمامی کاراکترهای غیر مجاز آن، اعتبارسنجی می نماید.
همان طور که از کد مشاهده می کنید، نمونه ی جاری ابتدا تمامی کاراکترهای غیرمجاز از متغیر $email را حذف می کند سپس بررسی می نماید آیا محتوای آن یک آدرس معتبر ایمیل است یا خیر:
$email = "john.doe@example.com";
// Remove all illegal characters from email
$email = filter_var($email, FILTER_SANITIZE_EMAIL);
// Validate e-mail
if (!filter_var($email, FILTER_VALIDATE_EMAIL) === false) {
echo("$email is a valid email address");
} else {
echo("$email is not a valid email address");
}