file_put_contents

(PHP 5)

file_put_contents -- Write a string to a file

Leírás

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

Paraméterek

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

Visszatérési értékek

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

Változások naplója

VáltozatLeírás
5.1.0 Added support for LOCK_EX and the ability to pass a stream resource to the data parameter

Megjegyzések

Megjegyzés: Ez a függvény "binary-safe", azaz helyesen kezeli a 127-es ASCII kód feletti karaktereket is.

Megjegyzés: A context támogatása a PHP 5.0.0 változattól felfele érhető el. A conext-ek leírását itt találod: CL, Stream Functions Referencia .

Tipp: URL-t is megadhatsz az állomány név paraméter helyén ha a fopen wrappers szolgáltatás be van kapcsolva. Bővebb információk az fopen() leírásánál olvashatóak arról, milyen módon adhatod meg a fájlneveket, valamint érdemes megtekinteni a M Függelék oldalt a támogatott URL típusok listájának megtekintése gyanánt.

Lásd még

fopen()
fwrite()
file_get_contents()