système de fichiers Flashcards Preview

Php > système de fichiers > Flashcards

Flashcards in système de fichiers Deck (80):
1

string basename ( string $path [, string $suffix ] )

Prend en paramètre path, le chemin complet d'un fichier et en extrait le nom du fichier.

2

bool chgrp ( string $filename , mixed $group )

Essaie de remplacer le groupe propriétaire courant du fichier filename par group.

Seul le super-utilisateur (root) peut changer le groupe propriétaire d'un fichier arbitrairement; les utilisateurs classiques ne peuvent changer le groupe propriétaire d'un fichier que si l'utilisateur propriétaire du fichier est membre du groupe.

3

bool chmod ( string $filename , int $mode )

Remplace le mode du fichier filename par le mode mode.

4

bool chown ( string $filename , mixed $user )

Change le propriétaire du fichier filename en user. Seul le super-utilisateur (root) peut changer arbitrairement le propriétaire d'un fichier.

5

void clearstatcache ([ bool $clear_realpath_cache = false [, string $filename ]] )

L'appel à la fonction stat() ou lstat() est relativement coûteux en termes de temps d'exécution. Pour cela, le résultat du dernier appel à l'une des fonctions de statut, (voir la liste ci-dessous), est sauvegardé pour réutilisation ultérieure. Si vous voulez forcer la vérification du statut d'un fichier, dans le cas où le fichier aurait pu être modifié ou aurait disparu, vous devez utiliser la fonction clearstatcache() afin d'effacer de la mémoire les résultats du dernier appel à la fonction.

Sachez que PHP ne met pas en cache les informations concernant un fichier inexistant. Si vous appelez file_exists() sur un fichier qui n'existe pas, la fonction retournera FALSE jusqu'à ce que vous créiez le fichier. Si vous créez le fichier, la fonction retournera TRUE même si vous effacez le fichier.

Note:

Cette fonction met en cache des informations sur les fichiers. Vous n'avez donc besoin d'appeler clearstatcache() que si vous faites des opérations multiples sur le dossier, et que vous voulez avoir une version récente des informations.

Les fonctions affectées sont : stat(), lstat(), file_exists(), is_writable(), is_readable(), is_executable(), is_file(), is_dir(), is_link(), filectime(), fileatime(), filemtime(), fileinode(), filegroup(), fileowner(), filesize(), filetype(), et fileperms().

6

bool copy ( string $source , string $dest [, resource $context ] )

Fait une copie du fichier source vers le fichier dest.

Si vous souhaitez déplacer un fichier, utilisez la fonction rename().

7

string dirname ( string $path )

string dirname ( string $path )

8

float disk_free_space ( string $directory )

Renvoie l'espace disque disponible dans le répertoire ou la partition.

9

float disk_total_space ( string $directory )

Lit récursivement toutes les tailles du dossier directory et retourne la somme en octets.

10

diskfreespace()

Cette fonction est un alias de : disk_free_space().

11

bool fclose ( resource $handle )

Ferme le fichier représenté par le pointeur handle.

12

bool feof ( resource $handle )

Teste la fin du fichier.

13

bool fflush ( resource $handle )

Force l'écriture de toutes les données bufferisées dans le fichier désigné par handle.

14

string fgetc ( resource $handle )

Lit un caractère dans un fichier.

15

