Manuale PHP
Indietro |  | Avanti

# file_put_contents

(PHP 5)

file_put_contents -- Write a string to a file

## Descrizione

int file_put_contents ( string filename, mixed data [, int flags [, resource context]] )

Identical to calling fopen(), fwrite(), and fclose() successively.

You can also specify the data parameter as an array (not multi-dimension arrays). This is equivalent to file_put_contents($filename, join('', $array)).

As of PHP 5.1.0, you may also pass a stream resource to the data parameter. In result, the remaining buffer of that stream will be copied to the specified file. This is similar with using stream_copy_to_stream().

## Elenco dei parametri

filename

  The file name where to write the data

data

  The data to write. Can be either a string, an array or a stream resource (explained above).

flags

  flags can take `FILE_USE_INCLUDE_PATH`, `FILE_APPEND` and/or `LOCK_EX` (acquire an exclusive lock), however the `FILE_USE_INCLUDE_PATH` option should be used with caution.

context

  A context resource

## Valori restituiti

The function returns the amount of bytes that were written to the file.

## Log delle modifiche

Versione | Descrizione
--- | ---
5.1.0 | Added support for `LOCK_EX` and the ability to pass a stream resource to the data parameter

## Note

> Nota: Questa funzione è binary-safe (gestisce correttamente i file binari)

> Nota: Il supporto per il contesto è stato aggiunto in PHP 5.0.0. Per la descrizione del contesto, fare riferimento a Riferimento CXLIV, Stream Functions.

> Suggerimento: È possibile utilizzare una URL come un nome di file con questa funzione se fopen wrappers è stata abilitata. Per maggiori informazioni su come specificare i nomi di file vedere fopen() e Appendice M per avere la lista dei protocolli URL supportati.

## Vedere anche:

fopen()
fwrite()
file_get_contents()

Indietro | Partenza | Avanti
file_get_contents | Risali | file