Programmer avec SPIP 3.0
Documentation technique sur SPIP 3.0

> > > > _request

_request

La fonction _request() permet de récupérer des variables envoyées par l’internaute, soit par l’URL, soit par un formulaire posté.

  1. $nom = _request('nom');

Principes de sécurité

Ces fonctions ne doivent pas être placées n’importe où dans les fichiers de SPIP, ceci afin de connaître précisément les lieux possibles de tentatives de piratage. Les éléments issus de saisies utilisateurs ne devraient être récupérés que dans

  • les fichiers d’actions (dans le répertoire action/),
  • les fichiers d’affichage privé (dans le répertoire exec/),
  • pour certaines très rares balises dynamiques (dans le répertoire balise/),
  • ou dans les fichiers de formulaires (dans le répertoire formulaires/).

Il faut en règle générale en plus, vérifier que le type reçu est bien au format attendu (pour éviter tout risque de hack, bien que SPIP effectue déjà un premier nettoyage de ce qui est reçu), par exemple, si vous attendez un nombre, il faut appliquer la fonction intval() (qui transformera tout texte en valeur numérique) :

  1. if ($identifiant = _request('identifiant')){
  2. $identifiant = intval($identifiant);
  3. }

Télécharger

Récupérer dans un tableau

Si vous souhaitez récupérer uniquement parmi certaines valeurs présentes dans un tableau, vous pouvez passer ce tableau en second paramètre :

  1. // recupere s'il existe $tableau['nom']
  2. $nom = _request('nom', $tableau);

Télécharger

Exemple

Récupérer uniquement parmi les valeurs transmises dans l’URL :

  1. $nom = _request('nom', $_GET);