کانال بله, جهت پشتیبانی و اطلاع رسانی کانال بله, جهت پشتیبانی و اطلاع رسانی
عضویت

آموزش کار با تابع ()input_filter_array در PHP

آموزش کار با تابع ()input_filter_array در PHP

دستور استفاده از تابع ()input_filter_array در PHP

filter_input_array(type, definition, add_empty)

شرح کاربرد تابع filter_input_array(type, definition, add_empty)

چندین متغیر (در قالب آرایه) از منبع خارجی همچون مقدار ورودی از یک فرم را به عنوان آرگومان دریافت کرده و این قابلیت را دارد که محتوای آن ها را اعتبارسنجی نماید.

تابع ()input_filter_array در PHP قادر است بر خلاف تابع ()filter_input در PHP که تنها یک ورودی را پذیرفته و اعتبارسنجی می کند، چندین متغیر را در قالب یک آرایه ی واحد دریافت کرده و مقادیر آن ها را اعتبارسنجی کند.

پارامترهای ارسالی به تابع ()input_filter_array در PHP

پارامتر مربوطه
شرح کاربرد آن
type
الزامی. نوع پارامتر ورودی مورد انتظار را مشخص می کند. می تواند یکی از آیتم های زیر باشد:
  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_SERVER
  • INPUT_ENV
definition
پارامتر اختیاری. یک آرایه از آرگومان هایی که قرار است محتوای آن ها اعتبارسنجی شوند. لازم به ذکر است که یک کلید معتبر در آرایه، همان اسم متغیر است و یک مقدار معتبر اسم فیلتر/ID آن می باشد یا یک آرایه که فیلتر، flag و option ها را مشخص می کند. این پارامتر همچنین می تواند یک اسم یا شناسه ی منحصر بفرد فیلتر باشد که در آن صورت، کلیه ی مقادیر موجود در آرایه ی ورودی توسط فیلتر مشخص شده، فیلتر می شوند.
add_empty
اختیاری. یک مقدار بولی که زمانی که بر روی TRUE تنظیم می شود، کلیدهای ناموجود را به صورت NULL به مقدار بازگشتی اضافه می کند. مقدار پیش فرض این پارامتر TRUE می باشد.

جزئیات تخصصی

خروجی تابع
ویرایش PHP
اختیاری. مقدار بولی. در صورت موفقیت در انجام عملیات یک آرایه دربردارنده ی مقادیر متغیرهای مربوطه را برمی گرداند و در صورت عدم موفقیت مقدار بولی FALSE را برمی گرداند.
+5.2.0
مثال کاربردی

در این مثال، به واسطه ی فراخوانی تابع ()filter_input_array در PHP، سه متغیر POST را فیلتر و محتوای آن ها را اعتبارسنجی می کنیم. متغیرهای دریافتی POST (ارسال شده از طریق متد POST) به ترتیب یک اسم (name)، سن (name) و در پایان آدرس ایمیل (e-mail address) را شامل می شوند:

< ?php
$filters = array
  (
  "name" => array
    (
    "filter"=>FILTER_CALLBACK,
    "flags"=>FILTER_FORCE_ARRAY,
    "options"=>"ucwords"
    ),
  "age" => array
    (
    "filter"=>FILTER_VALIDATE_INT,
    "options"=>array
      (
      "min_range"=>1,
      "max_range"=>120
      )
    ),
  "email"=> FILTER_VALIDATE_EMAIL,
  );
print_r(filter_input_array(INPUT_POST, $filters));
? >

خروجی:

Array
  (
  [name] => Peter
  [age] => 41
  [email] => peter@example.com
  )
1396/05/10 3384 1275
رمز عبور : tahlildadeh.com یا www.tahlildadeh.com
نظرات شما

نظرات خود را ثبت کنید...