WP_Filesystem_Direct::put_contents( string $file, string $contents, int|false $mode = false )

Writes a string to a file.

Parameters Parameters


(string) (Required) Remote path to the file where to write the data.


(string) (Required) The data to write.


(int|false) (Optional) The file permissions as octal number, usually 0644.

Default value: false

Top ↑

Return Return

(bool) True on success, false on failure.

Top ↑

Source Source

File: wp-admin/includes/class-wp-filesystem-direct.php

	public function put_contents( $file, $contents, $mode = false ) {
		$fp = @fopen( $file, 'wb' );

		if ( ! $fp ) {
			return false;


		$data_length = strlen( $contents );

		$bytes_written = fwrite( $fp, $contents );


		fclose( $fp );

		if ( $data_length !== $bytes_written ) {
			return false;

		$this->chmod( $file, $mode );

		return true;

Top ↑

Changelog Changelog

Version Description
2.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.