PHP Handbuch
Zurück |  | Weiter

# file_put_contents

(PHP 5)

file_put_contents -- Write a string to a file

## Beschreibung

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, implode('', $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().

## Parameter Liste

`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

## Rückgabewerte

The function returns the amount of bytes that were written to the file, or `FALSE` on failure.

## ChangeLog

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

## Anmerkungen

> Anmerkung: Diese Funktion ist binary safe.

> Anmerkung: Die Kontext-Unterstützung gibt es seit PHP 5.0.0. Eine Beschreibung von `Kontexten` finden Sie unter Verweis CLX, Stream Functions.

> Tipp: Mit dieser Funktion können Sie eine URL als Dateinamen verwenden, falls Sie fopen wrappers ermöglicht haben. Mehr Details dazu, wie Sie den Dateinamen angeben müssen finden Sie bei fopen(). Eine Liste der unterstützten URL Protokolle finden Sie unter Anhang N.

## Siehe auch

fopen()
fwrite()
file_get_contents()
stream_context_create()

Zurück | Zum Anfang | Weiter
file_get_contents | Nach oben | file