Manuel PHP
Précédent |  | Suivant

# XL. 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`.

Tableau 1. Options de configuration

Nom | Par défaut | Modifiable | Historique
--- | --- | --- | ---
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 à 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é.

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

  Avertissement
  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 Référence LXIII, 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)

`FILE_APPEND` (entier)

`FILE_IGNORE_NEW_LINES` (entier)

`FILE_SKIP_EMPTY_LINES` (entier)

# 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 Annexe M.

Précédent | Sommaire | Suivant
filepro | Niveau supérieur | basename