Forum und email

Système de fichiers

Introduction

Pré-requis

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.

Installation

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

Configuration à l'exécution

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

Options de configuration
NomPar défaut ModifiableHistorique
allow_url_fopen "1" PHP_INI_SYSTEM PHP_INI_ALL dans PHP <= 4.3.4. Disponible depuis PHP 4.0.4.
allow_url_include "0" PHP_INI_SYSTEM Disponible depuis PHP 5.2.0.
user_agent NULL PHP_INI_ALL Disponible depuis PHP 4.3.0.
default_socket_timeout "60" PHP_INI_ALL Disponible depuis PHP 4.3.0.
from "" PHP_INI_ALL  
auto_detect_line_endings "0" PHP_INI_ALL Disponible depuis PHP 4.3.0.
Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Directives du php.ini.

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é.

Note: Cette option a été introduite immédiatement après la publication de la version 4.0.3. Pour les versions jusqu'à la, vous ne pouvez désactiver cette fonctionnalité qu'au moment de la compilation, avec l'option --disable-url-fopen-wrapper.

Warning

Sous Windows, dans les versions antérieures à la version 4.3, les fonctions suivantes ne supportent pas l'accès aux fichiers distants : include(), include_once(), require(), require_once() et les fonctions imagecreatefromXXX de l'extension Images.

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.

Types de ressources

Constantes pré-définies

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)
Depuis PHP 5.0.0. Cherche filename dans include_path.
FILE_APPEND (entier)
FILE_IGNORE_NEW_LINES (entier)
Depuis PHP 5.0.0. Enlève les caractères EOL.
FILE_SKIP_EMPTY_LINES (entier)
Depuis PHP 5.0.0. Enlève les lignes vides.

Voir aussi

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 Liste des protocoles supportés.

Table of Contents

  • basename — Sépare le nom du fichier et le nom du dossier
  • chgrp — Change le groupe propriétaire d'un fichier
  • chmod — Change le mode du fichier
  • chown — Change le groupe propriétaire du fichier
  • clearstatcache — Efface le cache de stat
  • copy — Copie un fichier
  • delete — Effacer
  • dirname — Renvoie le nom du dossier
  • disk_free_space — Renvoie l'espace disque disponible dans le répertoire
  • disk_total_space — Retourne la taille d'un dossier
  • diskfreespace — Alias de disk_free_space
  • fclose — Ferme un fichier
  • feof — Teste la fin du fichier
  • fflush — Envoie tout le contenu généré dans un fichier
  • fgetc — Lit un caractère dans un fichier
  • fgetcsv — Renvoie la ligne courante et cherche les champs CSV
  • fgets — 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 existe
  • file_get_contents — Lit tout un fichier dans une chaîne
  • file_put_contents — Ecrit une chaîne dans un fichier
  • file — 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 groupe
  • fileinode — Renvoie le numéro d'inode du fichier
  • filemtime — Renvoie la date de dernière modification du fichier
  • fileowner — Renvoie le nom du propriétaire du fichier
  • fileperms — Renvoie les permissions affectées à un fichier
  • filesize — Renvoie la taille d'un fichier
  • filetype — Retourne le type de fichier
  • flock — Verrouille le fichier
  • fnmatch — Repère un fichier à partir d'un masque
  • fopen — Ouverture d'un fichier ou d'une URL
  • fpassthru — Affiche le reste du fichier
  • fputcsv — Formate une ligne en CSV et l'écrit dans un fichier
  • fputs — Alias de fwrite
  • fread — Lecture du fichier en mode binaire
  • fscanf — Analyse un fichier en fonction d'un format
  • fseek — Modifie la position du pointeur de fichier
  • fstat — Lit les informations sur un fichier à partir d'un pointeur de fichier
  • ftell — Renvoie la position du pointeur du fichier
  • ftruncate — Tronque un fichier
  • fwrite — Ecrit un fichier en mode binaire
  • glob — Recherche des chemins qui vérifient un masque
  • is_dir — Indique si le fichier est un dossier
  • is_executable — Indique si le fichier est exécutable
  • is_file — Indique si le fichier est un véritable fichier
  • is_link — Indique si le fichier est un lien symbolique
  • is_readable — Indique si un fichier est autorisé en lecture
  • is_uploaded_file — Indique si le fichier a été téléchargé par HTTP POST
  • is_writable — Indique si un fichier est autorisé en écriture
  • is_writeable — Alias de is_writable
  • lchgrp — Change l'appartenance du groupe d'un lien symbolique
  • lchown — Change l'appartenance du propriétaire d'un lien symbolique
  • link — Crée un lien
  • linkinfo — Renvoie les informations d'un lien
  • lstat — Retourne les informations sur n fichier ou un lien symbolique
  • mkdir — Crée un dossier
  • move_uploaded_file — Déplace un fichier téléchargé
  • parse_ini_file — Traite un fichier de configuration
  • pathinfo — Retourne des informations sur un chemin système
  • pclose — Ferme un processus de pointeur de fichier
  • popen — Crée un processus de pointeur de fichier
  • readfile — Affiche un fichier
  • readlink — Renvoie le nom du fichier vers lequel pointe un lien symbolique
  • realpath — Retourne le chemin canonique absolu
  • rename — Renomme un fichier ou un dossier
  • rewind — Replace le pointeur de fichier au début
  • rmdir — Efface un dossier
  • set_file_buffer — Alias de stream_set_write_buffer
  • stat — Renvoie les informations à propos d'un fichier
  • symlink — Crée un lien symbolique
  • tempnam — Crée un fichier avec un nom unique
  • tmpfile — Crée un fichier temporaire
  • touch — Modifie la date de modification et de dernier accès d'un fichier
  • umask — Change le "umask" courant
  • unlink — Efface un fichier