Manuel PHP
Précédent		Suivant

file_put_contents

(PHP 5)

file_put_contents -- Ecrit une chaîne dans un fichier

Description

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

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

Vous pouvez également spécifier le paramètre data sous forme de tableau (tableau non multi-dimensionnel). C'est l'équivalent à file_put_contents($filename, join('', $array)).

Depuis PHP 5.1.0, vous pouvez également passer un flux au paramètre data. Ainsi, le buffer restant de ce flux sera copié dans le fichier spécifié. Ce comportement revient à utiliser la fonction stream_copy_to_stream().

Liste de paramètres

filename: Le nom du fichier où l'on doit écrire les données
data: Les données à écrire. Peut être soit une chaîne de caractères, un tableau ou une ressource de flux (explication plus bas).
flags: flags peut prendre FILE_USE_INCLUDE_PATH, FILE_APPEND et/ou LOCK_EX (acquière un verrou exclusif), cependant, l'option FILE_USE_INCLUDE_PATH doit être utilisée avec précaution.
context: Une ressource de contexte

Valeurs de retour

La fonction retourne le nombre d'octets écrit dans le fichier.

Historique

Version	Description
5.1.0	Ajout du support de `LOCK_EX` et la possibilité de passer une ressource de flux dans le paramètre `data`

Notes

Note : Cette fonction gère les chaînes binaires.

Note : Le support de contexte a été ajouté en PHP 5.0.0. Pour une description des contexts, référez-vous à Référence CXL, Flux.

Astuce : Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si l'option des "fopen wrappers" a été activée. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier et Annexe M pour une liste des protocoles URL supportés.

Voir aussi

fopen()

fwrite()

file_get_contents()

Précédent	Sommaire	Suivant
file_get_contents	Niveau supérieur	file

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:05