IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

Introduction à PHP 5 par l'exemple


précédentsommairesuivant

XI. Des serveurs en PHP

Les programmes PHP pouvant être exécutés par un serveur WEB, un tel programme devient un programme serveur pouvant servir plusieurs clients. Du point de vue du client, appeler un service WEB revient à demander l'URL de ce service. Le client peut être écrit avec n'importe quel langage, notamment en PHP. Dans ce dernier cas, on utilise alors les fonctions réseau que nous venons de voir. Il nous faut par ailleurs savoir "converser" avec un service WEB, c'est-à-dire comprendre le protocole http de communication entre un serveur Web et ses clients. C'est le but des programmes qui suivent.

Le client web décrit au paragraphe , page , nous a permis de découvrir une partie du protocole HTTP.

Image non disponible

Dans leur version la plus simple, les échanges client / serveur sont les suivants :

  • le client ouvre une connexion avec le port 80 du serveur web
  • il fait une requête concernant un document
  • le serveur web envoie le document demandé et ferme la connexion
  • le client ferme à son tour la connexion

Le client peut être de nature diverse : un texte au format Html, une image, une vidéo… Ce peut être un document existant (document statique) ou bien un document généré à la volée par un script (document dynamique). Dans ce dernier cas, on parle de programmation web. Le script de génération dynamique de documents peut être écrit dans divers langages : PHP, Python, Perl, Java, Ruby, C#, VB.net…

Nous utilisons ici PHP pour générer dynamiquement des documents texte.

Image non disponible
  • en [1], le client ouvre une connexion avec le serveur, demande un script PHP, envoie ou non des paramètres à destination de ce script
  • en [2], le serveur web fait exécuter le script PHP par l'interpréteur PHP. Ce script génère un document qui est envoyé au client [3]
  • le serveur clôt la connexion. Le client en fait autant.

Le serveur web peut traiter plusieurs clients à la fois. Avec le paquetage logiciel WampServer, le serveur web est un serveur Apache, un serveur open source de l'Apache Foundation (http://www.apache.org/). Dans les applications qui suivent, WampServer doit être lancé. Cela active trois logiciels : le serveur web Apache, le Sgbd MySQL, l'interpréteur PHP.

Les scripts exécutés par le serveur web seront écrits avec l'outil Netbeans. Nous avons écrit jusqu'à maintenant des scripts PHP exécutés dans un contexte console :

Image non disponible

L'utilisateur utilise la console pour demander l'exécution d'un script PHP et en recevoir les résultats.

Dans les applications client /serveur qui vont suivre,

  • le script du client est exécuté dans un contexte console
  • le script du serveur est exécuté dans un contexte web
Image non disponible

