get_filesystem_method()
最后更新于:2021-11-26 09:09:27
get_filesystem_method( array$args=array(), string$context=”, bool$allow_relaxed_file_ownership=false)Determines which method to use for reading, writing, modifying, or deleting files on the filesystem.
参数
- $args
-
(array) (Optional) Connection details.
Default value: array()
- $context
-
(string) (Optional) Full path to the directory that is tested for being writable.
Default value: ”
- $allow_relaxed_file_ownership
-
(bool) (Optional) Whether to allow Group/World writable.
Default value: false
响应
(string) The transport to use, see description for valid return values.
源文件
文件: gc-admin/includes/file.php
function get_filesystem_method( $args = array(), $context = '', $allow_relaxed_file_ownership = false ) {
// Please ensure that this is either 'direct', 'ssh2', 'ftpext', or 'ftpsockets'.
$method = defined( 'FS_METHOD' ) ? FS_METHOD : false;
if ( ! $context ) {
$context = GC_CONTENT_DIR;
}
// If the directory doesn't exist (gc-content/languages) then use the parent directory as we'll create it.
if ( GC_LANG_DIR === $context && ! is_dir( $context ) ) {
$context = dirname( $context );
}
$context = trailingslashit( $context );
if ( ! $method ) {
$temp_file_name = $context . 'temp-write-test-' . str_replace( '.', '-', uniqid( '', true ) );
$temp_handle = @fopen( $temp_file_name, 'w' );
if ( $temp_handle ) {
// Attempt to determine the file owner of the GeChiUI files, and that of newly created files.
$gc_file_owner = false;
$temp_file_owner = false;
if ( function_exists( 'fileowner' ) ) {
$gc_file_owner = @fileowner( __FILE__ );
$temp_file_owner = @fileowner( $temp_file_name );
}
if ( false !== $gc_file_owner && $gc_file_owner === $temp_file_owner ) {
/*
* GeChiUI is creating files as the same owner as the GeChiUI files,
* this means it's safe to modify & create new files via PHP.
*/
$method = 'direct';
$GLOBALS['_gc_filesystem_direct_method'] = 'file_owner';
} elseif ( $allow_relaxed_file_ownership ) {
/*
* The $context directory is writable, and $allow_relaxed_file_ownership is set,
* this means we can modify files safely in this directory.
* This mode doesn't create new files, only alter existing ones.
*/
$method = 'direct';
$GLOBALS['_gc_filesystem_direct_method'] = 'relaxed_ownership';
}
fclose( $temp_handle );
@unlink( $temp_file_name );
}
}
if ( ! $method && isset( $args['connection_type'] ) && 'ssh' === $args['connection_type'] && extension_loaded( 'ssh2' ) ) {
$method = 'ssh2';
}
if ( ! $method && extension_loaded( 'ftp' ) ) {
$method = 'ftpext';
}
if ( ! $method && ( extension_loaded( 'sockets' ) || function_exists( 'fsockopen' ) ) ) {
$method = 'ftpsockets'; // Sockets: Socket extension; PHP Mode: FSockopen / fwrite / fread.
}
/**
* Filters the filesystem method to use.
*
* @since 2.6.0
*
* @param string $method Filesystem method to return.
* @param array $args An array of connection details for the method.
* @param string $context Full path to the directory that is tested for being writable.
* @param bool $allow_relaxed_file_ownership Whether to allow Group/World writable.
*/
return apply_filters( 'filesystem_method', $method, $args, $context, $allow_relaxed_file_ownership );
}