شناسه فیلتر (filter_id)
گاهی نام فیلتر را داریم، اما «شناسه فیلتر» لازم است. تابع filter_id همین کار را می کند. مثل شماره دانش آموزی که از روی نام، عددش را می گیری.
تعریف و کاربرد شناسه فیلتر
filter_id()، شناسه عددیِ یک نام فیلتر را برمی گرداند. اگر نام اشتباه باشد، مقدار FALSE می دهد.
سینتکس
filter_id(filter_name)
پارامتر filter_name نام فیلتر است. برای دیدن نام ها، از filter_list() کمک بگیر.
مثال 1: گرفتن شناسه یک فیلتر مشخص
<?php
echo(filter_id("validate_email"));
?>
مثال 2: لیست همه نام ها و شناسه ها
<?php
echo("<table>");
echo("<tr><td>Filter Name</td><td>Filter ID</td></tr>");
foreach (filter_list() as $id => $filter) {
echo("<tr><td>" . $filter . "</td><td>" . filter_id($filter) . "</td></tr>");
}
echo("</table>");
?>
قدم به قدم استفاده
- نام فیلتر را مشخص کن؛ مثلا
validate_email. filter_id(name)را صدا بزن.- اگر FALSE شد، نام فیلتر را چک کن.
جزییات فنی
خروجی: شناسه عددی در موفقیت، یا FALSE در نبود فیلتر. نسخه: PHP 5.2+.
نکته: برای آشنایی سریع با نام ها، سراغ filter_list() برو. همچنین «شناسه فیلتر»ها در مرجع فیلتر خلاصه شده اند.
پیوندها
- مرجع فیلتر PHP برای مرور همه ثابت ها و توابع.
- filter_has_var() برای چک کردن وجود ورودی.
- W3Schools: filter_id منبع این صفحه.
جمع بندی سریع
filter_idشناسه عددی فیلتر را می دهد.- نام درست را از
filter_listبگیر. - خروجی FALSE یعنی نام اشتباه است.
- شناسه فیلتر برای پیکربندی دقیق مفید است.