Manuel PHP
Précédent |  | Suivant

# 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, 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().

## 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 écrit dans le fichier.

## 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 à Référence CXLVIII, Flux.

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

## Voir aussi

fopen()
fwrite()
file_get_contents()

Précédent | Sommaire | Suivant
file_get_contents | Niveau supérieur | file