Le script PHP du serveur ne peut pas être n'importe où dans le système de fichiers. En effet, le serveur web cherche dans des endroits précisés par configuration, les documents statiques et dynamiques qu'on lui demande. La configuration par défaut de WampServer fait que les documents sont cherchés dans le dossier <WampServer>/www où <WampServer> est le dossier d'installation de WampServer. Ainsi un client web demande un document D avec l'Url [http://localhost/D], le serveur web lui servira le document D de chemin [<WampServer>/www/D].

Dans les exemples qui suivent, nous mettrons les scripts serveur dans le dossier [www/exemples-web]. Si un script serveur s'appelle S.php, il sera demandé au serveur web avec l'Url [http://localhost/exemples-web/S.php]. Le document [<WampServer>/www/exemples-web/S.php] lui sera alors servi.

Image non disponible

Pour créer un script serveur avec Netbeans, nous procéderons de la façon suivante :

Image non disponible
  • en [1], nous créons un nouveau projet
  • en [2], nous prenons la catégorie [PHP] et le projet [PHP Application]Image non disponible
  • en [3], nous donnons un nom au projet
  • en [4], nous choisissons un dossier pour le projet
  • en [5], nous indiquons que le script doit être exécuté par un serveur web local (l'Url du script sera de la forme http://localhost/…). Le serveur web local sera le serveur web Apache de WampServer.
  • en [6], nous donnons l'Url du projet. Ici, nous décidons qu'un script S.php du projet sera demandé avec l'Url [http://localhost/exemples-web/S.php]. D'après ce qui a été dit, cela veut dire que le chemin du script S.php dans le système de fichiers sera [<WampServer>/www/exemples-web/S.php]. C'est ce qui est indiqué en [7]. Nous demandons ici que tout script S.php du projet soit recopié dans l'arborescence du serveur web Apache.
  • en [8], le nouverau projet.

Ecrivons un script de test :

Image non disponible
  • en [1], nous créons dans le projet [exemples-web] un premier script PHP
  • en [2], nous lui donnons un nom
  • en [3], après l'avoir créé, nous lui donnons le contenu suivantImage non disponible
    Pour la suite, il faut que WampServer soit lancé.
  • en [4], nous exécutons le script web [exemple1.php]. Netbeans va alors lancer le navigateur par défaut de la machine et va lui demander d'afficher l'Url [http://localhost/exemples-web/exemple1.php] [5]
  • en [6], le navigateur affiche ce que le script serveur a écrit au client.

Par la suite, nous rencontrerons deux types de clients web :

  • un navigateur comme ci-dessus. Nous avons écrit que le serveur web envoyait une réponse de la forme : entêtes Http, ligne vide, texte. Le navigateur n'affiche que texte.
  • un script PHP qui lui affichera la totalité de la réponse entêtes Http, ligne vide, texte.

Dans la suite,

  • les scripts serveur seront écrits comme [exemple1.php] ci-dessus
  • les scripts client seront écrits comme les scripts console que nous avons écrits jusqu'à maintenant.

XI-A. Application client/ serveur de date/heure

XI-A-1. Le serveur (web_01)

 
Cacher/Afficher le codeSélectionnez

Basiquement, le script PHP ci-dessus écrit l'heure courante sur l'écran. Cependant, lorsqu'il est exécuté par un serveur web, le flux n° 1 qui est habituellement associé à l'écran est redirigé vers la connexion qui lie le serveur à son client. Donc, dans un contexte web, le script ci-dessus envoie l'heure courante sous forme de texte au client.

Exécutons ce script au sein de Netbeans :

Image non disponible
  • en [1], on exécute le script. Un navigateur web est alors lancé.
  • en [2], l'Url demandée par le navigateur web
  • en [3], le texte envoyé par le script serveur

Le navigateur client utilise le protocole Http pour dialoguer avec le serveur web. Nous avons déjà décrit la forme de ce protocole.

Le client envoie des lignes de texte qu'on peut décomposer en trois parties : entêtes Http, ligne vide, document . Le document envoyé au serveur web est le plus souvent vide ou bien c'est un ensemble de paramètres parami=vali vali est une valeur saisie par l'utilisateur dans un formulaire Html.

La réponse du serveur a la même forme : entêtes Http, ligne vide, document document est cette fois le document demandé par le navigateur client. Si le client a transmis des paramètres, le document délivré dépend en général de ces paramètres.

Avec le navigateur Firefox , il est possible de découvrir les échanges réels entre client et serveur web. Il existe un plugin pour Firefox , appelé Firebug qui permet de tracer ces échanges. Firebug est disponible à l'Url [https://addons.mozilla.org/fr/firefox/addon/firebug/]. Si on utilise le navigateur Firefox pour visiter cette Url, on peut alors télécharger le plugin Firebug . Nous supposons dans la suite que le plugin Firebug a été téléchargé et installé. Il est disponible via une option du menu de Firefox  :

Image non disponible

Une fenêtre Firebug s'ouvre dans la fenêtre du navigateur Firefox. Cette fenêtre présente elle-même un menu :

Image non disponible

Pour découvrir les échanges client / serveur lors d'une requête Http, nous demandons l'Url [http://localhost/exemples-web/web_01.php] avec le navigateur Firefox. La fenêtre de Firebug se remplit alors d'informations :

Image non disponible

Ci-dessus, on a un résumé des échanges client / serveur :

  • [1] : le client a envoyé la commande HTTP : GET /exemples-web/web_01.php HTTP/1.1 pour demander le document [web01.php]
  • [2] : le serveur a envoyé la réponse : HTTP/1.1 200 OK indiquant qu'il a trouvé le document demandé.

Firebug permet d'obtenir les échanges complets. Il suffit de "déplier" l'Url :

Image non disponible

Nous voyons ci-dessus les en-têtes Http échangés entre le client (Requête) et le serveur (Réponse). Il est possible d'avoir le code source des échanges, c.a.d. les lignes de texte réellement échangées [1]. Nous obtenons alors le code source suivant :

Image non disponible

Pour écrire un script client du serveur web, il nous suffit de reproduire le comportement du navigateur. Après avoir ouvert une connexion avec le serveur, le script client pourrait envoyer les 8 lignes de la requête ci-dessus. En fait tout n'est pas indispensable et nous n'enverrons que les trois lignes suivantes :

 
Cacher/Afficher le codeSélectionnez
  • ligne 1 : précise le document demandé et le protocole Http utilisé
  • ligne 2 : donne le nom de la machine du script client
  • ligne 3 : indique qu'après l'échange, le client fermera la connexion au serveur

Intéressons-nous maintenant à la réponse du serveur. Nous savons qu'elle a été produite par le script PHP [web_01.php]. Ci-dessus, nous voyons les entêtes Http de la réponse. Le code du script [web01.php] montre que ce n'est pas lui qui les a générés. Rappelons-nous la configuration du script serveur :

Image non disponible

C'est le serveur web qui a généré les entêtes Http de la réponse. Le script serveur peut les générer lui-même. Nous en verrons un exemple un peu plus loin.

Nous avons dit que la réponse du serveur web était de la forme : entêtes Http, ligne vide, document. Si le document est un document texte, on peut voir celui-ci dans l'onglet [Réponse] de Firebug :

Image non disponible

Cette réponse a été générée par le script [web_01.php].

XI-A-2. Un client (client1_web_01)

Nous écrivons maintenant un script client pour le service précédent. Nous savons que le client doit :

  • ouvrir une connexion avec le serveur web
  • envoyer le texte : entêtes Http, ligne vide
  • lire la réponse complète du serveur jusqu'à ce que celui-ci ferme sa connexion avec le client
  • fermer sla connexion avec le serveur

Le script client s'exécute dans un environnement console de Netbeans :

Image non disponible
  • en [1], le script client [client1_web_01.php] est inclus dans le projet Netbeans [exemples]
  • en [2], les propriétés du projet Netbeans [exemples]
  • en [3], le projet Netbeans [exemples] s'exécute en mode "ligne de commande", ce que nous avons appelé aussi le mode "console".

Le code du script client est le suivant :

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • ligne 8 : ouverture d'une connexion vers le serveur
  • ligne 16 : commande Http GET
  • ligne 18 : commande Http Host
  • ligne 20 : commande Http Connection
  • ligne 22 : ligne vide
  • lignes 26-28 : lecture de toutes les lignes de texte envoyées par le serveur jusqu'à ce qu'il ferme la connexion.
  • ligne 30 : le client ferme à son tour la connexion

Résultats

L'exécution du script client produit les résultats suivants :

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • lignes 1-7 : la réponse Http du serveur web.
  • ligne 8 : la ligne vide qui signale la fin des entêtes Http
  • lignes 9 et au-delà : le document. Ici, c'est un simple texte représentant la date et l'heure courante. C'est le texte écrit par le script PHP sur la sortie n° 1.
  • ligne 1 : le serveur répond qu'il a trouvé le document demandé.
  • ligne 2 : date et heure courantes du serveur
  • ligne 3 : identité du serveur web
  • ligne 4 : indique que le document qui va suivre est un document généré par un script PHP
  • ligne 5 : nombre de caractères du document
  • ligne 6 : le serveur indique qu'après avoir envoyé le document, il va fermer la connexion
  • ligne 7 : indique que le document envoyé par le serveur est un texte au format Html. C'est inexact ici. Le document est du texte sans format particulier. Lorsque le document n'est pas du texte au format Html, c'est au script PHP de l'indiquer. Nous ne l'avons pas fait ici.

XI-A-3. Un deuxième client (client2_web_01)

Le client précédent affichait tout ce que lui envoyait le serveur web. Dans la pratique, on ignore généralement les entêtes Http de la réponse et on exploite la partie document. Nous cherchons ici à récupérer la date et l'heure envoyées par le script PHP serveur. Nous allons récupérer ces informations au moyen d'une expression régulière.

 
Cacher/Afficher le codeSélectionnez

Résultats

 
Cacher/Afficher le codeSélectionnez

XI-B. Récupération par le serveur des paramètres envoyés par le client

Dans le protocole Http, un client a deux méthodes pour passer des paramètres au serveur Web :

  • il demande l'URL du service sous la forme

GET url?param1=val1&param2=val2&param3=val3… HTTP/1.0

où les valeurs vali doivent au préalable subir un encodage afin que certains caractères réservés soient remplacés par leur valeur hexadécimale.

  • il demande l'URL du service sous la forme

POST url HTTP/1.0

puis parmi les entêtes Http envoyés au serveur place l'entête suivant :

Content-length=N

La suite des entêtes envoyés par le client se terminent par une ligne vide. Il peut alors envoyer ses données sous la forme

val1&param2=val2&param3=val3…

où les valeurs vali doivent, comme pour la méthode GET, être préalablement encodées. Le nombre de caractères envoyés au serveur doit être N où N est la valeur déclarée dans l'entête

Content-length=N

Le script PHP qui récupère les paramètres parami précédents envoyés par le client obtient leurs valeurs dans le tableau :

  • $_GET["parami"] pour une commande GET
  • $_POST["parami"] pour une commande POST

XI-B-1. Le client GET (client1_web_02)

Le script PHP ci-dessous envoie trois paramètres [nom, prenom, age] au serveur.

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • ligne 7 : Url du script serveur
  • ligne 8 : les valeurs des 3 paramètres
  • ligne 10 : ouverture d'une connexion avec le serveur web
  • ligne 18 : encodage des 3 paramètres. Nous sommes dans un script écrit sous Netbeans avec un encodage des caractères en UTF-8. Donc les 3 valeurs des paramètres de la ligne 8 sont encodés en UTF-8. La fonction utf8_decode passe leur encodage en ISO-8859-1. Ceci fait, ils peuvent être encodés pour l'Url. Tous les caractères non alphabétiques sont remplacés par %xx où xx est la valeur hexadécimale du caractère. Les espaces sont eux remplacés par le signe +.
  • ligne 24 : l'Url demandée est $URL?$infos où $ infos est de la forme nom=val1&prenom=val2&age=val3 .

XI-B-2. Le serveur (web_02)

Le serveur se contente d'afficher ce qu'il reçoit.

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • ligne 13 : fixe l'entête Http "Content-Type". Par défaut, le serveur web envoie l'entête
 
Cacher/Afficher le codeSélectionnez

qui dit que la réponse est du texte au format Html. Ici, la réponse sera du texte sans formatage avec des caractères encodés en UTF-8 :

 
Cacher/Afficher le codeSélectionnez

Les entêtes Http doivent être envoyés avant la réponse du serveur. Aussi ci-dessus, l'appel de la fonction header se trouvera-t-elle avant toute instruction print.

  • lignes 16-18 : on récupère les 3 paramètres dans le tableau $_GET.
  • ligne 21 : on construit la chaîne de caractères qui va être envoyée en réponse au client. Certains caractères ont des significations spéciales en HTML, et doivent être remplacés par des entités HTML pour être affichés. htmlspecialchars($string) remplace tous ces caractères par leur équivalent dans la chaîne $string. Par exemple, le caractère $ devient &amp. Ensuite comme nous avons dit en ligne 13 que la réponse serait du texte UTF-8, nous encodons en UTF-8 les valeurs récupérées.
  • ligne 25 : la réponse est envoyée au client

Test 1

Exécutons le script [web_02] à partir de Netbeans. Un navigateur est alors lancé pour afficher l'Url [http://localhost/exemples-web/web_02.php] :

Image non disponible
  • en [1], la navigateur affiche l'Url [http://localhost/exemples-web/web_02.php]. Parce que nous n'avons pas suffixé cette Url avec des paramètres, le serveur a répondu avec des paramètres vides. Rappelons que la réponse du serveur est celle écrite avec l'instruction print.
  • en [2], nous suffixons l'Url avec des paramètres. Cette fois-ci le script serveur les renvoie bien.

Notons que Netbeans n'est pas nécessaire à l'exécution d'un script serveur. Il suffit de taper l'Url du script serveur dans un navigateur pour que ce script soit exécuté.

Test 2

On exécute dans Netbeans le client [client1_web_02.php]. On reçoit la réponse suivante :

 
Cacher/Afficher le codeSélectionnez
  • ligne 1 : encodage des 3 paramètres. On voit que le caractère û est devenu %FB.
  • ligne 12 : la réponse du serveur

XI-B-3. Le client POST (client2_web_03)

Un client Http envoie au serveur web la séquence de texte suivante : entêtes Http, ligne vide, document. Dans le client précédent, cette séquence était la suivante :

 
Cacher/Afficher le codeSélectionnez

Il n'y avait pas de document. Il existe une autre façon de transmettre des paramètres, la méthode dite POST. Dans ce cas, la séquence de texte envoyée au serveur web est la suivante :

 
Cacher/Afficher le codeSélectionnez

Cette fois-ci, les paramètres qui pour le client GET étaient inclus dans les entêtes Http, font partie, dans le client POST, du document envoyé derrière les entêtes.

Le script du client POST est le suivant :

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • ligne 7 : l'Url du service web auquel le client POST va se connecter. Ce service web va être prochainement décrit.
  • ligne 8 : les paramètres à transmettre au service web
  • ligne 10 : connexion au serveur web
  • ligne 18 : encodage des paramètres à envoyer au service web
  • ligne 23 : commande Http POST
  • ligne 25 : commande Http Host
  • ligne 27 : commande Http Connection
  • ligne 29 : commande Http Content-type. Nous avons déjà rencontré cet entête Http. Il est présent à chaque fois qu'un document est envoyé. Un serveur web qui envoie un document Html, utilise l'entête Http
 
Cacher/Afficher le codeSélectionnez

S'il envoie du texte non formaté, il utilise l'entête Http

 
Cacher/Afficher le codeSélectionnez

Notre client POST envoie un document qui est un texte de la forme param1=val1&param2=val2&…. Ce type de document a le type application/x-www-form-urlencoded. Nous n'expliquerons pas pourquoi car cela nous obligerait à expliquer ce qu'est un formulaire web.

  • ligne 32 : commande Content-length. Nous avons déjà rencontré cet entête Http. Il est présent à chaque fois qu'un document est envoyé. Il indique le nombre d'octets du document.
  • ligne 34 : la ligne vide signalant la fin des entêtes Http
  • ligne 36 : l'envoi des paramètres
  • lignes 40-41 : lecture de la réponse complète du serveur
  • ligne 43 : fermeture de la connexion

XI-B-4. Le serveur (web_03)

Le service web [web_03] fait la même chose que le service web [web_02]. Il lit les paramètres envoyés par le client POST et les erenvoie au client. Son code est le suivant :

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • lignes 14-16 : les paramètres envoyés par un client POST deviennent disponibles dans le tableau $_POST pour le service web qui les reçoit.
  • ligne 6 : entête Http Content-Type. On peut s'étonner de ne pas trouver dans les entêtes Http l'entête Http Content-Length indiquant la taille du document renvoyé au client. Nous avons vu que le serveur web envoyait des entêtes Http par défaut. L'entête Content-Length en fait partie.

Résultats

Une fois le script serveur écrit sous Netbreans, il devient immédiatement disponible via le serveur Apache de WampServer. Rappelons-nous que cela est obtenu par configuration (cf page ). On lance le client qui interroge le serveur et on reçoit alors la réponse suivante :

 
Cacher/Afficher le codeSélectionnez
  • lignes 2-10 : la réponse du serveur
  • lignes 2-8 : les en-têtes Http
  • ligne 10 : le document
  • ligne 6 : l'en-tête Http Content-Length. Comme ce n'est pas le script serveur qui a généré cet en-tête, il a donc été généré par le serveur web.
  • ligne 8 : le seul en-tête généré par le script serveur

XI-C. Récupération des variables d'environnement du serveur WEB

Un script Serveur s'exécute dans un environnement web qu'il peut connaître. Cet environnement est stocké dans le dictionnaire $_SERVER. Nous écrivons tout d'abord une application serveur qui envoie à ses clients le contenu de ce dictionnaire.

XI-C-1. Le serveur (web_04)

 
Cacher/Afficher le codeSélectionnez
  • les couples (clé, valeur) du dictionnaire $_SERVER sont envoyés aux clients.

Le résultat obtenu lorsque le client est un navigateur web est le suivant :

Image non disponible

Voici la signification de certaines des variables (pour windows. Sous Linux, elles seraient différentes) :

HTTP_CMDE CMDE représente l'entête Http envoyé par le client. On a accès à tous ces entêtes.
PATH le chemin des exécutables sur la machine sur laquelle s'exécute le script serveur
COMSPEC le chemin de l'interpréteur de commandes Dos
PATHEXT les extensions des fichiers exécutables
WINDIR le dossier d'installation de Windows
SERVER_SIGNATURE la signature du serveur web. Ici rien.
SERVER_SOFTWARE le type du serveur web
SERVER_NAME le nom Internet de la machine du serveur web
SERVER_PORT le port d'écoute du serveur web
SERVER_ADDR l'adresse IP de la machine du serveur web
REMOTE_ADDR l'adresse IP du client. Ici le client était sur la même machine que le serveur.
REMOTE_PORT le port de communication du client
DOCUMENT_ROOT la racine de l'arborescence des documents servis par le serveur web
SERVER_ADMIN l'adresse électronique de l'administrateur du serveur web
SCRIPT_FILENAME le chemin complet du scrit serveur
SERVER_PROTOCOL la version du protocole Http utilisée par le serveur web
REQUEST_METHOD l'ordre Http utilisé par le client. Il y en a quatre : GET, POST, PUT, DELETE
QUERY_STRING les paramètres envoyés avec un ordre GET /url?paramètres
REQUEST_URI l'Url demandée par le client. Si le navigateur demande l'Url http://machine[:port]/uri, on aura REQUEST_URI=uri
SCRIPT_NAME $_SERVER['SCRIPT_FILENAME']=$_SERVER['DOCUMENT_ROOT'].$_SERVER['SCRIPT_NAME']

XI-C-2. Le client (client1_web_04)

Le client se contente d'afficher tout ce que lui envoie le serveur.

 
Cacher/Afficher le codeSélectionnez

Résultats

 
Cacher/Afficher le codeSélectionnez

XI-D. Gestion des sessions WEB

Dans les exemples client / serveur précédents on avait le fonctionnement suivant :

  • le client ouvre une connexion vers le port 80 de la machine du service web
  • il envoie la séquence de texte : en-têtes Http, ligne vide, [document]
  • en réponse, le serveur envoie une séquence du même type
  • le serveur clôt la connexion vers le client
  • le client clôt la connexion vers le serveur

Si le même client fait peu après une nouvelle demande au serveur web, une nouvelle connexion est créée entre le client et le serveur. Celui-ci ne peut pas savoir si le client qui se connecte est déjà venu ou si c'est une première demande. Entre deux connexions, le serveur "oublie" son client. Pour cette raison, on dit que le protocole Http est un protocole sans état. Il est pourtant utile que le serveur se souvienne de ses clients. Ainsi si une application est sécurisée, le client va envoyer au serveur un login et un mot de passe pour s'identifier. Si le serveur "oublie" son client entre deux connexions, celui-ci devra s'identifier à chaque nouvelle connexion, ce qui n'est pas envisageable.

Pour faire le suivi d'un client, le serveur procéde de la façon suivante : lors d'une première demande d'un client, il inclut dans sa réponse un identifiant que le client doit ensuite lui renvoyer à chaque nouvelle demande. Grâce à cet identifiant, différent pour chaque client, le serveur peut reconnaître un client. Il peut alors gérer une mémoire pour ce client sous la forme d'un fichier associé de façon unique à l'identifiant du client.

Techniquement cela se passe ainsi :

  • dans la réponse à un nouveau client, le serveur inclut l'en-tête Http Set-Cookie : MotClé=Identifiant. Il ne fait cela qu'à la première demande.
  • dans ses demandes suivantes, le client va renvoyer son identifiant via l'en-tête Http Cookie : MotClé=Identifiant afin que le serveur le reconnaisse.

On peut se demander comment le serveur fait pour savoir qu'il a affaire à un nouveau client plutôt qu'à un client déjà venu. C'est la présence de l'en-tête Http Cookie dans les en-têtes Http du client qui le lui indique. Pour un nouveau client, cet en-tête est absent.

L'ensemble des connexions d'un client donné est appelé une session.

XI-D-1. Le fichier de configuration

Pour que la gestion des sessions fonctionne correctement avec PHP, il faut vérifier que celui-ci est correctement configuré. Sous windows, son fichier de configuration est php.ini. Selon le contexte d'exécution (console, web), le fichier de configuration [php.ini] doit être recherché dans des dossiers différents. Pour découvrir ceux-ci, on utilisera le script suivant :

 
Cacher/Afficher le codeSélectionnez

Ligne 4, la fonction phpinfo donne des informations sur l'interpréteur PHP qui exécute le script. Elle donne notamment le chemin du fichier de configuration [php.ini] utilisé.

Dans un environnement console, on obtient un résultat analogue au suivant :

 
Cacher/Afficher le codeSélectionnez

ligne 2 : le fichier de configuration principal est c:\windows\php.ini

ligne 3 : un fichier de configuration secondaire est C:\serveursSGBD\wamp21\bin\php\PHP5.3.5\php.ini. Il permet de modifier certaines options de configuration du fichier de configuration principal.

Dans un environnement web, on obtient le résultat suivant :

Image non disponible

Le fichier secondaire de configuration n'est ici pas le même que dans l'environnement console. C'est ce dernier que nous allons consulter. On trouve dans ce fichier une section session :

 
Cacher/Afficher le codeSélectionnez
  • ligne 1 : les données d'une session client sont sauvegardées dans un fichier
  • ligne 3 : le dossier de sauvegarde des données de session. Si ce dossier n'existe pas, aucune erreur n'est signalée et la gestion des sessions ne fonctionne pas.
  • lignes 4-5 : indiquent que l'identifiant de session est géré par les en-têtes Http Set-Cookie et Cookie
  • ligne 6 : l'entête Set-Cookie sera de la forme Set-Cookie : PHPSESSID=identifiant_de_session
  • ligne 7 : une session client n'est pas démarrée automatiquement. Le script serveur doit la demander explicitement par une instruction session_start().

XI-D-2. Le serveur 1 (web_05)

La gestion de l'identifiant de session est transparent pour un service web. Cet identifiant est géré par le serveur web. Un service web a accès à la session du client via l'instruction session_start(). A partir de ce moment, le service web peut lire / écrire des données dans la session du client via le dictionnaire $_SESSION. Le code suivant montre la gestion en session de trois compteurs.

 
Cacher/Afficher le codeSélectionnez
  • ligne 9 : démarrage d'une session client
  • lignes 11-13 : le tableau $_SESSION est un dictionnaire de couple (clé, valeur). Les données mises dans ce dictionnaire persistent au fil des requêtes d'un même client. C'est la mémoire du client sur le serveur.
  • lignes 11-19 : si les trois compteurs N1, N2, N3 ne sont pas en session, on les y met.
  • lignes 21-23 : on les incrémente d'une unité
  • lignes 25-27 : on envoie leur valeur au client

Dans la relation client / serveur, la gestion de la session client sur le serveur dépend des deux acteurs, le client et le serveur :

  • le serveur a la charge d'envoyer un identifiant à son client lors de sa première demande
  • le client a la charge de renvoyer cet identifiant à chaque nouvelle demande. S'il ne le fait pas, le serveur croira que c'est un nouveau client et génèrera un nouvel identifiant pour une nouvelle session.

Résultats

Nous utilisons comme client, un navigateur web. Par défaut (par configuration en fait), celui-ci renvoie bien au serveur les identifiants de session que celui-ci lui envoie. Au fil des requêtes, le navigateur va recevoir les trois compteurs envoyés par le serveur et va voir leurs valeurs s'incrémenter.

Image non disponible
  • en [1], la 1re demande au service web [web_05]
  • en [2], la 3ième demande montre que les compteurs sont bien incrémentés. Il y a bien mémorisation des valeurs des compteurs au fil des demandes.

Utilisons Firebug pour voir les en-têtes Http échangés entre le serveur et le client. Nous fermons Firefox pour terminer la session courante avec le serveur, le rouvrons et activons Firebug. Nous demandons le service |web_05] :

Image non disponible

Ci-dessus, on voit l'identifiant de session envoyé par le serveur dans sa réponse à la 1re demande du client. Il utilise l'en-tête Http Set-Cookie.

Faisons une nouvelle demande en rafraîchissant (F5) la page dans le navigateur web :

Image non disponible

Ci-dessus on remarquera deux choses :

  • le navigateur web renvoie l'identifiant de session avec l'en-tête Http Cookie.
  • dans sa réponse, le service web n'inclut plus cet identifiant. C'est désormais le client qui a la charge de l'envoyer à chacune de ses demandes.

XI-D-3. Le client 1 (client1_web_05)

Nous écrivons maintenant un script client du script serveur précédent. Dans sa gestion de la session, il doit se comporter comme le navigateur web :

  • dans la réponse du serveur à sa première demande, il doit trouver l'identifiant de session que le serveur lui envoie. Il sait qu'il le trouvera dans l'en-tête Http Set-Cookie.
  • il doit, à chacune de ses demandes ultérieures, renvoyer au serveur l'identifiant qu'il a reçu. Il le fera avec l'en-tête Http Cookie.

Le code du client est le suivant :

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • lignes 3-16 : le programme principal
  • lignes 18-67 : la fonction connecte
  • lignes 9-14 : le client appelle 5 fois le serveur et affiche les valeurs successives des compteurs N1, N2 et N3. Si la session est correctement gérée, ces compteurs devraient être incrémentés de 1 à chaque nouvelle demande.
  • ligne 10 : la fonction connecte utilise les paramètres $HOTE, $PORT, $urlServeur pour connecter le client au service web. Le paramètre $cookie représente l'identifiant de session. Au 1er appel, c'est la chaîne vide. Aux suivants, c'est l'identifiant de session envoyé par le serveur en réponse au 1er appel du client. La fonction connecte renvoie en résultats, les valeurs des trois compteurs $N1, $N2, $N3, l'identifiant de session $cookie et une éventuelle erreur $erreur.
  • ligne 18 : la fonction connecte a les caractéristiques d'un client Http classique. Nous ne commentons que les nouveautés.
  • lignes 30-40 : envoi des en-têtes Http.
  • lignes 36-38 : si l'identifiant de session est connu, on l'envoie au serveur
  • lignes 44-66 : exploitation de toutes les lignes de texte envoyées par le serveur
  • lignes 47-51 : si l'identifiant de session n'a pas encore été récupéré, on le récupère dans l'en-tête Http Set-Cookie par une expression régulière.
  • lignes 53-54 : le compteur N1 est obtenu lui aussi par une expression régulière
  • lignes 56-57, 59-60 : idem pour les compteurs N2 et N3
  • ligne 63 : fermeture de la connexion avec le serveur.
  • ligne 65 : renvoi des résultats sous la forme d'un tableau.

Résultats

L'exécution du script client provoque l'affichage suivant dans la console Netbeans :

 
Cacher/Afficher le codeSélectionnez
  • ligne 5 : dans sa première réponse, le serveur envoie l'identifiant de session. Dans les réponses suivantes, il ne l'envoie plus.
  • on voit clairement que le serveur Web conserve les valeurs de (N1,N2,N3) au fil des demandes du client. C'est ce qu'on appelle le suivi de session.

Les deux exemples qui suivent montrent qu'on peut aussi sauvegarder les valeurs d'un tableau ou d'un objet.

XI-D-4. Le serveur 2 (web_06)

Le script serveur suivant montre qu'on peut mettre en session un tableau ou un dictionnaire.

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • lignes 17-19 : un tableau est initialement mis en session s'il n'y est pas déjà
  • lignes 12-15 : s'il y est déjà, ses éléments sont incrémentés de 1
  • ligne 27 : un dictionnaire à valeurs numériques est mis en session s'il n'y est pas déjà
  • lignes 22-25 : s'il y est déjà, ses valeurs numériques sont incrémentées de 1
  • lignes 30-35 : le tableau et le dictionnaire sont envoyés au client

XI-D-5. Le client 2 (client1_web_06)

 
Cacher/Afficher le codeSélectionnez

Le code du client est analogue au code du client déjà commenté.

Résultats

 
Cacher/Afficher le codeSélectionnez

XI-D-6. Le serveur 3 (web_07)

Le script serveur suivant montre qu'on peut mettre en session un objet.

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • ligne 17 : on met en session un objet de type Personne s'il n'y est pas déjà.
  • lignes 11-15 : s'il y est déjà, on incrémente son âge de 1
  • ligne 20 : on envoie l'objet de type Personne au client.

XI-D-7. Le client 3 (client1_web_07)

 
Cacher/Afficher le codeSélectionnez

Commentaires

  • ligne 15 : la fonction connecte est identique à celle du script client précédent

Résultats

 
Cacher/Afficher le codeSélectionnez

précédentsommairesuivant

Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright © 2013 Serge Tahé. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.