(PHP 5)
file_put_contents — Ecrit une chaîne dans un fichier
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() .
Le nom du fichier où l'on doit écrire les données
Les données à écrire. Peut être soit une chaîne de caractères , un tableau ou une ressource de flux (explication plus bas).
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.
Une ressource de contexte
La fonction retourne le nombre d'octets écrits dans le fichier ou FALSE si une erreur survient.
| 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 |
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 Annexe O, Liste des protocoles supportés pour une liste des protocoles URL supportés.
| fopen() |
| fwrite() |
| file_get_contents() |
| stream_context_create() |