file_put_contents
(PHP 5)
file_put_contents — Ecrit une chaîne dans un fichier
Description
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.
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.