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]] )

file_put_contents() revient à appeler successivement fopen() avec le paramètre filename, flags et, éventuellement, context, fwrite() avec les données data, et fclose().

Le paramètre flags peut valoir FILE_USE_INCLUDE_PATH et/ou FILE_APPEND, mais FILE_USE_INCLUDE_PATH doit être utilisé avec prudence.

Vous pouvez aussi spécifier data comme un tableau. Cela revient alors à : 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().

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

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 L pour une liste des protocoles URL supportés.

Voir aussi fopen(), fwrite(), fclose() et file_get_contents().