Table :

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

file_put_contents

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, implode('', $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 écrits dans le fichier ou FALSE si une erreur survient.

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 CLVIII, 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()

stream_context_create()

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

Annonces

Retour au chapitre Php