Passage de paramètres à un script PHP via l'URL

Syntaxe générale

<schéma>://<utilisateur>:<mot de passe>@<machine>:<port>/<chemin>?<paramètres>#<fragment>

Syntaxe de la liste des paramètres

Le champs <paramètres> ci-haut peut être décomposé plus finement :

<couple (nom,valeur)>&<couple (nom,valeur)>&...

Syntaxe du couple (nom, valeur)

Le champs <couple (nom,valeur)> peut être décomposé encore plus finement :

nom=valeur

Résumé

Le caractère ? indique que la suite de l'URL sont des paramètres et ne font pas partie du nom de fichier. Le caractère = sépare un nom de paramètre et sa valeur transmise. Le caractère & sépare deux couples (nom, valeur).

Pour faire face au cas général d'un paramètre dont la valeur contient des caractères interdits, on utilisera les fonctions de codage.

Exemple concrêt

<a href="index.php?imprim=yes&user_id=75">Version imprimable</a>

Dans cet exemple on transmet deux variables au script index.php : $imprim de valeur "yes" et $user_id de valeur "75".

Passage d'une chaîne de caractères

Une URL étant d'abord une chaîne de caractère, la valeur reçue par le script sera de type chaîne de caractères.

Passage d'un entier

Le cast implicite et le faible typage des variables en PHP, provoque une conversion directe de la chaîne "20" en l'entier 20 lors de son utilisation dans un calcul ou un test.

Passage d'un flottant

De la même manière que pour un entier, un flottant sera automatiquement traduit en flottant lors de son utilisation.

Passage d'un tableau

Pour passer un tableau à un script, il faut passer chaque élément du tableau séparément. Le nom du paramètre sera le nom du tableau, suivi de crochets [].

Erreur à ne pas commettre : oublier les crochets. Car alors, on remplacera la valeur du premier élément par le deuxième, et par le troisième...

Passage d'un tableau associatif

Un tableau associatif associe un élément à une clé. Pour le passer en paramètre, il faut ajouter entre les crochets le nom de la clé.

Linéariser une variable

Il n'est pas du tout pratique de passer en paramètre un tableau avec 150 champs comme dans l'exemple précédent.

Heureusement, il existe un couple de fonctions serialise() et unserialise() qui permet traduire une variable en une chaîne de caractères que l'on peut passer facilement en paramètre sans perdre ni leur structure ni leur type.

Pour récupérer une variable linéarisée, et retrouver la valeur de la variable, on utilise unserialize().

Après avoir linéarisé notre variable, on doit coder cette chaîne avant de la passer en param et en protéger les slashs éventuels.

Attention à une erreur commune : bien respecter l'ordre des fonctions composées ! Dans le script de départ : linéariser, coder et protéger les slashs. Puis, dans le script d'arrivée, l'opération inverse : déprotéger les slashs, décoder, délinéariser.

Passage d'un objet

Tout comme pour le tableau, un objet n'étant pas un type de base (nombre, chaîne, booléen), il ne peut être passé directement en paramètre.

Travaillons sur l'objet moi instance de la classe Personne :

class Personne {
	var nom; 
	var prenom;
	var age;
	function Personne($n, $p, $a) {
		$this->nom = $n;
		$this->prenom = $p;
		$this->age = $a;
	}
	function afficher() {
		echo $this->prenom, " ", $this->nom, " ", $this->age;
	}
}
$moi = new Personne("Hugo", "ETIEVANT", 1980);

On pourait en passer chacun des attributs en paramètre séparement dans l'URL comme le montre l'exemple suivant :

Mais cette méthode est laborieuse, il est plus simple de ne passer qu'une seule valeur en paramètre. Or on sait que la linéarisation permet de "compresser" une variable - même complexe - dans une seule valeur de type chaîne de caractères. On va donc linéariser notre objet.

De plus, la linéarisation permet de conserver les connexions ouvertes vers les bases de données ! Par contre les méthodes ne sont pas conservées.

Codage de base

urlencode : Encode une chaîne en URL.
urldecode : Décode une chaîne encodée URL.

urlencode($str) : code la chaîne $str. Les espaces sont remplacés par des signes plus (+). Ce codage est celui qui est utilisé pour poster des informations dans les formulaires HTML. Le type MIME utilisé est application/x-www-form-urlencoded.

Exemple :
echo <a href=\"$PHP_SELF?foo=".urlencode($foo)."\">Foo</a>";

NB : Pour être accessible, la valeur du paramètre devra par la suite être décodée dans le script d'arrivé par la fonction réciproque adéquate.

Codage complet

rawurlencode : Encode une chaîne en URL, selon la RFC1738.
rawurldecode : Décode une chaîne URL, selon la RFC1738.

rawurlencode($str) : code la chaîne $str. Remplace tous les caractères interdits par leur codage équivalent hexadécimal.

Exemple :
echo <a href=\"$PHP_SELF?foo=".rawurlencode($foo)."\">Foo</a>";

Codage plus évolué

base64_encode : Encode une chaîne en MIME base64.
base64_decode : Décode une chaîne en MIME base64

base64_encode($str) : code la chaîne $str en base 64. Cet encodage permet à des informations binaires d'être manipulées par les systèmes qui ne gèrent pas correctement les codes 8 bits (code ASCII 7 bit étendu aux accents européens), comme par exemple, les corps de mail qui en général sont américains et ne gèrent que les 7 bits. Une chaîne encodée en base 64 a une taille d'environ 33% supérieure à celle des données initiales.

Exemple :
echo <a href=\"$PHP_SELF?foo=".base64_encode($foo)."\">Foo</a>";