WordPress Version: 5.7
/**
* Copies a directory from one location to another via the WordPress Filesystem Abstraction.
*
* Assumes that WP_Filesystem() has already been called and setup.
*
* This is a standalone copy of the `copy_dir()` function that is used to
* upgrade the core files. It is placed here so that the version of this
* function from the *new* WordPress version will be called.
*
* It was initially added for the 3.1 -> 3.2 upgrade.
*
* @ignore
* @since 3.2.0
* @since 3.7.0 Updated not to use a regular expression for the skip list.
*
* @see copy_dir()
* @link https://core.trac.wordpress.org/ticket/17173
*
* @global WP_Filesystem_Base $wp_filesystem
*
* @param string $from Source directory.
* @param string $to Destination directory.
* @param string[] $skip_list Array of files/folders to skip copying.
* @return true|WP_Error True on success, WP_Error on failure.
*/
function _copy_dir($from, $to, $skip_list = array())
{
global $wp_filesystem;
$dirlist = $wp_filesystem->dirlist($from);
if (false === $dirlist) {
return new WP_Error('dirlist_failed__copy_dir', __('Directory listing failed.'), basename($to));
}
$from = trailingslashit($from);
$to = trailingslashit($to);
foreach ((array) $dirlist as $filename => $fileinfo) {
if (in_array($filename, $skip_list, true)) {
continue;
}
if ('f' === $fileinfo['type']) {
if (!$wp_filesystem->copy($from . $filename, $to . $filename, true, FS_CHMOD_FILE)) {
// If copy failed, chmod file to 0644 and try again.
$wp_filesystem->chmod($to . $filename, FS_CHMOD_FILE);
if (!$wp_filesystem->copy($from . $filename, $to . $filename, true, FS_CHMOD_FILE)) {
return new WP_Error('copy_failed__copy_dir', __('Could not copy file.'), $to . $filename);
}
}
/*
* `wp_opcache_invalidate()` only exists in WordPress 5.5 or later,
* so don't run it when upgrading from older versions.
*/
if (function_exists('wp_opcache_invalidate')) {
wp_opcache_invalidate($to . $filename);
}
} elseif ('d' === $fileinfo['type']) {
if (!$wp_filesystem->is_dir($to . $filename)) {
if (!$wp_filesystem->mkdir($to . $filename, FS_CHMOD_DIR)) {
return new WP_Error('mkdir_failed__copy_dir', __('Could not create directory.'), $to . $filename);
}
}
/*
* Generate the $sub_skip_list for the subdirectory as a sub-set
* of the existing $skip_list.
*/
$sub_skip_list = array();
foreach ($skip_list as $skip_item) {
if (0 === strpos($skip_item, $filename . '/')) {
$sub_skip_list[] = preg_replace('!^' . preg_quote($filename, '!') . '/!i', '', $skip_item);
}
}
$result = _copy_dir($from . $filename, $to . $filename, $sub_skip_list);
if (is_wp_error($result)) {
return $result;
}
}
}
return true;
}