file_put_contentsWrite data to a file
&reftitle.description;
intfile_put_contentsstringfilenamemixeddataintflags0resourcecontext
This function is identical to calling fopen,
fwrite and fclose successively
to write data to a file.
If filename does not exist, the file is created.
Otherwise, the existing file is overwritten, unless the
FILE_APPEND flag is set.
&reftitle.parameters;
filename
Path to the file where to write the data.
data
The data to write. Can be either a string, an
array or a stream resource.
If data is a stream resource, the
remaining buffer of that stream will be copied to the specified file.
This is similar with using stream_copy_to_stream.
You can also specify the data parameter as a single
dimension array. This is equivalent to
file_put_contents($filename, implode('', $array)).
flags
The value of flags can be any combination of
the following flags, joined with the binary OR (|)
operator.
Available flagsFlagDescriptionFILE_USE_INCLUDE_PATH
Search for filename in the include directory.
See include_path for more
information.
FILE_APPEND
If file filename already exists, append
the data to the file instead of overwriting it.
LOCK_EX
Acquire an exclusive lock on the file while proceeding to the
writing. In other words, a flock call happens
between the fopen call and the
fwrite call. This is not identical to an
fopen call with mode "x".
context
A valid context resource created with
stream_context_create.
&reftitle.returnvalues;
This function returns the number of bytes that were written to the file, or
&false; on failure.
&return.falseproblem;
&reftitle.examples;
Simple usage example
]]>
Using flags
]]>
&reftitle.changelog;
&Version;&Description;5.1.0
Added support for LOCK_EX and the ability to pass
a stream resource to the data parameter
&reftitle.notes;
¬e.bin-safe;
&tip.fopen-wrapper;
&reftitle.seealso;
fopenfwritefile_get_contentsstream_context_create