W3Schools.com

PHP file_put_contents() Function

PHP Filesystem Reference Complete PHP Filesystem Reference

Definition and Usage

The file_put_contents() writes a string to a file.

This function follows these rules when accessing a file:

  1. If FILE_USE_INCLUDE_PATH is set, check the include path for a copy of *filename*
  2. Create the file if it does not exist
  3. Open the file
  4. Lock the file if LOCK_EX is set
  5. If FILE_APPEND is set, move to the end of the file. Otherwise, clear the file content
  6. Write the data into the file
  7. Close the file and release any locks

This function returns the number of character written into the file on success, or FALSE on failure.

Syntax

file_put_contents(file,data,mode,context)

Parameter Description
file Required. Specifies the file to write to. If the file does not exist, this function will create one
data Required. The data to write to the file. Can be a string, an array or a data stream
mode Optional. Specifies how to open/write to the file. Possible values:
  • FILE_USE_INCLUDE_PATH
  • FILE_APPEND
  • LOCK_EX
context Optional. Specifies the context of the file handle. Context is a set of options that can modify the behavior of a stream.

Tips and Notes

Note: Use FILE_APPEND to avoid deleting the existing content of the file.

Example

<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>

The output of the code above will be:

21

PHP Filesystem Reference Complete PHP Filesystem Reference
WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Best Hosting Coupons
UK Reseller Hosting
Cloud Hosting
Top Web Hosting
$3.98 Unlimited Hosting
Premium Website Design
WEB BUILDING
Download XML Editor
FREE Website BUILDER
Best Website Templates Top CSS Templates
CREATE HTML Websites
EASY WEBSITE BUILDER
W3SCHOOLS EXAMS
Get Certified in:
HTML, CSS, JavaScript, XML, PHP, and ASP
W3SCHOOLS BOOKS
New Books:
HTML, CSS
JavaScript, and Ajax
STATISTICS
Browser Statistics
Browser OS
Browser Display
SHARE THIS PAGE