filter_var_array

Function • Params and return types changed in PHP 8.0

Gets multiple variables and optionally filters them.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1-8.2
PHP 8.3-8.4
PHP 8.5
PHP 8.6

filter_var_array Function synopsis

filter_var_array(
    array $array,
    array|int $options = FILTER_DEFAULT,
    bool $add_empty = true
  ): array|false|null

Parameters

$array

Typearray

$options

OptionalTypearray|intDefault valueFILTER_DEFAULT

$add_empty

OptionalTypeboolDefault valuetrue

Add missing keys as null to the return value.

Return value

Typearray|false|null

An array containing the values of the requested variables on success, or false on failure. An array value will be false if the filter fails, or null if the variable is not set.

Changes to the filter_var_array Function

PHP 8.0

  • Return type added: array|false|null
  • Parameter name of parameter #1 changed: $data to $array
  • Parameter type added for parameter #1 ($array): array
  • Parameter name of parameter #2 changed: $definition to $options
  • Parameter type added for parameter #2 ($options): array|int
  • Parameter default value added for position #2 ($options): FILTER_DEFAULT
  • Parameter type added for parameter #3 ($add_empty): bool
  • Parameter default value added for position #3 ($add_empty): true
  filter_var_array(
-     $data,
+     array $array,
-     $definition,
+     array|int $options = FILTER_DEFAULT,
-     $add_empty
+     bool $add_empty = true
-   )
+   ): array|false|null

filter_var_array Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Supported Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Security-Fixes Only Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes