آرایه مقدارها (filter_var_array)
با filter_var_array چند «متغیر (Variable)» را یکجا بررسی کن. سپس بر اساس «فیلتر (Filter)» آن ها را تمیز یا اعتبارسنجی کن. مثل حضور و غیاب گروهی کلاس.
تعریف و کاربرد
filter_var_array(data_array, args, add_empty) روی یک آرایه ورودی کار می کند. سپس هر کلید را با فیلتر خواسته شده بررسی می کند. اگر فیلتر ست نشود، فقط مقدارها برگردانده می شوند.
سینتکس
filter_var_array(data_array, args, add_empty)
مثال 1: دریافت چند مقدار ساده
<?php
$data = array(
'fullname' => 'Peter Griffin',
'age' => '41',
'email' => 'peter@example.com'
);
$mydata = filter_var_array($data);
var_dump($mydata);
?>
مثال 2: فیلترهای جدا برای هر کلید
<?php
$data = array(
'fullname' => 'peter griffin',
'age' => '41',
'email' => 'peter@example.com'
);
$args = array(
'fullname' => array(
'filter' => FILTER_CALLBACK,
'options' => 'ucwords'
),
'age' => array(
'filter' => FILTER_VALIDATE_INT,
'options' => array('min_range' => 1, 'max_range' => 120)
),
'email' => FILTER_VALIDATE_EMAIL
);
$result = filter_var_array($data, $args);
var_dump($result);
?>
مثال 3: یک فیلتر برای همه مقدارها
<?php
$data = array(
'a' => '10',
'b' => '20',
'c' => 'oops'
);
$all = filter_var_array($data, FILTER_VALIDATE_INT);
var_dump($all);
?>
گام های عملی
- آرایه ورودی را آماده کن.
- برای هر کلید فیلتر تعیین کن.
filter_var_arrayرا اجرا کن.- نتیجه معتبر را استفاده کن.
نکته: اگر کلیدی نبود و add_empty برابر true باشد، مقدار null برمی گردد.
پیوندهای مفید
- filter_var برای فیلتر یک مقدار.
- filter_input_array برای ورودی های فرم.
- فهرست فیلترها نام و شناسه فیلترها.
- آرایه مقدارها همین بخش با جزئیات.
- W3Schools: filter_var_array() صفحه مرجع و توضیحات.
- PHP Filter Reference فهرست کامل فیلترها.
جمع بندی سریع
filter_var_arrayبرای چند مقدار هم زمان است.- می توانی برای هر کلید فیلتر بدهی.
- یک فیلتر برای همه هم ممکن است.
- کلید گمشده با
nullپر می شود.