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

VersionDescription
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()

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