Array Functions

PHP extract() Function

Topic: PHP Array ReferencePrev|Next

Description

The extract() function imports variables into the current symbol table from an array.

This function basically creates variables from an associative array. This is typically done by using the array keys as variable names and their corresponding values as the variable values.

The following table summarizes the technical details of this function.

Return Value: Returns the number of variables successfully imported into the symbol table.
Version: PHP 4+

Syntax

The basic syntax of the extract() function is given with:

extract(array, flags, prefix)

The following example shows the extract() function in action.

<?php
// Sample associative array
$array = array("brand"=>"Porsche", "model"=>"911", "color"=>"blue");

// Extracting variables
extract($array);
echo "Brand: $brand, Model: $model, Color: $color";
?>

Tip: If an existing variable has the same name as one of the keys in the associative array, a collision will occur, and the extracted variable overwrites the existing variable. Also, if any key in the associative array is not a valid variable name it won't be extracted. However, the default behavior of this function can be changed by setting the flags and prefix parameter.

Warning: Do not use the extract() function on untrusted data, such as user input received through a web form (e.g. $_GET, $_FILES), as it poses a potential security risk.


Parameters

The extract() function accepts the following parameters.

Parameter Description
array Required. Specifies an array to use.
flags

Optional. Specifies how invalid or numeric keys and collisions are treated.

This parameter can take one of the following values:

  • EXTR_OVERWRITE - On collision, overwrite the existing variable.
  • EXTR_SKIP - On collision, do not overwrite the existing variable.
  • EXTR_PREFIX_SAME - On collision, prefix the variable name with the prefix.
  • EXTR_PREFIX_ALL - Prefix all variable names with the prefix.
  • EXTR_PREFIX_INVALID - Only prefix invalid or numeric variable names with prefix.
  • EXTR_IF_EXISTS - Only overwrite the variable if it already exists, else do nothing.
  • EXTR_PREFIX_IF_EXISTS - Only create prefixed variable names if the non-prefixed version of the same variable already exists.
  • EXTR_REFS - Extract variables as references rather than copies. This means that the values of the imported variables are still referencing the values of the array parameter.

If this parameter is not specified, it is assumed to be EXTR_OVERWRITE.

prefix

Optional. Specifies the prefix string. Prefixes are automatically separated from the array key by an underscore (_). If the prefixed result is not a valid variable name, it is not extracted.

This parameter is only required if flags is set to any of these values EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID or EXTR_PREFIX_IF_EXISTS.

More Examples

Here're some more examples showing how extract() function basically works:

The following example shows how to prevent overwriting of existing variable if a collision occurs.

<?php
// Variable name same as array key 
$color = "red";

// Sample associative array
$array = array("brand"=>"Porsche", "model"=>"911", "color"=>"blue");

// Extracting variables
extract($array, EXTR_PREFIX_SAME, "car");
echo "$brand, $model, $color, $car_color";
?>

The following example prevent overwriting an existing variable on collision by skipping extraction.

<?php
// Variable name same as array key 
$color = "red";

// Sample associative array
$array = array("brand"=>"Porsche", "model"=>"911", "color"=>"blue");

// Extracting variables
extract($array, EXTR_SKIP);
echo "$brand, $model, $color";
?>
Bootstrap UI Design Templates Property Marvels - A Leading Real Estate Portal for Premium Properties