Aucune bibliothèque externe n’est requise pour avoir cette extension, mais si vous voulez le support des grands fichiers “LFS” sur Linux, vous devez avoir une version récente de gclib et vous devrez compiler PHP avec les options suivantes : “-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64”.

Il n’y pas d’installation nécessaire pour utiliser ces fonctions, elles font parties du coeur de PHP.

Le comportement de ces fonctions est affecté par la configuration dans le fichier “php.ini”.

Tableau 1. Options de configuration

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe G.

Voici un éclaircissement sur l’utilisation des directives de configuration.

“allow_url_fopen” booléen

Cette option active les versions étendues des fonctions d’accès aux fichiers, qui savent exploiter les URL. Les extensions par défaut permettent d’accéder aux fichiers distants avec les protocoles FTP ou HTTP. Certaines extensions comme zlib, peuvent ajouter d’autres fonctionnalités.

Note : Cette option peut seulement être définie dans le php.ini pour des raisons de sécurité.

“allow_url_include” booléen

Cette option permet l’utilisation des gestionnaires fopen URL avec les fonctions suivantes : include(), include_once(), require(), require_once().

Note : Ce paramètre nécessite que le paramètre allow_url_fopen soit positionné à ‘on’.

“user_agent” string

Définit le type d’“user agent” (Définition du navigateur web) utilisé par PHP.

“default_socket_timeout” entier

Durée d’expiration (en secondes) pour les flots basés sur les sockets.

Note : Cette option de configuration a été introduite en PHP 4.3.

“from” string

Définit le mot de passe FTP en mode anonyme (en général, votre adresse email).

“auto_detect_line_endings” booléen

Lorsque cette option est activée, PHP va examiner les données lues par fgets() et file() pour voir si le fichier utilise les conventions de ligne de Unix, MS-Dos ou Macintosh.

Cela permet à PHP de fonctionner avec des systèmes Macintosh, mais par défaut, cette option est désactivée, car cette détection impose un légère pénalité en temps de traitement, mais aussi parce que ceux qui utilisent les retours chariots comme séparateurs auront des soucis de compatibilité.

Note : Cette option de configuration a été introduite en PHP 4.3.

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l’exécution.

“GLOB_BRACE” (entier)

“GLOB_ONLYDIR” (entier)

“GLOB_MARK” (entier)

“GLOB_NOSORT” (entier)

“GLOB_NOCHECK” (entier)

“GLOB_NOESCAPE” (entier)

“PATHINFO_DIRNAME” (entier)

“PATHINFO_BASENAME” (entier)

“PATHINFO_EXTENSION” (entier)

“PATHINFO_FILENAME” (entier)

Since PHP 5.2.0.

“FILE_USE_INCLUDE_PATH” (entier)

“FILE_APPEND” (entier)

“FILE_IGNORE_NEW_LINES” (entier)

“FILE_SKIP_EMPTY_LINES” (entier)

Pour les fonctions connexes, voyez aussi la section sur les accès aux Dossiers et sur les exécutions de programme.

Pour une liste et une explication sur les différents outils d’accès aux fichiers distants, voyez aussi Annexe M.

Table des matières

basename –  Sépare le nom du fichier et le nom du dossier chgrp – Change le groupe propriétaire d’un fichierchmod – Change le mode du fichierchown – Change le groupe propriétaire du fichierclearstatcache – Efface le cache de stat()
copy – Copie un fichierdelete – Effacerdirname – Renvoie le nom du dossierdisk_free_space –  Renvoie l’espace disque disponible dans le répertoire disk_total_space – Retourne la taille d’un dossierdiskfreespace – Alias de disk_free_space()
fclose – Ferme un fichierfeof – Teste la fin du fichierfflush – Envoie tout le contenu généré dans un fichierfgetc – Lit un caractère dans un fichierfgetcsv – Renvoie la ligne courante et cherche les champs CSVfgets –  Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier fgetss –  Renvoie la ligne courante du fichier et élimine les balises HTML file_exists – Vérifie si un fichier existefile_get_contents – Lit tout un fichier dans une chaînefile_put_contents – Ecrit une chaîne dans un fichierfile –  Lit le fichier et renvoie le résultat dans un tableau fileatime –  Renvoie la date à laquelle le fichier a été accédé pour la dernière fois filectime –  Renvoie la date de dernier accès à un inode filegroup – Lire le nom du groupefileinode – Renvoie le numéro d’inode du fichierfilemtime –  Renvoie la date de dernière modification du fichier fileowner – Renvoie le nom du propriétaire du fichierfileperms – Renvoie les permissions affectées à un fichierfilesize – Renvoie la taille d’un fichierfiletype – Retourne le type de fichierflock – Verrouille le fichierfnmatch – Repère un fichier à partir d’un masquefopen – Ouverture d’un fichier ou d’une URLfpassthru – Affiche le reste du fichierfputcsv –  Formate une ligne en CSV et l’écrit dans un fichier fputs – Alias de fwrite()
fread – Lecture du fichier en mode binairefscanf – Analyse un fichier en fonction d’un formatfseek – Modifie la position du pointeur de fichierfstat –  Lit les informations sur un fichier à partir d’un pointeur de fichier ftell – Renvoie la position du pointeur du fichierftruncate – Tronque un fichierfwrite – Ecrit un fichier en mode binaireglob – Recherche des chemins qui vérifient un masqueis_dir – Indique si le fichier est un dossieris_executable – Indique si le fichier est exécutableis_file – Indique si le fichier est un véritable fichieris_link – Indique si le fichier est un lien symboliqueis_readable – Indique si un fichier est autorisé en lectureis_uploaded_file –  Indique si le fichier a été téléchargé par HTTP POST is_writable – Indique si un fichier est autorisé en écritureis_writeable – Alias de is_writable()
lchgrp – Change l’appartenance du groupe d’un lien symboliquelchown – Change l’appartenance du propriétaire d’un lien symboliquelink – Crée un lienlinkinfo – Renvoie les informations d’un lienlstat –  Retourne les informations sur n fichier ou un lien symbolique mkdir – Crée un dossiermove_uploaded_file – Déplace un fichier téléchargéparse_ini_file – Traite un fichier de configurationpathinfo – Retourne des informations sur un chemin systèmepclose – Ferme un processus de pointeur de fichierpopen – Crée un processus de pointeur de fichierreadfile – Affiche un fichierreadlink –  Renvoie le nom du fichier vers lequel pointe un lien symbolique realpath – Retourne le chemin canonique absolurename – Renomme un fichier ou un dossierrewind – Replace le pointeur de fichier au débutrmdir – Efface un dossierset_file_buffer – Alias de stream_set_write_buffer()
stat – Renvoie les informations à propos d’un fichiersymlink – Crée un lien symboliquetempnam – Crée un fichier avec un nom uniquetmpfile – Crée un fichier temporairetouch –  Modifie la date de modification et de dernier accès d’un fichier umask – Change le “umask” courantunlink – Efface un fichier