WP_Filesystem()WP 2.5.0

Initializes and connects the WordPress Filesystem Abstraction classes.

This function will include the chosen transport and attempt connecting.

Plugins may add extra transports, And force WordPress to use them by returning the filename via the filesystem_method_file filter.

1 time — 0.001446 sec (very slow) | 50000 times — 4.11 sec (fast)
Hooks from the function

Return

true|false|null. True on success, false on failure, null if the filesystem method class file does not exist.

Usage

WP_Filesystem( $args, $context, $allow_relaxed_file_ownership ) // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid;
$args(array|false)
Connection args, These are passed directly to the WP_Filesystem_*() classes.
Default: false
$context(string|false)
Context for get_filesystem_method().
Default: false
$allow_relaxed_file_ownership(true|false)
Whether to allow Group/World writable.
Default: false

Examples

0

#1 Using the wp_filesystem

global $wp_filesystem;

// create a file interaction object, if it is not already created
if( ! $wp_filesystem ){
	require_once ABSPATH . 'wp-admin/includes/file.php';
	WP_Filesystem();
} 

// use the object
echo $wp_filesystem->abspath(); //  /home/www/example.com/public_html/

$wp_filesystem->delete( $maintenance_file );
$wp_filesystem->put_contents( $maintenance_file, $maintenance_string );
// etc.

A list of useful methods:

0

#2 Each call creates a new instance

Each call to WP_Filesystem() overwrites the variable global $wp_filesystem;. So it may be a good idea to check if the object has already been created before calling this function.

require_once ABSPATH . 'wp-admin/includes/file.php';

global $wp_filesystem;

// base init
WP_Filesystem();
echo get_class( $wp_filesystem ); // WP_Filesystem_Direct

// call one more time
define( 'FS_METHOD', 'ssh2' );
WP_Filesystem();
echo get_class( $wp_filesystem ); // WP_Filesystem_SSH2

Notes

  • Global. WP_Filesystem_Base. $wp_filesystem WordPress filesystem subclass.

Changelog

Since 2.5.0 Introduced.

WP_Filesystem() code WP 6.1.1

function WP_Filesystem( $args = false, $context = false, $allow_relaxed_file_ownership = false ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
	global $wp_filesystem;

	require_once ABSPATH . 'wp-admin/includes/class-wp-filesystem-base.php';

	$method = get_filesystem_method( $args, $context, $allow_relaxed_file_ownership );

	if ( ! $method ) {
		return false;
	}

	if ( ! class_exists( "WP_Filesystem_$method" ) ) {

		/**
		 * Filters the path for a specific filesystem method class file.
		 *
		 * @since 2.6.0
		 *
		 * @see get_filesystem_method()
		 *
		 * @param string $path   Path to the specific filesystem method class file.
		 * @param string $method The filesystem method to use.
		 */
		$abstraction_file = apply_filters( 'filesystem_method_file', ABSPATH . 'wp-admin/includes/class-wp-filesystem-' . $method . '.php', $method );

		if ( ! file_exists( $abstraction_file ) ) {
			return;
		}

		require_once $abstraction_file;
	}
	$method = "WP_Filesystem_$method";

	$wp_filesystem = new $method( $args );

	/*
	 * Define the timeouts for the connections. Only available after the constructor is called
	 * to allow for per-transport overriding of the default.
	 */
	if ( ! defined( 'FS_CONNECT_TIMEOUT' ) ) {
		define( 'FS_CONNECT_TIMEOUT', 30 ); // 30 seconds.
	}
	if ( ! defined( 'FS_TIMEOUT' ) ) {
		define( 'FS_TIMEOUT', 30 ); // 30 seconds.
	}

	if ( is_wp_error( $wp_filesystem->errors ) && $wp_filesystem->errors->has_errors() ) {
		return false;
	}

	if ( ! $wp_filesystem->connect() ) {
		return false; // There was an error connecting to the server.
	}

	// Set the permission constants if not already set.
	if ( ! defined( 'FS_CHMOD_DIR' ) ) {
		define( 'FS_CHMOD_DIR', ( fileperms( ABSPATH ) & 0777 | 0755 ) );
	}
	if ( ! defined( 'FS_CHMOD_FILE' ) ) {
		define( 'FS_CHMOD_FILE', ( fileperms( ABSPATH . 'index.php' ) & 0777 | 0644 ) );
	}

	return true;
}