WP_Filesystem_SSH2::sftp_path( string $path )

Gets the ssh2.sftp PHP stream wrapper path to open for the given file.

Description

This method also works around a PHP bug where the root directory (/) cannot be opened by PHP functions, causing a false failure. In order to work around this, the path is converted to /./ which is semantically the same as / See https://bugs.php.net/bug.php?id=64169 for more details.

Parameters

$path

(string) (Required) The File/Directory path on the remote server to return

Return

(string) The ssh2.sftp:// wrapped path to use.

Source

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

public function sftp_path( $path ) {
		if ( '/' === $path ) {
			$path = '/./';
		}

		return 'ssh2.sftp://' . $this->sftp_link . '/' . ltrim( $path, '/' );
	}

Changelog

Version Description
4.4.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_filesystem_ssh2/sftp_path