import_request_variables

(PHP 4 >= 4.1.0, PHP 5)

import_request_variables -- Importe les variables de GET/POST/Cookie dans l'environnement global

Description

bool import_request_variables ( string types [, string prefix] )

import_request_variables() importe les variables GET/POST/Cookie dans l'environnement global. C'est pratique si vous avez désactivé register_globals, mais que vous voulez enregistrer des variables dans l'environnement global.

En utilisant le paramètre types, vous pouvez spécifier les variables que vous voulez importer. Vous pouvez utiliser 'G', 'P' et 'C' pour désigner respectivement GET, POST et Cookie. Ces caractères ne sont pas sensibles à la casse, et vous pouvez les combiner entre eux. POST inclut les fichiers téléchargés. Notez que l'ordre des lettres est important. En utilisant par exemple "GP", les variables de POST écraseront par les variables de GET, ayant le même nom. Toute lettre autre que G, P ou C, est ignorée.

Le paramètre prefix est utilisé comme un préfixe de nom de variable, qui sera ajoutée au début de tous les noms de variables importées. Si vous avez par exemple une variable GET du nom de "userid", et utilisez le préfixe "pref_", la variable ainsi générée s'appellera $pref_userid.

Si vous souhaitez importer d'autres variables dans l'environnement global, comme $_SERVER, considérez l'utilisation de la fonction extract().

Note : Bien que le paramètre prefix soit optionnel, il sera généré une alerte E_NOTICE si vous ne spécifiez pas de préfixe, ou si vous utilisez une chaîne vide comme préfixe. C'est potentiellement un trou de sécurité. Les alertes de ce niveau ne sont pas affichées si vous utilisez le niveau d'erreur par défaut.

Exemple 1. Exemple avec import_request_variables()

<?php
// Ce code va importer les variables GET et POST
// avec un préfixe "rvar_"
import_request_variables("gP", "rvar_");

echo
$rvar_foo;
?>

Voir aussi $_REQUEST, register_globals, variables pré-définies et extract().