C.5 Fonctions XML 503 Renvoie la valeur de l’option option. Seules deux options sont proposées : • XML_OPTION_CASE_FOLDING : booléen indiquant que les noms d’éléments sont mis en majuscules. • XML_OPTION_TARGET_ENCODING : le jeu de caractères pour le codage du résultat. xml_parser_set_option xml_parser_set_option (parseur, string option, string valeur ) Affecte une valeur à une option (voir ci-dessus). xml_parse_into_struct xml_parse_into_struct (parseur, string donnees, string tabValeur, string tabIndex ) Analyse complètement un document XML et le représente dans deux tableaux PHP. Assez complexe : voir la documentation PHP pour un exemple complet. xml_set_character_data_handler xml_set_character_data_handler (parseur, fChar ) Affecte la fonction fChar() au traitement des données caractères. Cette fonction doit accepter deux arguments : le parseur, et la chaîne contenant les données carac- tères. xml_set_default_handler xml_set_default_handler (parseur, fDef ) Affecte la fonction fDef() (mêmes arguments que la précédente) au traitement des composants du document XML pour lesquels il n’existe pas d’autre « déclencheur ». xml_set_element_handler xml_set_element_handler (parseur, fElemDebut, fElemFin ) Affecte la fonction fElemDebut() au traitement des balises ouvrantes, et fElemFin() au traitement des balises fermantes. Voir les exemples du chapitre 8. xml_set_external_entity_ref_handler xml_set_external_entity_ref_handler (parseur, fEntExt ) Affecte la fonction fEntExt() au traitement des entités externes. 504 Annexe C. Fonctions PHP xml_set_notation_decl_handler xml_set_notation_decl_handler (parseur, fNotation ) Affecte la fonction fNotation() au traitement des notations XML. Les « nota- tions » (très rarement utilisées) fournissent un moyen de décrire dans un document XML des données non alphanumériques. xml_set_object xml_set_object (parseur, objet ) Indique au parseur que les déclencheurs sont les méthodes de objet. xml_set_processing_instruction_handler xml_set_processing_instruction_handler (parseur, fPI ) Affecte la fonction fPI() au traitement des instructions de traitement. Cette fonction doit accepter trois paramètres : le parseur, un paramètre nom contenant le nom de l’instruction, et un paramètre donn´ees contenant la chaîne constituant l’instruction. C.6 ACCÈS AUX FICHIERS chdir chdir (string r´epertoire ) Permet de se positionner dans r´epertoire. closedir closedir (int r´epertoire ) Referme le pointeur de répertoire (qui doit avoir été ouvert par opendir() aupara- vant). copy copy (string source, string destination ) Copie un fichier de source vers destination. fclose fclose (int descFichier ) FermelefichieridentifiépardescFichier. C.6 Accès aux fichiers 505 feof bool feof (int descFichier ) Renvoie vrai si la fin du fichier identifié par descFichier est atteinte. fgetc char fgetc (int descFichier ) Renvoie le caractère placé à la position courante du fichier identifié par descFi- chier, et avance d’une position. fgets string fgets (int descFichier, int longueur ) Renvoie une ligne du fichier, de taille maximale longueur. file array file (string nomFichier ) Charge tout le contenu de nomFichier dans un tableau, avec un élément par ligne. file_exists bool file_exists (string nomFichier ) Teste l’existence de nomFichier. filesize int filesize (string nomFichier ) Renvoie la taille de nomFichier. fopen int fopen (string nomFichier, string mode ) Ouvre le fichier nomFichier et renvoie un descripteur qui peut être utilisé ensuite pour lire le contenu. Les modes d’ouverture sont les suivants : 1. r : lecture seule. 2. w : écriture seule. Le contenu du fichier est effacé s’il existe déjà. 3. a : ajout. Le fichier est créé s’il n’existe pas. On peut combiner des options, comme par exemple rw qui indique à la fois lecture et écriture. On peut aussi, dans tous les cas, ajouter un b à la fin du mode pour indiquer que le fichier est au format binaire. 506 Annexe C. Fonctions PHP Le paramètre nomFichier peut être une URL complète, commençant par http:// ou ftp://, suivie du serveur, du chemin d’accès et du nom du fichier proprement dit. fpassthru int fpasstrhu (int descFichier ) Cette fonction permet de transférer directement le contenu d’un fichier – en partant de la position courante dans le fichier– vers le programme client. Elle renvoie le nombre d’octets lus. Le fichier doit avoir été ouvert par fopen() auparavant. La fonction readfile() est encore plus simple à utiliser puisqu’on se contente de donner le nom du fichier. fputs bool fputs (int descFichier, string cha^ıne ) La fonction écrit cha^ıne dans le fichier décrit par descFichier. Elle renvoie vrai si l’opération réussit. include include (string nomFichier ) La fonction ouvre le fichier et exécute les instructions qui y sont contenues. Pour des raisons expliquées page 60, ce mode d’appel à des instructions extérieures au script est à utiliser avec précaution. On peut avantageusement le remplacer par un appel de fonction. mkdir bool mkdir (string nomR´epertoire, string permissions ) Crée un répertoire de nom nomR´epertoire. Les permissions sont codées comme sous UNIX. opendir opendir (string nomR´epertoire ) Crée un pointeur de répertoire qui permet de parcourir la liste des fichiers du répertoire avec readdir(). readdir readdir (int r´epertoire ) Retourne le nom du fichier suivant dans le répertoire identifié par r´epertoire (ouvert avec opendir()). C.7 Interface PHP/MySQL 507 readfile int readfile (string nomFichier [, bool chercherPartout ]) Cette fonction transfère directement le contenu de nomFichier vers le programme client et renvoie le nombre d’octets lus. Si le second paramètre est true,lefichierest recherché dans tous les répertoires de l’option include_path dans le fichier php.ini. rename bool rename (string source, string destination ) Renomme le fichier source en destination. require require (string nomFichier ) La fonction insère le contenu du fichier nomFichier dans le script courant. Pour des raisons expliquées page 60, le fichier inclus doit contenir des déclarations de constantes ou de fonctions, mais il vaut mieux éviter d’y placer des instructions ou des définitions de variables. rmdir bool rmdir (string nomR´epertoire ) Détruit le répertoire de nom nomR´epertoire. C.7 INTERFACE PHP/MySQL mysql_affected_rows int mysql_affected_rows (int [connexion ]) mysql_affected_rows renvoie le nombre de lignes modifiées, détruites ou insérées dans une table après une requête UPDATE, DELETE ou INSERT.L’argumentconnexion est optionnel : par défaut, la dernière connexion établie avec MySQL est utilisée. mysql_change_user int mysql_change_user (string nom, string motPasse, string [base ], int [connexion ]) . des données caractères. Cette fonction doit accepter deux arguments : le parseur, et la chaîne contenant les données carac- tères. xml_set_default_handler xml_set_default_handler (parseur, fDef. dans un document XML des données non alphanumériques. xml_set_object xml_set_object (parseur, objet ) Indique au parseur que les déclencheurs sont les méthodes de objet. xml_set_processing_instruction_handler xml_set_processing_instruction_handler. ) FermelefichieridentifiépardescFichier. C.6 Accès aux fichiers 505 feof bool feof (int descFichier ) Renvoie vrai si la fin du fichier identifié par descFichier est atteinte. fgetc char fgetc (int descFichier