488 Annexe C. Fonctions PHP eregi int eregi (string motif, string cha^ıne [, array tabOcc ]) Idem que la précédente, mais l’évaluation n’est pas sensible à la casse (majuscules/- minuscules). ereg_replace string ereg_replace (string motif, string remplacement, string cha^ıne ) Évalue une expression régulière, remplace les occurrences trouvées par remplace- ment, et renvoie la nouvelle chaîne. eregi_replace int eregi_replace (string motif, string remplacement, string cha^ıne ) Idem que la précédente, mais l’évaluation n’est pas sensible à la casse (majuscules/- minuscules). extension_loaded bool extension_loaded (string nomExtension ) Renvoie true si l’extension est chargée, false sinon. Les noms des extensions sont affichés avec phpinfo(). getenv string getenv (string variable ) Renvoie la valeur de la variable d’environnement variable, ou 0 si elle n’existe pas. getType string getType (variable ) Renvoieletyped’unevariable. Header Header (cha^ıne ) Cette fonction produit un en-tête HTTP comme Content-type, Location, Expires, etc. Elle doit être utilisée avant toute production de texte HTML. C.1 Fonctions générales 489 htmlEntities string htmlEntities (string cha^ıne ) Cette fonction remplace tous les caractères réservés de HTML (comme par exemple « & »), par une entité (par exemple &). is_array bool is_array (variable ) Renvoie vrai si variable est un tableau. is_double bool is_double (variable ) Renvoie vrai si variable est de type double. is_float bool is_float (variable ) Renvoie vrai si variable est de type float. is_int bool is_int (variable ) Renvoie vrai si variable est un entier. is_long bool is_long (variable ) Renvoie vrai si variable est de type long. is_object bool is_object (variable ) Renvoie vrai si variable est un objet. is_string bool is_string (variable ) Renvoie vrai si variable est une chaîne. 490 Annexe C. Fonctions PHP isSet bool isSet (variable ) Renvoie vrai si la variable est définie et a une valeur, faux sinon. mail bool mail (string destinataire, string sujet, string texte, string ajoutEnt^ete ) Cette fonction envoie un email. Le dernier paramètre, optionnel, permet d’ajouter des informations dans l’en-tête de l’email. max mixed max (mixed var1, mixed var2, mixed varN ) Renvoie la plus grande des variables passées en argument. On peut aussi lui passer un tableau, au lieu d’une liste de variables. md5 string md5 (string cha^ıne ) MD5 est une fonction de hachage qui renvoie une chaîne de 32 octets associée à la chaîne cha^ıne. Il est à peu près impossible d’obtenir deux valeurs identiques pour des chaînes différentes (collision) ce qui permet de considérer cette fonction comme un cryptage de chaîne. min mixed min (mixed var1, mixed var2, mixed varN ) Renvoie la plus petite des variables passées en argument. On peut aussi passer un tableau, au lieu d’une liste de variables. nl2br string nl2br (string cha^ıne ) Remplace les retours à la ligne dans cha^ıne par <br/> pour que ces retours soient reportés correctement dans un affichage HTML. C.1 Fonctions générales 491 passthru string passthru (string commande [, int retour ]]) Cette fonction est identique à exec(), mais le résultat produit par commande est envoyé directement au navigateur. En d’autres termes, on fait appel à un pro- gramme ou à une commande système auxiliaire pour produire le document, ou l’extrait de document, transmis au navigateur. La fonction system() est analogue à passthru(). phpInfo phpInfo () Affiche des informations sur l’interpréteur PHP. print print (string cha^ıne ) Imprime une chaîne sur la sortie standard. Identique à echo() – à ceci près qu’il faut encadrer cha^ıne par des parenthèses. print_r print_r (array tab ) Affiche tous les éléments d’un tableau (fonctionne aussi pour n’importe quel type de variable). printf printf (string format, variable1, variable2, ) Imprime une liste de variables selon un format décrit comme pour la fonction C de même nom. putenv putenv (string expression ) Définit une variable d’environnement comme indiqué dans expression qui peut être, par exemple, "PATH=$path". rand int rand () Engendre une valeur aléatoire. 492 Annexe C. Fonctions PHP round int round (float nombre ) Renvoiel’entierleplusprochedenombre. SetCookie bool setCookie (string nom, string valeur, int expiration, string chemin, string domaine, string s´ecurit´e ) Cette fonction permet de demander au navigateur d’enregistrer un cookie avec l’en- tête Set-Cookie : voir page 17. Tous les paramètres sauf le premier sont optionnels : si seul le nom est indiqué, le cookie sera supprimé. Les cookies doivent faire partie de l’en-tête d’un document, ce qui implique que la fonction doit être appelée avant de produire la première balise HTML. La durée de vie du cookie est indiquée par expiration exprimée en temps Unix. On peut donc appeler la fonction time() et ajouter au résultat le nombre de secondes donnant la durée de vie. Par défaut un cookie disparaît quand le programme client (navigateur) s’arrête. Les paramètres chemin et domaine définissent la visi- bilité du cookie pour les serveurs qui dialoguent par la suite avec le navigateur (voir page 17). Par défaut, seul le serveur qui a créé le cookie peut le lire. Enfin, s´ecurit´e indique que le cookie sera transféré en mode sécurisé avec SSL (Secure Socket Layer). unset unset (variable ) Détruit variable, qui n’est alors plus définie. urlDecode string urlDecode (string cha^ıne ) Cette fonction décode le paramètre cha^ıne provenant d’une URL, pour y remplacer par exemple les « + » par des espaces. urlEncode string urlEncode (string cha^ıne ) Cette fonction code le paramètre cha^ıne de manière à ce qu’elle puisse être trans- mise dans une URL. Les blancs dans cha^ıne sont par exemple transformés en « + » dans la chaîne produite. . transféré en mode sécurisé avec SSL (Secure Socket Layer). unset unset (variable ) Détruit variable, qui n’est alors plus définie. urlDecode string urlDecode (string cha^ıne ) Cette fonction décode le. ) Renvoiel’entierleplusprochedenombre. SetCookie bool setCookie (string nom, string valeur, int expiration, string chemin, string domaine, string s´ecurit´e ) Cette fonction permet de demander au navigateur. ) Renvoie la valeur de la variable d’environnement variable, ou 0 si elle n’existe pas. getType string getType (variable ) Renvoieletyped’unevariable. Header Header (cha^ıne ) Cette fonction produit