Podręcznik PHP
Poprzedni |  | Następny

# file_put_contents

(PHP 5)

file_put_contents -- Write a string to a file

## Opis

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

## Parametry

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

## Zwracane wartości

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

## Rejestr zmian

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

## Notatki

> Notatka: Ta funkcja jest bezpieczna dla danych binarnych.

> Notatka: Wsparcie dla kontekstów zostało dodane w PHP 5.0.0. Opis kontekstów znajduje się w rozdziale Materiały źródłowe CL, Stream Functions.

> Podpowiedź: Jeśli włączona jest dyrektywa konfiguracyjna fopen wrappers, możliwe jest podanie jako nazwy pliku adresu URL. Zobacz opis funkcji fopen() aby dowiedzieć się jak przekazać nazwę pliku, oraz fopen wrappers aby uzyskać listę obsługiwanych protokołów.

## Patrz także

fopen()
fwrite()
file_get_contents()

Poprzedni | Spis treści | Następny
file_get_contents | Początek rozdziału | file