FILE_PUT_CONTENTS |
Fichier : Mettre le contenu |
---|---|
PHP 5.0+ |
Syntaxe
function file_put_contents($filename, $data); |
function file_put_contents($filename, $data, $flags); |
function file_put_contents($filename, $data, $flags, $context); |
Paramètres
Nom | Description | |
---|---|---|
$filename | Ce paramètre permet d'indiquer le nom du fichier dans lequel il faut écrire le contenu. | |
$data | Ce paramètre permet d'indiquer les données à écrire : une chaîne de caractères, un tableau, une ressource de flux,... | |
$flags | Ce paramètre permet d'indiquer les options d'écrire (lequel peuvent être combiné par un «OU BINAIRE»). | |
Constante | Description | |
FILE_USE_INCLUDE_PATH | Cette constante permet d'indiquer que la recherche du fichier s'effectuer également dans le dossier d'inclusion. | |
FILE_APPEND | Cette constante permet d'indiquer qu'il faut rajouter les données à la fin du fichier si le fichier existe déjà. | |
LOCK_EX | Cette constante permet d'indiquer que durant l'opération d'écriture, il faut utilisé un verrou exclusif interdisant un accès aux autres processus. | |
$context | Ce paramètre permet d'indiquer la ressource de contexte valide. |
Retour
Valeur | Description |
---|---|
FALSE | Cette valeur permet d'indiquer qu'une erreur est survenu. |
entier | Ces valeurs permettent d'indiquer le nombre d'octets ayant été écrit dans le fichier. |
Description
Cette fonction permet d'effectuer l'écriture du contenu d'une chaîne de caractères ou de données variables dans un fichier.
Remarques
- Si vous avez un message d'erreur comme ceci «PHP Warning: file_put_contents( ... ): failed to open stream: Permission denied in ...», c'est que vous n'avez pas le droit de lire et/ou d'écrire si le fichier spécifié, probablement a cause de droit d'accès insuffisant.
- La constante «LOCK_EX» est uniquement disponible à partir de la version 5.1.0 de PHP. De plus, la possibilité de passer une ressource de flux de données dans le paramètre $data est uniquement disponible à partir de la version 5.1.0 de PHP.
Exemple
L'exemple suivant permet d'écrire dans le fichier «gladir.com» une chaîne de caractères «CECI EST UN EXEMPLE ECRIT DANS GLADIR.COM» :
- <?php
- file_put_contents('gladir.com', 'CECI EST UN EXEMPLE ECRIT DANS GLADIR.COM');
- ?>
Voir également
Langage de programmation - PHP - Référence de procédures et fonctions - file_get_contents
Langage de programmation - PHP - Référence de procédures et fonctions - fopen
Langage de programmation - PHP - Référence de procédures et fonctions - fwrite
Dernière mise à jour : Vendredi, le 3 avril 2015