Forum und email

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 à Flux.

Tip

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