array fgetcsv ( resource $handle [, int $length = 0 [, string $delimiter = "," [, string $enclosure = '"' [, string $escape = "\" ]]]] )

Similaire à fgets() mais fgetcsv() analyse la ligne qu'il lit et recherche les champs CSV, qu'il va retourner dans un tableau les contenant.

16

string fgets ( resource $handle [, int $length ] )

Récupère la ligne courante sur laquelle se trouve le pointeur du fichier.

17

string fgetss ( resource $handle [, int $length [, string $allowable_tags ]] )

Identique à fgets(), sauf que la fonction fgetss() supprime tous les octets nuls, toutes les balises HTML et PHP qu'il trouve dans le texte lu.

18

bool file_exists ( string $filename )

Vérifie si un fichier ou un dossier existe.

19

string file_get_contents ( string $filename [, bool $use_include_path = false [, resource $context [, int $offset = -1 [, int $maxlen ]]]] )

Identique à la fonction file(), hormis le fait que file_get_contents() retourne le fichier filename dans une chaîne, à partir de la position offset, et jusqu'à maxlen octets. En cas d'erreur, file_get_contents() retourne FALSE.

file_get_contents() est la façon recommandée pour lire le contenu d'un fichier dans une chaîne de caractères. Elle utilisera un buffer en mémoire si ce mécanisme est supporté par votre système, afin d'améliorer les performances.

Note:

Si vous ouvrez une URI avec des caractères spéciaux, comme des espaces, vous devez encoder cette URI avec la fonction urlencode().

20

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] )

Revient à appeler les fonctions fopen(), fwrite() et fclose() successivement.

Si le fichier filename n'existe pas, il sera créé. Sinon, le fichier existant sera écrasé, si l'option FILE_APPEND n'est pas définie.

21

array file ( string $filename [, int $flags = 0 [, resource $context ]] )

Lit le fichier et renvoie le résultat dans un tableau.

Note:

Vous pouvez utiliser la fonction file_get_contents() pour retourner le contenu d'un fichier dans une chaîne de caractères.

22

int fileatime ( string $filename )

Renvoie la date à laquelle le fichier a été accédé pour la dernière fois.

23

int filectime ( string $filename )

Renvoie la date de dernière modification de l'inode d'un fichier.

24

int filegroup ( string $filename )

Lit le nom du groupe. L'identifiant de groupe est retourné au format numérique, utilisez posix_getgrgid() pour retrouver le nom du groupe.

25

int fileinode ( string $filename )

Lit le numéro d'inode du fichier.

26

int filemtime ( string $filename )

Lit la date à laquelle le fichier a été modifié pour la dernière fois.

27

int fileowner ( string $filename )

Lit l'identifiant du propriétaire d'un fichier.

28

int fileperms ( string $filename )

Lit les droits du fichier donné.

29

int filesize ( string $filename )

Lit la taille du fichier donné.

30

string filetype ( string $filename )

Retourne le type d'un fichier donné.

31

bool flock ( resource $handle , int $operation [, int &$wouldblock ] )

flock() permet de réaliser un système simple de verrous écriture/lecture, qui peut être utilisé sur n'importe quelle plate-forme (Unix et Windows compris).

Avant PHP 5.3.2, le verrou est également levé avec la fonction fclose() (qui est également automatiquement appelée lors de la fin du script).

PHP dispose d'un système complet de verrouillage de fichiers. Tous les programmes qui accèdent au fichier doivent utiliser la même méthode de verrouillage pour qu'il soit efficace. Par défaut, cette fonction se bloquera tant que le verrou demandé ne sera pas acquis ; ce comportement peut être contrôlé avec l'option LOCK_NB dont vous trouverez la documentation ci-dessous.

32

bool fnmatch ( string $pattern , string $string [, int $flags = 0 ] )

fnmatch() vérifie si la chaîne string va passer le masque Shell pattern. Repère un fichier à partir d'un masque de recherche

33

resource fopen ( string $filename , string $mode [, bool $use_include_path = false [, resource $context ]] )

fopen() crée une ressource nommée, spécifiée par le paramètre filename, sous la forme d'un flux. Ouvre un fichier ou une URL

34

int fpassthru ( resource $handle )

Lit tout le reste d'un fichier jusqu'à la fin et dirige le résultat vers la sortie standard.

Vous devez appeler la fonction rewind() pour réinitialiser le pointeur de fichier au début si vous avez déjà écrit des données dans le fichier.

Si vous voulez uniquement copier le contenu d'un fichier dans le buffer de sortie, sans le modifier auparavant ou placer le pointeur à un endroit particulier, vous devriez utiliser la fonction readfile(), ce qui vous évite d'appeler la fonction fopen() call.

35

int fputcsv ( resource $handle , array $fields [, string $delimiter = "," [, string $enclosure = '"' [, string $escape_char = "\" ]]] )

fputcsv() formate la ligne passée sous forme de tableau fields, puis écrit le résultat dans le fichier handle.

36

fputs()

Cette fonction est un alias de : fwrite().

37

string fread ( resource $handle , int $length )

fread() lit jusqu'à length octets dans le fichier référencé par handle. La lecture s'arrête lorsqu'une des conditions suivantes apparaît :

length octets ont été lus
la fin du fichier est atteinte
un paquet devient disponible ou le temps socket timeout est passé (pour les flux réseau)
si le flux est lu depuis le buffer, et qu'il ne représente pas un fichier plein, alors au moins une lecture d'un nombre d'octets équivalent à la taille du bloc (habituellement 8192) est réalisée ; suivants les données du buffer précédent, la taille des données retournées peut être supérieure à la taille du bloc.

38

mixed fscanf ( resource $handle , string $format [, mixed &$... ] )

La fonction fscanf() est similaire à la fonction sscanf(), sauf qu'elle prend un fichier en entrée, représentée par la ressource handle et interprète l'entrée en fonction du format format spécifié, qui est décrit dans la documentation de la fonction sprintf().

Tous les caractères blancs de la chaîne de formatage correspondent à autant d'espaces dans le flux d'entrée. Cela signifie qu'une tabulation \t dans la chaîne de format peut remplacer un espace simple dans le flux d'entrée.

Chaque appel à la fonction fscanf() lit une ligne du fichier.

39

int fseek ( resource $handle , int $offset [, int $whence = SEEK_SET ] )

Modifie le curseur de position dans le fichier handle. La nouvelle position, mesurée en octets, à partir du début du fichier, est obtenue en additionnant la distance offset à la position whence.

En général, il est possible de se déplacer au delà de la fin du flux (eof); si des données sont écrites dans ce cas, l'espace entre la fin du flux et la position courante sera rempli d'octets nuls. Cependant, certains flux ne supportent pas ce comportement, en particulier lorsque l'espace de stockage sous-jascent est de taille fixe.

40

array fstat ( resource $handle )

Rassemble les informations sur le fichier dont on connaît le pointeur handle. fstat() est similaire à la fonction stat(), hormis le fait qu'elle utilise un pointeur de fichier, au lieu d'un nom de fichier.

41

int ftell ( resource $handle )

Renvoie la position du pointeur courante du pointeur de fichier.

42

bool ftruncate ( resource $handle , int $size )

Prend le pointeur de fichier handle et le tronque à la taille de size.

43

int fwrite ( resource $handle , string $string [, int $length ] )

fwrite() écrit le contenu de la chaîne string dans le fichier pointé par handle.

44

array glob ( string $pattern [, int $flags = 0 ] )

glob() recherche tous les chemins qui vérifient le masque pattern, en suivant les règles utilisées par la fonction glob() de la libc, qui sont les mêmes que celles utilisées par le Shell en général.

45

bool is_dir ( string $filename )

Indique si le fichier est un dossier.

46

bool is_executable ( string $filename )

Indique si le fichier est exécutable.

47

bool is_file ( string $filename )

Indique si le fichier est un véritable fichier.

48

bool is_link ( string $filename )

Indique si le fichier est un lien symbolique.

49

bool is_readable ( string $filename )

Indique si un fichier existe et est accessible en lecture.

50

bool is_uploaded_file ( string $filename )

Retourne TRUE si le fichier filename a été téléchargé par HTTP POST. Cela est très utile pour vous assurer qu'un utilisateur n'essaie pas d'accéder intentionnellement à un fichier auquel il n'a pas droit (comme /etc/passwd).

Ce type de vérification est spécialement important s'il est possible que les fichiers téléchargés révèlent leur contenu à l'utilisateur, ou même aux utilisateurs du même système.

Pour un fonctionnement correct, la fonction is_uploaded_file() nécessite un argument comme $_FILES['userfile']['tmp_name'], - le nom du fichier téléchargé sur la machine cliente $_FILES['userfile']['name'] ne fonctionne pas.

51

bool is_writable ( string $filename )

retourne TRUE si filename existe et est accessible en écriture. L'argument peut être le nom d'un dossier, vous permettant ainsi de vérifier si le dossier est accessible en écriture.

N'oubliez pas que PHP accède aux fichiers avec les mêmes autorisations que l'utilisateur qui fait tourner le serveur web (souvent, c'est 'nobody', personne). Les limitations du safe mode ne sont pas prises en compte.

52

is_writeable()

Cette fonction est un alias de : is_writable().

53

bool lchgrp ( string $filename , mixed $group )

Essaie de remplacer le groupe du lien symbolique filename par le groupe group.

Seul le super-utilisateur peut changer le groupe d'un lien symbolique arbitrairement; les autres utilisateurs peuvent changer le groupe d'un lien symbolique vers un groupe auquel cet utilisateur est membre.

54

bool lchown ( string $filename , mixed $user )

Essaie de remplacer le propriétaire du lien symbolique filename par l'utilisateur user

Seul le super-utilisateur peut changer le propriétaire d'un lien symbolique.

55

bool link ( string $target , string $link )

link() crée un lien.

56

int linkinfo ( string $path )

Renvoie les informations d'un lien.
Cette fonction est utilisée pour vérifier si un lien (pointé par le chemin path) existe réellement (en utilisant la même méthode que la macro S_ISLNK, définie dans stat.h).

57

array lstat ( string $filename )

Retourne les informations sur un fichier ou un lien symbolique.

58

bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = false [, resource $context ]]] )

Tente de créer un dossier.

59

bool move_uploaded_file ( string $filename , string $destination )

S'assure que le fichier filename est un fichier téléchargé par HTTP POST. Si le fichier est valide, il est déplacé jusqu'à destination.

Ce type de vérification est spécialement important s'il est possible que les fichiers téléchargés révèlent leur contenu à l'utilisateur, ou même aux utilisateurs du même système.

60

array parse_ini_file ( string $filename [, bool $process_sections = false [, int $scanner_mode = INI_SCANNER_NORMAL ]] )

parse_ini_file() charge le fichier filename et retourne les configurations qui s'y trouvent sous forme d'un tableau associatif.

La structure des fichiers de configuration lus est similaire à celle de php.ini.

61

array parse_ini_string ( string $ini [, bool $process_sections = false [, int $scanner_mode = INI_SCANNER_NORMAL ]] )

parse_ini_string() retourne la configuration dans une chaîne de type ini dans un tableau associatif.

La structure de la chaîne doit être la même que celle du fichier php.ini.

62

mixed pathinfo ( string $path [, int $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME ] )

pathinfo() retourne des informations sur le chemin path, sous forme de chaine ou de tableau associatif, ceci dépend du paramètre options.

63

int pclose ( resource $handle )

Ferme un processus de pointeur de fichier ouvert avec la fonction popen().

64

resource popen ( string $command , string $mode )

Crée un processus de pointeur de fichier, exécuté en effectuant un fork de la commande fournie par le paramètre command.

65

int readfile ( string $filename [, bool $use_include_path = false [, resource $context ]] )

Lit un fichier et l'envoie dans le buffer de sortie.

66

string readlink ( string $path )

readlink() effectue la même chose que la fonction C readlink.

67

array realpath_cache_get ( void )

Récupère les entrées du cache realpath.

68

int realpath_cache_size ( void )

Récupère la quantité de mémoire utilisée par le cache realpath.

69

string realpath ( string $path )

realpath() résout tous les liens symboliques, et remplace toutes les références /./, /../ et / de path puis retourne le chemin canonique absolu ainsi trouvé.

70

bool rename ( string $oldname , string $newname [, resource $context ] )

Tente de renommer oldname en newname, en le déplaçant de répertoire si nécessaire. Si newname existe, il sera écrasé.

71

bool rewind ( resource $handle )

Replace le pointeur de fichier handle au début du flux.

Note:

Si vous avez ouvert le fichier en mode d'ajout ("a" ou "a+"), toutes les données que vous écrirez dans ce fichier seront toujours ajoutées, sans se soucier de la position du pointeur de fichier.

72

bool rmdir ( string $dirname [, resource $context ] )

Tente d'effacer le dossier dont le chemin est dirname. Le dossier doit être vide, et le script doit avoir les autorisations adéquates. Une alerte de niveau E_WARNING sera générée en cas d'échec.

73

set_file_buffer()

Cette fonction est un alias de : stream_set_write_buffer().

74

array stat ( string $filename )

Renvoie les informations à propos du fichier filename. Si filename est un lien symbolique, les informations proviennent du fichier lui-même, et non du lien symbolique.

lstat() est identique à stat() sauf que les informations seront alors basées sur le lien symbolique.

75

bool symlink ( string $target , string $link )

symlink() crée un lien symbolique pour l'objet target avec le nom de link.

76

string tempnam ( string $dir , string $prefix )

Crée un fichier dont le nom est unique, ayant comme permissions d'accès 0600, dans le dossier spécifié. Si le dossier n'existe pas, tempnam() tentera de créer un fichier dans le dossier temporaire système, et retournera le chemin complet de ce fichier, y compris son nom.

77

resource tmpfile ( void )

Crée un fichier temporaire avec un nom unique, ouvert en écriture et lecture (w+), et retourne un pointeur de fichier.

Ce fichier sera automatiquement effacé lorsqu'il sera fermé (par exemple, en appelant la fonction fclose(), ou lorsqu'il n'y a plus de référence au gestionnaire de fichier retourné par la fonction tmpfile()), ou lorsque le script sera terminé.

Pour plus de détails, consultez votre documentation système sur la fonction tmpfile(3), et sur stdio.h.

78

bool touch ( string $filename [, int $time = time() [, int $atime ]] )

Tente de forcer la date de modification du fichier désigné par le paramètre filename à la date de spécifiée par le paramètre time. Notez bien que la date de dernier accès est modifiée, quelque soit le nombre de paramètres.

Si le fichier n'existe pas, PHP tentera de le créer.

79

int umask ([ int $mask ] )

umask() change le umask de PHP et le remplace par mask : mask & 0777 puis, retourne le vieux umask. Lorsque PHP est utilisé comme module de serveur, le umask reprend sa valeur à la fin de chaque script.

80

bool unlink ( string $filename [, resource $context ] )

Efface filename. Identique à la fonction Unix C unlink(). En cas d'échec, une alerte de niveau E_WARNING sera générée.