file_put_contents

(PHP 5)

file_put_contents -- Write a string to a file

Description

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

Parameters

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

Return Values

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

ChangeLog

VersionDescription
5.1.0 Added support for LOCK_EX and the ability to pass a stream resource to the data parameter

Notes

Óçìåßùóç: Αυτή η συνάρτηση είναι binary-safe.

Óçìåßùóç: Context support was added with PHP 5.0.0. For a description of contexts, refer to ÁíáöïñÜ CXLVIII, Stream Functions.

Õðüäåéîç: Μπορείτε να χρησιμοποιήσετε ένα URL σαν ένα όνομα αρχείου με αυτή τη συνάρτηση αν τα fopen wrappers έχουν ενεργοποιηθεί. Δείτε την fopen() για πιο πολλές λεπτομέρειες στο πώς να ορίσετε το όνομα του αρχείου και για ένα ÐáñÜñôçìá M κατάλογο των υποστηριζόμενων URL προτοκόλλων.

Δείτε επίσης

fopen()
fwrite()
file_get_contents()