PHP extract() Fonction

❮ Référence des tableaux PHP

Exemple

Assignez les valeurs "Chat", "Chien" et "Cheval" aux variables $a, $b et $c :

<?php
$a = "Original";
$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");
extract($my_array);
echo "\$a = $a; \$b = $b; \$c = $c";
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction extract() importe des variables dans la table des symboles actuelle à partir d'un tableau.

Cette fonction utilise les clés du tableau comme noms de variables et les valeurs comme valeurs de variables. Pour chaque élément, elle créera une variable dans la table des symboles actuelle.

Cette fonction retourne le nombre de variables extraites en cas de succès.

Remarque : Ne pas utiliser la fonction extract() sur des données non fiables, comme les entrées utilisateur de $_GET ou $_FILES !

Syntaxe

extract( array, extract_rules, prefix )

Valeurs des Paramètres

Paramètre Description
array Requis. Spécifie le tableau à utiliser.
extract_rules Optionnel. La fonction extract() vérifie les noms de variables invalides et les collisions avec les noms de variables existants. Ce paramètre spécifie comment les noms invalides et en collision sont traités.

Valeurs possibles :

  • EXTR_OVERWRITE - Par défaut. En cas de collision, la variable existante est écrasée.
  • EXTR_SKIP - En cas de collision, la variable existante n'est pas écrasée.
  • EXTR_PREFIX_SAME - En cas de collision, le nom de la variable recevra un préfixe.
  • EXTR_PREFIX_ALL - Tous les noms de variables recevront un préfixe.
  • EXTR_PREFIX_INVALID - Seuls les noms de variables invalides ou numériques recevront un préfixe.
  • EXTR_IF_EXISTS - Écrase uniquement les variables existantes dans la table des symboles actuelle, sinon ne fait rien.
  • EXTR_PREFIX_IF_EXISTS - N'ajoute un préfixe aux variables que si la même variable existe dans la table des symboles actuelle.
  • EXTR_REFS - Extrait les variables en tant que références. Les variables importées référencent toujours les valeurs du paramètre tableau.
prefix Optionnel. Si EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID ou EXTR_PREFIX_IF_EXISTS sont utilisés dans le paramètre extract_rules, un préfixe spécifié est requis.

Ce paramètre spécifie le préfixe. Le préfixe est automatiquement séparé de la clé du tableau par un caractère de soulignement.

Détails Techniques

Valeur de Retour : Retourne le nombre de variables extraites en cas de succès.
Version PHP : 4+

Plus d'Exemples

Exemple

Utilisation de tous les paramètres :

<?php
$a = "Original";
$my_array = array("a" => "Cat", "b" => "Dog", "c" => "Horse");

extract($my_array, EXTR_PREFIX_SAME, "dup");

echo "\$a = $a; \$b = $b; \$c = $c; \$dup_a = $dup_a";
?>
Essayez-le vous-même »
❮ Référence des tableaux PHP