int file_put_contents ( string $filename, mixed $data [, int $flags [, resource $context]] );

Definition and Usage

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 flags is set.


filenamePath to the file where to write the data.
dataThe data to write. Can be either a string, an array or a stream resource
flagsThe value of flags can be any combination of the following flags (with some restrictions), joined with the binary OR (|) operator.
  • FILE_USE_INCLUDE_PATH: Search for filename in the include directory.
  • 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.
  • FILE_TEXT: data is written in text mode. This flag cannot be used with FILE_BINARY. This flag is only available since PHP 6.
  • FILE_BINARY: data will be written in binary mode. This is the default setting and cannot be used with FILE_TEXT. This flag is only available since PHP 6.
contextA valid context resource created with stream_context_create().

Return Value

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


Following is the usage of this function:

// Copy input file into output file.

$inputFile = "/home/httpd/inputFile.txt";
$outputFile = "/home/httpd/outputFile.txt";
$fi = fopen($inputFile, 'r');
$source = '';
while (!feof($fi)) {
   $source .= fgets($fi);

Post a Comment