Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2026-04-03 17:53
📄 SECURITY.md If you believe that you have found a security issue associated with the current release of this plugin, then please report it to the email address with local part security-reports-only and the domain updraftplus.com. If receipt of the email is not acknowledged within 3 working days, then you can try again and also use the inquiry form on the plugin's website. Do not send emails on any other subject to this address. They will not be acknowledged, regardless of whether they contain pleas to do otherwise; there are inquiry forms and support forums available which are linked within the plugin and easy to find on the plugin website. Please include as much of the information listed below as you can to help us better understand and resolve the issue: * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.) * Affected version(s) * Impact of the issue, including how an attacker might exploit the issue * Step-by-step instructions to reproduce the issue * The location of the affected code * Full paths of source file(s) related to the manifestation of the issue * Any special configuration required to reproduce the issue * Any log files that are related to this issue (if possible) * Proof-of-concept or exploit code (if possible) This information will help us triage your report more quickly. Thank you!	1.33 KB	2025-10-09 08:53
📄 admin.php <?php if (!defined('UPDRAFTPLUS_DIR')) die('No direct access allowed'); // Admin-area code lives here. This gets called in admin_menu, earlier than admin_init global $updraftplus_admin; if (!is_a($updraftplus_admin, 'UpdraftPlus_Admin')) $updraftplus_admin = new UpdraftPlus_Admin(); class UpdraftPlus_Admin { public $logged = array(); private $template_directories; private $backups_instance_ids; private $auth_instance_ids = array('dropbox' => array(), 'pcloud' => array(), 'onedrive' => array(), 'googledrive' => array(), 'googlecloud' => array()); private $clone_php_versions = array('5.4', '5.5', '5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3', '8.4'); private $storage_service_without_settings; private $storage_service_with_partial_settings; private $storage_service_without_addons_settings; private $storage_module_option_errors = ''; private $no_settings_warning = false; private $restore_in_progress_jobdata = array(); private $entities_to_restore = array(); /** * Constructor / public function __construct() { $this->admin_init(); } /* * Get the path to the UI templates directory * * @return String - a filesystem directory path / public function get_templates_dir() { return apply_filters('updraftplus_templates_dir', UpdraftPlus_Manipulation_Functions::wp_normalize_path(UPDRAFTPLUS_DIR.'/templates')); } /* * Initialises self::$template_directories / private function register_template_directories() { $template_directories = array(); $templates_dir = $this->get_templates_dir(); if ($dh = opendir($templates_dir)) { while (($file = readdir($dh)) !== false) { if ('.' == $file \|\| '..' == $file) continue; if (is_dir($templates_dir.'/'.$file)) { $template_directories[$file] = $templates_dir.'/'.$file; } } closedir($dh); } // This is the optimal hook for most extensions to hook into $this->template_directories = apply_filters('updraftplus_template_directories', $template_directories); } /* * Output, or return, the results of running a template (from the 'templates' directory, unless a filter over-rides it). Templates are run with $updraftplus, $updraftplus_admin and $wpdb set. * * @param String $path - path to the template * @param Boolean $return_instead_of_echo - by default, the template is echo-ed; set this to instead return it * @param Array $extract_these - variables to inject into the template's run context * * @return Void\|String / public function include_template($path, $return_instead_of_echo = false, $extract_these = array()) { if ($return_instead_of_echo) ob_start(); if (preg_match('#^([^/]+)/(.)$#', $path, $matches)) { $prefix = $matches[1]; $suffix = $matches[2]; if (isset($this->template_directories[$prefix])) { $template_file = $this->template_directories[$prefix].'/'.$suffix; } } if (!isset($template_file)) $template_file = UPDRAFTPLUS_DIR.'/templates/'.$path; $template_file = apply_filters('updraftplus_template', $template_file, $path); do_action('updraftplus_before_template', $path, $template_file, $return_instead_of_echo, $extract_these); if (!file_exists($template_file)) { error_log("UpdraftPlus: template not found: $template_file"); echo esc_html(__('Error:', 'updraftplus').' '.__('template not found', 'updraftplus').' ('.$path.')'); } else { extract($extract_these); global $updraftplus, $wpdb;// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Passed though to template file. $updraftplus_admin = $this;// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Passed though to template file. include $template_file; } do_action('updraftplus_after_template', $path, $template_file, $return_instead_of_echo, $extract_these); if ($return_instead_of_echo) return ob_get_clean(); } /** * Add actions for any needed dashboard notices for remote storage services * * @param String\|Array $services - a list of services, or single service / private function setup_all_admin_notices_global($services) { global $updraftplus; if ('googledrive' === $services \|\| (is_array($services) && in_array('googledrive', $services))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('googledrive'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "Google Drive (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $instance_id => $storage_options) { if ((defined('UPDRAFTPLUS_CUSTOM_GOOGLEDRIVE_APP') && UPDRAFTPLUS_CUSTOM_GOOGLEDRIVE_APP) \|\| !empty($storage_options['clientid'])) { if (!empty($storage_options['clientid'])) { $clientid = $storage_options['clientid']; $token = empty($storage_options['token']) ? '' : $storage_options['token']; } if (!empty($clientid) && '' == $token) { if (!in_array($instance_id, $this->auth_instance_ids['googledrive'])) $this->auth_instance_ids['googledrive'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_googledrive'))) add_action('all_admin_notices', array($this, 'show_admin_warning_googledrive')); } unset($clientid); unset($token); } else { if (empty($storage_options['user_id'])) { if (!in_array($instance_id, $this->auth_instance_ids['googledrive'])) $this->auth_instance_ids['googledrive'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_googledrive'))) add_action('all_admin_notices', array($this, 'show_admin_warning_googledrive')); } } } } } if ('googlecloud' === $services \|\| (is_array($services) && in_array('googlecloud', $services))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('googlecloud'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "Google Cloud (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $instance_id => $storage_options) { if ((defined('UPDRAFTPLUS_CUSTOM_GOOGLECLOUD_APP') && UPDRAFTPLUS_CUSTOM_GOOGLECLOUD_APP) \|\| !empty($storage_options['clientid'])) { $clientid = $storage_options['clientid']; $token = (empty($storage_options['token'])) ? '' : $storage_options['token']; if (!empty($clientid) && empty($token)) { if (!in_array($instance_id, $this->auth_instance_ids['googlecloud'])) $this->auth_instance_ids['googlecloud'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_googlecloud'))) add_action('all_admin_notices', array($this, 'show_admin_warning_googlecloud')); } } else { if (empty($storage_options['user_id'])) { if (!in_array($instance_id, $this->auth_instance_ids['googlecloud'])) $this->auth_instance_ids['googlecloud'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_googlecloud'))) add_action('all_admin_notices', array($this, 'show_admin_warning_googlecloud')); } } } } } if ('dropbox' === $services \|\| (is_array($services) && in_array('dropbox', $services))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('dropbox'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "Dropbox (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $instance_id => $storage_options) { if (empty($storage_options['tk_access_token'])) { if (!in_array($instance_id, $this->auth_instance_ids['dropbox'])) $this->auth_instance_ids['dropbox'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_dropbox'))) add_action('all_admin_notices', array($this, 'show_admin_warning_dropbox')); } } } } if ('pcloud' === $services \|\| (is_array($services) && in_array('pcloud', $services))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('pcloud'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "pCloud (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $instance_id => $storage_options) { if (empty($storage_options['pclauth'])) { if (!in_array($instance_id, $this->auth_instance_ids['pcloud'])) $this->auth_instance_ids['pcloud'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_pcloud'))) add_action('all_admin_notices', array($this, 'show_admin_warning_pcloud')); } } } } if ('onedrive' === $services \|\| (is_array($services) && in_array('onedrive', $services))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('onedrive'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "OneDrive (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $instance_id => $storage_options) { if ((defined('UPDRAFTPLUS_CUSTOM_ONEDRIVE_APP') && UPDRAFTPLUS_CUSTOM_ONEDRIVE_APP)) { if (!empty($storage_options['clientid']) && !empty($storage_options['secret']) && empty($storage_options['refresh_token'])) { if (!in_array($instance_id, $this->auth_instance_ids['onedrive'])) $this->auth_instance_ids['onedrive'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_onedrive'))) add_action('all_admin_notices', array($this, 'show_admin_warning_onedrive')); } elseif (empty($storage_options['refresh_token'])) { if (!in_array($instance_id, $this->auth_instance_ids['onedrive'])) $this->auth_instance_ids['onedrive'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_onedrive'))) add_action('all_admin_notices', array($this, 'show_admin_warning_onedrive')); } } else { if (empty($storage_options['refresh_token'])) { if (!in_array($instance_id, $this->auth_instance_ids['onedrive'])) $this->auth_instance_ids['onedrive'][] = $instance_id; if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_onedrive'))) add_action('all_admin_notices', array($this, 'show_admin_warning_onedrive')); } } if (isset($storage_options['endpoint_tld']) && 'de' === $storage_options['endpoint_tld']) { if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_onedrive_germany'))) add_action('all_admin_notices', array($this, 'show_admin_warning_onedrive_germany')); } } } } if ('azure' === $services \|\| (is_array($services) && in_array('azure', $services))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('azure'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "Azure (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $instance_id => $storage_options) { if (isset($storage_options['endpoint']) && 'blob.core.cloudapi.de' === $storage_options['endpoint']) { if (false === has_action('all_admin_notices', array($this, 'show_admin_warning_azure_germany'))) add_action('all_admin_notices', array($this, 'show_admin_warning_azure_germany')); } } } } if ('updraftvault' === $services \|\| (is_array($services) && in_array('updraftvault', $services))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('updraftvault'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "UpdraftVault (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $instance_id => $storage_options) { if (empty($storage_options['token']) && empty($storage_options['email'])) { add_action('all_admin_notices', array($this, 'show_admin_warning_updraftvault')); } } } } if ($this->disk_space_check(104857635) === false) add_action('all_admin_notices', array($this, 'show_admin_warning_diskspace')); $all_services = UpdraftPlus_Storage_Methods_Interface::get_enabled_storage_objects_and_ids($updraftplus->get_canonical_service_list()); $this->storage_service_without_settings = array(); $this->storage_service_with_partial_settings = array(); $this->storage_service_without_addons_settings = array(); foreach ($all_services as $method => $sinfo) { if (empty($sinfo['object']) \|\| empty($sinfo['instance_settings']) \|\| !is_callable(array($sinfo['object'], 'options_exist'))) continue; foreach ($sinfo['instance_settings'] as $opt) { if (!$sinfo['object']->options_exist($opt)) { if (isset($opt['auth_in_progress'])) { $this->storage_service_with_partial_settings[$method] = $updraftplus->backup_methods[$method]; } else { if (is_a($sinfo['object'], 'UpdraftPlus_BackupModule_AddonNotYetPresent')) { $this->storage_service_without_addons_settings[] = $updraftplus->backup_methods[$method]; } else { $this->storage_service_without_settings[] = $updraftplus->backup_methods[$method]; } } } } } if (!empty($this->storage_service_with_partial_settings)) { add_action('all_admin_notices', array($this, 'show_admin_warning_if_remote_storage_with_partial_settings')); } if (!empty($this->storage_service_without_settings)) { add_action('all_admin_notices', array($this, 'show_admin_warning_if_remote_storage_setting_are_empty')); } if (!empty($this->storage_service_without_addons_settings)) { add_action('all_admin_notices', array($this, 'show_admin_warning_if_remote_storage_without_addons')); } if ($updraftplus->is_restricted_hosting('only_one_backup_per_month')) { add_action('all_admin_notices', array($this, 'show_admin_warning_one_backup_per_month')); } if (!$updraftplus->phpseclib_requirements_met()) { add_action('all_admin_notices', array($this, 'show_admin_warning_phpseclib')); } } private function setup_all_admin_notices_udonly($service, $override = false) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; if (UpdraftPlus_Options::get_updraft_option('updraft_debug_mode')) { @ini_set('display_errors', 1);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (defined('E_DEPRECATED')) { @error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged, PHPCompatibility.Constants.NewConstants.e_deprecatedFound -- Silenced to suppress errors that may arise because of the function. } else { @error_reporting(E_ALL & ~E_NOTICE);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } add_action('all_admin_notices', array($this, 'show_admin_debug_warning')); } if (null === UpdraftPlus_Options::get_updraft_option('updraft_interval')) { add_action('all_admin_notices', array($this, 'show_admin_nosettings_warning')); $this->no_settings_warning = true; } // Avoid false positives, by attempting to raise the limit (as happens when we actually do a backup) if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $max_execution_time = (int) ini_get('max_execution_time'); if ($max_execution_time>0 && $max_execution_time<20) { add_action('all_admin_notices', array($this, 'show_admin_warning_execution_time')); } // LiteSpeed has a generic problem with terminating cron jobs if (false == UpdraftPlus_Options::get_updraft_option('updraft_dismiss_admin_warning_litespeed') && isset($_SERVER['SERVER_SOFTWARE']) && strpos($_SERVER['SERVER_SOFTWARE'], 'LiteSpeed') !== false) { if (!is_file(ABSPATH.'.htaccess') \|\| !preg_match('/noabort/i', file_get_contents(ABSPATH.'.htaccess'))) { add_action('all_admin_notices', array($this, 'show_admin_warning_litespeed')); } } $binzip = $updraftplus->find_working_bin_zip(); if (false == UpdraftPlus_Options::get_updraft_option('updraft_dismiss_admin_warning_pclzip') && empty($binzip) && ((defined('UPDRAFTPLUS_PREFERPCLZIP') && UPDRAFTPLUS_PREFERPCLZIP == true) \|\| !class_exists('ZipArchive') \|\| (!extension_loaded('zip') && !method_exists('ZipArchive', 'AddFile')))) { add_action('all_admin_notices', array($this, 'show_admin_warning_pclzip')); } if (version_compare($updraftplus->get_wordpress_version(), '3.2', '<')) add_action('all_admin_notices', array($this, 'show_admin_warning_wordpressversion')); // DreamObjects west cluster shutdown warning if ('dreamobjects' === $service \|\| (is_array($service) && in_array('dreamobjects', $service))) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('dreamobjects'); if (is_wp_error($settings)) { if (!isset($this->storage_module_option_errors)) $this->storage_module_option_errors = ''; $this->storage_module_option_errors .= "DreamObjects (".$settings->get_error_code()."): ".$settings->get_error_message(); add_action('all_admin_notices', array($this, 'show_admin_warning_multiple_storage_options')); $updraftplus->log_wp_error($settings, true, true); } elseif (!empty($settings['settings'])) { foreach ($settings['settings'] as $storage_options) { if ('objects-us-west-1.dream.io' == $storage_options['endpoint']) { add_action('all_admin_notices', array($this, 'show_admin_warning_dreamobjects')); } elseif (!UpdraftPlus_BackupModule_dreamobjects::is_valid_endpoint($storage_options['endpoint'])) { add_action('all_admin_notices', array($this, 'show_admin_error_dreamobjects_invalid_custom_endpoint')); } } } } // If the plugin was not able to connect to a UDC account due to lack of licences if (isset($_GET['udc_connect']) && 0 == $_GET['udc_connect']) { add_action('all_admin_notices', array($this, 'show_admin_warning_udc_couldnt_connect')); } if (!$updraftplus->phpseclib_requirements_met()) { add_action('all_admin_notices', array($this, 'show_admin_warning_phpseclib')); } } /** * Used to output the information for the next scheduled backup. * moved to function for the ajax saves / public function next_scheduled_backups_output() { // UNIX timestamp $next_scheduled_backup = wp_next_scheduled('updraft_backup'); if ($next_scheduled_backup) { // Convert to GMT $next_scheduled_backup_gmt = gmdate('Y-m-d H:i:s', $next_scheduled_backup); // Convert to blog time zone $next_scheduled_backup = get_date_from_gmt($next_scheduled_backup_gmt, 'D, F j, Y H:i'); // $next_scheduled_backup = date_i18n('D, F j, Y H:i', $next_scheduled_backup); } else { $next_scheduled_backup = __('Nothing currently scheduled', 'updraftplus'); $files_not_scheduled = true; } $next_scheduled_backup_database = wp_next_scheduled('updraft_backup_database'); if (UpdraftPlus_Options::get_updraft_option('updraft_interval_database', UpdraftPlus_Options::get_updraft_option('updraft_interval')) == UpdraftPlus_Options::get_updraft_option('updraft_interval')) { if (isset($files_not_scheduled)) { $next_scheduled_backup_database = $next_scheduled_backup; $database_not_scheduled = true; } else { $next_scheduled_backup_database = __("At the same time as the files backup", 'updraftplus'); $next_scheduled_backup_database_same_time = true; } } else { if ($next_scheduled_backup_database) { // Convert to GMT $next_scheduled_backup_database_gmt = gmdate('Y-m-d H:i:s', $next_scheduled_backup_database); // Convert to blog time zone $next_scheduled_backup_database = get_date_from_gmt($next_scheduled_backup_database_gmt, 'D, F j, Y H:i'); // $next_scheduled_backup_database = date_i18n('D, F j, Y H:i', $next_scheduled_backup_database); } else { $next_scheduled_backup_database = __('Nothing currently scheduled', 'updraftplus'); $database_not_scheduled = true; } } if (isset($files_not_scheduled) && isset($database_not_scheduled)) { ?> <span class="not-scheduled"><?php esc_html_e('Nothing currently scheduled', 'updraftplus'); ?></span> <?php } else { echo empty($next_scheduled_backup_database_same_time) ? esc_html__('Files', 'updraftplus') : esc_html__('Files and database', 'updraftplus'); ?> : <span class="updraft_all-files"> <?php echo esc_html($next_scheduled_backup); ?> </span> <?php if (empty($next_scheduled_backup_database_same_time)) { esc_html_e('Database', 'updraftplus'); ?> : <span class="updraft_all-files"> <?php echo esc_html($next_scheduled_backup_database); ?> </span> <?php } } } /* * Used to output the information for the next scheduled file backup. * moved to function for the ajax saves * * @param Boolean $return_instead_of_echo Whether to return or echo the results. N.B. More than just the results to echo will be returned * @return Void\|String If $return_instead_of_echo parameter is true, It returns html string / public function next_scheduled_files_backups_output($return_instead_of_echo = false) { if ($return_instead_of_echo) ob_start(); // UNIX timestamp $next_scheduled_backup = wp_next_scheduled('updraft_backup'); if ($next_scheduled_backup) { // Convert to blog time zone. wp_date() (WP 5.3+) also performs locale translation. $next_scheduled_backup = function_exists('wp_date') ? wp_date('D, F j, Y H:i', $next_scheduled_backup) : get_date_from_gmt(gmdate('Y-m-d H:i:s', $next_scheduled_backup), 'D, F j, Y H:i'); $files_not_scheduled = false; } else { $next_scheduled_backup = __('Nothing currently scheduled', 'updraftplus'); $files_not_scheduled = true; } if ($files_not_scheduled) { echo '<span>'.esc_html($next_scheduled_backup).'</span>'; } else { echo '<span class="updraft_next_scheduled_date_time">'.esc_html($next_scheduled_backup).'</span>'; } if ($return_instead_of_echo) return ob_get_clean(); } /* * Used to output the information for the next scheduled database backup. * moved to function for the ajax saves * * @param Boolean $return_instead_of_echo Whether to return or echo the results. N.B. More than just the results to echo will be returned * @return Void\|String If $return_instead_of_echo parameter is true, It returns html string / public function next_scheduled_database_backups_output($return_instead_of_echo = false) { if ($return_instead_of_echo) ob_start(); $next_scheduled_backup_database = wp_next_scheduled('updraft_backup_database'); if ($next_scheduled_backup_database) { // Convert to GMT $next_scheduled_backup_database_gmt = gmdate('Y-m-d H:i:s', $next_scheduled_backup_database); // Convert to blog time zone. wp_date() (WP 5.3+) also performs locale translation. $next_scheduled_backup_database = function_exists('wp_date') ? wp_date('D, F j, Y H:i', $next_scheduled_backup_database) : get_date_from_gmt($next_scheduled_backup_database_gmt, 'D, F j, Y H:i'); $database_not_scheduled = false; } else { $next_scheduled_backup_database = __('Nothing currently scheduled', 'updraftplus'); $database_not_scheduled = true; } if ($database_not_scheduled) { echo '<span>'.esc_html($next_scheduled_backup_database).'</span>'; } else { echo '<span class="updraft_next_scheduled_date_time">'.esc_html($next_scheduled_backup_database).'</span>'; } if ($return_instead_of_echo) return ob_get_clean(); } /* * Run upon the WP admin_init action / private function admin_init() { add_action('admin_init', array($this, 'maybe_download_backup_from_email')); add_action('core_upgrade_preamble', array($this, 'core_upgrade_preamble')); add_action('admin_action_upgrade-plugin', array($this, 'admin_action_upgrade_pluginortheme')); add_action('admin_action_upgrade-theme', array($this, 'admin_action_upgrade_pluginortheme')); add_action('admin_head', array($this, 'admin_head')); add_filter((is_multisite() ? 'network_admin_' : '').'plugin_action_links', array($this, 'plugin_action_links'), 10, 2); add_action('wp_ajax_updraft_download_backup', array($this, 'updraft_download_backup')); add_action('wp_ajax_updraft_ajax', array($this, 'updraft_ajax_handler')); add_action('wp_ajax_updraft_ajaxrestore', array($this, 'updraft_ajaxrestore')); add_action('wp_ajax_nopriv_updraft_ajaxrestore', array($this, 'updraft_ajaxrestore')); add_action('wp_ajax_updraft_ajaxrestore_continue', array($this, 'updraft_ajaxrestore')); add_action('wp_ajax_nopriv_updraft_ajaxrestore_continue', array($this, 'updraft_ajaxrestore')); add_action('wp_ajax_plupload_action', array($this, 'plupload_action')); add_action('wp_ajax_plupload_action2', array($this, 'plupload_action2')); add_action('wp_before_admin_bar_render', array($this, 'wp_before_admin_bar_render')); // Add a new Ajax action for saving settings add_action('wp_ajax_updraft_savesettings', array($this, 'updraft_ajax_savesettings')); // Ajax for settings import and export add_action('wp_ajax_updraft_importsettings', array($this, 'updraft_ajax_importsettings')); add_filter('heartbeat_received', array($this, 'process_status_in_heartbeat'), 10, 2); // UpdraftPlus templates $this->register_template_directories(); global $updraftplus, $pagenow; add_filter('updraftplus_dirlist_others', array($updraftplus, 'backup_others_dirlist')); add_filter('updraftplus_dirlist_uploads', array($updraftplus, 'backup_uploads_dirlist')); // First, the checks that are on all (admin) pages: $service = UpdraftPlus_Options::get_updraft_option('updraft_service'); if (UpdraftPlus_Options::user_can_manage()) { $this->print_restore_in_progress_box_if_needed(); // Main dashboard page advert // Since our nonce is printed, make sure they have sufficient credentials if ('index.php' == $pagenow && current_user_can('update_plugins') && (!file_exists(UPDRAFTPLUS_DIR.'/udaddons') \|\| (defined('UPDRAFTPLUS_FORCE_DASHNOTICE') && UPDRAFTPLUS_FORCE_DASHNOTICE))) { $dismissed_until = UpdraftPlus_Options::get_updraft_option('updraftplus_dismisseddashnotice', 0); $backup_dir = $updraftplus->backups_dir_location(); // N.B. Not an exact proxy for the installed time; they may have tweaked the expert option to move the directory $installed = @filemtime($backup_dir.'/index.html');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $installed_for = time() - $installed; if (($installed && time() > $dismissed_until && $installed_for > 2886400 && !defined('UPDRAFTPLUS_NOADS_B')) \|\| (defined('UPDRAFTPLUS_NOADS_B') && !UPDRAFTPLUS_NOADS_B)) { add_action('all_admin_notices', array($this, 'show_admin_notice_ad')); } } // Moved out for use with Ajax saving $this->setup_all_admin_notices_global($service); } if (file_exists(UPDRAFTPLUS_DIR.'/udaddons')) { if (!class_exists('Updraft_Dashboard_News_Offer')) updraft_try_include_file('includes/class-updraft-dashboard-news-offer.php', 'include_once'); $news_translations = array( 'product_title' => 'UpdraftPlus', 'item_prefix' => __('UpdraftPlus', 'updraftplus'), 'item_description' => __('UpdraftPlus News', 'updraftplus'), 'dismiss_tooltip' => __('Dismiss all UpdraftPlus news', 'updraftplus'), 'dismiss_confirm' => __('Are you sure you want to dismiss all UpdraftPlus news forever?', 'updraftplus'), ); } add_filter('woocommerce_in_plugin_update_message', array($this, 'woocommerce_in_plugin_update_message')); if (file_exists(UPDRAFTPLUS_DIR.'/udaddons')) { new Updraft_Dashboard_News_Offer('https://feeds.feedburner.com/UpdraftPlus', 'https://updraftplus.com/news/', $news_translations); } // New-install admin tour if ((!defined('UPDRAFTPLUS_ENABLE_TOUR') \|\| UPDRAFTPLUS_ENABLE_TOUR) && (!defined('UPDRAFTPLUS_THIS_IS_CLONE') \|\| !UPDRAFTPLUS_THIS_IS_CLONE)) { updraft_try_include_file('includes/updraftplus-tour.php', 'include_once'); } if ('index.php' == $GLOBALS['pagenow'] && UpdraftPlus_Options::user_can_manage()) { add_action('admin_print_footer_scripts', array($this, 'admin_index_print_footer_scripts')); } $udp_saved_version = UpdraftPlus_Options::get_updraft_option('updraftplus_version'); if (!$udp_saved_version \|\| $udp_saved_version != $updraftplus->version) { if (!$udp_saved_version) { // udp was newly installed, or upgraded from an older version do_action('updraftplus_newly_installed', $updraftplus->version); } else { // udp was updated or downgraded do_action('updraftplus_version_changed', $udp_saved_version, $updraftplus->version); } UpdraftPlus_Options::update_updraft_option('updraftplus_version', $updraftplus->version); } // Dequeue conflicted scripts from other plugins before we enqueue our own scripts. add_action('admin_enqueue_scripts', array($this, 'dequeue_conflicted_scripts'), 99998); if (UpdraftPlus_Options::admin_page() != $pagenow \|\| empty($_REQUEST['page']) \|\| 'updraftplus' != $_REQUEST['page']) { // autobackup addon may enqueue admin-common.js and load the same script, so for the javascript we just need to make sure we call stopImmediatePropagation() to prevent other listeners of the same event from being called if (UpdraftPlus_Options::user_can_manage()) add_action('admin_print_footer_scripts', array($this, 'print_phpseclib_notice_scripts')); return; } if (isset($_REQUEST['udaction']) && 'initiate_restore' === $_REQUEST['udaction']) { // capability, backup_timestamp and nonce validations if (!UpdraftPlus_Options::user_can_manage() \|\| (!empty($_REQUEST['backup_timestamp']) && !preg_match('#^[0-9]+$#i', $_REQUEST['backup_timestamp'])) \|\| !isset($_REQUEST['restore_initiation_nonce']) \|\| !wp_verify_nonce($_REQUEST['restore_initiation_nonce'], 'updraftplus_udcentral_initiate_restore')) wp_die(esc_html__('Sorry, you are not allowed to access this page.', 'updraftplus')); } // Next, the actions that only come on the UpdraftPlus page $this->setup_all_admin_notices_udonly($service); UpdraftPlus::load_checkout_embed(); add_action('admin_enqueue_scripts', array($this, 'admin_enqueue_scripts'), 99999); if (isset($_POST['action']) && 'updraft_wipesettings' === $_POST['action'] && isset($_POST['nonce']) && UpdraftPlus_Options::user_can_manage()) { if (wp_verify_nonce($_POST['nonce'], 'updraftplus-wipe-setting-nonce')) $this->wipe_settings(); } } /** * Runs upon the WP action woocommerce_in_plugin_update_message * * @param String $msg - the message that WooCommerce will print * * @return String - filtered value / public function woocommerce_in_plugin_update_message($msg) { if (time() < UpdraftPlus_Options::get_updraft_option('dismissed_clone_wc_notices_until', 0)) return $msg; return '<div class="updraft-ad-container"><br><strong>'.__('You can test upgrading your site on an instant copy using UpdraftClone credits', 'updraftplus').' - <a href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus&tab=migrate#updraft-navtab-migrate-content">'.__('go here to learn more', 'updraftplus').'</a></strong><a href="#" onclick="jQuery(\'.updraft-ad-container\').slideUp(); jQuery.post(ajaxurl, {action: \'updraft_ajax\', subaction: \'dismiss_clone_wc_notice\', nonce: \''. wp_create_nonce('updraftplus-credentialtest-nonce') .'\' });return false;"> - '. __('dismiss notice', 'updraftplus') .'</a></div>'.$msg; } /* * Runs upon the WP action admin_print_footer_scripts if an entitled user is on the main WP dashboard page / public function admin_index_print_footer_scripts() { if (time() < UpdraftPlus_Options::get_updraft_option('dismissed_clone_php_notices_until', 0)) return; ?> <script> jQuery(function($) { if ($('#dashboard-widgets #dashboard_php_nag').length < 1) return; $('#dashboard-widgets #dashboard_php_nag .button-container').before('<div class="updraft-ad-container"><a href="<?php echo esc_url(UpdraftPlus_Options::admin_page_url()); ?>?page=updraftplus&tab=migrate#updraft-navtab-migrate-content"><?php echo esc_js(__('You can test running your site on a different PHP (or WordPress) version using UpdraftClone credits.', 'updraftplus')); ?></a> (<a href="#" onclick="jQuery(\'.updraft-ad-container\').slideUp(); jQuery.post(ajaxurl, {action: \'updraft_ajax\', subaction: \'dismiss_clone_php_notice\', nonce: \'<?php echo esc_js(wp_create_nonce('updraftplus-credentialtest-nonce')); ?>\' });return false;"><?php echo esc_js(__('Dismiss notice', 'updraftplus')); ?></a>)</div>'); }); </script> <?php } /* * Sets up what is needed to allow an in-page backup to be run. Will enqueue scripts and output appropriate HTML (so, should be run when at a suitable place). Not intended for use on the UpdraftPlus settings page. * * @param string $title Text to use for the title of the modal * @param callable $callback Callable function to output the contents of the updraft_inpage_prebackup element - i.e. what shows in the modal before a backup begins. / public function add_backup_scaffolding($title, $callback) { $this->admin_enqueue_scripts(); ?> <script> // TODO: This is not the best way. var updraft_credentialtest_nonce='<?php echo esc_js(wp_create_nonce('updraftplus-credentialtest-nonce'));?>'; </script> <div id="updraft-poplog" > <pre id="updraft-poplog-content" style="white-space: pre-wrap;"></pre> </div> <div id="updraft-backupnow-inpage-modal" title="UpdraftPlus - <?php echo esc_attr($title); ?>"> <div id="updraft_inpage_prebackup" style="float:left; clear:both;"> <?php call_user_func($callback); ?> </div> <div id="updraft_inpage_backup"> <h2><?php echo esc_html($title);?></h2> <div id="updraft_backup_started" class="updated" style="display:none; max-width: 560px; font-size:100%; line-height: 100%; padding:6px; clear:left;"></div> <?php $this->render_active_jobs_and_log_table(true, false); ?> </div> </div> <?php } /* * Called via the ajax_restore actions to prepare the restore over AJAX * * @return void / public function updraft_ajaxrestore() { if ('updraft_ajaxrestore' === $_REQUEST['action'] && (empty($_REQUEST['nonce']) \|\| !wp_verify_nonce($_REQUEST['nonce'], 'updraftplus-credentialtest-nonce'))) die('Security Check'); $this->prepare_restore(); die(); } /* * Runs upon the WP action wp_before_admin_bar_render / public function wp_before_admin_bar_render() { global $wp_admin_bar; if (!UpdraftPlus_Options::user_can_manage()) return; if (defined('UPDRAFTPLUS_ADMINBAR_DISABLE') && UPDRAFTPLUS_ADMINBAR_DISABLE) return; if (false == apply_filters('updraftplus_settings_page_render', true)) return; $option_location = UpdraftPlus_Options::admin_page_url(); $args = array( 'id' => 'updraft_admin_node', 'title' => apply_filters('updraftplus_admin_node_title', 'UpdraftPlus') ); $wp_admin_bar->add_node($args); $args = array( 'id' => 'updraft_admin_node_status', 'title' => str_ireplace('Back Up', 'Backup', __('Backup', 'updraftplus')).' / '.__('Restore', 'updraftplus'), 'parent' => 'updraft_admin_node', 'href' => $option_location.'?page=updraftplus&tab=backups' ); $wp_admin_bar->add_node($args); $args = array( 'id' => 'updraft_admin_node_migrate', 'title' => __('Migrate / Clone', 'updraftplus'), 'parent' => 'updraft_admin_node', 'href' => $option_location.'?page=updraftplus&tab=migrate' ); $wp_admin_bar->add_node($args); $args = array( 'id' => 'updraft_admin_node_settings', 'title' => __('Settings', 'updraftplus'), 'parent' => 'updraft_admin_node', 'href' => $option_location.'?page=updraftplus&tab=settings' ); $wp_admin_bar->add_node($args); $args = array( 'id' => 'updraft_admin_node_expert_content', 'title' => __('Advanced Tools', 'updraftplus'), 'parent' => 'updraft_admin_node', 'href' => $option_location.'?page=updraftplus&tab=expert' ); $wp_admin_bar->add_node($args); $args = array( 'id' => 'updraft_admin_node_addons', 'title' => __('Extensions', 'updraftplus'), 'parent' => 'updraft_admin_node', 'href' => $option_location.'?page=updraftplus&tab=addons' ); $wp_admin_bar->add_node($args); global $updraftplus; if (!$updraftplus->have_addons) { $args = array( 'id' => 'updraft_admin_node_premium', 'title' => 'UpdraftPlus Premium', 'parent' => 'updraft_admin_node', 'href' => $updraftplus->get_url('premium') ); $wp_admin_bar->add_node($args); } } /* * Output HTML for a dashboard notice highlighting the benefits of upgrading to Premium and other plugin / public function show_admin_notice_ad() { $this->include_template('wp-admin/notices/thanks-for-using-main-dash.php'); } /* * Enqueue sufficient versions of jQuery and our own scripts / private function ensure_sufficient_jquery_and_enqueue() { global $updraftplus; $enqueue_version = $updraftplus->use_unminified_scripts() ? $updraftplus->version.'.'.time() : $updraftplus->version; $min_or_not = $updraftplus->use_unminified_scripts() ? '' : '.min'; $updraft_min_or_not = $updraftplus->get_updraftplus_file_version(); if (version_compare($updraftplus->get_wordpress_version(), '3.3', '<')) { // Require a newer jQuery (3.2.1 has 1.6.1, so we go for something not too much newer). We use .on() in a way that is incompatible with < 1.7 wp_deregister_script('jquery'); $jquery_enqueue_version = $updraftplus->use_unminified_scripts() ? '1.7.2'.'.'.time() : '1.7.2'; wp_register_script('jquery', 'https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery'.$min_or_not.'.js', false, $jquery_enqueue_version, false); wp_enqueue_script('jquery'); // No plupload until 3.3 wp_enqueue_script('updraft-admin-common', UPDRAFTPLUS_URL.'/includes/updraft-admin-common'.$updraft_min_or_not.'.js', array('jquery', 'jquery-ui-dialog', 'jquery-ui-core', 'jquery-ui-accordion'), $enqueue_version, true); } else { wp_enqueue_script('updraft-admin-common', UPDRAFTPLUS_URL.'/includes/updraft-admin-common'.$updraft_min_or_not.'.js', array('jquery', 'jquery-ui-dialog', 'jquery-ui-core', 'jquery-ui-accordion', 'plupload-all'), $enqueue_version); } } /* * Dequeue conflicted scripts from other plugins before we enqueue our own scripts. / public function dequeue_conflicted_scripts() { global $pagenow; // Dequeue Gravity Forms tooltip scripts if the autobackup addon is enabled. if ('plugins.php' == $pagenow && class_exists('UpdraftPlus_Addon_Autobackup')) { wp_dequeue_script('gform_tooltip_init'); } } /* * Enqueue conflicted scripts from other plugins after we enqueue our own scripts. / public function enqueue_conflicted_scripts() { global $pagenow; // Enqueue Gravity Forms tooltip scripts if the autobackup addon is enabled. if ('plugins.php' == $pagenow && class_exists('UpdraftPlus_Addon_Autobackup')) { wp_enqueue_script('gform_tooltip_init'); } } /* * This is also called directly from the auto-backup add-on / public function admin_enqueue_scripts() { global $updraftplus, $wp_locale, $updraftplus_checkout_embed; $enqueue_version = $updraftplus->use_unminified_scripts() ? $updraftplus->version.'.'.time() : $updraftplus->version; $min_or_not = $updraftplus->use_unminified_scripts() ? '' : '.min'; $updraft_min_or_not = $updraftplus->get_updraftplus_file_version(); // Defeat other plugins/themes which dump their jQuery UI CSS onto our settings page if (!wp_style_is('jquery-ui', 'done')) { wp_dequeue_style('jquery-ui'); wp_deregister_style('jquery-ui'); } $jquery_ui_version = version_compare($updraftplus->get_wordpress_version(), '5.6', '>=') ? '1.12.1' : '1.11.4'; $jquery_ui_css_enqueue_version = $updraftplus->use_unminified_scripts() ? $jquery_ui_version.'.0'.'.'.time() : $jquery_ui_version.'.0'; wp_enqueue_style('updraft-jquery-ui', UPDRAFTPLUS_URL."/includes/jquery-ui.custom-v$jquery_ui_version$updraft_min_or_not.css", array(), $jquery_ui_css_enqueue_version); wp_enqueue_style('updraft-admin-css', UPDRAFTPLUS_URL.'/css/updraftplus-admin'.$updraft_min_or_not.'.css', array(), $enqueue_version); // add_filter('style_loader_tag', array($this, 'style_loader_tag'), 10, 2); $this->ensure_sufficient_jquery_and_enqueue(); $this->enqueue_conflicted_scripts(); $jquery_blockui_enqueue_version = $updraftplus->use_unminified_scripts() ? '2.71.0'.'.'.time() : '2.71.0'; wp_enqueue_script('jquery-blockui', UPDRAFTPLUS_URL.'/includes/blockui/jquery.blockUI'.$min_or_not.'.js', array('jquery'), $jquery_blockui_enqueue_version); wp_enqueue_script('jquery-labelauty', UPDRAFTPLUS_URL.'/includes/labelauty/jquery-labelauty'.$updraft_min_or_not.'.js', array('jquery'), $enqueue_version); wp_enqueue_style('jquery-labelauty', UPDRAFTPLUS_URL.'/includes/labelauty/jquery-labelauty'.$updraft_min_or_not.'.css', array(), $enqueue_version); $serialize_js_enqueue_version = $updraftplus->use_unminified_scripts() ? '3.2.0'.'.'.time() : '3.2.0'; wp_enqueue_script('jquery.serializeJSON', UPDRAFTPLUS_URL.'/includes/jquery.serializeJSON/jquery.serializejson'.$min_or_not.'.js', array('jquery'), $serialize_js_enqueue_version); wp_enqueue_script('handlebars', UPDRAFTPLUS_URL.'/includes/handlebars/handlebars'.$min_or_not.'.js', array(), $enqueue_version); $this->enqueue_jstree(); $jqueryui_dialog_extended_version = $updraftplus->use_unminified_scripts() ? '1.0.4'.'.'.time() : '1.0.4'; wp_enqueue_script('jquery-ui.dialog.extended', UPDRAFTPLUS_URL.'/includes/jquery-ui.dialog.extended/jquery-ui.dialog.extended'.$updraft_min_or_not.'.js', array('jquery', 'jquery-ui-core', 'jquery-ui-widget', 'jquery-ui-dialog'), $jqueryui_dialog_extended_version); $day_selector = ''; for ($day_index = 0; $day_index <= 6; $day_index++) { // $selected = ($opt == $day_index) ? 'selected="selected"' : ''; $selected = ''; $day_selector .= "\n\t<option value='" . $day_index . "' $selected>" . $wp_locale->get_weekday($day_index) . '</option>'; } $mday_selector = ''; for ($mday_index = 1; $mday_index <= 28; $mday_index++) { // $selected = ($opt == $mday_index) ? 'selected="selected"' : ''; $selected = ''; $mday_selector .= "\n\t<option value='" . $mday_index . "' $selected>" . $mday_index . '</option>'; } $backup_methods = $updraftplus->backup_methods; $remote_storage_options_and_templates = UpdraftPlus_Storage_Methods_Interface::get_remote_storage_options_and_templates(); do_action('updraftplus_admin_enqueue_scripts'); $main_tabs = $this->get_main_tabs_array(); $checkout_embed_5gb_trial_attribute = ''; if (is_a($updraftplus_checkout_embed, 'Updraft_Checkout_Embed')) { $checkout_embed_5gb_trial_attribute = $updraftplus_checkout_embed->get_product('updraftplus-vault-storage-5-gb') ? 'data-embed-checkout="'.apply_filters('updraftplus_com_link', $updraftplus_checkout_embed->get_product('updraftplus-vault-storage-5-gb', UpdraftPlus_Options::admin_page_url().'?page=updraftplus&tab=settings')).'"' : ''; } $hosting_company = $updraftplus->get_hosting_info(); wp_localize_script('updraft-admin-common', 'updraftlion', array( 'tab' => (empty($_GET['tab']) \|\| !preg_match('/^[a-z]+$/', $_GET['tab'])) ? 'backups' : $_GET['tab'], 'sendonlyonwarnings' => __('Send a report only when there are warnings/errors', 'updraftplus'), 'wholebackup' => __('When email storage method is enabled, and an email address is entered, also send the backup', 'updraftplus'), / translators: %s: Typical mail server size limit in megabytes / 'emailsizelimits' => esc_attr(sprintf(__('Be aware that mail servers tend to have size limits; typically around %s Mb; backups larger than any limits will likely not arrive.', 'updraftplus'), '10-20')), 'rescanning' => __('Rescanning (looking for backups that you have uploaded manually into the internal backup store)...', 'updraftplus'), 'dbbackup' => __('Only email the database backup', 'updraftplus'), 'rescanningremote' => __('Rescanning remote and local storage for backup sets...', 'updraftplus'), 'enteremailhere' => esc_attr(__('To send to more than one address, separate each address with a comma.', 'updraftplus')), 'excludedeverything' => __('If you exclude both the database and the files, then you have excluded everything!', 'updraftplus'), 'nofileschosen' => __('You have chosen to backup files, but no file entities have been selected', 'updraftplus'), 'notableschosen' => __('You have chosen to backup a database, but no tables have been selected', 'updraftplus'), 'nocloudserviceschosen' => __('You have chosen to send this backup to remote storage, but no remote storage locations have been selected', 'updraftplus'), 'restore_proceeding' => __('The restore operation has begun.', 'updraftplus').' '.__('Do not close your browser until it reports itself as having finished.', 'updraftplus'), 'unexpectedresponse' => __('Unexpected response:', 'updraftplus'), 'servererrorcode' => __('The web server returned an error code (try again, or check your web server logs)', 'updraftplus'), 'newuserpass' => __("The new user's RackSpace console password is (this will not be shown again):", 'updraftplus'), 'trying' => __('Trying...', 'updraftplus'), 'fetching' => __('Fetching...', 'updraftplus'), 'calculating' => __('calculating...', 'updraftplus'), 'begunlooking' => __('Begun looking for this entity', 'updraftplus'), 'stilldownloading' => __('Some files are still downloading or being processed - please wait.', 'updraftplus'), 'processing' => __('Processing files - please wait...', 'updraftplus'), 'emptyresponse' => __('Error: the server sent an empty response.', 'updraftplus'), 'warnings' => __('Warnings:', 'updraftplus'), 'errors' => __('Errors:', 'updraftplus'), 'jsonnotunderstood' => __('Error: the server sent us a response which we did not understand.', 'updraftplus'), 'errordata' => __('Error data:', 'updraftplus'), 'error' => __('Error:', 'updraftplus'), 'errornocolon' => __('Error', 'updraftplus'), 'existing_backups' => __('Existing backups', 'updraftplus'), 'fileready' => __('File ready.', 'updraftplus'), 'filesize' => __('File size', 'updraftplus'), 'actions' => __('Actions', 'updraftplus'), 'deletefromserver' => __('Delete from your web server', 'updraftplus'), 'downloadtocomputer' => __('Download to your computer', 'updraftplus'), 'browse_contents' => __('Browse contents', 'updraftplus'), 'notunderstood' => __('Download error: the server sent us a response which we did not understand.', 'updraftplus'), 'requeststart' => __('Requesting start of backup...', 'updraftplus'), 'phpinfo' => __('PHP information', 'updraftplus'), 'delete_old_dirs' => __('Delete Old Directories', 'updraftplus'), 'raw' => __('Raw backup history', 'updraftplus'), 'notarchive' => __('This file is not an UpdraftPlus backup archive (such files are .zip or .gz files which have a name like: backup_(time)_(site name)_(code)_(type).(zip\|gz)).', 'updraftplus').' '.__('However, UpdraftPlus archives are standard zip/SQL files - so if you are sure that your file has the right format, then you can rename it to match that pattern.', 'updraftplus'), 'notarchive2' => '<p>'.__('This file is not an UpdraftPlus backup archive (such files are .zip or .gz files which have a name like: backup_(time)_(site name)_(code)_(type).(zip\|gz)).', 'updraftplus').'</p> '.apply_filters('updraftplus_if_foreign_then_premium_message', '<p><a href="'.$updraftplus->get_url('premium').'">'.__('If this is a backup created by a different backup plugin, then UpdraftPlus Premium may be able to help you.', 'updraftplus').'</a></p>'), 'makesure' => __('(make sure that you were trying to upload a zip file previously created by UpdraftPlus)', 'updraftplus'), 'uploaderror' => __('Upload error:', 'updraftplus'), 'notdba' => __('This file is not an UpdraftPlus encrypted database archive (such files are .gz.crypt files which have a name like: backup_(time)_(site name)_(code)_db.crypt.gz).', 'updraftplus'), 'uploaderr' => __('Upload error', 'updraftplus'), 'followlink' => __('Follow this link to attempt decryption and download the database file to your computer.', 'updraftplus'), 'thiskey' => __('This decryption key will be attempted:', 'updraftplus'), 'unknownresp' => __('Unknown server response:', 'updraftplus'), 'ukrespstatus' => __('Unknown server response status:', 'updraftplus'), 'uploaded' => __('The file was uploaded.', 'updraftplus'), // One of the translators has erroneously changed "Backup" into "Back up" (which means, "reverse" !) 'backupnow' => str_ireplace('Back Up', 'Backup', __('Backup Now', 'updraftplus')), 'cancel' => __('Cancel', 'updraftplus'), 'deletebutton' => __('Delete', 'updraftplus'), 'createbutton' => __('Create', 'updraftplus'), 'uploadbutton' => __('Upload', 'updraftplus'), 'youdidnotselectany' => __('You did not select any components to restore.', 'updraftplus').' '.__('Please select at least one, and then try again.', 'updraftplus'), 'restoreactivitylogfullscreen' => __('Full-screen', 'updraftplus'), 'restoreactivitylogscreenexit' => __('Exit full-screen', 'updraftplus'), 'proceedwithupdate' => __('Proceed with update', 'updraftplus'), 'close' => __('Close', 'updraftplus'), 'restore' => __('Restore', 'updraftplus'), 'downloadlogfile' => __('Download log file', 'updraftplus'), 'automaticbackupbeforeupdate' => __('Automatic backup before update', 'updraftplus'), 'unsavedsettings' => __('You have made changes to your settings, and not saved.', 'updraftplus'), 'saving' => __('Saving...', 'updraftplus'), 'connect' => __('Connect', 'updraftplus'), 'connecting' => __('Connecting...', 'updraftplus'), 'disconnect' => __('Disconnect', 'updraftplus'), 'disconnecting' => __('Disconnecting...', 'updraftplus'), 'counting' => __('Counting...', 'updraftplus'), 'updatequotacount' => __('Update quota count', 'updraftplus'), 'addingsite' => __('Adding...', 'updraftplus'), 'addsite' => __('Add site', 'updraftplus'), // 'resetting' => __('Resetting...', 'updraftplus'), 'creating_please_allow' => __('Creating...', 'updraftplus').(function_exists('openssl_encrypt') ? '' : ' ('.__('your PHP install lacks the openssl module; as a result, this can take minutes; if nothing has happened by then, then you should either try a smaller key size, or ask your web hosting company how to enable this PHP module on your setup.', 'updraftplus').')'), 'sendtosite' => __('Send to site:', 'updraftplus'), / translators: %s: Minimum required UpdraftPlus version / 'checkrpcsetup' => sprintf(__('You should check that the remote site is online, not firewalled, does not have security modules that may be blocking access, has UpdraftPlus version %s or later active and that the keys have been entered correctly.', 'updraftplus'), '2.10.3'), 'pleasenamekey' => __('Please give this key a name (e.g. indicate the site it is for):', 'updraftplus'), 'key' => __('Key', 'updraftplus'), 'nokeynamegiven' => sprintf( / translators: %s: Missing key name / __("Failure: No %s was given.", 'updraftplus'), __('key name', 'updraftplus') ), 'deleting' => __('Deleting...', 'updraftplus'), 'enter_mothership_url' => __('Please enter a valid URL', 'updraftplus'), 'delete_response_not_understood' => __("We requested to delete the file, but could not understand the server's response", 'updraftplus'), 'testingconnection' => __('Testing connection...', 'updraftplus'), 'send' => __('Send', 'updraftplus'), 'migratemodalheight' => class_exists('UpdraftPlus_Addons_Migrator') ? 555 : 300, 'migratemodalwidth' => class_exists('UpdraftPlus_Addons_Migrator') ? 770 : 500, 'download' => _x('Download', '(verb)', 'updraftplus'), 'browse_download_link' => apply_filters('updraftplus_browse_download_link', '<a id="updraft_zip_download_notice" href="'.apply_filters('updraftplus_com_link', "https://updraftplus.com/landing/updraftplus-premium").'" target="_blank">'.__("With UpdraftPlus Premium, you can directly download individual files from here.", "updraftplus").'</a>'), 'unsavedsettingsbackup' => __('You have made changes to your settings, and not saved.', 'updraftplus')."\n".__('You should save your changes to ensure that they are used for making your backup.', 'updraftplus'), 'unsaved_settings_export' => __('You have made changes to your settings, and not saved.', 'updraftplus')."\n".__('Your export file will be of your displayed settings, not your saved ones.', 'updraftplus'), 'dayselector' => $day_selector, 'mdayselector' => $mday_selector, 'day' => __('day', 'updraftplus'), 'inthemonth' => __('in the month', 'updraftplus'), 'days' => __('day(s)', 'updraftplus'), 'hours' => __('hour(s)', 'updraftplus'), 'weeks' => __('week(s)', 'updraftplus'), 'forbackupsolderthan' => __('For backups older than', 'updraftplus'), 'ud_url' => UPDRAFTPLUS_URL, 'processing' => __('Processing...', 'updraftplus'), 'loading' => __('Loading...', 'updraftplus'), 'pleasefillinrequired' => __('Please fill in the required information.', 'updraftplus'), / translators: %s: Settings type / 'test_settings' => __('Test %s Settings', 'updraftplus'), / translators: %s: Settings type / 'testing_settings' => __('Testing %s Settings...', 'updraftplus'), / translators: %s: Settings type / 'settings_test_result' => __('%s settings test result:', 'updraftplus'), 'nothing_yet_logged' => __('Nothing yet logged', 'updraftplus'), 'import_select_file' => __('You have not yet selected a file to import.', 'updraftplus'), 'import_invalid_json_file' => __('Error: The chosen file is corrupt.', 'updraftplus').' '.__('Please choose a valid UpdraftPlus export file.', 'updraftplus'), 'updraft_settings_url' => UpdraftPlus_Options::admin_page_url().'?page=updraftplus', 'network_site_url' => network_site_url(), 'importing' => __('Importing...', 'updraftplus'), 'importing_data_from' => __('This will import data from:', 'updraftplus'), 'exported_on' => __('Which was exported on:', 'updraftplus'), 'continue_import' => __('Do you want to carry out the import?', 'updraftplus'), 'complete' => __('Complete', 'updraftplus'), 'backup_complete' => __('The backup has finished running', 'updraftplus'), 'backup_aborted' => __('The backup was aborted', 'updraftplus'), 'remote_delete_limit' => defined('UPDRAFTPLUS_REMOTE_DELETE_LIMIT') ? UPDRAFTPLUS_REMOTE_DELETE_LIMIT : 25, // this used to be number of files but now the value of this constant is in seconds 'remote_files_deleted' => __('remote files deleted', 'updraftplus'), 'http_code' => __('HTTP code:', 'updraftplus'), 'makesure2' => __('The file failed to upload.', 'updraftplus').' '.__('Please check the following:', 'updraftplus')."\n\n - ".__('Any settings in your .htaccess or web.config file that affects the maximum upload or post size.', 'updraftplus')."\n - ".__('The available memory on the server.', 'updraftplus')."\n - ".__('That you are attempting to upload a zip file previously created by UpdraftPlus.', 'updraftplus')."\n\n".__('Further information may be found in the browser JavaScript console, and the server PHP error logs.', 'updraftplus'), 'zip_file_contents' => __('Browsing zip file', 'updraftplus'), 'zip_file_contents_info' => __('Select a file to view information about it', 'updraftplus'), 'search' => __('Search', 'updraftplus'), 'download_timeout' => __('Unable to download file.', 'updraftplus').' '.__('This could be caused by a timeout.', 'updraftplus').' '.__('It would be best to download the zip to your computer.', 'updraftplus'), 'loading_log_file' => __('Loading log file', 'updraftplus'), 'updraftplus_version' => $updraftplus->version, 'updraftcentral_wizard_empty_url' => __('Please enter the URL where your UpdraftCentral dashboard is hosted.', 'updraftplus'), 'updraftcentral_wizard_invalid_url' => __('Please enter a valid URL e.g http://example.com', 'updraftplus'), 'export_settings_file_name' => 'updraftplus-settings-'.sanitize_title(get_bloginfo('name')).'.json', // For remote storage handlebarsjs template 'remote_storage_options' => $remote_storage_options_and_templates['options'], 'remote_storage_templates' => $remote_storage_options_and_templates['templates'], 'remote_storage_partial_templates' => $remote_storage_options_and_templates['partial_templates'], 'remote_storage_methods' => $backup_methods, 'instance_enabled' => __('Currently enabled', 'updraftplus'), 'instance_disabled' => __('Currently disabled', 'updraftplus'), 'local_upload_started' => __('Local backup upload has started; please check the log file to see the upload progress', 'updraftplus'), 'local_upload_error' => __('You must select at least one remote storage destination to upload this backup set to.', 'updraftplus'), 'already_uploaded' => __('(already uploaded)', 'updraftplus'), 'onedrive_folder_url_warning' => __('Please specify the Microsoft OneDrive folder name, not the URL.', 'updraftplus'), 'updraftcentral_cloud' => __('UpdraftCentral Cloud', 'updraftplus'), 'udc_cloud_connected' => __('Connected.', 'updraftplus').' '.__('Requesting UpdraftCentral Key.', 'updraftplus'), 'udc_cloud_key_created' => __('Key created.', 'updraftplus').' '.__('Adding site to UpdraftCentral Cloud.', 'updraftplus'), 'login_successful' => __('Login successful.', 'updraftplus').' '. / translators: %s: Name of the service to be opened in a new window./ __('Please follow this link to open %s in a new window.', 'updraftplus'), 'login_successful_short' => __('Login successful; reloading information.', 'updraftplus'), 'registration_successful' => __('Registration successful.', 'updraftplus').' '. / translators: %s: Name of the service to be opened in a new window./ __('Please follow this link to open %s in a new window.', 'updraftplus'), 'username_password_required' => __('Both email and password fields are required.', 'updraftplus'), 'valid_email_required' => __('An email is required and needs to be in a valid format.', 'updraftplus'), 'trouble_connecting' => __('Trouble connecting? Try using an alternative method in the advanced security options.', 'updraftplus'), 'checking_tfa_code' => __('Verifying one-time password...', 'updraftplus'), 'perhaps_login' => __('Perhaps you would want to login instead.', 'updraftplus'), 'generating_key' => __('Please wait while the system generates and registers an encryption key for your website with UpdraftCentral Cloud.', 'updraftplus'), 'updraftcentral_cloud_redirect' => __('Please wait while you are redirected to UpdraftCentral Cloud.', 'updraftplus'), 'data_consent_required' => __('You need to read and accept the UpdraftCentral Cloud data and privacy policies before you can proceed.', 'updraftplus'), 'close_wizard' => __('You can also close this wizard.', 'updraftplus'), 'control_udc_connections' => __('For future control of all your UpdraftCentral connections, go to the "Advanced Tools" tab.', 'updraftplus'), 'main_tabs_keys' => array_keys($main_tabs), 'clone_version_warning' => __('Warning: you have selected a lower version than your currently installed version.', 'updraftplus').' '.__('This may fail if you have components that are incompatible with earlier versions.', 'updraftplus'), 'clone_backup_complete' => __('The clone has been provisioned, and its data has been sent to it.', 'updraftplus').' '.__('Once the clone has finished deploying it, you will receive an email.', 'updraftplus'), 'clone_backup_aborted' => __('The preparation of the clone data has been aborted.', 'updraftplus'), 'current_clean_url' => esc_url(UpdraftPlus::get_current_clean_url()), 'exclude_rule_remove_conformation_msg' => __('Are you sure you want to remove this exclusion rule?', 'updraftplus'), 'exclude_select_file_or_folder_msg' => __('Please select a file/folder which you would like to exclude', 'updraftplus'), 'exclude_select_folder_wildcards_msg' => __('Please select a folder in which the files/directories you would like to exclude are located', 'updraftplus'), 'exclude_type_ext_msg' => __('Please enter a file extension, like zip', 'updraftplus'), 'exclude_ext_error_msg' => __('Please enter a valid file extension', 'updraftplus'), 'exclude_type_prefix_msg' => __('Please enter characters that begin the filename which you would like to exclude', 'updraftplus'), 'exclude_prefix_error_msg' => __('Please enter a valid file name prefix', 'updraftplus'), 'exclude_contain_error_msg' => __('Please enter part of the file name', 'updraftplus'), 'duplicate_exclude_rule_error_msg' => __('The exclusion rule which you are trying to add already exists', 'updraftplus'), 'clone_key_required' => __('UpdraftClone key is required.', 'updraftplus'), 'files_new_backup' => __('Include your files in the backup', 'updraftplus'), 'files_incremental_backup' => __('File backup options', 'updraftplus'), 'ajax_restore_invalid_response' => __('HTML was detected in the response.', 'updraftplus').' '.__('You may have a security module on your webserver blocking the restoration operation.', 'updraftplus'), 'emptyrestorepath' => __('You have not selected a restore path for your chosen backups', 'updraftplus'), 'updraftvault_info' => '<h3>'.__('Try UpdraftVault!', 'updraftplus').'</h3>' .'<p>'.__('UpdraftVault is our remote storage which works seamlessly with UpdraftPlus.', 'updraftplus') .' <a href="'.apply_filters('updraftplus_com_link', 'https://updraftplus.com/updraftvault/').'" target="_blank">'.__('Find out more here.', 'updraftplus').'</a>' .'</p>' .'<p><a href="'.apply_filters('updraftplus_com_link', $updraftplus->get_url('shop_vault_5')).'" target="_blank" '.$checkout_embed_5gb_trial_attribute.' class="button button-primary">'.__('Try it - 1 month for $1!', 'updraftplus').'</a></p>', 'login_udc_no_licences_short' => __('No UpdraftCentral licences were available.', 'updraftplus').' '.__('Continuing to connect to account.', 'updraftplus'), 'credentials' => __('credentials', 'updraftplus'), 'username' => __('Username', 'updraftplus'), 'password' => __('Password', 'updraftplus'), / translators: %d: Seconds ago / 'last_activity' => __('last activity: %d seconds ago', 'updraftplus'), / translators: %d: Seconds until resumption / 'no_recent_activity' => __('no recent activity; will offer resumption after: %d seconds', 'updraftplus'), 'restore_files_progress' => __('Restoring %s1 files out of %s2', 'updraftplus'), / translators: %s: Database table name / 'restore_db_table_progress' => __('Restoring table: %s', 'updraftplus'), / translators: %s: Stored routine name / 'restore_db_stored_routine_progress' => __('Restoring stored routine: %s', 'updraftplus'), 'finished' => __('Finished', 'updraftplus'), 'begun' => __('Begun', 'updraftplus'), 'maybe_downloading_entities' => __('Downloading backup files if needed', 'updraftplus'), 'preparing_backup_files' => __('Preparing backup files', 'updraftplus'), 'ajax_restore_contact_failed' => __('Attempts by the browser to contact the website failed.', 'updraftplus'), 'ajax_restore_error' => __('Restore error:', 'updraftplus'), 'ajax_restore_404_detected' => '<div class="notice notice-warning" style="margin: 0px; padding: 5px;"><p><span class="dashicons dashicons-warning"></span> <strong>'. __('Warning:', 'updraftplus') . '</strong></p><p>' . __('Attempts by the browser to access some pages have returned a "not found (404)" error.', 'updraftplus').' '.__('This could mean that your .htaccess file has incorrect contents, is missing, or that your webserver is missing an equivalent mechanism.', 'updraftplus'). '</p><p>'.__('Missing pages:', 'updraftplus').'</p><ul class="updraft_missing_pages"></ul><a target="_blank" href="https://updraftplus.com/faqs/migrating-site-front-page-works-pages-give-404-error/">'.__('Follow this link for more information', 'updraftplus').'.</a></div>', 'delete_error_log_prompt' => __('Please check the error log for more details', 'updraftplus'), 'existing_backups_limit' => defined('UPDRAFTPLUS_EXISTING_BACKUPS_LIMIT') ? UPDRAFTPLUS_EXISTING_BACKUPS_LIMIT : 100, 'remote_scan_warning' => __('Warning: if you continue, you will add all backups stored in the configured remote storage directory (whichever site they were created by).', 'updraftplus'), 'hosting_restriction_one_backup_permonth' => __("You have reached the monthly limit for the number of backups you can create at this time.", 'updraftplus').' '. __('Your hosting provider only allows you to take one backup per month.', 'updraftplus').' '. / translators: %s: Hosting provider name / sprintf(__("Please contact your hosting company (%s) if you require further support.", 'updraftplus'), $hosting_company['name']), 'hosting_restriction_one_incremental_perday' => __("You have reached the daily limit for the number of incremental backups you can create at this time.", 'updraftplus').' '. __("Your hosting provider only allows you to take one incremental backup per day.", 'updraftplus').' '. / translators: %s: Hosting provider name / sprintf(__("Please contact your hosting company (%s) if you require further support.", 'updraftplus'), $hosting_company['name']), 'hosting_restriction' => $updraftplus->is_hosting_backup_limit_reached(), 'conditional_logic' => array( 'day_of_the_week_options' => $updraftplus->list_days_of_the_week(), 'logic_options' => array( array( 'label' => __('on every backup', 'updraftplus'), 'value' => '', ), array( 'label' => __('if any of the following conditions are matched:', 'updraftplus'), 'value' => 'any', ), array( 'label' => __('if all of the following conditions are matched:', 'updraftplus'), 'value' => 'all', ), ), 'operand_options' => array( array( 'label' => __('Day of the week', 'updraftplus'), 'value' => 'day_of_the_week', ), array( 'label' => __('Day of the month', 'updraftplus'), 'value' => 'day_of_the_month', ), ), 'operator_options' => array( array( 'label' => __('is', 'updraftplus'), 'value' => 'is', ), array( 'label' => __('is not', 'updraftplus'), 'value' => 'is_not', ), ) ), 'php_max_input_vars_detected_warning' => __('The number of restore options that will be sent exceeds the configured maximum in your PHP configuration (max_input_vars).', 'updraftplus').' '.__('If you proceed with the restoration then some of the restore options will be lost and you may get unexpected results.', 'updraftplus').' '.__('See the browser console log for more information.', 'updraftplus'), 'remote_send_backup_info' => __('You can send an existing local backup to the remote site or create a new backup', 'updraftplus'), 'send_to_another_site' => __('Send a backup to another site', 'updraftplus'), 'send_existing_backup' => __('Send existing backup', 'updraftplus'), 'send_new_backup' => __('Send a new backup', 'updraftplus'), 'scanning_backups' => __('Searching for backups...', 'updraftplus'), 'back' => __('back', 'updraftplus'), 'expired_tokens' => __('This is usually caused by your dashboard page having been open a long time, and the included security tokens having since expired.', 'updraftplus'), 'reload_page' => __('Therefore, please reload the page.', 'updraftplus'), 'save_changes' => __('Save Changes', 'updraftplus'), 'close' => __('Close', 'updraftplus'), 'dreamobject_endpoints' => array_keys(UpdraftPlus_BackupModule_dreamobjects::get_endpoints()), 'dreamobject_endpoint_regex' => UpdraftPlus_BackupModule_dreamobjects::ENDPOINT_REGEX, )); } /* * Despite the name, this fires irrespective of what capabilities the user has (even none - so be careful) / public function core_upgrade_preamble() { // They need to be able to perform backups, and to perform updates if (!UpdraftPlus_Options::user_can_manage() \|\| (!current_user_can('update_core') && !current_user_can('update_plugins') && !current_user_can('update_themes'))) return; if (!class_exists('UpdraftPlus_Addon_Autobackup')) { if (defined('UPDRAFTPLUS_NOADS_B')) return; } ?> <?php if (!class_exists('UpdraftPlus_Addon_Autobackup')) { if (!class_exists('UpdraftPlus_Notices')) updraft_try_include_file('includes/updraftplus-notices.php', 'include_once'); global $updraftplus_notices; $notice = $updraftplus_notices->do_notice('autobackup', 'autobackup', true); } else { $notice = ''; } add_filter('safe_style_css', array($this, 'kses_allow_style_display')); echo wp_kses(apply_filters('updraftplus_autobackup_blurb', $notice), $this->kses_allow_tags()); remove_filter('safe_style_css', array($this, 'kses_allow_style_display')); ?> <script> jQuery(function() { jQuery('.updraft-ad-container').appendTo(jQuery('.wrap p').first()); }); </script> <?php } /* * Run upon the WP admin_head action / public function admin_head() { global $pagenow; if (UpdraftPlus_Options::admin_page() != $pagenow \|\| !isset($_REQUEST['page']) \|\| 'updraftplus' != $_REQUEST['page'] \|\| !UpdraftPlus_Options::user_can_manage()) return; $chunk_size = min(wp_max_upload_size()-1024, 10485762); // The multiple_queues argument is ignored in plupload 2.x (WP3.9+) - http://make.wordpress.org/core/2014/04/11/plupload-2-x-in-wordpress-3-9/ // max_file_size is also in filters as of plupload 2.x, but in its default position is still supported for backwards-compatibility. Likewise, our use of filters.extensions below is supported by a backwards-compatibility option (the current way is filters.mime-types.extensions $plupload_init = array( 'runtimes' => 'html5,flash,silverlight,html4', 'browse_button' => 'plupload-browse-button', 'container' => 'plupload-upload-ui', 'drop_element' => 'updraft-navtab-backups-content', 'file_data_name' => 'async-upload', 'multiple_queues' => true, 'max_file_size' => '100Gb', 'chunk_size' => $chunk_size.'b', 'url' => admin_url('admin-ajax.php', 'relative'), 'multipart' => true, 'multi_selection' => true, 'urlstream_upload' => true, // additional post data to send to our ajax hook 'multipart_params' => array( '_ajax_nonce' => wp_create_nonce('updraft-uploader'), 'action' => 'plupload_action' ) ); // WP 3.9 updated to plupload 2.0 - https://core.trac.wordpress.org/ticket/25663 if (is_file(ABSPATH.WPINC.'/js/plupload/Moxie.swf')) { $plupload_init['flash_swf_url'] = includes_url('js/plupload/Moxie.swf'); } else { $plupload_init['flash_swf_url'] = includes_url('js/plupload/plupload.flash.swf'); } if (is_file(ABSPATH.WPINC.'/js/plupload/Moxie.xap')) { $plupload_init['silverlight_xap_url'] = includes_url('js/plupload/Moxie.xap'); } else { $plupload_init['silverlight_xap_url'] = includes_url('js/plupload/plupload.silverlight.swf'); } ?><script> var updraft_credentialtest_nonce = '<?php echo esc_js(wp_create_nonce('updraftplus-credentialtest-nonce'));?>'; var updraftplus_settings_nonce = '<?php echo esc_js(wp_create_nonce('updraftplus-settings-nonce'));?>'; var updraft_siteurl = '<?php echo esc_js(site_url('', 'relative'));?>'; var updraft_plupload_config = <?php echo json_encode($plupload_init); ?>; var updraft_download_nonce = '<?php echo esc_js(wp_create_nonce('updraftplus_download'));?>'; var updraft_accept_archivename = <?php echo esc_js(apply_filters('updraftplus_accept_archivename_js', "[]"));?>; <?php $plupload_init['browse_button'] = 'plupload-browse-button2'; $plupload_init['container'] = 'plupload-upload-ui2'; $plupload_init['drop_element'] = 'drag-drop-area2'; $plupload_init['multipart_params']['action'] = 'plupload_action2'; $plupload_init['filters'] = array(array('title' => __('Allowed Files'), 'extensions' => 'crypt'));// phpcs:ignore WordPress.WP.I18n.MissingArgDomain -- The string exists within the WordPress core. ?> var updraft_plupload_config2 = <?php echo json_encode($plupload_init); ?>; var updraft_downloader_nonce = '<?php wp_create_nonce("updraftplus_download"); ?>' <?php $overdue = $this->howmany_overdue_crons(); if ($overdue >= 4) { ?> jQuery(function() { setTimeout(function(){ updraft_check_overduecrons(); }, 11000); }); <?php } ?> </script> <?php } /** * Check if available disk space is at least the specified number of bytes * * @param Integer $space - number of bytes * * @return Integer\|Boolean - true or false to indicate if available; of -1 if the result is unknown / private function disk_space_check($space) { // Allow checking by some other means (user request) if (null !== ($filtered_result = apply_filters('updraftplus_disk_space_check', null, $space))) return $filtered_result; global $updraftplus; $updraft_dir = $updraftplus->backups_dir_location(); $disk_free_space = function_exists('disk_free_space') ? @disk_free_space($updraft_dir) : false;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (false == $disk_free_space) return -1; return ($disk_free_space > $space) ? true : false; } /* * Adds the settings link under the plugin on the plugin screen. * * @param Array $links Set of links for the plugin, before being filtered * @param String $file File name (relative to the plugin directory) * @return Array filtered results / public function plugin_action_links($links, $file) { if (is_array($links) && 'updraftplus/updraftplus.php' == $file) { $settings_link = '<a href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus" class="js-updraftplus-settings">'.__("Settings", "updraftplus").'</a>'; array_unshift($links, $settings_link); $settings_link = '<a href="'.apply_filters('updraftplus_com_link', "https://updraftplus.com/").'" target="_blank">'.__("Premium / Pro Support", "updraftplus").'</a>'; array_unshift($links, $settings_link); } return $links; } public function admin_action_upgrade_pluginortheme() { if (isset($_GET['action']) && ('upgrade-plugin' == $_GET['action'] \|\| 'upgrade-theme' == $_GET['action']) && !class_exists('UpdraftPlus_Addon_Autobackup') && !defined('UPDRAFTPLUS_NOADS_B')) { if ('upgrade-plugin' == $_GET['action']) { if (!current_user_can('update_plugins')) return; } else { if (!current_user_can('update_themes')) return; } $dismissed_until = UpdraftPlus_Options::get_updraft_option('updraftplus_dismissedautobackup', 0); if ($dismissed_until > time()) return; if ('upgrade-plugin' == $_GET['action']) { $title = __('Update Plugin');// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable, WordPress.WP.I18n.MissingArgDomain -- Passed though to wp-admin/admin-header.php, The string exists within the WordPress core $parent_file = 'plugins.php';// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Passed though to wp-admin/admin-header.php $submenu_file = 'plugins.php';// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Passed though to wp-admin/admin-header.php } else { $title = __('Update Theme');// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Passed though to wp-admin/admin-header.php $parent_file = 'themes.php';// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Passed though to wp-admin/admin-header.php $submenu_file = 'themes.php';// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Passed though to wp-admin/admin-header.php } include_once(ABSPATH.'wp-admin/admin-header.php'); if (!class_exists('UpdraftPlus_Notices')) updraft_try_include_file('includes/updraftplus-notices.php', 'include_once'); global $updraftplus_notices; $updraftplus_notices->do_notice('autobackup', 'autobackup'); } } /* * Show an administrative warning message, which can appear only on the UpdraftPlus plugin page * * @param String $message the HTML for the message (already escaped) * @param String $class CSS class to use for the div / public function show_plugin_page_admin_warning($message, $class = 'updated') { global $pagenow, $plugin_page; if (UpdraftPlus_Options::admin_page() !== $pagenow \|\| 'updraftplus' !== $plugin_page) return; $this->show_admin_warning($message, $class); } /* * Paint a div for a dashboard warning * * @param String $message - the HTML for the message (already escaped) * @param String $class - CSS class to use for the div / public function show_admin_warning($message, $class = 'updated') { echo '<div class="updraftmessage '.esc_attr($class).'"><p>'.$message.'</p></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- As the docblock says, the $message param should be already escaped before passing it to this method } public function show_admin_warning_multiple_storage_options() { $this->show_admin_warning('<strong>UpdraftPlus:</strong> '.__('An error occurred when fetching storage module options: ', 'updraftplus').htmlspecialchars($this->storage_module_option_errors), 'error'); } public function show_admin_warning_unwritable() { // One of the translators has erroneously changed "Backup" into "Back up" (which means, "reverse" !) $unwritable_mess = htmlspecialchars(str_ireplace('Back Up', 'Backup', __("The 'Backup Now' button is disabled as your backup directory is not writable (go to the 'Settings' tab and find the relevant option).", 'updraftplus'))); $this->show_admin_warning($unwritable_mess, "error"); } public function show_admin_nosettings_warning() { $this->show_admin_warning('<strong>'.__('Welcome to UpdraftPlus!', 'updraftplus').'</strong> '.str_ireplace('Back Up', 'Backup', __('To make a backup, just press the Backup Now button.', 'updraftplus')).' <a href="'.esc_url(UpdraftPlus::get_current_clean_url()).'" id="updraft-navtab-settings2">'.__('To change any of the default settings of what is backed up, to configure scheduled backups, to send your backups to remote storage (recommended), and more, go to the settings tab.', 'updraftplus').'</a>', 'updated notice is-dismissible'); } public function show_admin_warning_execution_time() { $this->show_admin_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.sprintf(__('The amount of time allowed for WordPress plugins to run is very low (%s seconds) - you should increase it to avoid backup failures due to time-outs (consult your web hosting company for more help - it is the max_execution_time PHP setting; the recommended value is %s seconds or more)', 'updraftplus'), (int) @ini_get('max_execution_time'), 90));// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } public function show_admin_warning_disabledcron() { $ret = '<div class="updraftmessage updated"><p>'; $ret .= '<strong>'.__('Warning', 'updraftplus').':</strong> '.__('The scheduler is disabled in your WordPress install, via the DISABLE_WP_CRON setting.', 'updraftplus').' '.__('No backups can run (even "Backup Now") unless either you have set up a facility to call the scheduler manually, or until it is enabled.', 'updraftplus').' <a href="'.apply_filters('updraftplus_com_link', "https://teamupdraft.com/documentation/updraftplus/topics/backing-up/troubleshooting/scheduled-or-manual-backup-stops-mid-way/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=unknown&utm_creative_format=unknown").'" target="_blank">'.__('Go here for more information.', 'updraftplus').'</a>'; $ret .= '</p></div>'; return $ret; } public function show_admin_warning_diskspace() { $this->show_admin_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.sprintf(__('You have less than %s of free disk space on the disk which UpdraftPlus is configured to use to create backups.', 'updraftplus'), '35 MB').' '.__('UpdraftPlus could well run out of space.', 'updraftplus').' '.__('Contact your the operator of your server (e.g. your web hosting company) to resolve this issue.', 'updraftplus')); } public function show_admin_warning_wordpressversion() { $this->show_admin_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.sprintf(__('UpdraftPlus does not officially support versions of WordPress before %s.', 'updraftplus'), '3.2').' '.__('It may work for you, but if it does not, then please be aware that no support is available until you upgrade WordPress.', 'updraftplus')); } public function show_admin_warning_litespeed() { $this->show_admin_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.sprintf(__('Your website is hosted using the %s web server.', 'updraftplus'), 'LiteSpeed').' <a href="'.apply_filters('updraftplus_com_link', "https://updraftplus.com/faqs/i-am-having-trouble-backing-up-and-my-web-hosting-company-uses-the-litespeed-webserver/").'" target="_blank">'.__('Please consult this FAQ if you have problems backing up.', 'updraftplus').'</a>', 'updated admin-warning-litespeed notice is-dismissible'); } public function show_admin_warning_pclzip() { $this->show_admin_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.__('Neither the PHP zip module nor a zip executable are available on your webserver.', 'updraftplus').' '.__('Consequently, UpdraftPlus will use a built-in zip module (PclZip); this is significantly slower.', 'updraftplus').' '.__('To get faster backups, ask your web hosting provider how to turn on the PHP zip module on your hosting.', 'updraftplus').' <a href="'.apply_filters('updraftplus_com_link', "https://updraftplus.com/faqs/why-are-my-backups-slow/").'" target="_blank">'.__('Go here for more information.', 'updraftplus').'</a>', 'updated admin-warning-pclzip notice is-dismissible'); } public function show_admin_debug_warning() { $this->show_admin_warning('<strong>'.__('Notice', 'updraftplus').':</strong> '.__('UpdraftPlus\'s debug mode is on.', 'updraftplus').' '.__('You may see debugging notices on this page not just from UpdraftPlus, but from any other plugin installed.', 'updraftplus').' '.__('Please try to make sure that the notice you are seeing is from UpdraftPlus before you raise a support request.', 'updraftplus').'</a>'); } /* * Show dismissible PHPSecLib's admin notice on all admin pages, except UpdraftPlus plugin page / public function show_admin_warning_phpseclib() { global $updraftplus, $pagenow, $plugin_page; static $printed = false; if ($printed) return; $dismissible = (UpdraftPlus_Options::admin_page() !== $pagenow \|\| 'updraftplus' !== $plugin_page) && (!isset($_REQUEST['action']) \|\| 'updraft_savesettings' !== $_REQUEST['action']); $class = ''; if ($dismissible && true == UpdraftPlus_Options::get_updraft_option('updraft_dismiss_phpseclib_notice', false)) return; if ($dismissible) $class = 'ud-phpseclib-notice is-dismissible'; $this->show_admin_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.$updraftplus->get_phpseclib_warning_msg(), "notice notice-warning $class"); $printed = true; } /* * Return an admin warning notice * * @param Integer $howmany * * @return String / public function show_admin_warning_overdue_crons($howmany) { $ret = '<div class="updraftmessage updated"><p>'; $ret .= '<strong>'.__('Warning', 'updraftplus').':</strong> '.sprintf(__('WordPress has a number (%d) of scheduled tasks which are overdue.', 'updraftplus'), $howmany).' '.__('Unless this is a development site, this means that the scheduler in your WordPress install is not working properly.', 'updraftplus').' <a href="'.apply_filters('updraftplus_com_link', "https://teamupdraft.com/documentation/updraftplus/topics/general/troubleshooting/how-to-fix-the-wordpress-missed-schedule-error/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=unknown&utm_creative_format=unknown").'" target="_blank">'.__('Read this page for a guide to possible causes and how to fix it.', 'updraftplus').'</a>'; $ret .= '</p></div>'; return $ret; } /* * Output authorisation links for any un-authorised Dropbox settings instances / public function show_admin_warning_dropbox() { $this->get_method_auth_link('dropbox'); } /* * Output authorisation links for any un-authorised Dropbox settings instances / public function show_admin_warning_pcloud() { $this->get_method_auth_link('pcloud'); } /* * Output authorisation links for any un-authorised OneDrive settings instances / public function show_admin_warning_onedrive() { $this->get_method_auth_link('onedrive'); } public function show_admin_warning_updraftvault() { $this->show_admin_warning('<strong>'.__('UpdraftPlus notice:', 'updraftplus').'</strong> '.sprintf(__('%s has been chosen for remote storage, but you are not currently connected.', 'updraftplus'), 'UpdraftVault').' <a href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus&tab=settings#remote-storage-updraftvault" class="updraftplus-remote-storage-link">'.sprintf(__('Go here to complete your settings for %s.', 'updraftplus'), 'UpdraftVault').'</a>', 'updated'); } /* * Output authorisation links for any un-authorised Google Drive settings instances / public function show_admin_warning_googledrive() { $this->get_method_auth_link('googledrive'); } /* * Output authorisation links for any un-authorised Google Cloud settings instances / public function show_admin_warning_googlecloud() { $this->get_method_auth_link('googlecloud'); } /* * Show DreamObjects cluster migration warning / public function show_admin_warning_dreamobjects() { $this->show_admin_warning('<strong>'.__('UpdraftPlus notice:', 'updraftplus').'</strong> '.sprintf(__('The %s endpoint is scheduled to shut down on the 1st October 2018.', 'updraftplus'), 'objects-us-west-1.dream.io').' '.__('You will need to switch to a different end-point and migrate your data before that date.', 'updraftplus').' '.sprintf(__('%sPlease see this article for more information%s'), '<a href="https://help.dreamhost.com/hc/en-us/articles/360002135871-Cluster-migration-procedure" target="_blank">', '</a>'), 'updated'); } /* * Show DreamObjects invalid custom endpoint error. * * @return void / public function show_admin_error_dreamobjects_invalid_custom_endpoint() { $this->show_admin_warning( '<strong>'.__('Error:', 'updraftplus').'</strong> '. / translators: %s: Non-translated string 'DreamObjects'. / sprintf(__('Invalid custom %s endpoint.', 'updraftplus'), '<em>DreamObjects</em>').' '. / translators: %s: Desired endpoint format. / sprintf(__('Please enter the endpoint in the format "%s".', 'updraftplus'), '<em>s3.<region>.dream.io</em>'), 'error' ); } /* * Show notice if the account connection attempted to register with UDC Cloud but could not due to lack of licences / public function show_admin_warning_udc_couldnt_connect() { $this->show_admin_warning('<strong>'.__('Notice', 'updraftplus').':</strong> '.sprintf(__('Connection to your %s account was successful.', 'updraftplus'), 'UpdraftPlus.com').' '.sprintf(__('However, we were not able to register this site with %1$s, as there are no available %1$s licences on the account.', 'updraftplus'), 'UpdraftCentral Cloud'), 'updated'); } /* * Output warning of Microsoft Azure Germany shutdown / public function show_admin_warning_azure_germany() { $this->show_admin_warning('<strong>'.__('UpdraftPlus notice', 'updraftplus').':</strong> '.sprintf(__('Due to the shutdown of the %1$s endpoint, support for %1$s will be ending soon.', 'updraftplus'), 'Azure Germany').' '.__('You will need to migrate to the Global endpoint in your UpdraftPlus settings.', 'updraftplus').' '.sprintf(__('For more information, please see: %s', 'updraftplus'), '<a href="https://www.microsoft.com/en-us/cloud-platform/germany-cloud-regions" target="_blank">https://www.microsoft.com/en-us/cloud-platform/germany-cloud-regions</a>'), 'updated'); } /* * Output warning of Microsoft OneDrive Germany shutdown / public function show_admin_warning_onedrive_germany() { $this->show_admin_warning('<strong>'.__('UpdraftPlus notice', 'updraftplus').':</strong> '.sprintf(__('Due to the shutdown of the %1$s endpoint, support for %1$s will be ending soon.', 'updraftplus'), 'OneDrive Germany').' '.__('You will need to migrate to the Global endpoint in your UpdraftPlus settings.', 'updraftplus').' '.sprintf(__('For more information, please see: %s', 'updraftplus'), '<a href="https://www.microsoft.com/en-us/cloud-platform/germany-cloud-regions" target="_blank">https://www.microsoft.com/en-us/cloud-platform/germany-cloud-regions</a>'), 'updated'); } /* * This method will setup the storage object and get the authentication link ready to be output with the notice * * @param String $method - the remote storage method / public function get_method_auth_link($method) { $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array($method)); $object = $storage_objects_and_ids[$method]['object']; foreach ($this->auth_instance_ids[$method] as $instance_id) { $object->set_instance_id($instance_id); $this->show_admin_warning('<strong>'.__('UpdraftPlus notice:', 'updraftplus').'</strong> '.$object->get_authentication_link(false, false), 'updated updraft_authenticate_'.$method); } } /* * Start a download of a backup. This method is called via the AJAX action updraft_download_backup. May die instead of returning depending upon the mode in which it is called. / public function updraft_download_backup() { if (!UpdraftPlus_Options::user_can_manage()) die('Unauthorised.'); try { if (empty($_REQUEST['_wpnonce']) \|\| !wp_verify_nonce($_REQUEST['_wpnonce'], 'updraftplus_download')) die('Unauthorised.'); if (empty($_REQUEST['timestamp']) \|\| !is_numeric($_REQUEST['timestamp']) \|\| empty($_REQUEST['type'])) die; $findexes = empty($_REQUEST['findex']) ? array(0) : $_REQUEST['findex']; $stage = empty($_REQUEST['stage']) ? '' : sanitize_text_field($_REQUEST['stage']); $file_path = empty($_REQUEST['filepath']) ? '' : $_REQUEST['filepath']; // This call may not actually return, depending upon what mode it is called in $result = $this->do_updraft_download_backup($findexes, (string) $_REQUEST['type'], (int) $_REQUEST['timestamp'], $stage, false, $file_path); // In theory, if a response was already sent, then Connection: close has been issued, and a Content-Length. However, in https://updraftplus.com/forums/topic/pclzip_err_bad_format-10-invalid-archive-structure/ a browser ignores both of these, and then picks up the second output and complains. if (empty($result['already_closed'])) echo json_encode($result); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during download backup. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during download backup. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); } die(); } /* * Ensure that a specified backup is present, downloading if necessary (or delete it, if the parameters so indicate). N.B. This function may die(), depending on the request being made in $stage * * @param Array $findexes - the index number of the backup archive requested * @param String $type - the entity type (e.g. 'plugins') being requested * @param Integer $timestamp - identifier for the backup being requested (UNIX epoch time) * @param Mixed $stage - the stage; valid values include (have not audited for other possibilities) at least 'delete' and 2. * @param Callable\|Boolean $close_connection_callable - function used to close the connection to the caller; an array of data to return is passed. If false, then UpdraftPlus::close_browser_connection is called with a JSON version of the data. * @param String $file_path - an over-ride for where to download the file to (basename only) * * @return Array - summary of the results. May also just die. / public function do_updraft_download_backup($findexes, $type, $timestamp, $stage, $close_connection_callable = false, $file_path = '') { if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. global $updraftplus; if (!is_array($findexes)) $findexes = array($findexes); $connection_closed = false; // Check that it is a known entity type; if not, die if ('db' != substr($type, 0, 2)) { $backupable_entities = $updraftplus->get_backupable_file_entities(true); foreach ($backupable_entities as $t => $info) { if ($type == $t) $type_match = true; } if (empty($type_match)) return array('result' => 'error', 'code' => 'no_such_type'); } $debug_mode = UpdraftPlus_Options::get_updraft_option('updraft_debug_mode'); // Retrieve the information from our backup history $backup_history = UpdraftPlus_Backup_History::get_history(); foreach ($findexes as $findex) { // This is a bit ugly; these variables get placed back into $_POST (where they may possibly have come from), so that UpdraftPlus::log() can detect exactly where to log the download status. $_POST['findex'] = $findex; $_POST['type'] = $type; $_POST['timestamp'] = (int) $timestamp; // We already know that no possible entities have an MD5 clash (even after 2 characters) // Also, there's nothing enforcing a requirement that nonces are hexadecimal $job_nonce = dechex($timestamp).$findex.substr(md5($type), 0, 3); // You need a nonce before you can set job data. And we certainly don't yet have one. $updraftplus->backup_time_nonce($job_nonce); // Set the job type before logging, as there can be different logging destinations $updraftplus->jobdata_set('job_type', 'download'); $updraftplus->jobdata_set('job_time_ms', $updraftplus->job_time_ms); // Base name $file = $backup_history[$timestamp][$type]; // Deal with multi-archive sets if (is_array($file)) $file = $file[$findex]; if (false !== strpos($file_path, '..')) { error_log("UpdraftPlus_Admin::do_updraft_download_backup : invalid file_path: $file_path"); return array('result' => __('Error: invalid path', 'updraftplus')); } if (!empty($file_path)) $file = $file_path; // Where it should end up being downloaded to $fullpath = $updraftplus->backups_dir_location().'/'.$file; if (!empty($file_path) && strpos(realpath($fullpath), realpath($updraftplus->backups_dir_location())) === false) { error_log("UpdraftPlus_Admin::do_updraft_download_backup : invalid fullpath: $fullpath"); return array('result' => __('Error: invalid path', 'updraftplus')); } if (2 == $stage) { $updraftplus->spool_file($fullpath); // We only want to remove if it was a temp file from the zip browser if (!empty($file_path)) @unlink($fullpath);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. // Do not return - we do not want the caller to add any output die; } if ('delete' == $stage) { @unlink($fullpath);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. $updraftplus->log("The file has been deleted ($file)"); return array('result' => 'deleted'); } // TODO: FIXME: Failed downloads may leave log files forever (though they are small) if ($debug_mode) $updraftplus->logfile_open($updraftplus->nonce); $error_levels = version_compare(PHP_VERSION, '8.4.0', '>=') ? E_ALL : E_ALL & ~E_STRICT; set_error_handler(array($updraftplus, 'php_error'), $error_levels); $updraftplus->log("Requested to obtain file: timestamp=$timestamp, type=$type, index=$findex"); $itext = empty($findex) ? '' : $findex; $known_size = isset($backup_history[$timestamp][$type.$itext.'-size']) ? $backup_history[$timestamp][$type.$itext.'-size'] : 0; $services = isset($backup_history[$timestamp]['service']) ? $backup_history[$timestamp]['service'] : false; $services = $updraftplus->get_canonical_service_list($services); $updraftplus->jobdata_set('service', $services); // Fetch it from the cloud, if we have not already got it $needs_downloading = false; if (!file_exists($fullpath) && empty($services)) { $updraftplus->log('This file does not exist locally, and there is no remote storage for this file.'); } elseif (!file_exists($fullpath)) { // If the file doesn't exist and they're using one of the cloud options, fetch it down from the cloud. $needs_downloading = true; $updraftplus->log('File does not yet exist locally - needs downloading'); } elseif (is_array($services) && 1 == count($services) && 'email' == $services[0]) { $updraftplus->log(__('The email protocol does not allow a remote backup to be retrieved from an email that has been sent.', 'updraftplus').' '.__('Therefore, please download the attachment from the original backup email and upload it using the "Upload backup files" facility in the "Existing Backups" tab.', 'updraftplus'), 'error'); $updraftplus->jobdata_set('dlfile_'.$timestamp.'_'.$type.'_'.$findex, 'failed'); $updraftplus->jobdata_set('dlerrors_'.$timestamp.'_'.$type.'_'.$findex, $updraftplus->errors); return array('result' => 'error', 'code' => 'no_email_download'); } elseif ($known_size > 0 && filesize($fullpath) < $known_size) { $updraftplus->log("The file was found locally (".filesize($fullpath).") but did not match the size in the backup history ($known_size) - will resume downloading"); $needs_downloading = true; } elseif ($known_size > 0 && filesize($fullpath) > $known_size) { $updraftplus->log("The file was found locally (".filesize($fullpath).") but the size is larger than what is recorded in the backup history ($known_size) - will try to continue but if errors are encountered then check that the backup is correct"); } elseif ($known_size > 0) { $updraftplus->log('The file was found locally and matched the recorded size from the backup history ('.round($known_size/1024, 1).' KB)'); } else { $updraftplus->log('No file size was found recorded in the backup history. We will assume the local one is complete.'); $known_size = filesize($fullpath); } // The AJAX responder that updates on progress wants to see this $updraftplus->jobdata_set('dlfile_'.$timestamp.'_'.$type.'_'.$findex, "downloading:$known_size:$fullpath"); if ($needs_downloading) { // Update the "last modified" time to dissuade any other instances from thinking that no downloaders are active @touch($fullpath);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $msg = array( 'result' => 'needs_download', 'request' => array( 'type' => $type, 'timestamp' => $timestamp, 'findex' => $findex ) ); if ($close_connection_callable && is_callable($close_connection_callable) && !$connection_closed) { $connection_closed = true; call_user_func($close_connection_callable, $msg); } elseif (!$connection_closed) { $connection_closed = true; $updraftplus->close_browser_connection(json_encode($msg)); } UpdraftPlus_Storage_Methods_Interface::get_remote_file($services, $file, $timestamp); $needs_downloading = false; } // Now, be ready to spool the thing to the browser if (is_file($fullpath) && is_readable($fullpath) && !$needs_downloading) { // That message is then picked up by the AJAX listener $updraftplus->jobdata_set('dlfile_'.$timestamp.'_'.$type.'_'.$findex, 'downloaded:'.filesize($fullpath).":$fullpath"); $result = 'downloaded'; } elseif ($needs_downloading) { $updraftplus->jobdata_set('dlfile_'.$timestamp.'_'.$type.'_'.$findex, 'failed'); $updraftplus->jobdata_set('dlerrors_'.$timestamp.'_'.$type.'_'.$findex, $updraftplus->errors); $updraftplus->log('Remote fetch failed. File '.$fullpath.' did not exist or was unreadable. If you delete local backups then remote retrieval may have failed.'); $result = 'download_failed'; } else { $result = 'no_local_file'; } restore_error_handler(); if ($debug_mode) @fclose($updraftplus->logfile_handle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!$debug_mode) @unlink($updraftplus->logfile_name);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } // The browser connection was possibly already closed, but not necessarily return array('result' => $result, 'already_closed' => $connection_closed); } /* * This is used as a callback * * @param Mixed $msg The data to be JSON encoded and sent back / public function _updraftplus_background_operation_started($msg) { global $updraftplus; // The extra spaces are because of a bug seen on one server in handling of non-ASCII characters; see HS#11739 $updraftplus->close_browser_connection(json_encode($msg).' '); } public function updraft_ajax_handler() { $nonce = empty($_REQUEST['nonce']) ? '' : $_REQUEST['nonce']; if (!wp_verify_nonce($nonce, 'updraftplus-credentialtest-nonce') \|\| empty($_REQUEST['subaction'])) die('Security check'); $subaction = $_REQUEST['subaction']; // Mitigation in case the nonce leaked to an unauthorised user if ('dismissautobackup' == $subaction) { if (!current_user_can('update_plugins') && !current_user_can('update_themes')) return; } elseif ('dismissexpiry' == $subaction \|\| 'dismissdashnotice' == $subaction) { if (!current_user_can('update_plugins')) return; } else { if (!UpdraftPlus_Options::user_can_manage()) return; } // All others use _POST $data_in_get = array('get_log', 'get_fragment'); // UpdraftPlus_WPAdmin_Commands extends UpdraftPlus_Commands - i.e. all commands are in there if (!class_exists('UpdraftPlus_WPAdmin_Commands')) updraft_try_include_file('includes/class-wpadmin-commands.php', 'include_once'); $commands = new UpdraftPlus_WPAdmin_Commands($this); if (method_exists($commands, $subaction)) { $data = in_array($subaction, $data_in_get) ? $_GET : $_POST; // Undo WP's slashing of GET/POST data $data = UpdraftPlus_Manipulation_Functions::wp_unslash($data); // TODO: Once all commands come through here and through updraft_send_command(), the data should always come from this attribute (once updraft_send_command() is modified appropriately). if (isset($data['action_data'])) $data = $data['action_data']; try { $results = call_user_func(array($commands, $subaction), $data); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during '.$subaction.' subaction. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); die; // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during '.$subaction.' subaction. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); die; } if (is_wp_error($results)) { $results = array( 'result' => false, 'error_code' => $results->get_error_code(), 'error_message' => $results->get_error_message(), 'error_data' => $results->get_error_data(), ); } if (is_string($results)) { // A handful of legacy methods, and some which are directly the source for iframes, for which JSON is not appropriate. echo $results; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped --the escaping should take place at the time the caller of this ajax handler receives a response from its request possibly after calling wp_remote_() or JS jQuery.ajax() } else { echo json_encode($results); } die; } // Below are all the commands not ported over into class-commands.php or class-wpadmin-commands.php if ('activejobs_list' == $subaction) { try { // N.B. Also called from autobackup.php // TODO: This should go into UpdraftPlus_Commands, once the add-ons have been ported to use updraft_send_command() echo json_encode($this->get_activejobs_list(UpdraftPlus_Manipulation_Functions::wp_unslash($_GET))); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during get active job list. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during get active job list. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); } } elseif ('httpget' == $subaction) { try { // httpget $curl = empty($_REQUEST['curl']) ? false : true; echo $this->http_get(UpdraftPlus_Manipulation_Functions::wp_unslash($_REQUEST['uri']), $curl); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during http get. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during http get. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); } } elseif ('doaction' == $subaction && !empty($_REQUEST['subsubaction']) && 'updraft_' == substr($_REQUEST['subsubaction'], 0, 8)) { $subsubaction = $_REQUEST['subsubaction']; try { // These generally echo and die - they will need further work to port to one of the command classes. Some may already have equivalents in UpdraftPlus_Commands, if they are used from UpdraftCentral. do_action(UpdraftPlus_Manipulation_Functions::wp_unslash($subsubaction), $_REQUEST); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during doaction subaction with '.$subsubaction.' subsubaction. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); die; // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during doaction subaction with '.$subsubaction.' subsubaction. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); die; } } die; } /** * Run a credentials test for the indicated remote storage module * * @param Array $test_settings The test parameters, including the method itself indicated in the key 'method' * @param Boolean $return_instead_of_echo Whether to return or echo the results. N.B. More than just the results to echo will be returned * @return Array\|Void - the results, if they are being returned (rather than echoed). Keys: 'output' (the output), 'data' (other data) / public function do_credentials_test($test_settings, $return_instead_of_echo = false) { $method = (!empty($test_settings['method']) && preg_match("/^[a-z0-9]+$/", $test_settings['method'])) ? $test_settings['method'] : ""; $objname = "UpdraftPlus_BackupModule_$method"; $this->logged = array(); // TODO: Add action for WP HTTP SSL stuff $error_levels = version_compare(PHP_VERSION, '8.4.0', '>=') ? E_ALL : E_ALL & ~E_STRICT; set_error_handler(array($this, 'get_php_errors'), $error_levels); if (!class_exists($objname)) include_once(UPDRAFTPLUS_DIR."/methods/$method.php"); $ret = ''; $data = null; // TODO: Add action for WP HTTP SSL stuff if (method_exists($objname, "credentials_test")) { $obj = new $objname; if ($return_instead_of_echo) ob_start(); $data = $obj->credentials_test($test_settings); if ($return_instead_of_echo) $ret .= ob_get_clean(); } if (count($this->logged) >0) { $ret .= "\n\n".__('Messages:', 'updraftplus')."\n"; foreach ($this->logged as $err) { $ret .= " $err\n"; } if (!$return_instead_of_echo) echo $ret; } restore_error_handler(); if ($return_instead_of_echo) return array('output' => $ret, 'data' => $data); } /** * Delete a backup set, whilst respecting limits on how much to delete in one go * * @uses remove_backup_set_cleanup() * @param Array $opts - deletion options; with keys backup_timestamp, delete_remote, [remote_delete_limit] * @return Array - as from remove_backup_set_cleanup() / public function delete_set($opts) { global $updraftplus; if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $backups = UpdraftPlus_Backup_History::get_history(); $timestamps = (string) $opts['backup_timestamp']; $remote_delete_limit = (isset($opts['remote_delete_limit']) && $opts['remote_delete_limit'] > 0) ? (int) $opts['remote_delete_limit'] : PHP_INT_MAX; $processed_instance_ids = !empty($opts['processed_instance_ids']) && is_array($opts['processed_instance_ids']) ? $opts['processed_instance_ids'] : array(); $is_continuation = $opts['is_continuation']; $timestamps = explode(',', $timestamps); $deleted_timestamps = ''; $delete_remote = empty($opts['delete_remote']) ? false : true; // You need a nonce before you can set job data. And we certainly don't yet have one. $updraftplus->backup_time_nonce(); // Set the job type before logging, as there can be different logging destinations $updraftplus->jobdata_set('job_type', 'delete'); $updraftplus->jobdata_set('job_time_ms', $updraftplus->job_time_ms); if (UpdraftPlus_Options::get_updraft_option('updraft_debug_mode')) { $updraftplus->logfile_open($updraftplus->nonce); $error_levels = version_compare(PHP_VERSION, '8.4.0', '>=') ? E_ALL : E_ALL & ~E_STRICT; set_error_handler(array($updraftplus, 'php_error'), $error_levels); } $updraft_dir = $updraftplus->backups_dir_location(); $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); $local_deleted = 0; $remote_deleted = 0; $sets_removed = 0; $deletion_errors = array(); $timestamps_list = implode(',', $timestamps); if (!$is_continuation) { foreach ($timestamps as $i => $timestamp) { unset($backups[$timestamp]['instance_file_deletions_error']); } } foreach ($timestamps as $i => $timestamp) { if (!isset($backups[$timestamp])) { return array('result' => 'error', 'message' => __('Backup set not found', 'updraftplus')); } $nonce = isset($backups[$timestamp]['nonce']) ? $backups[$timestamp]['nonce'] : ''; $delete_from_service = array(); if ($delete_remote) { // Locate backup set if (isset($backups[$timestamp]['service'])) { // Convert to an array so that there is no uncertainty about how to process it $services = is_string($backups[$timestamp]['service']) ? array($backups[$timestamp]['service']) : $backups[$timestamp]['service']; if (is_array($services)) { foreach ($services as $service) { if (is_string($service) && 'none' != $service && 'email' != $service) $delete_from_service[] = $service; } } } } $delete_from_service = array_unique($delete_from_service); // it's possible that the same service was added more than one thus deleting already-done files over and over, we've seen a case when using SFTP service with two instance IDs and when rescanning remote storage will make two SFTP services appearing in the associated raw backup history $files_to_delete = array(); foreach ($backupable_entities as $key => $ent) { if (isset($backups[$timestamp][$key])) { $files_to_delete[$key] = $backups[$timestamp][$key]; } } // Delete DB foreach ($backups[$timestamp] as $key => $value) { if ('db' == strtolower(substr($key, 0, 2)) && '-size' != substr($key, -5, 5)) { $files_to_delete[$key] = $backups[$timestamp][$key]; } } // Also delete the log if ($nonce && !UpdraftPlus_Options::get_updraft_option('updraft_debug_mode')) { $files_to_delete['log'] = "log.$nonce.txt"; } $updraftplus->register_wp_http_option_hooks(); $start_time_for_file_deletions = microtime(true); foreach ($files_to_delete as $key => $files) { if (is_string($files)) $files = array($files); foreach ($files as $file) { if (is_file($updraft_dir.'/'.$file) && @unlink($updraft_dir.'/'.$file)) $local_deleted++;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } if ('log' != $key && count($delete_from_service) > 0) { $entity_total_files = count($files); $entity_total_instances = 0; $entity_remote_deleted = 0; $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids($delete_from_service); foreach ($delete_from_service as $service) { if ('email' == $service \|\| 'none' == $service \|\| !$service) continue; $deleted = -1; $remote_obj = $storage_objects_and_ids[$service]['object']; $instance_settings = $storage_objects_and_ids[$service]['instance_settings']; $this->backups_instance_ids = empty($backups[$timestamp]['service_instance_ids'][$service]) ? array() : $backups[$timestamp]['service_instance_ids'][$service]; if (empty($instance_settings)) continue; uksort($instance_settings, array($this, 'instance_ids_sort')); foreach ($instance_settings as $instance_id => $options) { if (in_array($timestamp.'-'.$instance_id.'-'.$key, $processed_instance_ids)) continue; // see the unset($backups[$timestamp]['instance_file_deletions_error']); few lines below to see why we use this $entity_total_instances++; $remote_obj->set_options($options, false, $instance_id); foreach ($files as $file) { $hashed_file = md5($instance_id.$file); if (isset($backups[$timestamp]['instance_file_deletions_done']) && in_array($hashed_file, $backups[$timestamp]['instance_file_deletions_done'])) continue; if ($is_continuation && isset($backups[$timestamp]['instance_file_deletions_error']) && in_array($hashed_file, $backups[$timestamp]['instance_file_deletions_error'])) continue; // if it's a continuation then we don't want to retry deleting the same file over and over $deleted = $remote_obj->delete($file); if (true === $deleted) { $backups[$timestamp]['instance_file_deletions_done'][] = $hashed_file; $remote_deleted++; $entity_remote_deleted++; } else { // Handle abstracted error codes/return fail status. Including handle array/objects returned if (is_object($deleted) \|\| is_array($deleted)) $deleted = false; if (!array_key_exists($instance_id, $deletion_errors)) { $deletion_errors[$instance_id] = array('error_code' => $deleted, 'service' => $service); } $backups[$timestamp]['instance_file_deletions_error'][] = $hashed_file; } if (floor(microtime(true)-$start_time_for_file_deletions) >= $remote_delete_limit) { return $this->remove_backup_set_cleanup(false, $backups, $local_deleted, $remote_deleted, $sets_removed, $timestamps_list, $deleted_timestamps, $deletion_errors, $processed_instance_ids); } } $processed_instance_ids[] = $timestamp.'-'.$instance_id.'-'.$key; } } if ($entity_total_files $entity_total_instances === $entity_remote_deleted) { unset($backups[$timestamp][$key]); for ($file_index=1; $file_index < $entity_total_files; $file_index++) { unset($backups[$timestamp][$key.$file_index.'-size']); if (isset($backups[$timestamp]['checksums']) && is_array($backups[$timestamp]['checksums'])) { foreach (array_keys($backups[$timestamp]['checksums']) as $algo) { unset($backups[$timestamp]['checksums'][$algo][$key.$file_index]); } } } unset($backups[$timestamp][$key.'-size']); if (isset($backups[$timestamp]['checksums']) && is_array($backups[$timestamp]['checksums'])) { foreach (array_keys($backups[$timestamp]['checksums']) as $algo) { unset($backups[$timestamp]['checksums'][$algo][$key."0"]); } } } } } if (empty($backups[$timestamp]['instance_file_deletions_error'])) { unset($backups[$timestamp]); unset($timestamps[$i]); if ('' != $deleted_timestamps) $deleted_timestamps .= ','; $deleted_timestamps .= $timestamp; $timestamps_list = implode(',', $timestamps); $sets_removed++; } else { // we already have $processed_instance_ids variable that stores all already-done instances and it's going to be used during the continuation as long as it gets returned to the JS caller // so we unset the instance_file_deletions_error variable to prevent backup history from swelling unset($backups[$timestamp]['instance_file_deletions_error']); } } return $this->remove_backup_set_cleanup(true, $backups, $local_deleted, $remote_deleted, $sets_removed, $timestamps_list, $deleted_timestamps, $deletion_errors); } /** * This function sorts the array of instance ids currently saved so that any instance id that is in both the saved settings and the backup history move to the top of the array, as these are likely to work. Then values that don't appear in the backup history move to the bottom. * * @param String $a - the first instance id * @param String $b - the second instance id * @return Integer - returns an integer to indicate what position the $b value should be moved in / public function instance_ids_sort($a, $b) { if (in_array($a, $this->backups_instance_ids)) { if (in_array($b, $this->backups_instance_ids)) return 0; return -1; } return in_array($b, $this->backups_instance_ids) ? 1 : 0; } /* * Called by self::delete_set() to finish up before returning (whether the complete deletion is finished or not) * * @param Boolean $delete_complete - whether the whole set is now gone (i.e. last round) * @param Array $backups - the backup history * @param Integer $local_deleted - how many backup archives were deleted from local storage * @param Integer $remote_deleted - how many backup archives were deleted from remote storage * @param Integer $sets_removed - how many complete sets were removed * @param String $timestamps - a csv of remaining timestamps * @param String $deleted_timestamps - a csv of deleted timestamps * @param Array $deletion_errors - an array of abstracted deletion errors, consisting of [error_code, service, instance]. For user notification purposes only, main error logging occurs at service. * @param Array $processed_instance_ids - a list of processed instance IDs prefixed with their corresponding timestamp * * @return Array - information on the status, suitable for returning to the UI / public function remove_backup_set_cleanup($delete_complete, $backups, $local_deleted, $remote_deleted, $sets_removed, $timestamps, $deleted_timestamps, $deletion_errors = array(), $processed_instance_ids = array()) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- $deletion_errors was used below but the code has been commented out. Can both be removed? global $updraftplus; $updraftplus->register_wp_http_option_hooks(false); UpdraftPlus_Backup_History::save_history($backups); $updraftplus->log("Local files deleted: $local_deleted. Remote files deleted: $remote_deleted"); / Disable until next release $error_messages = array(); $storage_details = array(); foreach ($deletion_errors as $instance => $entry) { $service = $entry['service']; if (!array_key_exists($service, $storage_details)) { // As errors from multiple instances of a service can be present, store the service storage object for possible use later $new_service = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array($service)); $storage_details = array_merge($storage_details, $new_service); } $intance_label = !empty($storage_details[$service]['instance_settings'][$instance]['instance_label']) ? $storage_details[$service]['instance_settings'][$instance]['instance_label'] : $service; switch ($entry['error_code']) { case 'authentication_fail': $error_messages[] = sprintf(__("The authentication failed for '%s'.", 'updraftplus').' '.__('Please check your credentials.', 'updraftplus'), $intance_label); break; case 'service_unavailable': $error_messages[] = sprintf(__("We were unable to access '%s'.", 'updraftplus').' '.__('Service unavailable.', 'updraftplus'), $intance_label); break; case 'container_access_error': $error_messages[] = sprintf(__("We were unable to access the folder/container for '%s'.", 'updraftplus').' '.__('Please check your permissions.', 'updraftplus'), $intance_label); break; case 'file_access_error': $error_messages[] = sprintf(__("We were unable to access a file on '%s'.", 'updraftplus').' '.__('Please check your permissions.', 'updraftplus'), $intance_label); break; case 'file_delete_error': $error_messages[] = sprintf(__("We were unable to delete a file on '%s'.", 'updraftplus').' '.__('The file may no longer exist or you may not have permission to delete.', 'updraftplus'), $intance_label); break; default: $error_messages[] = sprintf(__("An error occurred while attempting to delete from '%s'.", 'updraftplus'), $intance_label); break; } } / // $error_message_string = implode("\n", $error_messages); $error_message_string = ''; if ($delete_complete) { $set_message = __('Backup sets removed:', 'updraftplus'); $local_message = __('Local files deleted:', 'updraftplus'); $remote_message = __('Remote files deleted:', 'updraftplus'); if (UpdraftPlus_Options::get_updraft_option('updraft_debug_mode')) { restore_error_handler(); } return array('result' => 'success', 'set_message' => $set_message, 'local_message' => $local_message, 'remote_message' => $remote_message, 'backup_sets' => $sets_removed, 'backup_local' => $local_deleted, 'backup_remote' => $remote_deleted, 'deleted_timestamps' => $deleted_timestamps, 'error_messages' => $error_message_string); } else { return array('result' => 'continue', 'backup_local' => $local_deleted, 'backup_remote' => $remote_deleted, 'backup_sets' => $sets_removed, 'timestamps' => $timestamps, 'deleted_timestamps' => $deleted_timestamps, 'error_messages' => $error_message_string, 'processed_instance_ids' => $processed_instance_ids); } } /* * Get the history status HTML and other information * * @param Boolean $rescan - whether to rescan local storage * @param Boolean $remotescan - whether to also rescan remote storage * @param Boolean $debug - whether to return debugging information also * @param Integer $backup_count - a count of the total backups we want to display on the front end for use by UpdraftPlus_Backup_History::existing_backup_table() * * @return Array - the information requested / public function get_history_status($rescan, $remotescan, $debug = false, $backup_count = 0) { global $updraftplus; if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT); // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ($rescan) $messages = UpdraftPlus_Backup_History::rebuild($remotescan, false, $debug); $backup_history = UpdraftPlus_Backup_History::get_history(); $output = UpdraftPlus_Backup_History::existing_backup_table($backup_history, $backup_count); $data = array(); if (!empty($messages) && is_array($messages)) { $noutput = ''; foreach ($messages as $msg) { if (is_string($msg)) { $noutput .= '<li><em>'.$msg.'</em></li>'; } else { if (empty($msg['code']) \|\| 'file-listing' != $msg['code']) { $noutput .= '<li>'.(empty($msg['desc']) ? '' : $msg['desc'].': ').'<em>'.$msg['message'].'</em></li>'; } if (!empty($msg['data'])) { $key = $msg['method'].'-'.$msg['service_instance_id']; $data[$key] = $msg['data']; } } } if ($noutput) { $output = '<div style="margin-left: 100px; margin-top: 10px;"><ul style="list-style: disc inside;">'.$noutput.'</ul></div>'.$output; } } $logs_exist = (false !== strpos($output, 'downloadlog')); if (!$logs_exist) { list($mod_time, $log_file, $nonce) = $updraftplus->last_modified_log();// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Unused parameter is present because the method returns an array. if ($mod_time) $logs_exist = true; } return apply_filters('updraftplus_get_history_status_result', array( 'n' => __('Existing backups', 'updraftplus').' <span class="updraft_existing_backups_count">'.count($backup_history).'</span>', 't' => $output, // table 'data' => $data, 'cksum' => md5($output), 'logs_exist' => $logs_exist, 'web_server_disk_space' => UpdraftPlus_Filesystem_Functions::web_server_disk_space(true), )); } /* * Stop an active backup job * * @param String $job_id - job ID of the job to stop * * @return Array - information on the outcome of the attempt / public function activejobs_delete($job_id) { if (preg_match("/^[0-9a-f]{12}$/", $job_id)) { global $updraftplus; $cron = get_option('cron', array()); $jobdata = $updraftplus->jobdata_getarray($job_id); if (!empty($jobdata['clone_job']) && !empty($jobdata['clone_id']) && !empty($jobdata['secret_token'])) { $clone_id = $jobdata['clone_id']; $secret_token = $jobdata['secret_token']; $updraftplus->get_updraftplus_clone()->clone_failed_delete(array('clone_id' => $clone_id, 'secret_token' => $secret_token)); } $updraft_dir = $updraftplus->backups_dir_location(); if (file_exists($updraft_dir.'/log.'.$job_id.'.txt')) touch($updraft_dir.'/deleteflag-'.$job_id.'.txt'); foreach ($cron as $time => $job) { if (!isset($job['updraft_backup_resume'])) continue; foreach ($job['updraft_backup_resume'] as $hook => $info) { if (isset($info['args'][1]) && $info['args'][1] == $job_id) { $args = $cron[$time]['updraft_backup_resume'][$hook]['args']; wp_unschedule_event($time, 'updraft_backup_resume', $args); if (!class_exists('Updraft_Semaphore_3_0')) updraft_try_include_file('includes/class-updraft-semaphore.php', 'include_once'); $updraftplus_semaphore = new Updraft_Semaphore_3_0('udp_backupjob_'.$job_id); $updraftplus_semaphore->delete(); return array('ok' => 'Y', 'c' => 'deleted', 'm' => __('Job deleted', 'updraftplus')); } } } } return array('ok' => 'N', 'c' => 'not_found', 'm' => __('Could not find that job - perhaps it has already finished?', 'updraftplus')); } /* * Input: an array of items * Each item is in the format: <base>,<timestamp>,<type>(,<findex>) * The 'base' is not for us: we just pass it straight back * * @param array $downloaders Array of Items to download * @return array / public function get_download_statuses($downloaders) { global $updraftplus; $download_status = array(); foreach ($downloaders as $downloader) { // prefix, timestamp, entity, index if (preg_match('/^([^,]+),(\d+),([-a-z]+\|db[0-9]+),(\d+)$/', $downloader, $matches)) { $findex = (empty($matches[4])) ? '0' : $matches[4]; $updraftplus->nonce = dechex($matches[2]).$findex.substr(md5($matches[3]), 0, 3); $updraftplus->jobdata_reset(); $status = $this->download_status($matches[2], $matches[3], $matches[4]); if (is_array($status)) { $status['base'] = $matches[1]; $status['timestamp'] = $matches[2]; $status['what'] = $matches[3]; $status['findex'] = $findex; $download_status[] = $status; } } } return $download_status; } /* * Get, as HTML output, a list of active jobs * * @param Array $request - details on the request being made (e.g. extra info to include) * * @return String / public function get_activejobs_list($request) { global $updraftplus; $download_status = empty($request['downloaders']) ? array() : $this->get_download_statuses(explode(':', $request['downloaders'])); if (!empty($request['oneshot'])) { $job_id = get_site_option('updraft_oneshotnonce', false); // print_active_job() for one-shot jobs that aren't in cron $active_jobs = (false === $job_id) ? '' : $this->print_active_job($job_id, true); } elseif (!empty($request['thisjobonly'])) { // print_active_jobs() is for resumable jobs where we want the cron info to be included in the output $active_jobs = $this->print_active_jobs($request['thisjobonly']); } else { $active_jobs = $this->print_active_jobs(); } $logupdate_array = array(); if (!empty($request['log_fetch'])) { if (isset($request['log_nonce'])) { $log_nonce = $request['log_nonce']; $log_pointer = isset($request['log_pointer']) ? absint($request['log_pointer']) : 0; $logupdate_array = $this->fetch_log($log_nonce, $log_pointer); } } $res = array( // We allow the front-end to decide what to do if there's nothing logged - we used to (up to 1.11.29) send a pre-defined message 'l' => htmlspecialchars(UpdraftPlus_Options::get_updraft_lastmessage()), 'j' => $active_jobs, 'ds' => $download_status, 'u' => $logupdate_array, 'automatic_updates' => $updraftplus->is_automatic_updating_enabled() ); $res['hosting_restriction'] = $updraftplus->is_hosting_backup_limit_reached(); return $res; } /* * Start a new backup * * @param Array $request * @param Boolean\|Callable $close_connection_callable / public function request_backupnow($request, $close_connection_callable = false) { global $updraftplus; $abort_before_booting = false; $backupnow_nocloud = !empty($request['backupnow_nocloud']); $request['incremental'] = !empty($request['incremental']); $entities = !empty($request['onlythisfileentity']) ? explode(',', $request['onlythisfileentity']) : array(); $remote_storage_instances = array(); // if only_these_cloud_services is not an array then all connected remote storage locations are being backed up to and we don't need to do this if (!empty($request['only_these_cloud_services']) && is_array($request['only_these_cloud_services'])) { $remote_storage_locations = $request['only_these_cloud_services']; foreach ($remote_storage_locations as $key => $value) { / This name key inside the value array is the remote storage method name prefixed by 31 characters (updraft_include_remote_service_) so we need to remove them to get the actual name, then the value key inside the value array has the instance id. / $remote_storage_instances[substr($value['name'], 31)][$key] = $value['value']; } } $incremental = $request['incremental'] ? apply_filters('updraftplus_prepare_incremental_run', false, $entities) : false; // The call to backup_time_nonce() allows us to know the nonce in advance, and return it $nonce = $updraftplus->backup_time_nonce(); $msg = array( 'nonce' => $nonce, 'm' => apply_filters('updraftplus_backupnow_start_message', '<strong>'.__('Start backup', 'updraftplus').':</strong> '.htmlspecialchars(__('OK.', 'updraftplus').' '.__('You should soon see activity in the "Last log message" field below.', 'updraftplus')), $nonce) ); if (!empty($request['backup_nonce']) && 'current' != $request['backup_nonce']) $msg['nonce'] = $request['backup_nonce']; if (!empty($request['incremental']) && !$incremental) { $msg = array( 'error' => __('No suitable backup set (that already contains a full backup of all the requested file component types) was found, to add increments to.', 'updraftplus').' '.__('Aborting this backup.', 'updraftplus') ); $abort_before_booting = true; } if ($close_connection_callable && is_callable($close_connection_callable)) { call_user_func($close_connection_callable, $msg); } else { $updraftplus->close_browser_connection(json_encode($msg)); } if ($abort_before_booting) die; $options = array('nocloud' => $backupnow_nocloud, 'use_nonce' => $nonce); if (!empty($request['onlythisfileentity']) && is_string($request['onlythisfileentity'])) { // Something to see in the 'last log' field when it first appears, before the backup actually starts $updraftplus->log(__('Start backup', 'updraftplus')); $options['restrict_files_to_override'] = explode(',', $request['onlythisfileentity']); } if ($request['incremental'] && !$incremental) { $updraftplus->log('An incremental backup was requested but no suitable backup found to add increments to; will proceed with a new backup'); $request['incremental'] = false; } if (!empty($request['extradata'])) $options['extradata'] = $request['extradata']; if (!empty($remote_storage_instances)) $options['remote_storage_instances'] = $remote_storage_instances; $options['always_keep'] = !empty($request['always_keep']); $event = empty($request['backupnow_nofiles']) ? (empty($request['backupnow_nodb']) ? 'updraft_backupnow_backup_all' : 'updraft_backupnow_backup') : 'updraft_backupnow_backup_database'; do_action($event, apply_filters('updraft_backupnow_options', $options, $request)); } /* * Get the contents of a log file * * @param String $backup_nonce - the backup id; or empty, for the most recently modified * @param Integer $log_pointer - the byte count to fetch from * @param String $output_format - the format to return in; allowed as 'html' (which will escape HTML entities in what is returned) and 'raw' * * @return String / public function fetch_log($backup_nonce = '', $log_pointer = 0, $output_format = 'html') { global $updraftplus; if (empty($backup_nonce)) { list($mod_time, $log_file, $nonce) = $updraftplus->last_modified_log();// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Unused parameter is present because the method returns an array. } else { $nonce = $backup_nonce; } if (!preg_match('/^[0-9a-f]+$/', $nonce)) die('Security check'); $log_content = ''; $new_pointer = $log_pointer; if (!empty($nonce)) { $updraft_dir = $updraftplus->backups_dir_location(); $potential_log_file = $updraft_dir."/log.".$nonce.".txt"; if (is_readable($potential_log_file)) { $templog_array = array(); $log_file = fopen($potential_log_file, "r"); if ($log_pointer > 0) fseek($log_file, $log_pointer); while (($buffer = fgets($log_file, 4096)) !== false) { $templog_array[] = $buffer; } if (!feof($log_file)) { $templog_array[] = __('Error: unexpected file read fail', 'updraftplus'); } $new_pointer = ftell($log_file); $log_content = implode("", $templog_array); } else { $log_content .= __('The log file could not be read.', 'updraftplus'); } } else { $log_content .= __('The log file could not be read.', 'updraftplus'); } if ('html' == $output_format) $log_content = htmlspecialchars($log_content); $ret_array = array( 'log' => $log_content, 'nonce' => $nonce, 'pointer' => $new_pointer ); return $ret_array; } /* * Get a count for the number of overdue cron jobs * * @return Integer - how many cron jobs are overdue / public function howmany_overdue_crons() { $how_many_overdue = 0; if (function_exists('_get_cron_array') \|\| (is_file(ABSPATH.WPINC.'/cron.php') && include_once(ABSPATH.WPINC.'/cron.php') && function_exists('_get_cron_array'))) { $crons = _get_cron_array(); if (is_array($crons)) { $timenow = time(); foreach ($crons as $jt => $job) { if ($jt < $timenow) $how_many_overdue++; } } } return $how_many_overdue; } public function get_php_errors($errno, $errstr, $errfile, $errline) { global $updraftplus; if (0 == error_reporting()) return true; $logline = $updraftplus->php_error_to_logline($errno, $errstr, $errfile, $errline); if (false !== $logline) $this->logged[] = $logline; // Don't pass it up the chain (since it's going to be output to the user always) return true; } private function download_status($timestamp, $type, $findex) { global $updraftplus; $response = array('m' => $updraftplus->jobdata_get('dlmessage_'.$timestamp.'_'.$type.'_'.$findex).'<br>'); if ($file = $updraftplus->jobdata_get('dlfile_'.$timestamp.'_'.$type.'_'.$findex)) { if ('failed' == $file) { $response['e'] = __('Download failed', 'updraftplus').'<br>'; $response['failed'] = true; $errs = $updraftplus->jobdata_get('dlerrors_'.$timestamp.'_'.$type.'_'.$findex); if (is_array($errs) && !empty($errs)) { $response['e'] .= '<ul class="disc">'; foreach ($errs as $err) { if (is_array($err)) { $response['e'] .= '<li>'.htmlspecialchars($err['message']).'</li>'; } else { $response['e'] .= '<li>'.htmlspecialchars($err).'</li>'; } } $response['e'] .= '</ul>'; } } elseif (preg_match('/^downloaded:(\d+):(.)$/', $file, $matches) && file_exists($matches[2])) { $response['p'] = 100; $response['f'] = $matches[2]; $response['s'] = (int) $matches[1]; $response['t'] = (int) $matches[1]; $response['m'] = __('File ready.', 'updraftplus'); if ('db' != substr($type, 0, 2)) $response['can_show_contents'] = true; } elseif (preg_match('/^downloading:(\d+):(.)$/', $file, $matches) && file_exists($matches[2])) { // Convert to bytes $response['f'] = $matches[2]; $total_size = (int) max($matches[1], 1); $cur_size = filesize($matches[2]); $response['s'] = $cur_size; $file_age = time() - filemtime($matches[2]); if ($file_age > 20) $response['a'] = time() - filemtime($matches[2]); $response['t'] = $total_size; $response['m'] .= __("Download in progress", 'updraftplus').' ('.round($cur_size/1024).' / '.round(($total_size/1024)).' KB)'; $response['p'] = round(100$cur_size/$total_size); } else { $response['m'] .= __('No local copy present.', 'updraftplus'); $response['p'] = 0; $response['s'] = 0; $response['t'] = 1; } } return $response; } /** * Used with the WP filter upload_dir to adjust where uploads go to when uploading a backup * * @param Array $uploads - pre-filter array * * @return Array - filtered array / public function upload_dir($uploads) { global $updraftplus; $updraft_dir = $updraftplus->backups_dir_location(); if (is_writable($updraft_dir)) $uploads['path'] = $updraft_dir; return $uploads; } /* * We do actually want to over-write * * @param String $dir Directory * @param String $name Name * @param String $ext File extension * * @return String / public function unique_filename_callback($dir, $name, $ext) {// phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found -- Filter use return $name.$ext; } public function sanitize_file_name($filename) { // WordPress 3.4.2 on multisite (at least) adds in an unwanted underscore return preg_replace('/-db(.)\.gz_\.crypt$/', '-db$1.gz.crypt', $filename); } /** * Runs upon the WordPress action plupload_action / public function plupload_action() { global $updraftplus; if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!UpdraftPlus_Options::user_can_manage()) return; check_ajax_referer('updraft-uploader'); $updraft_dir = $updraftplus->backups_dir_location(); if (!@UpdraftPlus_Filesystem_Functions::really_is_writable($updraft_dir)) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. echo json_encode(array('e' => sprintf(__("Backup directory (%s) is not writable, or does not exist.", 'updraftplus'), $updraft_dir).' '.__('You will find more information about this in the Settings section.', 'updraftplus'))); exit; } add_filter('upload_dir', array($this, 'upload_dir')); add_filter('sanitize_file_name', array($this, 'sanitize_file_name')); // handle file upload $farray = array('test_form' => true, 'action' => 'plupload_action'); $farray['test_type'] = false; $farray['ext'] = 'x-gzip'; $farray['type'] = 'application/octet-stream'; if (!isset($_POST['chunks'])) { $farray['unique_filename_callback'] = array($this, 'unique_filename_callback'); } $status = wp_handle_upload( $_FILES['async-upload'], $farray ); remove_filter('upload_dir', array($this, 'upload_dir')); remove_filter('sanitize_file_name', array($this, 'sanitize_file_name')); if (isset($status['error'])) { echo json_encode(array('e' => $status['error'])); exit; } // If this was the chunk, then we should instead be concatenating onto the final file if (isset($_POST['chunks']) && isset($_POST['chunk']) && preg_match('/^[0-9]+$/', $_POST['chunk'])) { $final_file = basename($_POST['name']); if (!rename($status['file'], $updraft_dir.'/'.$final_file.'.'.$_POST['chunk'].'.zip.tmp')) { @unlink($status['file']);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. echo json_encode(array('e' => sprintf(__('Error: %s', 'updraftplus'), __('This file could not be uploaded', 'updraftplus')))); exit; } $status['file'] = $updraft_dir.'/'.$final_file.'.'.$_POST['chunk'].'.zip.tmp'; } $response = array(); if (!isset($_POST['chunks']) \|\| (isset($_POST['chunk']) && preg_match('/^[0-9]+$/', $_POST['chunk']) && $_POST['chunk'] == $_POST['chunks']-1) && isset($final_file)) { if (!preg_match('/^log\.[a-f0-9]{12}\.txt/i', $final_file) && !preg_match('/^backup_([\-0-9]{15})_._([0-9a-f]{12})-([\-a-z]+)([0-9]+)?(\.(zip\|gz\|gz\.crypt))?$/i', $final_file, $matches)) { $accept = apply_filters('updraftplus_accept_archivename', array()); if (is_array($accept)) { foreach ($accept as $acc) { if (preg_match('/'.$acc['pattern'].'/i', $final_file)) { $response['dm'] = sprintf(__('This backup was created by %s, and can be imported.', 'updraftplus'), $acc['desc']); } } } if (empty($response['dm'])) { if (isset($status['file'])) @unlink($status['file']);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. echo json_encode(array('e' => sprintf(__('Error: %s', 'updraftplus'), __('Bad filename format - this does not look like a file created by UpdraftPlus', 'updraftplus')))); exit; } } else { $backupable_entities = $updraftplus->get_backupable_file_entities(true); $type = isset($matches[3]) ? $matches[3] : ''; if (!preg_match('/^log\.[a-f0-9]{12}\.txt/', $final_file) && 'db' != $type && !isset($backupable_entities[$type])) { if (isset($status['file'])) @unlink($status['file']);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. echo json_encode(array('e' => sprintf(__('Error: %s', 'updraftplus'), sprintf(__('This looks like a file created by UpdraftPlus, but this install does not know about this type of object: %s.', 'updraftplus'), htmlspecialchars($type)).' '.__('Perhaps you need to install an add-on?', 'updraftplus')))); exit; } } // Final chunk? If so, then stich it all back together if (isset($_POST['chunk']) && $_POST['chunk'] == $_POST['chunks']-1 && !empty($final_file)) { if ($wh = fopen($updraft_dir.'/'.$final_file, 'wb')) { for ($i = 0; $i < $_POST['chunks']; $i++) { $rf = $updraft_dir.'/'.$final_file.'.'.$i.'.zip.tmp'; if ($rh = fopen($rf, 'rb+')) { // April 1st 2020 - Due to a bug during uploads to Dropbox some backups had string "null" appended to the end which caused warnings, this removes the string "null" from these backups fseek($rh, -4, SEEK_END); $data = fgets($rh, 5); if ("null" === $data) { ftruncate($rh, filesize($rf) - 4); } fseek($rh, 0, SEEK_SET); while ($line = fread($rh, 524288)) { fwrite($wh, $line); } fclose($rh); @unlink($rf);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } } fclose($wh); $status['file'] = $updraft_dir.'/'.$final_file; if ('.tar' == substr($final_file, -4, 4)) { if (file_exists($status['file'].'.gz')) unlink($status['file'].'.gz'); if (file_exists($status['file'].'.bz2')) unlink($status['file'].'.bz2'); } elseif ('.tar.gz' == substr($final_file, -7, 7)) { if (file_exists(substr($status['file'], 0, strlen($status['file'])-3))) unlink(substr($status['file'], 0, strlen($status['file'])-3)); if (file_exists(substr($status['file'], 0, strlen($status['file'])-3).'.bz2')) unlink(substr($status['file'], 0, strlen($status['file'])-3).'.bz2'); } elseif ('.tar.bz2' == substr($final_file, -8, 8)) { if (file_exists(substr($status['file'], 0, strlen($status['file'])-4))) unlink(substr($status['file'], 0, strlen($status['file'])-4)); if (file_exists(substr($status['file'], 0, strlen($status['file'])-4).'.gz')) unlink(substr($status['file'], 0, strlen($status['file'])-3).'.gz'); } } } } // send the uploaded file url in response $response['m'] = $status['url']; echo json_encode($response); exit; } /** * Database decrypter - runs upon the WP action plupload_action2 / public function plupload_action2() { if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. global $updraftplus; if (!UpdraftPlus_Options::user_can_manage()) return; check_ajax_referer('updraft-uploader'); $updraft_dir = $updraftplus->backups_dir_location(); if (!is_writable($updraft_dir)) exit; add_filter('upload_dir', array($this, 'upload_dir')); add_filter('sanitize_file_name', array($this, 'sanitize_file_name')); // handle file upload $farray = array('test_form' => true, 'action' => 'plupload_action2'); $farray['test_type'] = false; $farray['ext'] = 'crypt'; $farray['type'] = 'application/octet-stream'; if (isset($_POST['chunks'])) { // $farray['ext'] = 'zip'; // $farray['type'] = 'application/zip'; } else { $farray['unique_filename_callback'] = array($this, 'unique_filename_callback'); } $status = wp_handle_upload( $_FILES['async-upload'], $farray ); remove_filter('upload_dir', array($this, 'upload_dir')); remove_filter('sanitize_file_name', array($this, 'sanitize_file_name')); if (isset($status['error'])) die('ERROR: '.wp_kses_post($status['error'])); // If this was the chunk, then we should instead be concatenating onto the final file if (isset($_POST['chunks']) && isset($_POST['chunk']) && preg_match('/^[0-9]+$/', $_POST['chunk'])) { $final_file = basename($_POST['name']); rename($status['file'], $updraft_dir.'/'.$final_file.'.'.$_POST['chunk'].'.zip.tmp'); $status['file'] = $updraft_dir.'/'.$final_file.'.'.$_POST['chunk'].'.zip.tmp'; } if (!isset($_POST['chunks']) \|\| (isset($_POST['chunk']) && $_POST['chunk'] == $_POST['chunks']-1)) { if (!preg_match('/^backup_([\-0-9]{15})_._([0-9a-f]{12})-db([0-9]+)?\.(gz\.crypt)$/i', $final_file)) { @unlink($status['file']);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. echo 'ERROR:'.wp_kses_post(__('Bad filename format - this does not look like an encrypted database file created by UpdraftPlus', 'updraftplus')); exit; } // Final chunk? If so, then stich it all back together if (isset($_POST['chunk']) && $_POST['chunk'] == $_POST['chunks']-1 && isset($final_file)) { if ($wh = fopen($updraft_dir.'/'.$final_file, 'wb')) { for ($i=0; $i<$_POST['chunks']; $i++) { $rf = $updraft_dir.'/'.$final_file.'.'.$i.'.zip.tmp'; if ($rh = fopen($rf, 'rb')) { while ($line = fread($rh, 524288)) { fwrite($wh, $line); } fclose($rh); @unlink($rf);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } } fclose($wh); } } } // send the uploaded file url in response if (isset($final_file)) echo 'OK:'.wp_kses_post($final_file); exit; } /** * Show footer review message and link. * * @return string / public function display_footer_review_message() { $message = sprintf( __('Enjoyed %s? Please leave us a %s rating on %s or %s', 'updraftplus').' '.__('We really appreciate your support!', 'updraftplus'), '<b>UpdraftPlus</b>', '<span style="color:#2271b1">&starf;&starf;&starf;&starf;&starf;</span>', '<a href="https://trustpilot.com/review/updraftplus.com" target="_blank">Trustpilot</a>', '<a href="https://www.g2.com/products/updraftplus/reviews" target="_blank">G2.com</a>' ); return $message; } /* * Include the settings header template / public function settings_header() { $this->include_template('wp-admin/settings/header.php'); } /* * Include the settings footer template / public function settings_footer() { $this->include_template('wp-admin/settings/footer.php'); } /* * Output the settings page content. Will also run a restore if $_REQUEST so indicates. / public function settings_output() { if (false == ($render = apply_filters('updraftplus_settings_page_render', true))) { do_action('updraftplus_settings_page_render_abort', $render); return; } do_action('updraftplus_settings_page_init'); global $updraftplus; /* * We use request here because the initial restore is triggered by a POSTed form. we then may need to obtain credential for the WP_Filesystem. to do this WP outputs a form, but we don't pass our parameters via that. So the values are passed back in as GET parameters. / if (isset($_REQUEST['action']) && (('updraft_restore' == $_REQUEST['action'] && isset($_REQUEST['backup_timestamp'])) \|\| ('updraft_restore_continue' == $_REQUEST['action'] && !empty($_REQUEST['job_id'])))) { $this->prepare_restore(); return; } if (isset($_REQUEST['action']) && 'updraft_delete_old_dirs' == $_REQUEST['action']) { $nonce = empty($_REQUEST['updraft_delete_old_dirs_nonce']) ? '' : $_REQUEST['updraft_delete_old_dirs_nonce']; if (!wp_verify_nonce($nonce, 'updraftplus-credentialtest-nonce')) die('Security check'); $this->delete_old_dirs_go(); return; } if (!empty($_REQUEST['action']) && 'updraftplus_broadcastaction' == $_REQUEST['action'] && !empty($_REQUEST['subaction'])) { $nonce = (empty($_REQUEST['nonce'])) ? "" : $_REQUEST['nonce']; if (!wp_verify_nonce($nonce, 'updraftplus-credentialtest-nonce')) die('Security check'); do_action($_REQUEST['subaction']); return; } if (isset($_GET['error'])) { // This is used by Microsoft OneDrive authorisation failures (May 15). I am not sure what may have been using the 'error' GET parameter otherwise - but it is harmless. June 2024: also now used for insufficient Google Drive permissions upon return from auth.updraftplus.com. if (!empty($_GET['error_description'])) { $this->show_admin_warning(htmlspecialchars($_GET['error_description']).' ('.htmlspecialchars($_GET['error']).')', 'error'); } else { $this->show_admin_warning(htmlspecialchars($_GET['error']), 'error'); } } if (isset($_GET['message'])) $this->show_admin_warning(htmlspecialchars($_GET['message'])); if (isset($_GET['action']) && 'updraft_create_backup_dir' == $_GET['action'] && isset($_GET['nonce']) && wp_verify_nonce($_GET['nonce'], 'create_backup_dir')) { $created = $this->create_backup_dir(); if (is_wp_error($created)) { echo '<p>'.esc_html__('Backup directory could not be created', 'updraftplus').'...<br>'; echo '<ul class="disc">'; foreach ($created->get_error_messages() as $msg) { echo '<li>'.esc_html($msg).'</li>'; } echo '</ul></p>'; } elseif (false !== $created) { echo '<p>'.esc_html__('Backup directory successfully created.', 'updraftplus').'</p><br>'; } echo '<b>'.esc_html__('Actions', 'updraftplus').':</b> <a href="'.esc_url(UpdraftPlus_Options::admin_page_url().'?page=updraftplus').'">'.esc_html__('Return to UpdraftPlus configuration', 'updraftplus').'</a>'; return; } if (substr($updraftplus->version, 0, 1) === '2') { /* * Add filter for display footer review message and link. / add_filter('admin_footer_text', array($this, 'display_footer_review_message')); } echo '<div id="updraft_backup_started" class="updated updraft-hidden" style="display:none;"></div>'; // This opens a div $this->settings_header(); ?> <div id="updraft-hidethis"> <p> <strong><?php esc_html_e('Warning:', 'updraftplus'); ?> <?php esc_html_e("If you can still read these words after the page finishes loading, then there is a JavaScript or jQuery problem in the site.", 'updraftplus'); ?></strong> <?php if (false !== strpos(basename(UPDRAFTPLUS_URL), ' ')) { ?> <strong><?php echo esc_html(__('The UpdraftPlus directory in wp-content/plugins has white-space in it; WordPress does not like this.', 'updraftplus').' '.__('You should rename the directory to wp-content/plugins/updraftplus to fix this problem.', 'updraftplus'));?></strong> <?php } else { ?> <a href="<?php echo esc_url(apply_filters('updraftplus_com_link', "https://updraftplus.com/do-you-have-a-javascript-or-jquery-error/"));?>" target="_blank"><?php esc_html_e('Go here for more information.', 'updraftplus'); ?></a> <?php } ?> </p> </div> <?php $include_deleteform_div = true; // Opens a div, which needs closing later if (isset($_GET['updraft_restore_success'])) { if (get_template() === 'optimizePressTheme' \|\| is_plugin_active('optimizePressPlugin') \|\| is_plugin_active_for_network('optimizePressPlugin')) { $this->show_admin_warning("<a href='https://optimizepress.zendesk.com/hc/en-us/articles/203699826-Update-URL-References-after-moving-domain' target='_blank'>" . __("OptimizePress 2.0 encodes its contents, so search/replace does not work.", "updraftplus") . ' ' . __("To fix this problem go here.", "updraftplus") . "</a>", "notice notice-warning"); } $restore_success_no_addons = (isset($_GET['pval']) && 0 == $_GET['pval'] && !$updraftplus->have_addons) ? true : false; echo "<div class=\"updated backup-restored\"><span><strong>".esc_html__('Your backup has been restored.', 'updraftplus').'</strong></span><br>'; // Unnecessary - will be advised of this below // if (2 == $_GET['updraft_restore_success']) echo ' '.__('Your old (themes, uploads, plugins, whatever) directories have been retained with "-old" appended to their name. Remove them when you are satisfied that the backup worked properly.'); $include_deleteform_div = false; } if ($this->scan_old_dirs(true)) $this->print_delete_old_dirs_form(true, $include_deleteform_div); // Close the div opened by the earlier section if (isset($_GET['updraft_restore_success'])) echo '</div>'; if (empty($restore_success_no_addons) && empty($this->no_settings_warning)) { if (!class_exists('UpdraftPlus_Notices')) updraft_try_include_file('includes/updraftplus-notices.php', 'include_once'); global $updraftplus_notices; $backup_history = UpdraftPlus_Backup_History::get_history(); $review_dismiss = UpdraftPlus_Options::get_updraft_option('dismissed_review_notice', 0); $backup_dir = $updraftplus->backups_dir_location(); // N.B. Not an exact proxy for the installed time; they may have tweaked the expert option to move the directory $installed = @filemtime($backup_dir.'/index.html');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $installed_for = time() - $installed; $advert = false; if (!empty($backup_history) && $installed && time() > $review_dismiss && $installed_for > 2886400 && $installed_for < 8486400) { $advert = 'rate'; } $updraftplus_notices->do_notice($advert); } if (!$updraftplus->memory_check(64)) { // HS8390 - A case where UpdraftPlus::memory_check_current() returns -1 $memory_check_current = $updraftplus->memory_check_current(); if ($memory_check_current > 0) { ?> <div class="updated memory-limit"><?php echo esc_html(__('Your PHP memory limit (set by your web hosting company) is very low.', 'updraftplus').' '.__('UpdraftPlus attempted to raise it but was unsuccessful.', 'updraftplus').' '.__('This plugin may struggle with a memory limit of less than 64 Mb - especially if you have very large files uploaded (though on the other hand, many sites will be successful with a 32Mb limit - your experience may vary).', 'updraftplus').' '.__('Current limit is:', 'updraftplus').' '.$updraftplus->memory_check_current()); ?> MB</div> <?php } } if (!empty($updraftplus->errors)) { echo '<div class="error updraft_list_errors">'; $updraftplus->list_errors(); echo '</div>'; } $backup_history = UpdraftPlus_Backup_History::get_history(); if (empty($backup_history)) { UpdraftPlus_Backup_History::rebuild(); $backup_history = UpdraftPlus_Backup_History::get_history(); } $tabflag = 'backups'; $main_tabs = $this->get_main_tabs_array(); if (isset($_REQUEST['tab'])) { $request_tab = sanitize_text_field($_REQUEST['tab']); $valid_tabflags = array_keys($main_tabs); if (in_array($request_tab, $valid_tabflags)) { $tabflag = $request_tab; } else { $tabflag = 'backups'; } } $this->include_template('wp-admin/settings/tab-bar.php', false, array('main_tabs' => $main_tabs, 'backup_history' => $backup_history, 'tabflag' => $tabflag)); ?> <div id="updraft-poplog" > <pre id="updraft-poplog-content"></pre> </div> <?php $this->include_template('wp-admin/settings/delete-and-restore-modals.php'); ?> <div id="updraft-navtab-backups-content" <?php if ('backups' != $tabflag) echo 'class="updraft-hidden"'; ?> style="<?php if ('backups' != $tabflag) echo 'display:none;'; ?>"> <?php $is_opera = (false !== strpos($_SERVER['HTTP_USER_AGENT'], 'Opera') \|\| false !== strpos($_SERVER['HTTP_USER_AGENT'], 'OPR/')); $tmp_opts = array('include_opera_warning' => $is_opera); $this->include_template('wp-admin/settings/tab-backups.php', false, array('backup_history' => $backup_history, 'options' => $tmp_opts)); $this->include_template('wp-admin/settings/upload-backups-modal.php'); ?> </div> <div id="updraft-navtab-migrate-content"<?php if ('migrate' != $tabflag) echo ' class="updraft-hidden"'; ?> style="<?php if ('migrate' != $tabflag) echo 'display:none;'; ?>"> <?php if (has_action('updraftplus_migrate_tab_output')) { do_action('updraftplus_migrate_tab_output'); } else { $this->include_template('wp-admin/settings/migrator-no-migrator.php'); } ?> </div> <div id="updraft-navtab-settings-content" <?php if ('settings' != $tabflag) echo 'class="updraft-hidden"'; ?> style="<?php if ('settings' != $tabflag) echo 'display:none;'; ?>"> <h2 class="updraft_settings_sectionheading"><?php esc_html_e('Backup Contents And Schedule', 'updraftplus');?></h2> <?php UpdraftPlus_Options::options_form_begin(); ?> <?php $this->settings_formcontents(); ?> </form> <?php $our_keys = UpdraftPlus_Options::get_updraft_option('updraft_central_localkeys'); if (!is_array($our_keys)) $our_keys = array(); // Hide the UpdraftCentral Cloud wizard If the user already has a key created for either // updraftplus.com or self hosted version. if (empty($our_keys)) { ?> <div id="updraftcentral_cloud_connect_container" class="updraftcentral_cloud_connect hidden-in-updraftcentral"> <?php $email = ''; // Checking email from "Premium / Extensions" tab if (defined('UDADDONS2_SLUG')) { global $updraftplus_addons2; if (is_a($updraftplus_addons2, 'UpdraftPlusAddons2') && is_callable(array($updraftplus_addons2, 'get_option'))) { $options = $updraftplus_addons2->get_option(UDADDONS2_SLUG.'_options'); if (!empty($options['email'])) { $email = htmlspecialchars($options['email']); } } } // Check the vault's email if we fail to get the "email" from the "Premium / Extensions" tab if (empty($email)) { $settings = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('updraftvault'); if (!is_wp_error($settings)) { if (!empty($settings['settings'])) { foreach ($settings['settings'] as $storage_options) { if (!empty($storage_options['email'])) { $email = $storage_options['email']; break; } } } } } // Checking any possible email we could find from the "updraft_email" option in case the // above two checks failed. if (empty($email)) { $possible_emails = $updraftplus->just_one_email(UpdraftPlus_Options::get_updraft_option('updraft_email')); if (!empty($possible_emails)) { // If we get an array from the 'just_one_email' result then we're going // to pull the very first entry and make use of that on the succeeding process. if (is_array($possible_emails)) $possible_emails = array_shift($possible_emails); if (is_string($possible_emails)) { $emails = explode(',', $possible_emails); $email = trim($emails[0]); } } } $this->include_template('wp-admin/settings/updraftcentral-connect.php', false, array('email' => $email)); ?> </div> <?php } ?> </div> <div id="updraft-navtab-expert-content"<?php if ('expert' != $tabflag) echo ' class="updraft-hidden"'; ?> style="<?php if ('expert' != $tabflag) echo 'display:none;'; ?>"> <?php $this->settings_advanced_tools(); ?> </div> <div id="updraft-navtab-addons-content"<?php if ('addons' != $tabflag) echo ' class="updraft-hidden"'; ?> style="<?php if ('addons' != $tabflag) echo 'display:none;'; ?>"> <?php $tab_addons = $this->include_template('wp-admin/settings/tab-addons.php', true, array('tabflag' => $tabflag)); echo apply_filters('updraftplus_addonstab_content', $tab_addons);// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- this should be ignored because the variable contains html script tag ?> </div> <?php do_action('updraftplus_after_main_tab_content', $tabflag); // settings_header() opens a div $this->settings_footer(); } /* * Get main tabs array * * @return Array Array which have key as a tab key and value as tab label / private function get_main_tabs_array() { return apply_filters( 'updraftplus_main_tabs', array( 'backups' => __('Backup / Restore', 'updraftplus'), 'migrate' => __('Migrate / Clone', 'updraftplus'), 'settings' => __('Settings', 'updraftplus'), 'expert' => __('Advanced Tools', 'updraftplus'), 'addons' => __('Premium / Extensions', 'updraftplus'), ) ); } /* * Potentially register an action for showing restore progress / private function print_restore_in_progress_box_if_needed() { global $updraftplus; $check_restore_progress = $updraftplus->check_restore_progress(); // Check to see if the restore is still in progress if (is_array($check_restore_progress) && true == $check_restore_progress['status']) { $restore_jobdata = $check_restore_progress['restore_jobdata']; $restore_jobdata['jobid'] = $check_restore_progress['restore_in_progress']; $this->restore_in_progress_jobdata = $restore_jobdata; add_action('all_admin_notices', array($this, 'show_admin_restore_in_progress_notice')); add_action('admin_print_footer_scripts', array($this, 'print_unfinished_restoration_dialog_scripts')); add_action('admin_print_styles', array($this, 'print_unfinished_restoration_dialog_styles')); } } /* * This function is called via the command class, it will get the resume restore notice to be shown when a restore is taking place over AJAX * * @param string $job_id - the id of the job * * @return WP_Error\|string - can return a string containing html or a WP_Error / public function get_restore_resume_notice($job_id) { global $updraftplus; if (empty($job_id)) return new WP_Error('missing_parameter', 'Missing parameters.'); $restore_jobdata = $updraftplus->jobdata_getarray($job_id); if (!is_array($restore_jobdata) && empty($restore_jobdata)) return new WP_Error('missing_jobdata', 'Job data not found.'); $restore_jobdata['jobid'] = $job_id; $this->restore_in_progress_jobdata = $restore_jobdata; $html = $this->show_admin_restore_in_progress_notice(true); if (empty($html)) return new WP_Error('job_aborted', 'Job aborted.'); return $html; } /* * If added, then runs upon the WP action all_admin_notices, or can be called via get_restore_resume_notice() for when a restore is running over AJAX * * @param Boolean $return_instead_of_echo - indicates if we want to add the tfa UI * @param Boolean $exclude_js - indicates if we want to exclude the js in the returned html * * @return void\|string - can return a string containing html or echo the html to page / public function show_admin_restore_in_progress_notice($return_instead_of_echo = false) { if (isset($_REQUEST['action']) && 'updraft_restore_abort' === $_REQUEST['action'] && !empty($_REQUEST['job_id'])) { delete_site_option('updraft_restore_in_progress'); return; } $restore_jobdata = $this->restore_in_progress_jobdata; $seconds_ago = time() - (int) $restore_jobdata['job_time_ms']; $minutes_ago = floor($seconds_ago/60); $seconds_ago = $seconds_ago - $minutes_ago60; $time_ago = sprintf(__("%s minutes, %s seconds", 'updraftplus'), $minutes_ago, $seconds_ago); $html = '<div class="updated show_admin_restore_in_progress_notice"><div class="updraft_admin_restore_dialog">'; $html .= '<span class="unfinished-restoration"><strong>UpdraftPlus: '.__('Unfinished restoration', 'updraftplus').'</strong></span><br>'; $html .= '<p>'.sprintf(__('You have an unfinished restoration operation, begun %s ago.', 'updraftplus'), $time_ago).'</p>'; $html .= '<form method="post" action="'.esc_url(UpdraftPlus_Options::admin_page_url()).'?page=updraftplus">'; $html .= wp_nonce_field('updraftplus-credentialtest-nonce'); $html .= '<input id="updraft_restore_continue_action" type="hidden" name="action" value="updraft_restore_continue">'; $html .= '<input type="hidden" name="updraftplus_ajax_restore" value="continue_ajax_restore">'; $html .= '<input type="hidden" name="job_id" value="'.esc_attr($restore_jobdata['jobid']).'">'; $html .= '<button id="updraft_restore_resume" type="submit" class="button-primary">'.__('Continue restoration', 'updraftplus').'</button>'; $html .= '<button id="updraft_restore_abort" class="button-secondary">'.__('Dismiss', 'updraftplus').'</button>'; $html .= '</form></div></div>'; if ($return_instead_of_echo) return $html; add_filter('wp_kses_allowed_html', array($this, 'kses_allow_input_tags_on_unfinished_restoration_dialog')); echo wp_kses_post($html); remove_filter('wp_kses_allowed_html', array($this, 'kses_allow_input_tags_on_unfinished_restoration_dialog')); } /** * This method will build the UpdraftPlus.com login form and echo it to the page. * * @param String $option_page - the option page this form is being output to * @param Boolean $tfa - indicates if we want to add the tfa UI * @param Boolean $include_form_container - indicates if we want the form container * @param Array $further_options - other options (see below for the possibilities + defaults) * * @return void / public function build_credentials_form($option_page, $tfa = false, $include_form_container = true, $further_options = array()) { global $updraftplus; if (!in_array($option_page, array('updraftplus-addons', 'temporary_clone'))) { $further_options = wp_parse_args($further_options, array( 'under_username' => __("Not yet got an account (it's free)? Go get one!", 'updraftplus'), 'under_username_link' => $updraftplus->get_url('my-account') )); } if ($include_form_container) { UpdraftPlus_Options::options_form_begin('', false, array(), 'updraftplus_com_login'); // no need to echo as it's already echoed if (is_multisite()) echo '<input type="hidden" name="action" value="update">'; } else { echo '<div class="updraftplus_com_login">'; } $options = apply_filters('updraftplus_com_login_options', array("email" => "", "password" => "")); if ($include_form_container) { // We have to duplicate settings_fields() in order to set our referer // settings_fields(UDADDONS2_SLUG.'_options'); $option_group = $option_page.'_options'; echo "<input type='hidden' name='option_page' value='" . esc_attr($option_group) . "' />"; echo '<input type="hidden" name="action" value="update" />'; // wp_nonce_field("$option_group-options"); // This one is used on multisite echo '<input type="hidden" name="tab" value="addons" />'; $name = "_wpnonce"; $action = esc_attr($option_group."-options"); echo '<input type="hidden" name="' . esc_attr($name) . '" value="' . esc_attr(wp_create_nonce($action)) . '" />'; $referer = esc_url(UpdraftPlus_Manipulation_Functions::wp_unslash($_SERVER['REQUEST_URI'])); // This one is used on single site installs if (false === strpos($referer, '?')) { $referer .= '?tab=addons'; } else { $referer .= '&tab=addons'; } echo '<input type="hidden" name="_wp_http_referer" value="'.esc_attr($referer).'" />'; // End of duplication of settings-fields() } ?> <h2> <?php esc_html_e('Connect your TeamUpdraft.com account', 'updraftplus'); ?></h2> <p class="updraftplus_com_login_status"></p> <table class="form-table"> <tbody> <tr class="non_tfa_fields"> <th><?php esc_html_e('Email', 'updraftplus'); ?></th> <td> <label for="<?php echo esc_attr($option_page); ?>_options_email"> <input id="<?php echo esc_attr($option_page); ?>_options_email" type="text" size="36" name="<?php echo esc_attr($option_page); ?>_options[email]" value="<?php echo esc_attr($options['email']); ?>" /> <?php if (!empty($further_options['under_username_link']) && !empty($further_options['under_username'])) { ?> <br/> <a target="_blank" href="<?php echo esc_url($further_options['under_username_link']); ?>"><?php echo esc_html($further_options['under_username']); ?></a> <?php } ?> </label> </td> </tr> <tr class="non_tfa_fields"> <th><?php esc_html_e('Password', 'updraftplus'); ?></th> <td> <label for="<?php echo esc_attr($option_page); ?>_options_password"> <input id="<?php echo esc_attr($option_page); ?>_options_password" type="password" size="36" name="<?php echo esc_attr($option_page); ?>_options[password]" value="<?php echo empty($options['password']) ? '' : esc_attr($options['password']); ?>" /> <br/> <a target="_blank" href="<?php echo esc_url($updraftplus->get_url('lost-password')); ?>"><?php esc_html_e('Forgotten your details?', 'updraftplus'); ?></a> </label> </td> </tr> <?php if ('updraftplus-addons' == $option_page) { ?> <tr class="non_tfa_fields"> <th></th> <td> <label> <input type="checkbox" id="<?php echo esc_attr($option_page); ?>_options_auto_updates" data-updraft_settings_test="updraft_auto_updates" name="<?php echo esc_attr($option_page); ?>_options[updraft_auto_update]" value="1" <?php if ($updraftplus->is_automatic_updating_enabled()) echo 'checked="checked"'; ?> /> <?php esc_html_e('Ask WordPress to update UpdraftPlus automatically when an update is available', 'updraftplus');?> </label> <?php $our_keys = UpdraftPlus_Options::get_updraft_option('updraft_central_localkeys'); if (!is_array($our_keys)) $our_keys = array(); if (empty($our_keys)) : ?> <p class="<?php echo esc_attr($option_page); ?>-connect-to-udc"> <label> <input type="checkbox" id="<?php echo esc_attr($option_page); ?>_options_auto_udc_connect" name="<?php echo esc_attr($option_page); ?>_options[updraft_auto_udc_connect]" value="1" checked="checked" /> <?php esc_html_e('Add this website to UpdraftCentral (remote, centralised control) - free for up to 5 sites.', 'updraftplus'); ?> <a target="_blank" href="https://updraftcentral.com"><?php esc_html_e('Learn more about UpdraftCentral', 'updraftplus'); ?></a> </label> </p> <?php endif; ?> </td> </tr> <?php } ?> <?php if (isset($further_options['terms_and_conditions']) && isset($further_options['terms_and_conditions_link'])) { ?> <tr class="non_tfa_fields"> <th></th> <td> <input type="checkbox" class="<?php echo esc_attr($option_page); ?>_terms_and_conditions" name="<?php echo esc_attr($option_page); ?>_terms_and_conditions" value="1"> <a target="_blank" href="<?php echo esc_url($further_options['terms_and_conditions_link']); ?>"><?php echo esc_html($further_options['terms_and_conditions']); ?></a> </td> </tr> <?php } ?> <?php if ($tfa) { ?> <tr class="tfa_fields" style="display:none;"> <th><?php esc_html_e('One Time Password (check your OTP app to get this password)', 'updraftplus'); ?></th> <td> <label for="<?php echo esc_attr($option_page); ?>_options_two_factor_code"> <input id="<?php echo esc_attr($option_page); ?>_options_two_factor_code" type="text" size="10" name="<?php echo esc_attr($option_page); ?>_options[two_factor_code]" /> </label> </td> </tr> <?php } ?> </tbody> </table> <p class="updraft-after-form-table"> <?php $connect = esc_html__('Connect', 'updraftplus'); if ($include_form_container) { ?> <input type="submit" class="button-primary ud_connectsubmit" value="<?php echo esc_attr($connect); ?>" /> <?php } else { ?> <button class="button-primary ud_connectsubmit"><?php esc_html_e($connect); ?></button> <?php } ?> <span class="updraftplus_spinner spinner"><?php esc_html_e('Processing', 'updraftplus'); ?>...</span></p> <p class="updraft-after-form-table" style="font-size: 70%"><em><a href="https://teamupdraft.com/privacy/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=password-security&utm_creative_format=text" target="_blank"><?php esc_html_e('Interested in knowing about your password security? Read about it here.', 'updraftplus'); ?></a></em></p> <?php if ($include_form_container) { ?> </form> <?php } else { ?> </div> <?php } } /* * Return widgetry for the 'backup now' modal. * Don't optimise this method away; it's used by third-party plugins (e.g. EUM). * * @return String / public function backupnow_modal_contents() { return $this->include_template('wp-admin/settings/backupnow-modal.php', true); } /* * Also used by the auto-backups add-on * * @param Boolean $wide_format Whether to return data in a wide format * @param Boolean $print_active_jobs Whether to include currently active jobs * @return String - the HTML output / public function render_active_jobs_and_log_table($wide_format = false, $print_active_jobs = true) { global $updraftplus; ?> <div id="updraft_activejobs_table"> <?php $active_jobs = ($print_active_jobs) ? $this->print_active_jobs() : '';?> <div id="updraft_activejobsrow" class="<?php if (!$active_jobs && !$wide_format) { echo 'hidden'; } if ($wide_format) { echo ".minimum-height"; } ?>"> <div id="updraft_activejobs" class="<?php echo $wide_format ? 'wide-format' : ''; ?>"> <?php echo wp_kses_post($active_jobs); ?> </div> </div> <div id="updraft_lastlogmessagerow"> <?php if ($wide_format) { // Hide for now - too ugly ?> <div class="last-message"><strong><?php esc_html_e('Last log message', 'updraftplus');?>:</strong><br> <span id="updraft_lastlogcontainer"><?php echo wp_kses_post(UpdraftPlus_Options::get_updraft_lastmessage()); ?></span><br> <?php $this->most_recently_modified_log_link(); ?> </div> <?php } else { ?> <div> <strong><?php esc_html_e('Last log message', 'updraftplus');?>:</strong> <span id="updraft_lastlogcontainer"><?php echo wp_kses_post(UpdraftPlus_Options::get_updraft_lastmessage()); ?></span><br> <?php $this->most_recently_modified_log_link(); ?> </div> <?php } ?> </div> <?php // Currently disabled - not sure who we want to show this to if (1==0 && !defined('UPDRAFTPLUS_NOADS_B')) { $feed = $updraftplus->get_updraftplus_rssfeed(); if (is_a($feed, 'SimplePie')) { echo '<tr><th style="vertical-align:top;">'.esc_html__('Latest UpdraftPlus.com news:', 'updraftplus').'</th><td class="updraft_simplepie">'; echo '<ul class="disc;">'; foreach ($feed->get_items(0, 5) as $item) { echo '<li>'; echo '<a href="'.esc_attr($item->get_permalink()).'">'; echo esc_html($item->get_title()); // D, F j, Y H:i echo "</a> (".esc_html($item->get_date('j F Y')).")"; echo '</li>'; } echo '</ul></td></tr>'; } } ?> </div> <?php } /* * Output directly a link allowing download of the most recently modified log file / private function most_recently_modified_log_link() { global $updraftplus; list($mod_time, $log_file, $nonce) = $updraftplus->last_modified_log();// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Unused parameter is present because the method returns an array. ?> <a href="?page=updraftplus&action=downloadlatestmodlog&wpnonce=<?php echo esc_attr(wp_create_nonce('updraftplus_download')); ?>" <?php if (!$mod_time) echo 'style="display:none;"'; ?> class="updraft-log-link" onclick="event.preventDefault(); updraft_popuplog('');"><?php esc_html_e('Download most recently modified log file', 'updraftplus');?></a> <?php } public function settings_downloading_and_restoring($backup_history = array(), $return_result = false, $options = array()) { return $this->include_template('wp-admin/settings/downloading-and-restoring.php', $return_result, array('backup_history' => $backup_history, 'options' => $options)); } /* * Renders take backup content / public function take_backup_content() { global $updraftplus; $updraft_dir = $updraftplus->backups_dir_location(); $backup_disabled = UpdraftPlus_Filesystem_Functions::really_is_writable($updraft_dir) ? '' : 'disabled="disabled"'; $this->include_template('wp-admin/settings/take-backup.php', false, array('backup_disabled' => $backup_disabled)); } /* * Output a table row using the updraft_debugrow class * * @param String $head - header cell contents * @param String $content - content cell contents / public function settings_debugrow($head, $content) { echo "<tr class=\"updraft_debugrow\"><th>".$head."</th><td>".wp_kses($content, $this->kses_allow_tags())."</td></tr>"; } /* * Get site information data for advanced tools * * @param array $options Options for the site info (e.g. suppress_plugins_for_debugging) * @return array Site information data / public function get_site_info_data($options = array()) { global $updraftplus, $wpdb; $site_info_data = array(); // Server information if (function_exists('php_uname')) { // It appears (Mar 2015) that some mod_security distributions block the output of the string el6.x86_64 in PHP output, on the silly assumption that only hackers are interested in knowing what environment PHP is running on. $uname_info = @php_uname('s').' '.@php_uname('n').' ';// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $release_name = @php_uname('r');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (preg_match('/^(.)\.(x86_64\|[3456]86)$/', $release_name, $matches)) { $release_name = $matches[1].' '; } else { $release_name = ''; } // In case someone does something similar with just the processor type string $mtype = @php_uname('m');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ('x86_64' == $mtype) { $mtype = '64-bit'; } elseif (preg_match('/^i([3456]86)$/', $mtype, $matches)) { $mtype = $matches[1]; } $uname_info .= $release_name.$mtype.' '.@php_uname('v');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } else { $uname_info = PHP_OS; } $web_server = $_SERVER["SERVER_SOFTWARE"]; $site_info_data['web_server'] = array( 'label' => __('Web server:', 'updraftplus'), 'value' => htmlspecialchars($web_server).' ('.htmlspecialchars($uname_info).')' ); // UpdraftClone information if (defined('UPDRAFTPLUS_THIS_IS_CLONE')) { $response = wp_remote_get('http://169.254.169.254/metadata/v1/user-data', array('timeout' => 2)); if (!is_wp_error($response) && 200 === wp_remote_retrieve_response_code($response)) { $json_body = wp_remote_retrieve_body($response); $metadata = json_decode($json_body, true); if (isset($metadata['image_id'])) { $site_info_data['updraftclone_image'] = array( 'label' => __('UpdraftClone image:', 'updraftplus'), 'value' => htmlspecialchars($metadata['image_id']) ); } } } // WordPress paths $site_info_data['abspath'] = array( 'label' => 'ABSPATH:', 'value' => htmlspecialchars(ABSPATH) ); $site_info_data['wp_content_dir'] = array( 'label' => 'WP_CONTENT_DIR:', 'value' => htmlspecialchars(WP_CONTENT_DIR) ); $site_info_data['wp_plugin_dir'] = array( 'label' => 'WP_PLUGIN_DIR:', 'value' => htmlspecialchars(WP_PLUGIN_DIR) ); $site_info_data['table_prefix'] = array( 'label' => __('Table prefix:', 'updraftplus'), 'value' => htmlspecialchars($updraftplus->get_table_prefix()) ); // Disk space $site_info_data['disk_space'] = array( 'label' => __('Web-server disk space in use by UpdraftPlus', 'updraftplus').':', 'value' => '<span class="updraft_diskspaceused">'.UpdraftPlus_Filesystem_Functions::get_disk_space_used('updraft').'</span> <a class="updraft_diskspaceused_update" href="'.esc_url(UpdraftPlus::get_current_clean_url()).'">'.__('refresh', 'updraftplus').'</a>', 'is_html' => true ); // Memory usage $peak_memory_usage = memory_get_peak_usage(true)/1048576; $memory_usage = memory_get_usage(true)/1048576; $site_info_data['peak_memory'] = array( 'label' => __('Peak memory usage', 'updraftplus').':', 'value' => $peak_memory_usage.' MB' ); $site_info_data['current_memory'] = array( 'label' => __('Current memory usage', 'updraftplus').':', 'value' => $memory_usage.' MB' ); $site_info_data['memory_limit'] = array( 'label' => __('Memory limit', 'updraftplus').':', 'value' => htmlspecialchars(ini_get('memory_limit')) ); // PHP version $site_info_data['php_version'] = array( 'label' => sprintf(__('%s version:', 'updraftplus'), 'PHP'), 'value' => htmlspecialchars(phpversion()).' - <a href="admin-ajax.php?page=updraftplus&action=updraft_ajax&subaction=phpinfo&nonce='.wp_create_nonce('updraftplus-credentialtest-nonce').'" id="updraftplus-phpinfo">'.__('show PHP information (phpinfo)', 'updraftplus').'</a>', 'is_html' => true ); // Database version $db_version = $wpdb->get_var('SELECT VERSION()'); // WPDB::db_version() uses mysqli_get_server_info() ; see: https://github.com/joomla/joomla-cms/issues/9062 if ('' == $db_version) $db_version = $wpdb->db_version(); $site_info_data['mysql_version'] = array( 'label' => sprintf(__('%s version:', 'updraftplus'), 'MySQL'), 'value' => htmlspecialchars($db_version) ); // Database packet size $mysql_max_packet_size = round($updraftplus->max_packet_size(false, false)/1048576, 1); $site_info_data['mysql_max_packet'] = array( 'label' => __('Database maximum packet size:', 'updraftplus'), 'value' => $mysql_max_packet_size.' MB' ); // SQL mode $sql_mode = $wpdb->get_var('SELECT @@GLOBAL.sql_mode'); $sql_mode = !empty($sql_mode) ? htmlspecialchars($sql_mode) : '-'; $site_info_data['sql_mode'] = array( 'label' => __('Current SQL mode:', 'updraftplus'), 'value' => $sql_mode ); // Curl version if (function_exists('curl_version') && function_exists('curl_exec')) { $cv = curl_version(); $cvs = $cv['version'].' / SSL: '.$cv['ssl_version'].' / libz: '.$cv['libz_version']; } else { $cvs = __('Not installed', 'updraftplus').' ('.__('required for some remote storage providers', 'updraftplus').')'; } $site_info_data['curl_version'] = array( 'label' => sprintf(__('%s version:', 'updraftplus'), 'Curl'), 'value' => htmlspecialchars($cvs) ); // OpenSSL version $site_info_data['openssl_version'] = array( 'label' => sprintf(__('%s version:', 'updraftplus'), 'OpenSSL'), 'value' => defined('OPENSSL_VERSION_TEXT') ? OPENSSL_VERSION_TEXT : '-' ); // MCrypt $site_info_data['mcrypt'] = array( 'label' => 'MCrypt:', 'value' => function_exists('mcrypt_encrypt') ? __('Yes') : __('No') ); // ZipArchive if (version_compare(PHP_VERSION, '5.2.0', '>=') && extension_loaded('zip')) { $ziparchive_exists = __('Yes', 'updraftplus'); } else { // First do class_exists, because method_exists still sometimes segfaults due to a rare PHP bug $ziparchive_exists = (class_exists('ZipArchive') && method_exists('ZipArchive', 'addFile')) ? __('Yes', 'updraftplus') : __('No', 'updraftplus'); } $site_info_data['ziparchive'] = array( 'label' => 'ZipArchive::addFile:', 'value' => $ziparchive_exists ); // Zip executable $binzip = $updraftplus->find_working_bin_zip(false, false); $site_info_data['zip_executable'] = array( 'label' => __('zip executable found:', 'updraftplus'), 'value' => ((is_string($binzip)) ? __('Yes').': '.$binzip : __('No')) ); // Free disk space $hosting_bytes_free = $updraftplus->get_hosting_disk_quota_free(); if (is_array($hosting_bytes_free)) { $perc = round(100$hosting_bytes_free[1]/(max($hosting_bytes_free[2], 1)), 1); $site_info_data['free_disk_space'] = array( 'label' => __('Free disk space in account:', 'updraftplus'), 'value' => sprintf(__('%s (%s used)', 'updraftplus'), round($hosting_bytes_free[3]/1048576, 1)." MB", "$perc %") ); } // Apache modules if (function_exists('apache_get_modules')) { $apache_info = ''; $apache_modules = apache_get_modules(); if (is_array($apache_modules)) { sort($apache_modules, SORT_STRING); foreach ($apache_modules as $mod) { if (0 === strpos($mod, 'mod_')) { $apache_info .= ', '.substr($mod, 4); } else { $apache_info .= ', '.$mod; } } } $apache_info = substr($apache_info, 2); $site_info_data['apache_modules'] = array( 'label' => __('Apache modules', 'updraftplus').':', 'value' => $apache_info ); } // Debugging plugins if (empty($options['suppress_plugins_for_debugging'])) { $site_info_data['debugging_plugins'] = array( 'label' => __('Install debugging plugins:', 'updraftplus'), 'value' => '<a href="'.wp_nonce_url(self_admin_url('update.php?action=install-plugin&updraftplus_noautobackup=1&plugin=wp-crontrol'), 'install-plugin_wp-crontrol').'">WP Crontrol</a> \| <a href="'.wp_nonce_url(self_admin_url('update.php?action=install-plugin&updraftplus_noautobackup=1&plugin=query-monitor'), 'install-plugin_query-monitor').'">Query Monitor</a> \| <a href="'.wp_nonce_url(self_admin_url('update.php?action=install-plugin&updraftplus_noautobackup=1&plugin=sql-executioner'), 'install-plugin_sql-executioner').'">SQL Executioner</a> \| <a href="'.wp_nonce_url(self_admin_url('update.php?action=install-plugin&updraftplus_noautobackup=1&plugin=wp-file-manager'), 'install-plugin_wp-file-manager').'">WP Filemanager</a>', 'is_html' => true ); } // HTTP Get test $site_info_data['http_get'] = array( 'label' => "HTTP Get: ", 'value' => '<input id="updraftplus_httpget_uri" type="text" class="call-action"> <a href="'.esc_url(UpdraftPlus::get_current_clean_url()).'" id="updraftplus_httpget_go">'.__('Fetch', 'updraftplus').'</a> <a href="'.esc_url(UpdraftPlus::get_current_clean_url()).'" id="updraftplus_httpget_gocurl">'.__('Fetch', 'updraftplus').' (Curl)</a><p id="updraftplus_httpget_results"></p>', 'is_html' => true ); // Call WordPress action $site_info_data['wp_action'] = array( 'label' => __("Call WordPress action:", 'updraftplus'), 'value' => '<input id="updraftplus_callwpaction" type="text" class="call-action"> <a href="'.esc_url(UpdraftPlus::get_current_clean_url()).'" id="updraftplus_callwpaction_go">'.__('Call', 'updraftplus').'</a><div id="updraftplus_callwpaction_results"></div>', 'is_html' => true ); // Site ID $site_info_data['site_id'] = array( 'label' => 'Site ID:', 'value' => '(used to identify any Vault connections) <span id="updraft_show_sid">'.htmlspecialchars($updraftplus->siteid()).'</span> - <a href="'.esc_url(UpdraftPlus::get_current_clean_url()).'" id="updraft_reset_sid">'.__('reset', 'updraftplus')."</a>", 'is_html' => true ); // Raw backup history and rescan $site_info_data['raw_backup'] = array( 'label' => '', 'value' => '<a href="admin-ajax.php?page=updraftplus&action=updraft_ajax&subaction=backuphistoryraw&nonce='.wp_create_nonce('updraftplus-credentialtest-nonce').'" id="updraftplus-rawbackuphistory">'.__('Show raw backup and file list', 'updraftplus').'</a><br><span class="hidden-in-updraftcentral"><a id="updraftplus-remote-rescan-debug" href="#">'.__('Rescan remote storage', 'updraftplus').' - '.__('log results to console', 'updraftplus').'</a></span>', 'is_html' => true ); return $site_info_data; } public function settings_advanced_tools($return_instead_of_echo = false, $pass_through = array()) { $options = isset($pass_through['options']) ? $pass_through['options'] : array(); $site_info_data = $this->get_site_info_data($options); $pass_through['site_info_data'] = $site_info_data; return $this->include_template('wp-admin/advanced/advanced-tools.php', $return_instead_of_echo, $pass_through); } /* * Paint the HTML for the form for deleting old directories * * @param Boolean $include_blurb - whether to include explanatory text * @param Boolean $include_div - whether to wrap inside a div tag / public function print_delete_old_dirs_form($include_blurb = true, $include_div = true) { if ($include_blurb) { if ($include_div) { echo '<div id="updraft_delete_old_dirs_pagediv" class="updated delete-old-directories">'; } echo '<p>'.esc_html(__('Your WordPress install has old folders from its state before you restored/migrated (technical information: these are suffixed with -old).', 'updraftplus').' '.__('You should press this button to delete them as soon as you have verified that the restoration worked.', 'updraftplus')).'</p>'; } ?> <form method="post" action="<?php echo esc_url(add_query_arg(array('error' => false, 'updraft_restore_success' => false, 'action' => false, 'page' => 'updraftplus'), UpdraftPlus_Options::admin_page_url())); ?>"> <?php wp_nonce_field('updraftplus-credentialtest-nonce', 'updraft_delete_old_dirs_nonce'); ?> <input type="hidden" name="action" value="updraft_delete_old_dirs"> <input type="submit" class="button-primary" value="<?php echo esc_attr(__('Delete old folders', 'updraftplus'));?>"> </form> <?php if ($include_blurb && $include_div) echo '</div>'; } /* * Return cron status information about a specified in-progress job * * @param Boolean\|String $job_id - the job to get information about; or, if not specified, all jobs * * @return Array\|Boolean - the requested information, or false if it was not found. Format differs depending on whether info on all jobs, or a single job, was requested. / public function get_cron($job_id = false) { $cron = get_option('cron'); if (!is_array($cron)) $cron = array(); if (false === $job_id) return $cron; foreach ($cron as $time => $job) { if (!isset($job['updraft_backup_resume'])) continue; foreach ($job['updraft_backup_resume'] as $info) { if (isset($info['args'][1]) && $job_id == $info['args'][1]) { global $updraftplus; $jobdata = $updraftplus->jobdata_getarray($job_id); return is_array($jobdata) ? array($time, $jobdata) : false; } } } } /* * Gets HTML describing the active jobs * * @param Boolean $this_job_only A value for $this_job_only also causes something non-empty to always be returned (to allow detection of the job having started on the front-end) * * @return String - the HTML / private function print_active_jobs($this_job_only = false) { $cron = $this->get_cron(); $ret = ''; foreach ($cron as $time => $job) { if (!isset($job['updraft_backup_resume'])) continue; foreach ($job['updraft_backup_resume'] as $info) { if (isset($info['args'][1])) { $job_id = $info['args'][1]; if (false === $this_job_only \|\| $job_id == $this_job_only) { $ret .= $this->print_active_job($job_id, false, $time, $info['args'][0]); } } } } // A value for $this_job_only implies that output is required if (false !== $this_job_only && !$ret) { $ret = $this->print_active_job($this_job_only); if ('' == $ret) { global $updraftplus; $log_file = $updraftplus->get_logfile_name($this_job_only); // if the file exists, the backup was booted. Check if the information about completion is found in the log, or if it was modified at least 2 minutes ago. if (file_exists($log_file) && ($updraftplus->found_backup_complete_in_logfile($this_job_only) \|\| (time() - filemtime($log_file)) > 120)) { // The presence of the exact ID matters to the front-end - indicates that the backup job has at least begun $ret = '<div class="active-jobs updraft_finished" id="updraft-jobid-'.$this_job_only.'"><em>'.__('The backup has finished running', 'updraftplus').'</em> - <a class="updraft-log-link" data-jobid="'.$this_job_only.'">'.__('View Log', 'updraftplus').'</a></div>'; } } } return $ret; } /* * Print the HTML for a particular job * * @param String $job_id - the job identifier/nonce * @param Boolean $is_oneshot - whether this backup should be 'one shot', i.e. no resumptions * @param Boolean\|Integer $time * @param Integer $next_resumption * * @return String / private function print_active_job($job_id, $is_oneshot = false, $time = false, $next_resumption = false) { $ret = ''; global $updraftplus; $jobdata = $updraftplus->jobdata_getarray($job_id); if (false == apply_filters('updraftplus_print_active_job_continue', true, $is_oneshot, $next_resumption, $jobdata)) return ''; if (!isset($jobdata['backup_time'])) return ''; $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); $began_at = isset($jobdata['backup_time']) ? get_date_from_gmt(gmdate('Y-m-d H:i:s', (int) $jobdata['backup_time']), 'D, F j, Y H:i') : '?'; $backup_label = !empty($jobdata['label']) ? $jobdata['label'] : ''; $remote_sent = (!empty($jobdata['service']) && ((is_array($jobdata['service']) && in_array('remotesend', $jobdata['service'])) \|\| 'remotesend' === $jobdata['service'])) ? true : false; $jobstatus = empty($jobdata['jobstatus']) ? 'unknown' : $jobdata['jobstatus']; $stage = 0; switch ($jobstatus) { // Stage 0 case 'begun': $curstage = __('Backup begun', 'updraftplus'); break; // Stage 1 case 'filescreating': $stage = 1; $curstage = __('Creating file backup zips', 'updraftplus'); if (!empty($jobdata['filecreating_substatus']) && isset($backupable_entities[$jobdata['filecreating_substatus']['e']]['description'])) { $sdescrip = preg_replace('/ $.$$/', '', $backupable_entities[$jobdata['filecreating_substatus']['e']]['description']); if (strlen($sdescrip) > 20 && isset($jobdata['filecreating_substatus']['e']) && is_array($jobdata['filecreating_substatus']['e']) && isset($backupable_entities[$jobdata['filecreating_substatus']['e']]['shortdescription'])) $sdescrip = $backupable_entities[$jobdata['filecreating_substatus']['e']]['shortdescription']; $curstage .= ' ('.$sdescrip.')'; if (isset($jobdata['filecreating_substatus']['i']) && isset($jobdata['filecreating_substatus']['t'])) { $stage = min(2, 1 + ($jobdata['filecreating_substatus']['i']/max($jobdata['filecreating_substatus']['t'], 1))); } } break; case 'filescreated': $stage = 2; $curstage = __('Created file backup zips', 'updraftplus'); break; // Stage 4 case 'clonepolling': $stage = 4; $curstage = __('Clone server being provisioned and booted (can take several minutes)', 'updraftplus'); break; case 'partialclouduploading': case 'clouduploading': $stage = 'clouduploading' == $jobstatus ? 4 : 2; $curstage = __('Uploading files to remote storage', 'updraftplus'); if ($remote_sent) $curstage = __('Sending files to remote site', 'updraftplus'); if (isset($jobdata['uploading_substatus']['t']) && isset($jobdata['uploading_substatus']['i'])) { $t = max((int) $jobdata['uploading_substatus']['t'], 1); $i = min($jobdata['uploading_substatus']['i']/$t, 1); $p = min($jobdata['uploading_substatus']['p'], 1); $pd = $i + $p/$t; $stage = 'clouduploading' == $jobstatus ? $stage + $pd : $stage; $curstage .= ' ('.floor(100$pd).'%, '.sprintf(__('file %d of %d', 'updraftplus'), (int) $jobdata['uploading_substatus']['i']+1, $t).')'; } break; case 'pruning': $stage = 5; $curstage = __('Pruning old backup sets', 'updraftplus'); break; case 'resumingforerrors': $stage = -1; $curstage = __('Waiting until scheduled time to retry because of errors', 'updraftplus'); break; // Stage 6 case 'finished': $stage = 6; $curstage = __('Backup finished', 'updraftplus'); break; default: // Database creation and encryption occupies the space from 2 to 4. Databases are created then encrypted, then the next database is created/encrypted, etc. if ('dbcreated' == substr($jobstatus, 0, 9)) { $jobstatus = 'dbcreated'; $whichdb = substr($jobstatus, 9); if (!is_numeric($whichdb)) $whichdb = 0; $howmanydbs = max((empty($jobdata['backup_database']) \|\| !is_array($jobdata['backup_database'])) ? 1 : count($jobdata['backup_database']), 1); $perdbspace = 2/$howmanydbs; $stage = min(4, 2 + ($whichdb+2)$perdbspace); $curstage = __('Created database backup', 'updraftplus'); } elseif ('dbcreating' == substr($jobstatus, 0, 10)) { $whichdb = substr($jobstatus, 10); if (!is_numeric($whichdb)) $whichdb = 0; $howmanydbs = (empty($jobdata['backup_database']) \|\| !is_array($jobdata['backup_database'])) ? 1 : count($jobdata['backup_database']); $perdbspace = 2/$howmanydbs; $jobstatus = 'dbcreating'; $stage = min(4, 2 + $whichdb$perdbspace); $curstage = __('Creating database backup', 'updraftplus'); if (!empty($jobdata['dbcreating_substatus']['t'])) { $curstage .= ' ('.sprintf(__('table: %s', 'updraftplus'), $jobdata['dbcreating_substatus']['t']).')'; if (!empty($jobdata['dbcreating_substatus']['i']) && !empty($jobdata['dbcreating_substatus']['a'])) { $substage = max(0.001, ($jobdata['dbcreating_substatus']['i'] / max($jobdata['dbcreating_substatus']['a'], 1))); $stage += $substage $perdbspace * 0.5; } } } elseif ('dbencrypting' == substr($jobstatus, 0, 12)) { $whichdb = substr($jobstatus, 12); if (!is_numeric($whichdb)) $whichdb = 0; $howmanydbs = (empty($jobdata['backup_database']) \|\| !is_array($jobdata['backup_database'])) ? 1 : count($jobdata['backup_database']); $perdbspace = 2/$howmanydbs; $stage = min(4, 2 + $whichdb$perdbspace + $perdbspace0.5); $jobstatus = 'dbencrypting'; $curstage = __('Encrypting database', 'updraftplus'); } elseif ('dbencrypted' == substr($jobstatus, 0, 11)) { $whichdb = substr($jobstatus, 11); if (!is_numeric($whichdb)) $whichdb = 0; $howmanydbs = (empty($jobdata['backup_database']) \|\| !is_array($jobdata['backup_database'])) ? 1 : count($jobdata['backup_database']); $jobstatus = 'dbencrypted'; $perdbspace = 2/$howmanydbs; $stage = min(4, 2 + $whichdb$perdbspace + $perdbspace); $curstage = __('Encrypted database', 'updraftplus'); } else { $curstage = __('Unknown', 'updraftplus'); } } $runs_started = empty($jobdata['runs_started']) ? array() : $jobdata['runs_started']; $time_passed = empty($jobdata['run_times']) ? array() : $jobdata['run_times']; $last_checkin_ago = -1; if (is_array($time_passed)) { foreach ($time_passed as $run => $passed) { if (isset($runs_started[$run])) { $time_ago = microtime(true) - ($runs_started[$run] + $time_passed[$run]); if ($time_ago < $last_checkin_ago \|\| -1 == $last_checkin_ago) $last_checkin_ago = $time_ago; } } } $next_res_after = (int) $time-time(); $next_res_txt = $is_oneshot ? '' : sprintf(__('next resumption: %d', 'updraftplus'), $next_resumption).($next_resumption ? ' '.sprintf(__('(after %ss)', 'updraftplus'), $next_res_after) : '').' '; $last_activity_txt = ($last_checkin_ago >= 0) ? sprintf(__('last activity: %ss ago', 'updraftplus'), floor($last_checkin_ago)).' ' : ''; if (($last_checkin_ago < 50 && $next_res_after>30) \|\| $is_oneshot) { $show_inline_info = $last_activity_txt; $title_info = $next_res_txt; } else { $show_inline_info = $next_res_txt; $title_info = $last_activity_txt; } $ret .= '<div class="updraft_row">'; $ret .= '<div class="updraft_col"><div class="updraft_jobtimings next-resumption'; if (!empty($jobdata['is_autobackup'])) $ret .= ' isautobackup'; $is_clone = empty($jobdata['clone_job']) ? '0' : '1'; $clone_url = empty($jobdata['clone_url']) ? false : true; $ret .= '" data-jobid="'.$job_id.'" data-lastactivity="'.(int) $last_checkin_ago.'" data-nextresumption="'.$next_resumption.'" data-nextresumptionafter="'.$next_res_after.'" title="'.esc_attr(sprintf(__('Job ID: %s', 'updraftplus'), $job_id)).$title_info.'">'.(!empty($backup_label) ? esc_html($backup_label) : $began_at). '</div></div>'; $ret .= '<div class="updraft_col updraft_progress_container">'; // Existence of the 'updraft-jobid-(id)' id is checked for in other places, so do not modify this $ret .= '<div class="job-id" data-isclone="'.$is_clone.'" id="updraft-jobid-'.$job_id.'">'; if ($clone_url) $ret .= '<div class="updraft_clone_url" data-clone_url="' . $jobdata['clone_url'] . '"></div>'; $ret .= apply_filters('updraft_printjob_beforewarnings', '', $jobdata, $job_id); if (!empty($jobdata['warnings']) && is_array($jobdata['warnings'])) { $ret .= '<ul class="disc">'; foreach ($jobdata['warnings'] as $warning) { $ret .= '<li>'.sprintf(__('Warning: %s', 'updraftplus'), make_clickable(htmlspecialchars($warning))).'</li>'; } $ret .= '</ul>'; } $ret .= '<div class="curstage">'; // $ret .= '<span class="curstage-info">'.htmlspecialchars($curstage).'</span>'; $ret .= htmlspecialchars($curstage); // we need to add this data-progress attribute in order to be able to update the progress bar in UDC $ret .= '<div class="updraft_percentage" data-info="'.esc_attr($curstage).'" data-progress="'.(($stage>0) ? (ceil((100/6)$stage)) : '0').'" style="height: 100%; width:'.(($stage>0) ? (ceil((100/6)$stage)) : '0').'%"></div>'; $ret .= '</div></div>'; $ret .= '<div class="updraft_last_activity">'; $ret .= $show_inline_info; if (!empty($show_inline_info)) $ret .= ' - '; $file_nonce = empty($jobdata['file_nonce']) ? $job_id : $jobdata['file_nonce']; $ret .= '<a data-fileid="'.$file_nonce.'" data-jobid="'.$job_id.'" href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus&action=downloadlog&updraftplus_backup_nonce='.$file_nonce.'" class="updraft-log-link">'.__('show log', 'updraftplus').'</a>'; if (!$is_oneshot) $ret .=' - <a href="#" data-jobid="'.$job_id.'" title="'.esc_attr(__('Note: the progress bar below is based on stages, NOT time.', 'updraftplus').' '.__('Do not stop the backup simply because it seems to have remained in the same place for a while - that is normal.', 'updraftplus')).'" class="updraft_jobinfo_delete">'.__('stop', 'updraftplus').'</a>'; $ret .= '</div>'; $ret .= '</div></div>'; return $ret; } private function delete_old_dirs_go($show_return = true) { echo $show_return ? '<h1>UpdraftPlus - '.esc_html__('Remove old folders', 'updraftplus').'</h1>' : '<h2>'.esc_html__('Remove old directories', 'updraftplus').'</h2>'; if ($this->delete_old_dirs()) { echo '<p>'.esc_html__('Old folders successfully removed.', 'updraftplus').'</p><br>'; } else { echo '<p>'.esc_html__('Old folder removal failed for some reason.', 'updraftplus').' '.esc_html__('You may want to do this manually.', 'updraftplus').'</p><br>'; } if ($show_return) echo '<b>'.esc_html__('Actions', 'updraftplus').':</b> <a href="'.esc_url(UpdraftPlus_Options::admin_page_url()).'?page=updraftplus">'.esc_html__('Return to UpdraftPlus configuration', 'updraftplus').'</a>'; } /* * Deletes the -old directories and wp-config-pre-ud-restore-backup.php that are created when a backup is restored. * * @return Boolean. Can also exit (something we ought to probably review) / private function delete_old_dirs() { global $wp_filesystem, $updraftplus; $credentials = request_filesystem_credentials(wp_nonce_url(UpdraftPlus_Options::admin_page_url()."?page=updraftplus&action=updraft_delete_old_dirs", 'updraftplus-credentialtest-nonce', 'updraft_delete_old_dirs_nonce')); $wpfs = WP_Filesystem($credentials); if (!empty($wp_filesystem->errors) && $wp_filesystem->errors->get_error_code()) { foreach ($wp_filesystem->errors->get_error_messages() as $message) show_message($message); exit; } if (!$wpfs) exit; // From WP_CONTENT_DIR - which contains 'themes' $ret = $this->delete_old_dirs_dir($wp_filesystem->wp_content_dir()); $updraft_dir = $updraftplus->backups_dir_location(); if ($updraft_dir) { $ret4 = $updraft_dir ? $this->delete_old_dirs_dir($updraft_dir, false) : true; } else { $ret4 = true; } $plugs = untrailingslashit($wp_filesystem->wp_plugins_dir()); if ($wp_filesystem->is_dir($plugs.'-old')) { echo "<strong>".esc_html__('Delete', 'updraftplus').": </strong>plugins-old: "; if (!$wp_filesystem->delete($plugs.'-old', true)) { $ret3 = false; echo "<strong>".esc_html__('Failed', 'updraftplus')."</strong><br>"; echo esc_html($updraftplus->log_permission_failure_message($wp_filesystem->wp_content_dir(), 'Delete '.$plugs.'-old')); } else { $ret3 = true; echo "<strong>".esc_html__('OK', 'updraftplus')."</strong><br>"; } } else { $ret3 = true; } $ret2 = true; if ($wp_filesystem->is_file(ABSPATH.'wp-config-pre-ud-restore-backup.php')) { echo "<strong>".esc_html__('Delete', 'updraftplus').": </strong>wp-config-pre-ud-restore-backup.php: "; if ($wp_filesystem->delete(ABSPATH.'wp-config-pre-ud-restore-backup.php')) { echo "<strong>".esc_html__('OK', 'updraftplus')."</strong><br>"; } else { $ret2 = false; echo "<strong>".esc_html__('Failed', 'updraftplus')."</strong><br>"; } } return $ret && $ret2 && $ret3 && $ret4; } private function delete_old_dirs_dir($dir, $wpfs = true) { $dir = trailingslashit($dir); global $wp_filesystem, $updraftplus; if ($wpfs) { $list = $wp_filesystem->dirlist($dir); } else { $list = scandir($dir); } if (!is_array($list)) return false; $ret = true; foreach ($list as $item) { $name = (is_array($item)) ? $item['name'] : $item; if ("-old" == substr($name, -4, 4)) { // recursively delete print "<strong>".esc_html__('Delete', 'updraftplus').": </strong>".esc_html(basename($dir).'/'.$name).": "; if ($wpfs) { if (!$wp_filesystem->delete($dir.$name, true)) { $ret = false; echo "<strong>".esc_html__('Failed', 'updraftplus')."</strong><br>"; echo wp_kses_post($updraftplus->log_permission_failure_message($dir, 'Delete '.$dir.$name)); } else { echo "<strong>".esc_html__('OK', 'updraftplus')."</strong><br>"; } } else { if (UpdraftPlus_Filesystem_Functions::remove_local_directory($dir.$name)) { echo "<strong>".esc_html__('OK', 'updraftplus')."</strong><br>"; } else { $ret = false; echo "<strong>".esc_html__('Failed', 'updraftplus')."</strong><br>"; echo wp_kses_post($updraftplus->log_permission_failure_message($dir, 'Delete '.$dir.$name)); } } } } return $ret; } /* * The aim is to get a directory that is writable by the webserver, because that's the only way we can create zip files * * @return Boolean\|WP_Error true if successful, otherwise false or a WP_Error / private function create_backup_dir() { global $wp_filesystem, $updraftplus; if (false === ($credentials = request_filesystem_credentials(UpdraftPlus_Options::admin_page().'?page=updraftplus&action=updraft_create_backup_dir&nonce='.wp_create_nonce('create_backup_dir')))) { return false; } if (!WP_Filesystem($credentials)) { // our credentials were no good, ask the user for them again request_filesystem_credentials(UpdraftPlus_Options::admin_page().'?page=updraftplus&action=updraft_create_backup_dir&nonce='.wp_create_nonce('create_backup_dir'), '', true); return false; } $updraft_dir = $updraftplus->backups_dir_location(); $default_backup_dir = $wp_filesystem->find_folder(dirname($updraft_dir)).basename($updraft_dir); $updraft_dir = ($updraft_dir) ? $wp_filesystem->find_folder(dirname($updraft_dir)).basename($updraft_dir) : $default_backup_dir; if (!$wp_filesystem->is_dir($default_backup_dir) && !$wp_filesystem->mkdir($default_backup_dir, 0775)) { $wperr = new WP_Error; if ($wp_filesystem->errors->get_error_code()) { foreach ($wp_filesystem->errors->get_error_messages() as $message) { $wperr->add('mkdir_error', $message); } return $wperr; } else { return new WP_Error('mkdir_error', __('The request to the filesystem to create the directory failed.', 'updraftplus')); } } if ($wp_filesystem->is_dir($default_backup_dir)) { if (UpdraftPlus_Filesystem_Functions::really_is_writable($updraft_dir)) return true; @$wp_filesystem->chmod($default_backup_dir, 0775);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. if (UpdraftPlus_Filesystem_Functions::really_is_writable($updraft_dir)) return true; @$wp_filesystem->chmod($default_backup_dir, 0777);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. if (UpdraftPlus_Filesystem_Functions::really_is_writable($updraft_dir)) { echo '<p>'.esc_html__('The folder was created, but we had to change its file permissions to 777 (world-writable) to be able to write to it.', 'updraftplus').' '.esc_html__('You should check with your hosting provider that this will not cause any problems', 'updraftplus').'</p>'; return true; } else { @$wp_filesystem->chmod($default_backup_dir, 0775);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. $show_dir = (0 === strpos($default_backup_dir, ABSPATH)) ? substr($default_backup_dir, strlen(ABSPATH)) : $default_backup_dir; return new WP_Error('writable_error', __('The folder exists, but your webserver does not have permission to write to it.', 'updraftplus').' '.__('You will need to consult with your web hosting provider to find out how to set permissions for a WordPress plugin to write to the directory.', 'updraftplus').' ('.$show_dir.')'); } } return true; } /* * scans the content dir to see if any -old dirs are present * * @param Boolean $print_as_comment Echo information in an HTML comment * @return Boolean / private function scan_old_dirs($print_as_comment = false) { global $updraftplus; $dirs = scandir(untrailingslashit(WP_CONTENT_DIR)); if (!is_array($dirs)) $dirs = array(); foreach ($dirs as $dir) { if (preg_match('/-old$/', $dir)) { if ($print_as_comment) echo '<!--'.esc_html($dir).'-->'; return true; } } $backups_dir_location = $updraftplus->backups_dir_location(); $dirs = @scandir($backups_dir_location);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!is_array($dirs)) $dirs = array(); foreach ($dirs as $dir) { if (preg_match('/-old$/', $dir)) { if ($print_as_comment) echo '<!--'.esc_html($dir).'-->'; return true; } } // No need to scan ABSPATH - we don't backup there if (is_dir(untrailingslashit(WP_PLUGIN_DIR).'-old')) { if ($print_as_comment) echo '<!--'.esc_html(untrailingslashit(WP_PLUGIN_DIR).'-old').'-->'; return true; } if (is_file(ABSPATH.'wp-config-pre-ud-restore-backup.php')) { if ($print_as_comment) echo '<!--'.esc_html(ABSPATH.'wp-config-pre-ud-restore-backup.php').'-->'; return true; } return false; } /* * Outputs html for a storage method using the parameters passed in, this version should be removed when all remote storages use the multi version * * @param String $method a list of methods to be used when * @param String $header the table header content * @param String $contents the table contents / public function storagemethod_row($method, $header, $contents) { ?> <tr class="updraftplusmethod <?php echo esc_attr($method);?>"> <th><?php echo wp_kses_post($header);?></th> <td><?php echo wp_kses_post($contents);?></td> </tr> <?php } /* * Outputs html for a storage method using the parameters passed in, this version of the method is compatible with multi storage options * * @param string $classes a list of classes to be used when * @param string $header the table header content * @param string $contents the table contents / public function storagemethod_row_multi($classes, $header, $contents) { ?> <tr class="<?php echo esc_attr($classes);?>"> <th><?php echo wp_kses_post($header);?></th> <td><?php echo wp_kses_post($contents);?></td> </tr> <?php } /* * Returns html for a storage method using the parameters passed in, this version of the method is compatible with multi storage options * DEV NOTE: please don't use this method in a handlebars template, but write the HTML code directly in the template. Also, this method might be no longer available in future releases * * @param string $classes a list of classes to be used when * @param string $header the table header content * @param string $contents the table contents * @return string handlebars html template / public function get_storagemethod_row_multi_configuration_template($classes, $header, $contents) { return '<tr class="'.esc_attr($classes).'"> <th>'.$header.'</th> <td>'.$contents.'</td> </tr>'; } /* * Get HTML suitable for the admin area for the status of the last backup * * @return String / public function last_backup_html() { global $updraftplus; $updraft_last_backup = UpdraftPlus_Options::get_updraft_option('updraft_last_backup'); if ($updraft_last_backup) { // Convert to GMT, then to blog time $backup_time = (int) $updraft_last_backup['backup_time']; $print_time = get_date_from_gmt(gmdate('Y-m-d H:i:s', $backup_time), 'D, F j, Y H:i'); if (empty($updraft_last_backup['backup_time_incremental'])) { $last_backup_text = "<span style=\"color:".(($updraft_last_backup['success']) ? 'green' : 'black').";\">".$print_time.'</span>'; } else { $inc_time = get_date_from_gmt(gmdate('Y-m-d H:i:s', $updraft_last_backup['backup_time_incremental']), 'D, F j, Y H:i'); $last_backup_text = "<span style=\"color:".(($updraft_last_backup['success']) ? 'green' : 'black').";\">$inc_time</span> (".sprintf(__('incremental backup; base backup: %s', 'updraftplus'), $print_time).')'; } $last_backup_text .= '<br>'; // Show errors + warnings if (is_array($updraft_last_backup['errors'])) { foreach ($updraft_last_backup['errors'] as $err) { $level = (is_array($err)) ? $err['level'] : 'error'; $message = (is_array($err)) ? $err['message'] : $err; $last_backup_text .= ('warning' == $level) ? "<span style=\"color:orange;\">" : "<span style=\"color:red;\">"; if ('warning' == $level) { $message = sprintf(__("Warning: %s", 'updraftplus'), make_clickable(htmlspecialchars($message))); } else { $message = htmlspecialchars($message); } $last_backup_text .= $message; $last_backup_text .= '</span><br>'; } } // Link log if (!empty($updraft_last_backup['backup_nonce'])) { $updraft_dir = $updraftplus->backups_dir_location(); $potential_log_file = $updraft_dir."/log.".$updraft_last_backup['backup_nonce'].".txt"; if (is_readable($potential_log_file)) $last_backup_text .= "<a href=\"?page=updraftplus&action=downloadlog&updraftplus_backup_nonce=".$updraft_last_backup['backup_nonce']."\" class=\"updraft-log-link\" onclick=\"event.preventDefault(); updraft_popuplog('".$updraft_last_backup['backup_nonce']."');\">".__('Download log file', 'updraftplus')."</a>"; } } else { $last_backup_text = "<span style=\"color:blue;\">".__('No backup has been completed', 'updraftplus')."</span>"; } return $last_backup_text; } /* * Get a list of backup intervals * * @param String $what_for - 'files' or 'db' * * @return Array - keys are used as identifiers in the UI drop-down; values are user-displayed text describing the interval / public function get_intervals($what_for = 'db') { global $updraftplus; $intervals = wp_get_schedules(); if ($updraftplus->is_restricted_hosting('only_one_backup_per_month')) { $intervals = array_intersect_key($intervals, array('monthly' => array())); } else { if ('db' != $what_for) unset($intervals['everyhour']); } $intervals = array_intersect_key(updraftplus_list_cron_schedules(), $intervals); // update schedule descriptions for the UI of the backup schedule drop-down and rearrange schedule order foreach ($intervals as $interval => $data) { $intervals[$interval] = $data['display']; } $intervals = array('manual' => _x('Manual', 'i.e. Non-automatic', 'updraftplus')) + $intervals; return apply_filters('updraftplus_backup_intervals', $intervals, $what_for); } public function really_writable_message($really_is_writable, $updraft_dir) { if ($really_is_writable) { $dir_info = '<span style="color:green;">'.__('Backup directory specified is writable, which is good.', 'updraftplus').'</span>'; } else { $dir_info = '<span style="color:red;">'; if (!is_dir($updraft_dir)) { $dir_info .= __('Backup directory specified does <b>not</b> exist.', 'updraftplus'); } else { $dir_info .= __('Backup directory specified exists, but is <b>not</b> writable.', 'updraftplus'); } $dir_info .= '<span class="updraft-directory-not-writable-blurb"><span class="directory-permissions"><a class="updraft_create_backup_dir" href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus&action=updraft_create_backup_dir&nonce='.wp_create_nonce('create_backup_dir').'">'.__('Follow this link to attempt to create the directory and set the permissions', 'updraftplus').'</a></span>, '.__('or, to reset this option', 'updraftplus').' <a href="'.esc_url(UpdraftPlus::get_current_clean_url()).'" class="updraft_backup_dir_reset">'.__('press here', 'updraftplus').'</a>. '.__('If that is unsuccessful check the permissions on your server or change it to another directory that is writable by your web server process.', 'updraftplus').'</span>'; } return $dir_info; } /* * Directly output the settings form (suitable for the admin area) * * @param Array $options current options (passed on to the template) / public function settings_formcontents($options = array()) { $this->include_template('wp-admin/settings/form-contents.php', false, array( 'options' => $options )); if (!(defined('UPDRAFTCENTRAL_COMMAND') && UPDRAFTCENTRAL_COMMAND)) { $this->include_template('wp-admin/settings/exclude-modal.php', false); } } public function get_settings_js($method_objects, $really_is_writable, $updraft_dir, $active_service) {// phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found -- Filter use global $updraftplus; ob_start(); ?> jQuery(function() { <?php if (!$really_is_writable) echo "jQuery('.backupdirrow').show();\n"; ?> <?php if (!empty($active_service)) { if (is_array($active_service)) { foreach ($active_service as $serv) { echo "jQuery('.".esc_js($serv)."').show();\n"; } } else { echo "jQuery('.".esc_js($active_service)."').show();\n"; } } else { echo "jQuery('.none').show();\n"; } foreach ($updraftplus->backup_methods as $method => $description) { // already done: updraft_try_include_file('methods/'.$method.'.php', 'require_once'); $call_method = "UpdraftPlus_BackupModule_$method"; if (method_exists($call_method, 'config_print_javascript_onready')) { $method_objects[$method]->config_print_javascript_onready(); } } ?> }); <?php $ret = ob_get_contents(); ob_end_clean(); return $ret; } /* * Return the HTML for the files selector widget * * @param String $prefix Prefix for the ID * @param Boolean $show_exclusion_options True or False for exclusion options * @param Boolean\|String $include_more $include_more can be (bool) or (string)"sometimes" * * @return String / public function files_selector_widgetry($prefix = '', $show_exclusion_options = true, $include_more = true) { $ret = ''; global $updraftplus; $for_updraftcentral = defined('UPDRAFTCENTRAL_COMMAND') && UPDRAFTCENTRAL_COMMAND; $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); if (!function_exists('get_mu_plugins')) include_once(ABSPATH.'wp-admin/includes/plugin.php'); $mu_plugins = get_mu_plugins(); // The true (default value if non-existent) here has the effect of forcing a default of on. $include_more_paths = UpdraftPlus_Options::get_updraft_option('updraft_include_more_path'); foreach ($backupable_entities as $key => $info) { $included = (UpdraftPlus_Options::get_updraft_option("updraft_include_$key", apply_filters("updraftplus_defaultoption_include_".$key, true))) ? 'checked="checked"' : ""; if ('others' == $key \|\| 'uploads' == $key) { $data_toggle_exclude_field = $show_exclusion_options ? 'data-toggle_exclude_field="'.$key.'"' : ''; $ret .= '<label '.(('others' == $key) ? 'title="'.sprintf(__('Your wp-content directory server path: %s', 'updraftplus'), WP_CONTENT_DIR).'" ' : '').' for="'.$prefix.'updraft_include_'.$key.'" class="updraft_checkbox"><input class="updraft_include_entity" id="'.$prefix.'updraft_include_'.$key.'" '.$data_toggle_exclude_field.' type="checkbox" name="updraft_include_'.$key.'" value="1" '.$included.'> '.(('others' == $key) ? __('Any other directories found inside wp-content', 'updraftplus') : htmlspecialchars($info['description'])).'</label>'; if ($show_exclusion_options) { $include_exclude = UpdraftPlus_Options::get_updraft_option('updraft_include_'.$key.'_exclude', ('others' == $key) ? UPDRAFT_DEFAULT_OTHERS_EXCLUDE : UPDRAFT_DEFAULT_UPLOADS_EXCLUDE); $display = ($included) ? '' : 'class="updraft-hidden" style="display:none;"'; $exclude_container_class = $prefix.'updraft_include_'.$key.'_exclude'; if (!$for_updraftcentral) $exclude_container_class .= '_container'; $ret .= "<div id=\"".$exclude_container_class."\" $display class=\"updraft_exclude_container\">"; $ret .= '<label class="updraft-exclude-label" for="'.$prefix.'updraft_include_'.$key.'_exclude">'.__('Exclude these from', 'updraftplus').' '.htmlspecialchars($info['description']).':</label> <span class="updraft-fs-italic">'.__('(the asterisk character matches zero or more characters)', 'updraftplus').'</span>'; $exclude_input_type = $for_updraftcentral ? "text" : "hidden"; $exclude_input_extra_attr = $for_updraftcentral ? 'title="'.__('If entering multiple files/directories, then separate them with commas.', 'updraftplus').' '.__('For entities at the top level, you can use a at the start or end of the entry as a wildcard.', 'updraftplus').'" size="54"' : ''; $ret .= '<input type="'.$exclude_input_type.'" id="'.$prefix.'updraft_include_'.$key.'_exclude" name="updraft_include_'.$key.'_exclude" '.$exclude_input_extra_attr.' value="'.htmlspecialchars($include_exclude).'" />'; if (!$for_updraftcentral) { global $updraftplus; $backupable_file_entities = $updraftplus->get_backupable_file_entities(); if ('uploads' == $key) { $path = UpdraftPlus_Manipulation_Functions::wp_normalize_path($backupable_file_entities['uploads']); } elseif ('others' == $key) { $path = UpdraftPlus_Manipulation_Functions::wp_normalize_path($backupable_file_entities['others']); } $ret .= $this->include_template('wp-admin/settings/file-backup-exclude.php', true, array( 'key' => $key, 'include_exclude' => $include_exclude, 'path' => $path, 'show_exclusion_options' => $show_exclusion_options, )); } $ret .= '</div>'; } } else { if ('more' != $key \|\| true === $include_more \|\| ('sometimes' === $include_more && !empty($include_more_paths))) { $data_toggle_exclude_field = $show_exclusion_options ? 'data-toggle_exclude_field="'.$key.'"' : ''; $force_disabled = ''; if ('mu-plugins' == $key && !$mu_plugins) { $force_disabled = 'data-force_disabled="1"'; $info['description'] .= ' ('.__('none present', 'updraftplus').')'; } $ret .= "<label for=\"".$prefix."updraft_include_$key\"".((isset($info['htmltitle'])) ? ' title="'.htmlspecialchars($info['htmltitle']).'"' : '')." class=\"updraft_checkbox\"><input class=\"updraft_include_entity\" $data_toggle_exclude_field id=\"".$prefix."updraft_include_$key\" type=\"checkbox\" name=\"updraft_include_$key\" value=\"1\" $included $force_disabled/> ".htmlspecialchars($info['description']); $ret .= "</label>"; $ret .= apply_filters("updraftplus_config_option_include_$key", '', $prefix, $for_updraftcentral); } } } return $ret; } /** * Output or echo HTML for an error condition relating to a remote storage method * * @param String $text - the text of the message; this should already be escaped (no more is done) * @param String $extraclass - a CSS class for the resulting DOM node * @param Integer $echo - if set, then the results will be echoed as well as returned * * @return String - the results / public function show_double_warning($text, $extraclass = '', $echo = true) { $ret = "<div class=\"error updraftplusmethod $extraclass\"><p>$text</p></div>"; $ret .= "<div class=\"notice error below-h2\"><p>$text</p></div>"; if ($echo) echo wp_kses_post($ret); return $ret; } public function optionfilter_split_every($value) { return max(absint($value), UPDRAFTPLUS_SPLIT_MIN); } /* * Check if curl exists; if not, print or return appropriate error messages * * @param String $service the service description (used only for user-visible messages - so, use the description) * @param Boolean $has_fallback set as true if the lack of Curl only affects the ability to connect over SSL * @param String $extraclass an extra CSS class for any resulting message, passed on to show_double_warning() * @param Boolean $echo_instead_of_return whether the result should be echoed or returned * @return String any resulting message, if $echo_instead_of_return was set / public function curl_check($service, $has_fallback = false, $extraclass = '', $echo_instead_of_return = true) { $ret = ''; // Check requirements if (!function_exists("curl_init") \|\| !function_exists('curl_exec')) { $ret .= $this->show_double_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.sprintf(__("Your web server's PHP installation does not included a <strong>required</strong> (for %s) module (%s).", 'updraftplus'), $service, 'Curl').' '.__("Please contact your web hosting provider's support and ask for them to enable it.", 'updraftplus').' ', $extraclass, false); } else { $curl_version = curl_version(); $curl_ssl_supported= ($curl_version['features'] & CURL_VERSION_SSL); if (!$curl_ssl_supported) { if ($has_fallback) { $ret .= '<p><strong>'.__('Warning', 'updraftplus').':</strong> '.__("Your web server's PHP/Curl installation does not support https access.", 'updraftplus').' '.sprintf(__("Communications with %s will be unencrypted.", 'updraftplus'), $service).' '.__("Ask your web host to install Curl/SSL in order to gain the ability for encryption (via an add-on).", 'updraftplus').'</p>'; } else { $ret .= $this->show_double_warning('<p><strong>'.__('Warning', 'updraftplus').':</strong> '.__("Your web server's PHP/Curl installation does not support https access.", 'updraftplus').' '.sprintf(__("We cannot access %s without this support.", 'updraftplus'), $service).' '.__("Please contact your web hosting provider's support.", 'updraftplus').' '.sprintf(__("%s <strong>requires</strong> Curl+https.", 'updraftplus'), $service).' '.__("Please do not file any support requests; there is no alternative.", 'updraftplus').'</p>', $extraclass, false); } } else { $ret .= '<p><em>'.sprintf(__("Good news: Your site's communications with %s can be encrypted.", 'updraftplus'), $service).' '.__("If you see any errors to do with encryption, then look in the 'Expert Settings' for more help.", 'updraftplus').'</em></p>'; } } if ($echo_instead_of_return) { echo wp_kses_post($ret); } else { return $ret; } } /* * Get backup information in HTML format for a specific backup * * @param Array $backup_history all backups history * @param String $key backup timestamp * @param String $nonce backup nonce (job ID) * @param Array\|Null $job_data if an array, then use this as the job data (if null, then it will be fetched directly) * * @return string HTML-formatted backup information / public function raw_backup_info($backup_history, $key, $nonce, $job_data = null) { global $updraftplus; $backup = $backup_history[$key]; $only_remote_sent = !empty($backup['service']) && (array('remotesend') === $backup['service'] \|\| 'remotesend' === $backup['service']); $pretty_date = get_date_from_gmt(gmdate('Y-m-d H:i:s', (int) $key), 'M d, Y G:i'); $rawbackup = "<h2 title=\"$key\">$pretty_date</h2>"; if (!empty($backup['label'])) $rawbackup .= '<span class="raw-backup-info">'.$backup['label'].'</span>'; if (null === $job_data) $job_data = empty($nonce) ? array() : $updraftplus->jobdata_getarray($nonce); if (!$only_remote_sent) { $rawbackup .= '<hr>'; $rawbackup .= '<input type="checkbox" name="always_keep_this_backup" id="always_keep_this_backup" data-backup_key="'.$key.'" '.(empty($backup['always_keep']) ? '' : 'checked ').'><label for="always_keep_this_backup">'.__('Only allow this backup to be deleted manually (i.e. keep it even if retention limits are hit).', 'updraftplus').'</label>'; } $rawbackup .= '<hr><p>'; $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); $checksums = $updraftplus->which_checksums(); foreach ($backupable_entities as $type => $info) { if (!isset($backup[$type])) continue; $rawbackup .= $updraftplus->printfile($info['description'], $backup, $type, $checksums, $job_data, true); } $total_size = 0; foreach ($backup as $ekey => $files) { if ('db' == strtolower(substr($ekey, 0, 2)) && '-size' != substr($ekey, -5, 5)) { $rawbackup .= $updraftplus->printfile(__('Database', 'updraftplus'), $backup, $ekey, $checksums, $job_data, true); } if (!isset($backupable_entities[$ekey]) && ('db' != substr($ekey, 0, 2) \|\| '-size' == substr($ekey, -5, 5))) continue; if (is_string($files)) $files = array($files); foreach ($files as $findex => $file) { $size_key = (0 == $findex) ? $ekey.'-size' : $ekey.$findex.'-size'; $total_size = (false === $total_size \|\| !isset($backup[$size_key]) \|\| !is_numeric($backup[$size_key])) ? false : $total_size + $backup[$size_key]; } } $services = empty($backup['service']) ? array('none') : $backup['service']; if (!is_array($services)) $services = array('none'); $rawbackup .= '<strong>'.__('Uploaded to:', 'updraftplus').'</strong> '; $show_services = ''; foreach ($services as $serv) { if ('none' == $serv \|\| '' == $serv) { $add_none = true; } elseif (isset($updraftplus->backup_methods[$serv])) { $show_services .= $show_services ? ', '.$updraftplus->backup_methods[$serv] : $updraftplus->backup_methods[$serv]; } else { $show_services .= $show_services ? ', '.$serv : $serv; } } if ('' == $show_services && $add_none) $show_services .= __('None', 'updraftplus'); $rawbackup .= $show_services; if (false !== $total_size) { $rawbackup .= '</p><strong>'.__('Total backup size:', 'updraftplus').'</strong> '.UpdraftPlus_Manipulation_Functions::convert_numeric_size_to_text($total_size).'<p>'; } $rawbackup .= '</p><hr><p><pre>'.print_r($backup, true).'</pre></p>'; if (!empty($job_data) && is_array($job_data)) { $rawbackup .= '<p><pre>'.htmlspecialchars(print_r($job_data, true)).'</pre></p>'; } return esc_attr($rawbackup); } /* * Display button to download the DB backup in the existing backups table. * * @param string $bkey Backup type. * @param string $key Backup timestamp (epoch time). * @param string $esc_pretty_date Escaped pretty date. * @param array $backup Backup Instance. * @param array $accept Accepted archive names. * @return void - Display download button for DB backup. / private function download_db_button($bkey, $key, $esc_pretty_date, $backup, $accept = array()) { if (!empty($backup['meta_foreign']) && isset($accept[$backup['meta_foreign']])) { $desc_source = $accept[$backup['meta_foreign']]['desc']; } else { $desc_source = __('unknown source', 'updraftplus'); } if ('db' == $bkey) { $dbt = empty($backup['meta_foreign']) ? esc_attr(__('Database', 'updraftplus')) : esc_attr(sprintf(__('Database (created by %s)', 'updraftplus'), $desc_source)); } else { $dbt = __('External database', 'updraftplus').' ('.substr($bkey, 2).')'; } $this->download_button($bkey, $key, 0, null, '', $dbt, $esc_pretty_date, '0'); } /* * Go through each of the file entities * * @param Array $backup An array of meta information * @param Integer $key Backup timestamp (epoch time) * @param Array $accept An array of values to be accepted from values within $backup * @param String $entities Entities to be added * @param String $esc_pretty_date Escaped pretty date * @return Void - Display download buttons in existing backups table / public function download_buttons($backup, $key, $accept, &$entities, $esc_pretty_date) { global $updraftplus; $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); $first_entity = true;// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- template foreach ($backupable_entities as $type => $info) { if (!empty($backup['meta_foreign']) && 'wpcore' != $type) continue; $ide = ''; if (empty($backup['meta_foreign'])) { $sdescrip = preg_replace('/ $.$$/', '', $info['description']); if (strlen($sdescrip) > 20 && isset($info['shortdescription'])) $sdescrip = $info['shortdescription']; } else { $info['description'] = 'WordPress'; if (isset($accept[$backup['meta_foreign']])) { $desc_source = $accept[$backup['meta_foreign']]['desc']; $ide .= sprintf(__('Backup created by: %s.', 'updraftplus'), $accept[$backup['meta_foreign']]['desc']).' '; } else { $desc_source = __('unknown source', 'updraftplus'); $ide .= __('Backup created by unknown source (%s) - cannot be restored.', 'updraftplus').' '; } $sdescrip = (empty($accept[$backup['meta_foreign']]['separatedb'])) ? sprintf(__('Files and database WordPress backup (created by %s)', 'updraftplus'), $desc_source) : sprintf(__('Files backup (created by %s)', 'updraftplus'), $desc_source); } if (isset($backup[$type])) { if (!is_array($backup[$type])) $backup[$type] = array($backup[$type]); $howmanyinset = count($backup[$type]); $expected_index = 0; $index_missing = false; $set_contents = ''; $entities .= "/$type="; $whatfiles = $backup[$type]; ksort($whatfiles); $total_file_size = 0; foreach ($whatfiles as $findex => $bfile) { $set_contents .= ('' == $set_contents) ? $findex : ",$findex"; if ($findex != $expected_index) $index_missing = true; $expected_index++; if ($howmanyinset > 0) { if (!empty($backup[$type.(($findex > 0) ? $findex : '')."-size"]) && $findex < $howmanyinset) $total_file_size += $backup[$type.(($findex > 0) ? $findex : '')."-size"]; } } $ide .= __('Press here to download or browse', 'updraftplus').' '.strtolower($info['description']); $ide .= ' '.sprintf(__('(%d archive(s) in set, total %s).', 'updraftplus'), $howmanyinset, UpdraftPlus_Manipulation_Functions::convert_numeric_size_to_text($total_file_size)); if ($index_missing) $ide .= ' '.__('You are missing one or more archives from this multi-archive set.', 'updraftplus'); $entities .= $set_contents.'/'; if (!empty($backup['meta_foreign'])) { $entities .= '/plugins=0//themes=0//uploads=0//others=0/'; } $this->download_button($type, $key, 0, null, $ide, $sdescrip, $esc_pretty_date, $set_contents); } } } /** * Function to get the download button data from a list of backups * * @param Array $backup_history the backup history. * @return Array An array of download button data from the passed in backup history. / public function get_download_buttons_data($backup_history) { global $updraftplus; $accept = apply_filters('updraftplus_accept_archivename', array()); if (!is_array($accept)) $accept = array(); $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); $button_data = array(); foreach ($backup_history as $key => $backup) { $remote_sent = !empty($backup['service']) && ((is_array($backup['service']) && in_array('remotesend', $backup['service'])) \|\| 'remotesend' === $backup['service']); $button_data[$key] = array( 'remote_sent' => $remote_sent, 'downloads' => array(), ); // Just skip if remote sent is true. if ($remote_sent) { continue; } // https://core.trac.wordpress.org/ticket/25331 explains why the following line is wrong // $pretty_date = date_i18n('Y-m-d G:i',$key); // Convert to blog time zone // $pretty_date = get_date_from_gmt(gmdate('Y-m-d H:i:s', (int)$key), 'Y-m-d G:i'); $pretty_date = get_date_from_gmt(gmdate('Y-m-d H:i:s', (int) $key), 'M d, Y G:i'); if (empty($backup['meta_foreign']) \|\| !empty($accept[$backup['meta_foreign']]['separatedb'])) { if (isset($backup['db'])) { $entities = '/db=0/'; // Set a flag according to whether or not $backup['db'] ends in .crypt, then pick this up in the display of the decrypt field. $db = is_array($backup['db']) ? $backup['db'][0] : $backup['db']; if (UpdraftPlus_Encryption::is_file_encrypted($db)) $entities .= '/dbcrypted=1/'; $button_data[$key]['downloads']['db'] = array( 'pretty_date' => $pretty_date, 'entities' => $entities, 'set_contents' => '0', 'title' => __('Database', 'updraftplus'), ); } // External databases foreach ($backup as $bkey => $binfo) { if ('db' == $bkey \|\| 'db' != substr($bkey, 0, 2) \|\| '-size' == substr($bkey, -5, 5)) continue; $entities = '/'.$bkey.'=0/'; $button_data[$key]['downloads'][$bkey] = array( 'pretty_date' => $pretty_date, 'entities' => $entities, 'set_contents' => '0', 'title' => __('External database', 'updraftplus').' ('.substr($bkey, 2).')', ); } } else { // Foreign without separate db $entities = '/db=0/meta_foreign=1/'; $button_data[$key]['downloads']['db'] = array( 'pretty_date' => $pretty_date, 'entities' => $entities, 'set_contents' => '0', 'title' => __('Database', 'updraftplus'), ); } if (!empty($backup['meta_foreign']) && !empty($accept[$backup['meta_foreign']]) && !empty($accept[$backup['meta_foreign']]['separatedb'])) { $entities = '/db=0/meta_foreign=2/'; $button_data[$key]['downloads']['db'] = array( 'pretty_date' => $pretty_date, 'entities' => $entities, 'set_contents' => '0', 'title' => __('Database', 'updraftplus'), ); } foreach ($backupable_entities as $type => $info) { if (!empty($backup['meta_foreign']) && 'wpcore' != $type) continue; $ide = ''; if (empty($backup['meta_foreign'])) { $sdescrip = preg_replace('/ $.$$/', '', $info['description']); if (strlen($sdescrip) > 20 && isset($info['shortdescription'])) $sdescrip = $info['shortdescription']; } else { $info['description'] = 'WordPress'; if (isset($accept[$backup['meta_foreign']])) { $desc_source = $accept[$backup['meta_foreign']]['desc']; $ide .= sprintf(__('Backup created by: %s.', 'updraftplus'), $accept[$backup['meta_foreign']]['desc']).' '; } else { $desc_source = __('unknown source', 'updraftplus'); $ide .= __('Backup created by unknown source (%s) - cannot be restored.', 'updraftplus').' '; } $sdescrip = (empty($accept[$backup['meta_foreign']]['separatedb'])) ? sprintf(__('Files and database WordPress backup (created by %s)', 'updraftplus'), $desc_source) : sprintf(__('Files backup (created by %s)', 'updraftplus'), $desc_source); } if (isset($backup[$type])) { if (!is_array($backup[$type])) $backup[$type] = array($backup[$type]); $howmanyinset = count($backup[$type]); $expected_index = 0; $index_missing = false; $set_contents = ''; $entities = "/$type="; $whatfiles = $backup[$type]; ksort($whatfiles); $total_file_size = 0; foreach ($whatfiles as $findex => $bfile) { $set_contents .= ('' == $set_contents) ? $findex : ",$findex"; if ($findex != $expected_index) $index_missing = true; $expected_index++; if ($howmanyinset > 0) { if (!empty($backup[$type.(($findex > 0) ? $findex : '')."-size"]) && $findex < $howmanyinset) $total_file_size += $backup[$type.(($findex > 0) ? $findex : '')."-size"]; } } $ide .= __('Press here to download or browse', 'updraftplus').' '.strtolower($info['description']); $ide .= ' '.sprintf(__('(%d archive(s) in set, total %s).', 'updraftplus'), $howmanyinset, UpdraftPlus_Manipulation_Functions::convert_numeric_size_to_text($total_file_size)); if ($index_missing) $ide .= ' '.__('You are missing one or more archives from this multi-archive set.', 'updraftplus'); $entities .= $set_contents.'/'; if (!empty($backup['meta_foreign'])) { $entities .= '/plugins=0//themes=0//uploads=0//others=0/'; } $button_data[$key]['downloads'][$type] = array( 'pretty_date' => $pretty_date, 'entities' => $entities, 'set_contents' => $set_contents, 'title' => $sdescrip, 'ide' => $ide, ); } } } return $button_data; } /** * Return HTML for 'Backup date' column in existing backups data table. * * @param string $pretty_date Pretty date. * @param string $key Backup timestamp (epoch time). * @param array $backup Backup instance. * @param array $jobdata Job data. * @param string $nonce Nonce. * @param bool $simple_format Whether to display simple format or not. Default false. * @return string - Return HTML for date label. / public function date_label($pretty_date, $key, $backup, $jobdata, $nonce, $simple_format = false) { $pretty_date = $simple_format ? $pretty_date : '<div class="clear-right">'.$pretty_date.'</div>'; $ret = apply_filters('updraftplus_showbackup_date', $pretty_date, $backup, $jobdata, (int) $key, $simple_format); if (is_array($jobdata) && !empty($jobdata['resume_interval']) && (empty($jobdata['jobstatus']) \|\| 'finished' != $jobdata['jobstatus'])) { if ($simple_format) { $ret .= ' '.__('(Not finished)', 'updraftplus'); } else { $ret .= apply_filters('updraftplus_msg_unfinishedbackup', "<br><span title=\"".esc_attr(__('If you are seeing more backups than you expect, then it is probably because the deletion of old backup sets does not happen until a fresh backup completes.', 'updraftplus'))."\">".__('(Not finished)', 'updraftplus').'</span>', $jobdata, $nonce); } } return $ret; } /* * Display download button for backups in existing backups table. * * @param string $type Backup type. * @param string $backup_timestamp Backup timestamp (epoch time). * @param int $findex File index. * @param string $info Additional Info. * @param string $title Title attribute contents. * @param string $pdescrip Button text. * @param string $esc_pretty_date Escaped pretty date. * @param string $set_contents Custom data attribute called set. * @return void - Display download button for backups. / public function download_button($type, $backup_timestamp, $findex, $info, $title, $pdescrip, $esc_pretty_date, $set_contents) {// phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found -- Filter use $wp_nonce = wp_create_nonce('updraftplus_download'); // updraft_downloader(base, backup_timestamp, what, whicharea, set_contents, prettydate, async) echo '<button data-wp_nonce="'.esc_attr($wp_nonce).'" data-backup_timestamp="'.esc_attr($backup_timestamp).'" data-what="'.esc_attr($type).'" data-set_contents="'.esc_attr($set_contents).'" data-prettydate="'.esc_attr($esc_pretty_date).'" type="button" class="button updraft_download_button '.esc_attr("uddownloadform_{$type}_{$backup_timestamp}_{$findex}").'" title="'.esc_attr($title).'">'.esc_html($pdescrip).'</button>'; // onclick="'."return updraft_downloader('uddlstatus_', '$backup_timestamp', '$type', '.ud_downloadstatus', '$set_contents', '$esc_pretty_date', true)".'" } /* * Display 'Restore' button for backup in existing backups table. * * @param array $backup Backup instance. * @param string $key Backup timestamp (epoch time). * @param string $pretty_date Pretty date. * @param string $entities Entities backed-up in this backup. * @return void - Display 'Restore' button. / public function restore_button($backup, $key, $pretty_date, $entities = '') { ?> <div class="restore-button"> <?php if ($entities) { $show_data = $pretty_date; if (isset($backup['native']) && false == $backup['native']) { $show_data .= ' '.__('(backup set imported from remote location)', 'updraftplus'); } ?> <button data-showdata="<?php echo esc_attr($show_data);?>" data-backup_timestamp="<?php echo esc_attr($key);?>" data-entities="<?php echo esc_attr($entities);?>" title="<?php esc_attr_e('After pressing this button, you will be given the option to choose which components you wish to restore', 'updraftplus');?>" type="button" class="button button-primary choose-components-button"> <?php esc_html_e('Restore', 'updraftplus');?> </button> <?php } ?> </div> <?php } /* * Display HTML for the 'Upload' button for a particular backup in the 'Existing backups' tab * * @param Integer $backup_time - backup timestamp (epoch time) * @param String $nonce - backup nonce * @param Array $backup - backup information array * @param Null\|Array $jobdata - if not null, then use as the job data instead of fetching * * @return Void - Display 'Upload' button in existing backup table. / public function upload_button($backup_time, $nonce, $backup, $jobdata = null) { global $updraftplus; // Check the job is not still running. if (null === $jobdata) $jobdata = $updraftplus->jobdata_getarray($nonce); if (!empty($jobdata) && 'finished' != $jobdata['jobstatus']) return ''; // Check that the user has remote storage setup. $services = (array) $updraftplus->just_one($updraftplus->get_canonical_service_list()); if (empty($services)) return ''; $show_upload = false; // Check that the backup has not already been sent to remote storage before. if (empty($backup['service']) \|\| array('none') == $backup['service'] \|\| array('') == $backup['service'] \|\| 'none' == $backup['service']) { $show_upload = true; // If it has been uploaded then check if there are any new remote storage options that it has not yet been sent to. } elseif (!empty($backup['service']) && array('none') != $backup['service'] && array('') != $backup['service'] && 'none' != $backup['service']) { foreach ($services as $key => $value) { if (is_string($backup['service'])) $backup['service'] = array($backup['service']); if (in_array($value, $backup['service'])) unset($services[$key]); } if (!empty($services)) $show_upload = true; } if ($show_upload) { $backup_local = $this->check_backup_is_complete($backup, false, false, true); if ($backup_local) { $service_list = ''; $service_list_display = ''; $is_first_service = true; foreach ($services as $key => $service) { if (!$is_first_service) { $service_list .= ','; $service_list_display .= ', '; } $service_list .= $service; $service_list_display .= $updraftplus->backup_methods[$service]; $is_first_service = false; } ?> <div class="updraftplus-upload"> <button data-nonce="<?php echo esc_attr($nonce);?>" data-key="<?php echo esc_attr($backup_time);?>" data-services="<?php echo esc_attr($service_list);?>" title="<?php echo esc_attr(__('After pressing this button, you can select where to upload your backup from a list of your currently saved remote storage locations', 'updraftplus').' ('.$service_list_display.')');?>" type="button" class="button button-primary updraft-upload-link"> <?php esc_html_e('Upload', 'updraftplus');?> </button> </div> <?php } return; } } /* * Display HTML for the 'Delete' button for a particular backup in the 'Existing backups' tab * * @param Integer $backup_time - backup timestamp (epoch time) * @param String $nonce - backup nonce * @param Array $backup - backup information array * * @return Void - Display delete button for backup. / public function delete_button($backup_time, $nonce, $backup) { $sval = (!empty($backup['service']) && 'email' != $backup['service'] && 'none' != $backup['service'] && array('email') !== $backup['service'] && array('none') !== $backup['service'] && array('remotesend') !== $backup['service']) ? '1' : '0'; ?> <div class="updraftplus-remove" data-hasremote="<?php echo esc_attr($sval);?>"> <a data-hasremote="<?php echo esc_attr($sval);?>" data-nonce="<?php echo esc_attr($nonce);?>" data-key="<?php echo esc_attr($backup_time);?>" class="button button-remove no-decoration updraft-delete-link" href="<?php echo esc_url(UpdraftPlus::get_current_clean_url());?>" title="<?php esc_attr_e('Delete this backup set', 'updraftplus');?>"> <?php esc_html_e('Delete', 'updraftplus');?> </a> </div> <?php } /* * Display 'View Log' button in existing backups table. * * @param array $backup Backup instance. * @return void - Display 'View Log' button. / public function log_button($backup) { global $updraftplus; $updraft_dir = $updraftplus->backups_dir_location(); if (isset($backup['nonce']) && preg_match("/^[0-9a-f]{12}$/", $backup['nonce']) && is_readable($updraft_dir.'/log.'.$backup['nonce'].'.txt')) { $nval = $backup['nonce']; $url = UpdraftPlus_Options::admin_page()."?page=updraftplus&action=downloadlog&updraftplus_backup_nonce=$nval"; ?> <div style="clear:none;" class="updraft-viewlogdiv"> <a class="button no-decoration updraft-log-link" href="<?php echo esc_attr($url);?>" data-jobid="<?php echo esc_attr($nval);?>"> <?php esc_html_e('View Log', 'updraftplus');?> </a> <!-- <form action="$url" method="get"> <input type="hidden" name="action" value="downloadlog" /> <input type="hidden" name="page" value="updraftplus" /> <input type="hidden" name="updraftplus_backup_nonce" value="$nval" /> <input type="submit" value="$lt" class="updraft-log-link" onclick="event.preventDefault(); updraft_popuplog(\''.esc_attr($nval).'\');" /> </form> --> </div> <?php } } /* * This function will check that a backup is complete depending on the parameters passed in. * A backup is complete in the case of a "clone" if it contains a db, plugins, themes, uploads and others. * A backup is complete in the case of a "full backup" when it contains everything the user has set in their options to be backed up. * It can also check if the backup is local on the filesystem. * * @param array $backup - the backup array we want to check * @param boolean $full_backup - a boolean to indicate if the backup should also be a full backup * @param boolean $clone - a boolean to indicate if the backup is for a clone, if so it does not need to be a full backup it only needs to include everything a clone can restore * @param boolean $local - a boolean to indicate if the backup should be present on the local file system or not * * @return boolean - returns true if the backup is complete and if specified is found on the local system otherwise false / public function check_backup_is_complete($backup, $full_backup, $clone, $local) { global $updraftplus; if (empty($backup)) return false; if ($clone) { $entities = array('db' => '', 'plugins' => '', 'themes' => '', 'uploads' => '', 'others' => ''); } else { $entities = $updraftplus->get_backupable_file_entities(true, true); // Add the database to the entities array ready to loop over $entities['db'] = ''; foreach ($entities as $key => $info) { if (!UpdraftPlus_Options::get_updraft_option("updraft_include_$key", false)) { unset($entities[$key]); } } } $updraft_dir = trailingslashit($updraftplus->backups_dir_location()); foreach ($entities as $type => $info) { if ($full_backup) { if (UpdraftPlus_Options::get_updraft_option("updraft_include_$type", false) && !isset($backup[$type])) return false; } if (!isset($backup[$type])) return false; if ($local) { // Cast this to an array so that a warning is not thrown when we encounter a Database. foreach ((array) $backup[$type] as $value) { if (!file_exists($updraft_dir . DIRECTORY_SEPARATOR . $value)) return false; } } } return true; } /* * This function will set up the backup job data for when we are uploading a local backup to remote storage. It changes the initial jobdata so that UpdraftPlus knows about what files it's uploading and so that it skips directly to the upload stage. * * @param array $jobdata - the initial job data that we want to change * @param array $options - options sent from the front end includes backup timestamp and nonce * * @return array - the modified jobdata / public function upload_local_backup_jobdata($jobdata, $options) { global $updraftplus; if (!is_array($jobdata)) return $jobdata; $backup_history = UpdraftPlus_Backup_History::get_history(); $services = !empty($options['services']) ? $options['services'] : array(); $backup = $backup_history[$options['use_timestamp']]; / The initial job data is not set up in a key value array instead it is set up so key "x" is the name of the key and then key "y" is the value. e.g array[0] = 'backup_name' array[1] = 'my_backup' / $jobstatus_key = array_search('jobstatus', $jobdata) + 1; $backup_time_key = array_search('backup_time', $jobdata) + 1; $backup_database_key = array_search('backup_database', $jobdata) + 1; $backup_files_key = array_search('backup_files', $jobdata) + 1; $service_key = array_search('service', $jobdata) + 1; $db_backups = $jobdata[$backup_database_key]; $db_backup_info = $updraftplus->update_database_jobdata($db_backups, $backup); $file_backups = $updraftplus->update_files_jobdata($backup); // Next we need to build the services array using the remote storage destinations the user has selected to upload this backup set to $selected_services = array(); if (is_array($services)) { foreach ($services as $storage_info) { $selected_services[] = $storage_info['value']; } } else { $selected_services = array($services); } $jobdata[$jobstatus_key] = 'clouduploading'; $jobdata[$backup_time_key] = $options['use_timestamp']; $jobdata[$backup_files_key] = 'finished'; $jobdata[] = 'backup_files_array'; $jobdata[] = $file_backups; $jobdata[] = 'blog_name'; $jobdata[] = $db_backup_info['blog_name']; $jobdata[$backup_database_key] = $db_backup_info['db_backups']; $jobdata[] = 'local_upload'; $jobdata[] = true; if (!empty($selected_services)) $jobdata[$service_key] = $selected_services; return $jobdata; } /* * This function allows us to change the backup name, this is needed when uploading a local database backup to remote storage when the backup has come from another site. * * @param string $backup_name - the current name of the backup file * @param string $use_time - the current timestamp we are using * @param string $blog_name - the blog name of the current site * * @return string - the new filename or the original if the blog name from the job data is not set / public function upload_local_backup_name($backup_name, $use_time, $blog_name) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found -- Filter use global $updraftplus; $backup_blog_name = $updraftplus->jobdata_get('blog_name', ''); if ('' != $blog_name && '' != $backup_blog_name) { return str_replace($blog_name, $backup_blog_name, $backup_name); } return $backup_name; } /* * This function starts the updraftplus restore process it processes $_REQUEST * (keys: updraft_, meta_foreign, backup_timestamp and job_id) * @return void / public function prepare_restore() { global $updraftplus; // on restore start job_id is empty but if we needed file system permissions or this is a resumption then we have already started a job so reuse it $restore_job_id = empty($_REQUEST['job_id']) ? false : stripslashes($_REQUEST['job_id']); if (false !== $restore_job_id && !preg_match('/^[0-9a-f]+$/', $restore_job_id)) die('Invalid request (restore_job_id).'); if (isset($_REQUEST['action']) && 'updraft_ajaxrestore_continue' === $_REQUEST['action']) { // unlike updraft_ajaxrestore which requires nonce to start a new restoration, updraft_ajaxrestore_continue doesn't require nonces at all so additional checks are required $restore_in_progress = get_site_option('updraft_restore_in_progress'); if (empty($restore_in_progress) \|\| !$restore_job_id \|\| $restore_job_id !== $restore_in_progress) die; // continuation requires a job ID, and if it's not presented then just abort without showing anything } // Set up nonces, log files etc. $updraftplus->initiate_restore_job($restore_job_id); // If this is the start of a restore then get the restore data from the posted data and put it into jobdata. if (isset($_REQUEST['action']) && 'updraft_restore' == $_REQUEST['action']) { if (empty($restore_job_id)) { $jobdata_to_save = array(); foreach ($_REQUEST as $key => $value) { if (false !== strpos($key, 'updraft_') \|\| 'backup_timestamp' == $key \|\| 'meta_foreign' == $key) { if ('updraft_restorer_restore_options' == $key) parse_str(stripslashes($value), $value); $jobdata_to_save[$key] = $value; } } $selective_restore_types = array( 'tables', 'plugins', 'themes', ); foreach ($selective_restore_types as $type) { if (isset($jobdata_to_save['updraft_restorer_restore_options']['updraft_restore_'.$type.'_options']) && !empty($jobdata_to_save['updraft_restorer_restore_options']['updraft_restore_'.$type.'_options'])) { $restore_entities_options = $jobdata_to_save['updraft_restorer_restore_options']['updraft_restore_'.$type.'_options']; $include_unspecified_entities = false; $entities_to_restore = array(); $entities_to_skip = array(); foreach ($restore_entities_options as $entity) { if ('udp_all_other_'.$type == $entity) { $include_unspecified_entities = true; } elseif (substr($entity, 0, strlen('udp-skip-'.$type)) == 'udp-skip-'.$type) { $entities_to_skip[] = substr($entity, strlen('udp-skip-'.$type) + 1); } else { $entities_to_restore[] = $entity; } } $jobdata_to_save['updraft_restorer_restore_options']['include_unspecified_'.$type] = $include_unspecified_entities; $jobdata_to_save['updraft_restorer_restore_options'][$type.'_to_restore'] = $entities_to_restore; $jobdata_to_save['updraft_restorer_restore_options'][$type.'_to_skip'] = $entities_to_skip; unset($jobdata_to_save['updraft_restorer_restore_options']['updraft_restore_'.$type.'_options']); } } $updraftplus->jobdata_set_multi($jobdata_to_save); // Use a site option, as otherwise on multisite when all the array of options is updated via UpdraftPlus_Options::update_site_option(), it will over-write any restored UD options from the backup update_site_option('updraft_restore_in_progress', $updraftplus->nonce); } } // If this is the start of an ajax restore then end execution here so it can then be booted over ajax if (isset($_REQUEST['updraftplus_ajax_restore']) && 'start_ajax_restore' == $_REQUEST['updraftplus_ajax_restore']) { // return to prevent any more code from running return $this->prepare_ajax_restore(); } elseif (isset($_REQUEST['updraftplus_ajax_restore']) && 'continue_ajax_restore' == $_REQUEST['updraftplus_ajax_restore']) { // If we enter here then in order to restore we needed to require the filesystem credentials we should save these before returning back to the browser and load them back after the AJAX call, this prevents us asking for the filesystem credentials again $filesystem_credentials = array( 'hostname' => '', 'username' => '', 'password' => '', 'connection_type' => '', 'upgrade' => '', ); $credentials_found = false; foreach ($_REQUEST as $key => $value) { if (array_key_exists($key, $filesystem_credentials)) { $filesystem_credentials[$key] = stripslashes($value); $credentials_found = true; } } if ($credentials_found) $updraftplus->jobdata_set('filesystem_credentials', $filesystem_credentials); // return to prevent any more code from running return $this->prepare_ajax_restore(); } if (!empty($_REQUEST['updraftplus_ajax_restore'])) add_filter('updraftplus_logline', array($this, 'updraftplus_logline'), 10, 5); $is_continuation = ('updraft_ajaxrestore_continue' == $_REQUEST['action']) ? true : false; if ($is_continuation) { $restore_in_progress = get_site_option('updraft_restore_in_progress'); if ($restore_in_progress != $_REQUEST['job_id']) { $abort_restore_already = true; $updraftplus->log(__('Sufficient information about the in-progress restoration operation could not be found.', 'updraftplus') . ' (job_id_mismatch)', 'error', 'job_id_mismatch'); } else { $restore_jobdata = $updraftplus->jobdata_getarray($restore_in_progress); if (is_array($restore_jobdata) && isset($restore_jobdata['job_type']) && 'restore' == $restore_jobdata['job_type'] && isset($restore_jobdata['second_loop_entities']) && !empty($restore_jobdata['second_loop_entities']) && isset($restore_jobdata['job_time_ms']) && isset($restore_jobdata['backup_timestamp'])) { $backup_timestamp = $restore_jobdata['backup_timestamp']; $continuation_data = $restore_jobdata; $continuation_data['updraftplus_ajax_restore'] = 'continue_ajax_restore'; } else { $abort_restore_already = true; $updraftplus->log(__('Sufficient information about the in-progress restoration operation could not be found.', 'updraftplus') . ' (job_id_nojobdata)', 'error', 'job_id_nojobdata'); } } } elseif (isset($_REQUEST['updraftplus_ajax_restore']) && 'do_ajax_restore' == $_REQUEST['updraftplus_ajax_restore']) { $backup_timestamp = $updraftplus->jobdata_get('backup_timestamp'); $continuation_data = array('updraftplus_ajax_restore' => 'do_ajax_restore'); } else { $backup_timestamp = (int) $_REQUEST['backup_timestamp']; $continuation_data = null; } $filesystem_credentials = $updraftplus->jobdata_get('filesystem_credentials', array()); if (!empty($filesystem_credentials)) { $continuation_data['updraftplus_ajax_restore'] = 'continue_ajax_restore'; // If the filesystem credentials are not empty then we now need to load these back into $_POST so that WP_Filesystem can access them foreach ($filesystem_credentials as $key => $value) { $_POST[$key] = $value; } } if (empty($abort_restore_already)) { $backup_success = $this->restore_backup($backup_timestamp, $continuation_data); } else { $backup_success = false; } if (empty($updraftplus->errors) && true === $backup_success) { // TODO: Deal with the case of some of the work having been deferred echo '<p class="updraft_restore_successful"><strong>'; $updraftplus->log_e('Restore successful!'); echo '</strong></p>'; $updraftplus->log('Restore successful'); $s_val = 1; if (!empty($this->entities_to_restore) && is_array($this->entities_to_restore)) { foreach ($this->entities_to_restore as $v) { if ('db' != $v) $s_val = 2; } } $pval = $updraftplus->have_addons ? 1 : 0; echo '<strong>'.esc_html__('Actions', 'updraftplus').':</strong> <a href="'.esc_url(UpdraftPlus_Options::admin_page_url().'?page=updraftplus&updraft_restore_success='.$s_val.'&pval='.$pval).'">'.esc_html__('Return to UpdraftPlus configuration', 'updraftplus').'</a>'; return; } elseif (is_wp_error($backup_success)) { echo '<p class="updraft_restore_error">'; $updraftplus->log_e('Restore failed...'); echo '</p>'; $updraftplus->log_wp_error($backup_success); $updraftplus->log('Restore failed'); echo '<div class="updraft_restore_errors">'; $updraftplus->list_errors(); echo '</div>'; echo '<strong>'.esc_html__('Actions', 'updraftplus').':</strong> <a href="'.esc_url(UpdraftPlus_Options::admin_page_url().'?page=updraftplus').'">'.esc_html__('Return to UpdraftPlus configuration', 'updraftplus').'</a>'; return; } elseif (false === $backup_success) { // This means, "not yet - but stay on the page because we may be able to do it later, e.g. if the user types in the requested information" echo '<p class="updraft_restore_error">'; $updraftplus->log_e('Restore failed...'); echo '</p>'; $updraftplus->log("Restore failed"); echo '<div class="updraft_restore_errors">'; $updraftplus->list_errors(); echo '</div>'; echo '<strong>' . __('Actions', 'updraftplus') . ':</strong> <a href="' . UpdraftPlus_Options::admin_page_url() . '?page=updraftplus">' . __('Return to UpdraftPlus configuration', 'updraftplus') . '</a>'; return; } } /* * This function will load the required ajax and output any relevant html for the ajax restore * * @return void / private function prepare_ajax_restore() { global $updraftplus; $debug = $updraftplus->use_unminified_scripts(); $enqueue_version = $debug ? $updraftplus->version . '.' . time() : $updraftplus->version; $updraft_min_or_not = $updraftplus->get_updraftplus_file_version(); $ajax_action = isset($_REQUEST['updraftplus_ajax_restore']) && 'continue_ajax_restore' == $_REQUEST['updraftplus_ajax_restore'] && 'updraft_restore' != $_REQUEST['action'] ? 'updraft_ajaxrestore_continue' : 'updraft_ajaxrestore'; // get the entities info $jobdata = $updraftplus->jobdata_getarray($updraftplus->nonce); $restore_components = $jobdata['updraft_restore']; usort($restore_components, array('UpdraftPlus_Manipulation_Functions', 'sort_restoration_entities')); $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); $pretty_date = get_date_from_gmt(gmdate('Y-m-d H:i:s', (int) $jobdata['backup_timestamp']), 'M d, Y G:i'); wp_enqueue_script('updraft-admin-restore', UPDRAFTPLUS_URL . '/js/updraft-admin-restore' . $updraft_min_or_not . '.js', array(), $enqueue_version); $updraftplus->log("Restore setup, now closing connection and starting restore over AJAX."); echo '<div class="updraft_restore_container">'; echo '<div class="error" id="updraft-restore-hidethis">'; echo '<p><strong>'.esc_html__('Warning: If you can still read these words after the page finishes loading, then there is a JavaScript or jQuery problem in the site.', 'updraftplus').' '.esc_html__('This may prevent the restore procedure from being able to proceed.', 'updraftplus').'</strong>'; echo ' <a href="'.esc_url(apply_filters('updraftplus_com_link', "https://updraftplus.com/do-you-have-a-javascript-or-jquery-error/")).'" target="_blank">'.esc_html__('Go here for more information.', 'updraftplus').'</a></p>'; echo '</div>'; echo '<div class="updraft_restore_main--header">'.esc_html__('UpdraftPlus Restoration', 'updraftplus').' - '.esc_html__('Backup', 'updraftplus').' '.esc_html($pretty_date).'</div>'; echo '<div class="updraft_restore_main">'; if ($debug) echo '<input type="hidden" id="updraftplus_ajax_restore_debug" name="updraftplus_ajax_restore_debug" value="1">'; echo '<input type="hidden" id="updraftplus_ajax_restore_job_id" name="updraftplus_restore_job_id" value="' . esc_attr($updraftplus->nonce) . '">'; echo '<input type="hidden" id="updraftplus_ajax_restore_action" name="updraftplus_restore_action" value="' . esc_attr($ajax_action) . '">'; echo '<div id="updraftplus_ajax_restore_progress" style="display: none;"></div>'; echo '<div class="updraft_restore_main--components">'; echo '<p>'.sprintf(esc_html__('The restore operation has begun (%s).', 'updraftplus'), $updraftplus->nonce).' '.esc_html__('Do not close this page until it reports itself as having finished.', 'updraftplus').'</p>'; echo '<h2>'.esc_html__('Restoration progress:', 'updraftplus').'</h2>'; echo ' <div class="updraft_restore_result"><span class="dashicons"></span><pan class="updraft_restore_result--text"></span></div>'; echo ' <ul class="updraft_restore_components_list">'; echo '<li data-component="verifying" class="active"><span class="updraft_component--description">'.esc_html__('Verifying', 'updraftplus').'</span><span class="updraft_component--progress"></span></li>'; foreach ($restore_components as $restore_component) { // Set Database description if ('db' == $restore_component && !isset($backupable_entities[$restore_component]['description'])) $backupable_entities[$restore_component]['description'] = __('Database', 'updraftplus'); if (!isset($backupable_entities[$restore_component])) { die('Abort: invalid data'); } echo '<li data-component="'.esc_attr($restore_component).'"><span class="updraft_component--description">'.(isset($backupable_entities[$restore_component]['description']) ? esc_html($backupable_entities[$restore_component]['description']) : esc_html($restore_component)).'</span><span class="updraft_component--progress"></span></li>'; } echo '<li data-component="cleaning"><span class="updraft_component--description">'.esc_html__('Cleaning', 'updraftplus').'</span><span class="updraft_component--progress"></span></li>'; echo '<li data-component="finished"><span class="updraft_component--description">'.esc_html__('Finished', 'updraftplus').'</span><span class="updraft_component--progress"></span></li>'; echo ' </ul>'; // end ul.updraft_restore_components_list // Provide download link for the log file echo '<p><a target="_blank" href="?action=downloadlog&page=updraftplus&updraftplus_backup_nonce='.esc_attr($updraftplus->nonce).'">'.esc_html__('Follow this link to download the log file for this restoration (needed for any support requests).', 'updraftplus').'</a></p>'; echo '</div>'; // end .updraft_restore_main--components echo '<div class="updraft_restore_main--activity">'; echo '<h2 class="updraft_restore_main--activity-title">'.esc_html__('Activity log', 'updraftplus').' <i id="activity-full-log" title="'.esc_html__('Full-screen', 'updraftplus').'" class="dashicons dashicons-fullscreen-alt" style="float: right; cursor: pointer; margin-left: 7px;"></i> <span id="updraftplus_ajax_restore_last_activity"></span></h2>'; echo ' <div id="updraftplus_ajax_restore_output"></div>'; echo '</div>'; // end .updraft_restore_main--activity echo ' <div class="updraft-restore--footer"> <ul class="updraft-restore--stages"> <li><span>1. '.esc_html__('Component selection', 'updraftplus').'</span></li> <li><span>2. '.esc_html__('Verifications', 'updraftplus').'</span></li> <li class="active"><span>3. '.esc_html__('Restoration', 'updraftplus').'</span></li> </ul> </div>'; echo '</div>'; // end .updraft_restore_main echo '</div>'; // end .updraft_restore_container } /* * Processes the jobdata to build an array of entities to restore. * * @param Array $backup_set - information on the backup to restore * * @return Array - the entities to restore built from the restore jobdata / private function get_entities_to_restore_from_jobdata($backup_set) { global $updraftplus; $updraft_restore = $updraftplus->jobdata_get('updraft_restore'); if (empty($updraft_restore) \|\| (!is_array($updraft_restore))) $updraft_restore = array(); $entities_to_restore = array(); $foreign_known = apply_filters('updraftplus_accept_archivename', array()); foreach ($updraft_restore as $entity) { if (empty($backup_set['meta_foreign'])) { $entities_to_restore[$entity] = $entity; } else { if ('db' == $entity && !empty($foreign_known[$backup_set['meta_foreign']]) && !empty($foreign_known[$backup_set['meta_foreign']]['separatedb'])) { $entities_to_restore[$entity] = 'db'; } else { $entities_to_restore[$entity] = 'wpcore'; } } } return $entities_to_restore; } /* * Processes the jobdata to build an array of restoration options * * @return Array - the restore options built from the restore jobdata / private function get_restore_options_from_jobdata() { global $updraftplus; $restore_options = $updraftplus->jobdata_get('updraft_restorer_restore_options'); $updraft_encryptionphrase = $updraftplus->jobdata_get('updraft_encryptionphrase'); $include_wpconfig = $updraftplus->jobdata_get('updraft_restorer_wpcore_includewpconfig'); $restore_options['updraft_encryptionphrase'] = empty($updraft_encryptionphrase) ? '' : $updraft_encryptionphrase; $restore_options['updraft_restorer_wpcore_includewpconfig'] = !empty($include_wpconfig); $restore_options['updraft_incremental_restore_point'] = empty($restore_options['updraft_incremental_restore_point']) ? -1 : (int) $restore_options['updraft_incremental_restore_point']; return $restore_options; } /* * Carry out the restore process within the WP admin dashboard, using data from $_POST * * @param Integer $timestamp Identifying the backup to be restored * @param Array\|null $continuation_data For continuing a multi-stage restore; this is the saved jobdata for the job; in this method the keys used are second_loop_entities, restore_options; but it is also passed on to Updraft_Restorer::perform_restore() * @return Boolean\|WP_Error - a WP_Error indicates a terminal failure; false indicates not-yet complete (not necessarily terminal); true indicates complete. / private function restore_backup($timestamp, $continuation_data = null) { global $updraftplus, $updraftplus_restorer; $second_loop_entities = empty($continuation_data['second_loop_entities']) ? array() : $continuation_data['second_loop_entities']; // If this is a resumption and we still need to restore the database we should rebuild the backup history to ensure the database is in there. if (!empty($second_loop_entities['db'])) UpdraftPlus_Backup_History::rebuild(); $backup_set = UpdraftPlus_Backup_History::get_history($timestamp); if (empty($backup_set)) { echo '<p>'.esc_html__('This backup does not exist in the backup history - restoration aborted.', 'updraftplus').' '.esc_html__('Timestamp:', 'updraftplus').' '.esc_html($timestamp).'</p><br>'; return new WP_Error('does_not_exist', __('Backup does not exist in the backup history', 'updraftplus')." ($timestamp)"); } $backup_set['timestamp'] = $timestamp; $url_parameters = array( 'backup_timestamp' => $timestamp, 'job_id' => $updraftplus->nonce ); if (!empty($continuation_data['updraftplus_ajax_restore'])) { $url_parameters['updraftplus_ajax_restore'] = 'continue_ajax_restore'; $updraftplus->output_to_browser(''); // Start timer // Force output buffering off so that we get log lines sent to the browser as they come not all at once at the end of the ajax restore // zlib creates an output buffer, and waits for the entire page to be generated before it can send it to the client try to turn it off @ini_set("zlib.output_compression", '0');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // Turn off PHP output buffering for NGINX header('X-Accel-Buffering: no'); header('Content-Encoding: none'); while (ob_get_level()) { ob_end_flush(); } if (version_compare(PHP_VERSION, '8.0.0', '>=')) { $flush = true; // PHP 8.0.0 or newer, use bool } else { $flush = 1; // PHP older than 8.0.0, use int } ob_implicit_flush($flush); } $updraftplus->log("Ensuring WP_Filesystem is setup for a restore"); // This will print HTML and die() if necessary UpdraftPlus_Filesystem_Functions::ensure_wp_filesystem_set_up_for_restore($url_parameters); $updraftplus->log("WP_Filesystem is setup and ready for a restore"); $entities_to_restore = $this->get_entities_to_restore_from_jobdata($backup_set); if (empty($entities_to_restore)) { $restore_jobdata = $updraftplus->jobdata_getarray($updraftplus->nonce); echo '<p>'.esc_html__('ABORT: Could not find the information on which entities to restore.', 'updraftplus').'</p><p>'.esc_html__('If making a request for support, please include this information:', 'updraftplus').' '.count($restore_jobdata).' : '.esc_html(serialize($restore_jobdata)).'</p>'; return new WP_Error('missing_info', 'Backup information not found'); } // This is used in painting the admin page after a successful restore $this->entities_to_restore = $entities_to_restore; $error_levels = version_compare(PHP_VERSION, '8.4.0', '>=') ? E_ALL : E_ALL & ~E_STRICT; // This will be removed by Updraft_Restorer::post_restore_clean_up() set_error_handler(array($updraftplus, 'php_error'), $error_levels); // Set $restore_options, either from the continuation data, or from $_POST if (!empty($continuation_data['restore_options'])) { $restore_options = $continuation_data['restore_options']; } else { // Gather the restore options into one place - code after here should read the options $restore_options = $this->get_restore_options_from_jobdata(); $updraftplus->jobdata_set('restore_options', $restore_options); } add_action('updraftplus_restoration_title', array($this, 'restoration_title')); $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'started', 'data' => array())); // We use a single object for each entity, because we want to store information about the backup set $updraftplus_restorer = new Updraft_Restorer(new Updraft_Restorer_Skin, $backup_set, false, $restore_options, $continuation_data); $restore_result = $updraftplus_restorer->perform_restore($entities_to_restore, $restore_options); $updraftplus_restorer->post_restore_clean_up($restore_result); $pval = $updraftplus->have_addons ? 1 : 0; $sval = (true === $restore_result) ? 1 : 0; $pages = get_pages(array('number' => 2)); $page_urls = array( 'home' => get_home_url(), ); foreach ($pages as $page_info) { $page_urls[$page_info->post_name] = get_page_link($page_info->ID); } $updraftplus->log_restore_update( array( 'type' => 'state', 'stage' => 'finished', 'data' => array( 'actions' => array( __('Return to UpdraftPlus configuration', 'updraftplus') => UpdraftPlus_Options::admin_page_url() . '?page=updraftplus&updraft_restore_success=' . $sval . '&pval=' . $pval ), 'urls' => $page_urls, ) ) ); return $restore_result; } /* * Called when the restore process wants to print a title * * @param String $title - title / public function restoration_title($title) { echo '<h2>'.esc_html($title).'</h2>'; } /* * Logs a line from the restore process, being called from UpdraftPlus::log(). * Hooks the WordPress filter updraftplus_logline * In future, this can get more sophisticated. For now, things are funnelled through here, giving the future possibility. * * @param String $line - the line to be logged * @param String $nonce - the job ID of the restore job * @param String $level - the level of the log notice * @param String\|Boolean $uniq_id - a unique ID for the log if it should only be logged once; or false otherwise * @param String $destination - the type of job ongoing. If it is not 'restore', then we will skip the logging. * * @return String\|Boolean - the filtered value. If set to false, then UpdraftPlus::log() will stop processing the log line. / public function updraftplus_logline($line, $nonce, $level, $uniq_id, $destination) {// phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found -- Unused parameter is present because the method is used as a WP filter. if ('progress' != $destination \|\| (defined('WP_CLI') && WP_CLI) \|\| false === $line \|\| false === strpos($line, 'RINFO:')) return $line; global $updraftplus; $updraftplus->output_to_browser($line); // Indicate that we have completely handled all logging needed return false; } /* * Ensure that what is returned is an array. Used as a WP options filter. * * @param Array $input - input * * @return Array / public function return_array($input) { return is_array($input) ? $input : array(); } /* * Called upon the WP action wp_ajax_updraft_savesettings. Will die(). / public function updraft_ajax_savesettings() { try { if (empty($_POST) \|\| empty($_POST['subaction']) \|\| 'savesettings' != $_POST['subaction'] \|\| !isset($_POST['nonce']) \|\| !is_user_logged_in() \|\| !UpdraftPlus_Options::user_can_manage() \|\| !wp_verify_nonce($_POST['nonce'], 'updraftplus-settings-nonce')) die('Security check'); if (empty($_POST['settings']) \|\| !is_string($_POST['settings'])) die('Invalid data'); parse_str(stripslashes($_POST['settings']), $posted_settings); // We now have $posted_settings as an array if (!empty($_POST['updraftplus_version'])) $posted_settings['updraftplus_version'] = $_POST['updraftplus_version']; echo json_encode($this->save_settings($posted_settings)); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during save settings. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during save settings. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); } die; } public function updraft_ajax_importsettings() { try { if (empty($_POST) \|\| empty($_POST['subaction']) \|\| 'importsettings' != $_POST['subaction'] \|\| !isset($_POST['nonce']) \|\| !is_user_logged_in() \|\| !UpdraftPlus_Options::user_can_manage() \|\| !wp_verify_nonce($_POST['nonce'], 'updraftplus-settings-nonce')) die('Security check'); if (empty($_POST['settings']) \|\| !is_string($_POST['settings'])) die('Invalid data'); $this->import_settings($_POST); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during import settings. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during import settings. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); echo json_encode(array( 'fatal_error' => true, 'fatal_error_message' => $log_message )); } } /* * This method handles the imported json settings it will convert them into a readable format for the existing save settings function, it will also update some of the options to match the new remote storage options format (Apr 2017) * * @param Array $settings - The settings from the imported json file * @param Bool $return_instead_of_echo - Whether to return the result instead of echoing it / public function import_settings($settings, $return_instead_of_echo = false) { // A bug in UD releases around 1.12.40 - 1.13.3 meant that it was saved in URL-string format, instead of JSON $perhaps_not_yet_parsed = json_decode(stripslashes($settings['settings']), true); if (!is_array($perhaps_not_yet_parsed)) { parse_str($perhaps_not_yet_parsed, $posted_settings); } else { $posted_settings = $perhaps_not_yet_parsed; } if (!empty($settings['updraftplus_version'])) $posted_settings['updraftplus_version'] = $settings['updraftplus_version']; // Handle the settings name change of WebDAV and SFTP (Apr 2017) if someone tries to import an old settings to this version if (isset($posted_settings['updraft_webdav_settings'])) { $posted_settings['updraft_webdav'] = $posted_settings['updraft_webdav_settings']; unset($posted_settings['updraft_webdav_settings']); } if (isset($posted_settings['updraft_sftp_settings'])) { $posted_settings['updraft_sftp'] = $posted_settings['updraft_sftp_settings']; unset($posted_settings['updraft_sftp_settings']); } // We also need to wrap some of the options in the new style settings array otherwise later on we will lose the settings if this information is missing if (empty($posted_settings['updraft_webdav']['settings'])) $posted_settings['updraft_webdav'] = UpdraftPlus_Storage_Methods_Interface::wrap_remote_storage_options($posted_settings['updraft_webdav']); if (empty($posted_settings['updraft_googledrive']['settings'])) $posted_settings['updraft_googledrive'] = UpdraftPlus_Storage_Methods_Interface::wrap_remote_storage_options($posted_settings['updraft_googledrive']); if (empty($posted_settings['updraft_googlecloud']['settings'])) $posted_settings['updraft_googlecloud'] = UpdraftPlus_Storage_Methods_Interface::wrap_remote_storage_options($posted_settings['updraft_googlecloud']); if (empty($posted_settings['updraft_onedrive']['settings'])) $posted_settings['updraft_onedrive'] = UpdraftPlus_Storage_Methods_Interface::wrap_remote_storage_options($posted_settings['updraft_onedrive']); if (empty($posted_settings['updraft_azure']['settings'])) $posted_settings['updraft_azure'] = UpdraftPlus_Storage_Methods_Interface::wrap_remote_storage_options($posted_settings['updraft_azure']); if (empty($posted_settings['updraft_dropbox']['settings'])) $posted_settings['updraft_dropbox'] = UpdraftPlus_Storage_Methods_Interface::wrap_remote_storage_options($posted_settings['updraft_dropbox']); if ($return_instead_of_echo) { return $this->save_settings($posted_settings); } else { echo json_encode($this->save_settings($posted_settings)); die; } } /* * This function will get a list of remote storage methods with valid connection details and create a HTML list of checkboxes * * @return String - HTML checkbox list of remote storage methods with valid connection details / private function backup_now_remote_message() { global $updraftplus; $active_remote_storage_list = ''; $active_remote_storages = $this->get_active_remote_storages(); foreach ($active_remote_storages as $instance => $remote_storage) { $method = $remote_storage['method']; $label = $remote_storage['label']; $checked = !empty($remote_storage['enabled']) ? 'checked="checked"' : ''; if ('email' == $method) { $active_remote_storage_list .= '<input class="updraft_remote_service_entity" id="'.esc_attr($method).'updraft_service" checked="checked" type="checkbox" name="updraft_include_remote_service_'. esc_attr($method) . '" value=""> <label for="'.esc_attr($method).'updraft_service">'.esc_html($updraftplus->backup_methods[$method]).'</label><br>'; } else { $active_remote_storage_list .= '<input class="updraft_remote_service_entity" id="'.esc_attr($method).'updraft_service_'.esc_attr($instance).'" ' . esc_attr($checked) . ' type="checkbox" name="updraft_include_remote_service_'. esc_attr($method) . '" value="'.esc_attr($instance).'"> <label for="'.esc_attr($method).'updraft_service_'.esc_attr($instance).'">'.esc_html($label).'</label><br>'; } } $service = $updraftplus->just_one(UpdraftPlus_Options::get_updraft_option('updraft_service')); if (is_string($service)) $service = array($service); if (!is_array($service)) $service = array(); $no_remote_configured = (empty($service) \|\| array('none') === $service \|\| array('') === $service) ? true : false; if ($no_remote_configured && empty($active_remote_storage_list)) { return '<input type="checkbox" disabled="disabled" id="backupnow_includecloud"> <em>'. / translators: %s: "settings" which is the name of a tab on which remote storage settings are configured / sprintf(__("Backup won't be sent to any remote storage - none has been saved in the %s", 'updraftplus'), '<a href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus&tab=settings" id="updraft_backupnow_gotosettings">'. __('settings', 'updraftplus')).'</a>. '.__('Not got any remote storage?', 'updraftplus').' <a href="'.apply_filters('updraftplus_com_link', "https://teamupdraft.com/updraftplus/updraftvault/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=check-out-vault&utm_creative_format=text").'" target="_blank">'.__("Check out UpdraftVault.", 'updraftplus').'</a></em>'; } if (empty($active_remote_storage_list)) { $active_remote_storage_list = '<p>'.__('No remote storage locations with valid options found.', 'updraftplus').'</p>'; } return '<input type="checkbox" id="backupnow_includecloud" checked="checked"> <label for="backupnow_includecloud">'.__("Send this backup to remote storage", 'updraftplus').'</label> (<a href="'.esc_url(UpdraftPlus::get_current_clean_url()).'" id="backupnow_includecloud_showmoreoptions">...</a>)<br><div id="backupnow_includecloud_moreoptions" class="updraft-hidden" style="display:none;"><em>'. __('The following remote storage options are configured.', 'updraftplus').'</em><br>'.$active_remote_storage_list.'</div>'; } /* * This function will get a list of remote storage methods with valid connection details. * * @return array - List of configured remote storages. / public function get_active_remote_storages() { global $updraftplus; $active_instances = array(); $services = (array) $updraftplus->just_one($updraftplus->get_canonical_service_list()); $all_services = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids($services); foreach ($all_services as $method => $sinfo) { if ('email' == $method) { $possible_emails = $updraftplus->just_one_email(UpdraftPlus_Options::get_updraft_option('updraft_email')); if (!empty($possible_emails)) { $active_instances['email'] = array( 'label' => $updraftplus->backup_methods[$method], 'method' => $method, 'enabled' => true, // We hardcode this as true -- legacy logic, its always checked. ); } } elseif (empty($sinfo['object']) \|\| empty($sinfo['instance_settings']) \|\| !is_callable(array($sinfo['object'], 'options_exist'))) { continue; } $instance_count = 1; foreach ($sinfo['instance_settings'] as $instance => $opt) { if ($sinfo['object']->options_exist($opt)) { $instance_count_label = (1 == $instance_count) ? '' : ' ('.$instance_count.')'; $label = empty($opt['instance_label']) ? $sinfo['object']->get_description() . $instance_count_label : $opt['instance_label']; if (!isset($opt['instance_enabled'])) $opt['instance_enabled'] = 1; $active_instances[$instance] = array( 'label' => $label, 'method' => $method, 'enabled' => !empty($opt['instance_enabled']), ); $instance_count++; } } } return $active_instances; } /* * This method works through the passed in settings array and saves the settings to the database clearing old data and setting up a return array with content to update the page via ajax * * @param array $settings An array of settings taking from the admin page ready to be saved to the database * @return array An array response containing the status of the update along with content to be used to update the admin page. / public function save_settings($settings) { global $updraftplus; // Make sure that settings filters are registered UpdraftPlus_Options::admin_init(); $more_files_path_updated = false; if (isset($settings['updraftplus_version']) && $updraftplus->version == $settings['updraftplus_version']) { $return_array = array('saved' => true); $add_to_post_keys = array('updraft_interval', 'updraft_interval_database', 'updraft_interval_increments', 'updraft_starttime_files', 'updraft_starttime_db', 'updraft_startday_files', 'updraft_startday_db'); // If database and files are on same schedule, override the db day/time settings if (isset($settings['updraft_interval_database']) && isset($settings['updraft_interval_database']) && $settings['updraft_interval_database'] == $settings['updraft_interval'] && isset($settings['updraft_starttime_files'])) { $settings['updraft_starttime_db'] = $settings['updraft_starttime_files']; $settings['updraft_startday_db'] = $settings['updraft_startday_files']; } foreach ($add_to_post_keys as $key) { // For add-ons that look at $_POST to find saved settings, add the relevant keys to $_POST so that they find them there if (isset($settings[$key])) { $_POST[$key] = $settings[$key]; } } // Check if updraft_include_more_path is set, if it is then we need to update the page, if it's not set but there's content already in the database that is cleared down below so again we should update the page. $more_files_path_updated = false; // i.e. If an option has been set, or if it was currently active in the settings if (isset($settings['updraft_include_more_path']) \|\| UpdraftPlus_Options::get_updraft_option('updraft_include_more_path')) { $more_files_path_updated = true; } // Wipe the extra retention rules, as they are not saved correctly if the last one is deleted UpdraftPlus_Options::update_updraft_option('updraft_retain_extrarules', array()); UpdraftPlus_Options::update_updraft_option('updraft_email', array()); UpdraftPlus_Options::update_updraft_option('updraft_report_warningsonly', array()); UpdraftPlus_Options::update_updraft_option('updraft_report_wholebackup', array()); UpdraftPlus_Options::update_updraft_option('updraft_extradbs', array()); UpdraftPlus_Options::update_updraft_option('updraft_include_more_path', array()); $relevant_keys = $updraftplus->get_settings_keys(); if (isset($settings['updraft_auto_updates']) && in_array('updraft_auto_updates', $relevant_keys)) { $updraftplus->set_automatic_updates($settings['updraft_auto_updates']); unset($settings['updraft_auto_updates']); // unset the key and its value to prevent being processed the second time } if (method_exists('UpdraftPlus_Options', 'mass_options_update')) { $original_settings = $settings; $settings = UpdraftPlus_Options::mass_options_update($settings); $mass_updated = true; } foreach ($settings as $key => $value) { if (in_array($key, $relevant_keys)) { if ('updraft_service' == $key && is_array($value)) { foreach ($value as $subkey => $subvalue) { if ('0' == $subvalue) unset($value[$subkey]); } } // This flag indicates that either the stored database option was changed, or that the supplied option was changed before being stored. It isn't comprehensive - it's only used to update some UI elements with invalid input. $updated = empty($mass_updated) ? (is_string($value) && UpdraftPlus_Options::get_updraft_option($key) != $value) : (is_string($value) && (!isset($original_settings[$key]) \|\| $original_settings[$key] != $value)); if (empty($mass_updated)) UpdraftPlus_Options::update_updraft_option($key, $value); // Add information on what has changed to array to loop through to update links etc. // Restricting to strings for now, to prevent any unintended leakage (since this is just used for UI updating) if ($updated) { $value = UpdraftPlus_Options::get_updraft_option($key); if (is_string($value)) $return_array['changed'][$key] = $value; } // @codingStandardsIgnoreLine } else { // This section is ignored by CI otherwise it will complain the ELSE is empty. // When last active, it was catching: option_page, action, _wpnonce, _wp_http_referer, updraft_s3_endpoint, updraft_dreamobjects_endpoint. The latter two are empty; probably don't need to be in the page at all. // error_log("Non-UD key when saving from POSTed data: ".$key); } } } else { $return_array = array('saved' => false, 'error_message' => sprintf(__('UpdraftPlus seems to have been updated to version (%s), which is different to the version running when this settings page was loaded.', 'updraftplus'), $updraftplus->version).' '.__('Please reload the settings page before trying to save settings.', 'updraftplus')); } // Checking for various possible messages $updraft_dir = $updraftplus->backups_dir_location(false); $really_is_writable = UpdraftPlus_Filesystem_Functions::really_is_writable($updraft_dir); $dir_info = $this->really_writable_message($really_is_writable, $updraft_dir); $button_title = esc_attr(__('This button is disabled because your backup directory is not writable (see the settings).', 'updraftplus')); $return_array['backup_now_message'] = $this->backup_now_remote_message(); $return_array['backup_dir'] = array('writable' => $really_is_writable, 'message' => $dir_info, 'button_title' => $button_title); // Check if $more_files_path_updated is true, is so then there's a change and we should update the backup modal if ($more_files_path_updated) { $return_array['updraft_include_more_path'] = $this->files_selector_widgetry('backupnow_files_', false, 'sometimes'); } // Because of the single AJAX call, we need to remove the existing UD messages from the 'all_admin_notices' action remove_all_actions('all_admin_notices'); // Moving from 2 to 1 ajax call ob_start(); $service = UpdraftPlus_Options::get_updraft_option('updraft_service'); $this->setup_all_admin_notices_global($service); $this->setup_all_admin_notices_udonly($service); do_action('all_admin_notices'); if (!$really_is_writable) { // Check if writable $this->show_admin_warning_unwritable(); } if ($return_array['saved']) { // $this->show_admin_warning(__('Your settings have been saved.', 'updraftplus'), 'updated fade'); } else { if (isset($return_array['error_message'])) { $this->show_admin_warning($return_array['error_message'], 'error'); } else { $this->show_admin_warning(__('Your settings failed to save.', 'updraftplus').' '.__('Please refresh the settings page and try again', 'updraftplus'), 'error'); } } $messages_output = ob_get_contents(); ob_clean(); // Backup schedule output $this->next_scheduled_backups_output('line'); $scheduled_output = ob_get_clean(); $return_array['messages'] = $messages_output; $return_array['scheduled'] = $scheduled_output; $return_array['files_scheduled'] = $this->next_scheduled_files_backups_output(true); $return_array['database_scheduled'] = $this->next_scheduled_database_backups_output(true); // Add the updated options to the return message, so we can update on screen return $return_array; } /* * Authenticate remote storage instance * * @param array - $data It consists of below key elements: * $remote_method - Remote storage service * $instance_id - Remote storage instance id * @return array An array response containing the status of the authentication / public function auth_remote_method($data) { global $updraftplus; $response = array(); if (isset($data['remote_method']) && isset($data['instance_id'])) { $response['result'] = 'success'; $remote_method = $data['remote_method']; $instance_id = $data['instance_id']; $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array($remote_method)); try { $storage_objects_and_ids[$remote_method]['object']->authenticate_storage($instance_id); } catch (Exception $e) { $response['result'] = 'error'; $response['message'] = $updraftplus->backup_methods[$remote_method] . ' ' . __('authentication error', 'updraftplus') . ' ' . $e->getMessage(); } } else { $response['result'] = 'error'; $response['message'] = __('Remote storage method and instance id are required for authentication.', 'updraftplus'); } return $response; } /* * Deauthenticate remote storage instance * * @param array - $data It consists of below key elements: * $remote_method - Remote storage service * $instance_id - Remote storage instance id * @return array An array response containing the status of the deauthentication / public function deauth_remote_method($data) { global $updraftplus; $response = array(); if (isset($data['remote_method']) && isset($data['instance_id'])) { $response['result'] = 'success'; $remote_method = $data['remote_method']; $instance_id = $data['instance_id']; $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array($remote_method)); try { $storage_objects_and_ids[$remote_method]['object']->deauthenticate_storage($instance_id); } catch (Exception $e) { $response['result'] = 'error'; $response['message'] = $updraftplus->backup_methods[$remote_method] . ' deauthentication error ' . $e->getMessage(); } } else { $response['result'] = 'error'; $response['message'] = 'Remote storage method and instance id are required for deauthentication.'; } return $response; } /* * A method to remove UpdraftPlus settings from the options table. * * @param boolean $wipe_all_settings Set to true as default as we want to remove all options, set to false if calling from UpdraftCentral, as we do not want to remove the UpdraftCentral key or we will lose connection to the site. * @return boolean / public function wipe_settings($wipe_all_settings = true) { global $updraftplus; $settings = $updraftplus->get_settings_keys(); // if this is false the UDC has called it we don't want to remove the UDC key other wise we will lose connection to the remote site. if (false == $wipe_all_settings) { $key = array_search('updraft_central_localkeys', $settings); unset($settings[$key]); } foreach ($settings as $s) UpdraftPlus_Options::delete_updraft_option($s); if (is_multisite()) $updraftplus->wipe_state_data(true, 'sitemeta'); $updraftplus->wipe_state_data(true); $site_options = array('updraft_oneshotnonce'); foreach ($site_options as $s) delete_site_option($s); $updraftplus->schedule_backup('manual'); $updraftplus->schedule_backup_database('manual'); $this->show_admin_warning(__("Your settings have been wiped.", 'updraftplus')); return true; } /* * This get the details for updraft vault and to be used globally * * @param string $instance_id - the instance_id of the current instance being used * @return object - the UpdraftVault option setup to use the passed in instance id or if one wasn't passed then use the default set of options / public function get_updraftvault($instance_id = '') { $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array('updraftvault')); if (isset($storage_objects_and_ids['updraftvault']['instance_settings'][$instance_id])) { $opts = $storage_objects_and_ids['updraftvault']['instance_settings'][$instance_id]; $vault = $storage_objects_and_ids['updraftvault']['object']; $vault->set_options($opts, false, $instance_id); } else { updraft_try_include_file('methods/updraftvault.php', 'include_once'); $vault = new UpdraftPlus_BackupModule_updraftvault(); } return $vault; } /* * http_get will allow the HTTP Fetch execute available in advanced tools * * @param String $uri Specific URL passed to curl * @param Boolean $curl True or False if cURL is to be used * @return String - JSON encoded results / public function http_get($uri = null, $curl = false) { if (!preg_match('/^https?/', $uri)) return json_encode(array('e' => 'Non-http URL specified')); if ($curl) { if (!function_exists('curl_exec')) { return json_encode(array('e' => 'No Curl installed')); die; } $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $uri); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_FAILONERROR, true); curl_setopt($ch, CURLOPT_HEADER, false); curl_setopt($ch, CURLOPT_VERBOSE, true); curl_setopt($ch, CURLOPT_STDERR, $output = fopen('php://temp', "w+")); $response = curl_exec($ch); $error = curl_error($ch); $getinfo = curl_getinfo($ch); curl_close($ch); rewind($output); $verb = stream_get_contents($output); $resp = array(); if (false === $response) { $resp['e'] = htmlspecialchars($error); } $resp['r'] = (empty($response)) ? '' : htmlspecialchars(substr($response, 0, 2048)); if (!empty($verb)) $resp['r'] = htmlspecialchars($verb)."\n\n".$resp['r']; // Extra info returned for Central $resp['verb'] = $verb; $resp['response'] = $response; $resp['status'] = $getinfo; return json_encode($resp); } else { $response = wp_remote_get($uri, array('timeout' => 10)); if (is_wp_error($response)) { return json_encode(array('e' => htmlspecialchars($response->get_error_message()))); } return json_encode( array( 'r' => wp_remote_retrieve_response_code($response).': '.htmlspecialchars(substr(wp_remote_retrieve_body($response), 0, 2048)), 'code' => wp_remote_retrieve_response_code($response), 'html_response' => htmlspecialchars(substr(wp_remote_retrieve_body($response), 0, 2048)), 'response' => $response ) ); } } /* * This will return all the details for raw backup and file list, in HTML format * * @param Boolean $no_pre_tags - if set, then <pre></pre> tags will be removed from the output * * @return String / public function show_raw_backups($no_pre_tags = false) { global $updraftplus; $response = array(); $response['html'] = '<h3 id="ud-debuginfo-rawbackups">'.__('Known backups (raw)', 'updraftplus').'</h3><pre>'; ob_start(); $history = UpdraftPlus_Backup_History::get_history(); var_dump($history); $response["html"] .= ob_get_clean(); $response['html'] .= '</pre>'; $response['html'] .= '<h3 id="ud-debuginfo-files">'.__('Files', 'updraftplus').'</h3><pre>'; $updraft_dir = $updraftplus->backups_dir_location(); $raw_output = array(); $d = dir($updraft_dir); while (false !== ($entry = $d->read())) { $fp = $updraft_dir.'/'.$entry; $mtime = filemtime($fp); if (is_dir($fp)) { $size = ' d'; } elseif (is_link($fp)) { $size = ' l'; } elseif (is_file($fp)) { $size = sprintf("%8.1f", round(filesize($fp)/1024, 1)).' '.gmdate('r', $mtime); } else { $size = ' ?'; } if (preg_match('/^log\.(.)\.txt$/', $entry, $lmatch)) $entry = '<a target="_top" href="?action=downloadlog&page=updraftplus&updraftplus_backup_nonce='.htmlspecialchars($lmatch[1]).'">'.$entry.'</a>'; $raw_output[$mtime] = empty($raw_output[$mtime]) ? sprintf("%s %s\n", $size, $entry) : $raw_output[$mtime].sprintf("%s %s\n", $size, $entry); } @$d->close();// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. krsort($raw_output, SORT_NUMERIC); foreach ($raw_output as $line) { $response['html'] .= $line; } $response['html'] .= '</pre>'; $response['html'] .= '<h3 id="ud-debuginfo-options">'.__('Options (raw)', 'updraftplus').'</h3>'; $opts = $updraftplus->get_settings_keys(); asort($opts); // <tr><th>'.__('Key', 'updraftplus').'</th><th>'.__('Value', 'updraftplus').'</th></tr> $response['html'] .= '<table><thead></thead><tbody>'; foreach ($opts as $opt) { $response['html'] .= '<tr><td>'.htmlspecialchars($opt).'</td><td>'.htmlspecialchars(print_r(UpdraftPlus_Options::get_updraft_option($opt), true)).'</td>'; } // Get the option saved by yahnis-elsts/plugin-update-checker $response['html'] .= '<tr><td>external_updates-updraftplus</td><td><pre>'.htmlspecialchars(print_r(get_site_option('external_updates-updraftplus'), true)).'</pre></td>'; $response['html'] .= '</tbody></table>'; ob_start(); do_action('updraftplus_showrawinfo'); $response['html'] .= ob_get_clean(); if (true == $no_pre_tags) { $response['html'] = str_replace('<pre>', '', $response['html']); $response['html'] = str_replace('</pre>', '', $response['html']); } return $response; } /** * This will call any wp_action * * @param Array\|Null $data The array of data with the values for wpaction * @param Callable\|Boolean $close_connection_callable A callable to call to close the browser connection, or true for a default suitable for internal use, or false for none * @return Array - results / public function call_wp_action($data = null, $close_connection_callable = false) { global $updraftplus; ob_start(); $res = '<em>Request received: </em>'; if (preg_match('/^([^:]+)+:(.)$/', $data['wpaction'], $matches)) { $action = $matches[1]; if (null === ($args = json_decode($matches[2], true))) { $res .= "The parameters (should be JSON) could not be decoded"; $action = false; } else { if (is_string($args)) $args = array($args); $res .= "Will despatch action: ".htmlspecialchars($action).", parameters: ".htmlspecialchars(implode(',', $args)); } } else { $action = $data['wpaction']; $res .= "Will despatch action: ".htmlspecialchars($action).", no parameters"; } ob_get_clean(); // Need to add this as the close browser should only work for UDP if ($close_connection_callable) { if (is_callable($close_connection_callable)) { call_user_func($close_connection_callable, array('r' => $res)); } else { $updraftplus->close_browser_connection(json_encode(array('r' => $res))); } } if (!empty($action)) { if (!empty($args)) { ob_start(); $returned = do_action_ref_array($action, $args); $output = ob_get_clean(); $res .= " - do_action_ref_array Trigger "; } else { ob_start(); do_action($action); $output = ob_get_contents(); ob_end_clean(); $res .= " - do_action Trigger "; } } $response = array(); $response['response'] = $res; $response['log'] = $output; // Check if response is empty if (!empty($returned)) $response['status'] = $returned; return $response; } /** * Enqueue JSTree JavaScript and CSS, taking into account whether it is already enqueued, and current debug settings / public function enqueue_jstree() { global $updraftplus; static $already_enqueued = false; if ($already_enqueued) return; $already_enqueued = true; $jstree_enqueue_version = $updraftplus->use_unminified_scripts() ? '3.3.12-rc.0'.'.'.time() : '3.3.12-rc.0'; $min_or_not = $updraftplus->use_unminified_scripts() ? '' : '.min'; wp_enqueue_script('jstree', UPDRAFTPLUS_URL.'/includes/jstree/jstree'.$min_or_not.'.js', array('jquery'), $jstree_enqueue_version); wp_enqueue_style('jstree', UPDRAFTPLUS_URL.'/includes/jstree/themes/default/style'.$min_or_not.'.css', array(), $jstree_enqueue_version); } /* * Detects byte-order mark at the start of common files and change waning message texts * * @return string\|boolean BOM warning text or false if not bom characters detected / public function get_bom_warning_text() { $files_to_check = array( ABSPATH.'wp-config.php', get_template_directory().DIRECTORY_SEPARATOR.'functions.php', ); if (is_child_theme()) { $files_to_check[] = get_stylesheet_directory().DIRECTORY_SEPARATOR.'functions.php'; } $corrupted_files = array(); foreach ($files_to_check as $file) { if (!file_exists($file)) continue; if (false === ($fp = fopen($file, 'r'))) continue; if (false === ($file_data = fread($fp, 8192))); fclose($fp); $substr_file_data = array(); for ($substr_length = 2; $substr_length <= 5; $substr_length++) { $substr_file_data[$substr_length] = substr($file_data, 0, $substr_length); } // Detect UTF-7, UTF-8, UTF-16 (BE), UTF-16 (LE), UTF-32 (BE) & UTF-32 (LE) Byte order marks (BOM) $bom_decimal_representations = array( array(43, 47, 118, 56), // UTF-7 (Hexadecimal: 2B 2F 76 38) array(43, 47, 118, 57), // UTF-7 (Hexadecimal: 2B 2F 76 39) array(43, 47, 118, 43), // UTF-7 (Hexadecimal: 2B 2F 76 2B) array(43, 47, 118, 47), // UTF-7 (Hexadecimal: 2B 2F 76 2F) array(43, 47, 118, 56, 45), // UTF-7 (Hexadecimal: 2B 2F 76 38 2D) array(239, 187, 191), // UTF-8 (Hexadecimal: 2B 2F 76 38 2D) array(254, 255), // UTF-16 (BE) (Hexadecimal: FE FF) array(255, 254), // UTF-16 (LE) (Hexadecimal: FF FE) array(0, 0, 254, 255), // UTF-32 (BE) (Hexadecimal: 00 00 FE FF) array(255, 254, 0, 0), // UTF-32 (LE) (Hexadecimal: FF FE 00 00) ); foreach ($bom_decimal_representations as $bom_decimal_representation) { $no_of_chars = count($bom_decimal_representation); array_unshift($bom_decimal_representation, 'C'); $binary = call_user_func_array('pack', $bom_decimal_representation); if ($binary == $substr_file_data[$no_of_chars]) { $corrupted_files[] = $file; break; } } } if (empty($corrupted_files)) { return false; } else { $corrupted_files_count = count($corrupted_files); return '<strong>'.__('Warning', 'updraftplus').':</strong> '.sprintf(_n('The file %s has a "byte order mark" (BOM) at its beginning.', 'The files %s have a "byte order mark" (BOM) at their beginning.', $corrupted_files_count, 'updraftplus'), '<strong>'.implode('</strong>, <strong>', $corrupted_files).'</strong>').' <a href="'.apply_filters('updraftplus_com_link', "https://teamupdraft.com/documentation/updraftplus/topics/general/troubleshooting/problems-with-extra-white-space/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=unknown&utm_creative_format=unknown").'" target="_blank">'.__('Follow this link for more information', 'updraftplus').'</a>'; } } /** * Gets an instance of the "UpdraftPlus_UpdraftCentral_Cloud" class which will be * used to login or register the user to the UpdraftCentral cloud * * @return object / public function get_updraftcentral_cloud() { if (!class_exists('UpdraftPlus_UpdraftCentral_Cloud')) updraft_try_include_file('includes/updraftcentral.php', 'include_once'); return new UpdraftPlus_UpdraftCentral_Cloud(); } /* * This function will build and return the UpdraftPlus temporary clone ui widget * * @param boolean $include_testing_ui - a boolean to indicate if testing-only UI elements should be shown (N.B. they can only work if the user also has testing permissions) * @param array $supported_wp_versions - an array of supported WordPress versions * @param array $supported_packages - an array of supported clone packages * @param array $supported_regions - an array of supported clone regions * @param string $nearest_region - the user's nearest region * @param array $supported_packages_label - an array of supported clone packages label * * @return string - the clone UI widget / public function updraftplus_clone_ui_widget($include_testing_ui, $supported_wp_versions, $supported_packages, $supported_regions, $nearest_region = '', $supported_packages_label = array()) { global $updraftplus; $output = '<p class="updraftplus-option updraftplus-option-inline php-version">'; $output .= '<span class="updraftplus-option-label">'.sprintf(__('%s version:', 'updraftplus'), 'PHP').'</span> '; $output .= $this->output_select_data($this->clone_php_versions, 'php'); $output .= '</p>'; $output .= '<p class="updraftplus-option updraftplus-option-inline wp-version">'; $output .= ' <span class="updraftplus-option-label">'.sprintf(__('%s version:', 'updraftplus'), 'WordPress').'</span> '; $output .= $this->output_select_data($this->get_wordpress_versions($supported_wp_versions), 'wp'); $output .= '</p>'; $output .= '<p class="updraftplus-option updraftplus-option-inline region">'; $output .= ' <span class="updraftplus-option-label">'.__('Clone region:', 'updraftplus').'</span> '; $output .= $this->output_select_data($supported_regions, 'region', $nearest_region); $output .= '</p>'; $backup_history = UpdraftPlus_Backup_History::get_history(); foreach ($backup_history as $key => $backup) { $backup_complete = $this->check_backup_is_complete($backup, false, true, false); $remote_sent = !empty($backup['service']) && ((is_array($backup['service']) && in_array('remotesend', $backup['service'])) \|\| 'remotesend' === $backup['service']); if (!$backup_complete \|\| $remote_sent) unset($backup_history[$key]); } $output .= '<p class="updraftplus-option updraftplus-option-inline updraftclone-backup">'; $output .= ' <span class="updraftplus-option-label">'.__('Clone:', 'updraftplus').'</span> '; $output .= '<select id="updraftplus_clone_backup_options" name="updraftplus_clone_backup_options">'; $output .= '<option value="current" data-nonce="current" data-timestamp="current" selected="selected">'. __('This current site', 'updraftplus') .'</option>'; $output .= '<option value="wp_only" data-nonce="wp_only" data-timestamp="wp_only">'. __('An empty WordPress install', 'updraftplus') .'</option>'; if (!empty($backup_history)) { foreach ($backup_history as $key => $backup) { $total_size = round($updraftplus->get_total_backup_size($backup) / 1073741824, 1); $pretty_date = get_date_from_gmt(gmdate('Y-m-d H:i:s', (int) $key), 'M d, Y G:i'); $label = isset($backup['label']) ? ' ' . $backup['label'] : ''; $output .= '<option value="'.$key. '" data-nonce="'.$backup['nonce'].'" data-timestamp="'.$key.'" data-size="'.$total_size.'">' . $pretty_date . $label . '</option>'; } } $output .= '</select>'; $output .= '</p>'; $output .= '<p class="updraftplus-option updraftplus-option-inline package">'; $output .= ' <span class="updraftplus-option-label">'.__('Clone package', 'updraftplus').' (<a href="'.$updraftplus->get_url('clone_packages').'" target="_blank">'.__('more info', 'updraftplus').'</a>):</span> '; $output .= '<select id="updraftplus_clone_package_options" name="updraftplus_clone_package_options" data-package_version="starter">'; foreach ($supported_packages as $key => $value) { $output .= '<option value="'.esc_attr($key).'" data-size="'.esc_attr($value).'"'; if ('starter' == $key) $output .= 'selected="selected"'; $label = isset($supported_packages_label[$key]) ? $supported_packages_label[$key] : $key; $output .= ">".esc_html($label).('starter' == $key ? ' ' . __('(current version)', 'updraftplus') : '')."</option>\n"; } $output .= '</select>'; $output .= '</p>'; if ((defined('UPDRAFTPLUS_UPDRAFTCLONE_DEVELOPMENT') && UPDRAFTPLUS_UPDRAFTCLONE_DEVELOPMENT) \|\| $include_testing_ui) { $output .= '<p class="updraftplus-option updraftplus-option-inline updraftclone-branch">'; $output .= ' <span class="updraftplus-option-label">UpdraftClone Branch:</span> '; $output .= '<input id="updraftplus_clone_updraftclone_branch" type="text" size="36" name="updraftplus_clone_updraftclone_branch" value="">'; $output .= '</p>'; $output .= '<p class="updraftplus-option updraftplus-option-inline updraftplus-branch">'; $output .= ' <span class="updraftplus-option-label">UpdraftPlus Branch:</span> '; $output .= '<input id="updraftplus_clone_updraftplus_branch" type="text" size="36" name="updraftplus_clone_updraftplus_branch" value="">'; $output .= '</p>'; $output .= '<p><input type="checkbox" id="updraftplus_clone_use_queue" name="updraftplus_clone_use_queue" value="1" checked="checked"><label for="updraftplus_clone_use_queue" class="updraftplus_clone_use_queue">Use the UpdraftClone queue</label></p>'; } $output .= '<p class="updraftplus-option limit-to-admins">'; $output .= '<input type="checkbox" class="updraftplus_clone_admin_login_options" id="updraftplus_clone_admin_login_options" name="updraftplus_clone_admin_login_options" value="1" checked="checked">'; $output .= '<label for="updraftplus_clone_admin_login_options" class="updraftplus_clone_admin_login_options_label">'.__('Forbid non-administrators to login to WordPress on your clone', 'updraftplus').'</label>'; $output .= '</p>'; $output = apply_filters('updraftplus_clone_additional_ui', $output); return $output; } /* * This function will output a select input using the passed in values. * * @param array $data - the keys and values for the select * @param string $name - the name of the items in the select input * @param string $selected - the value we want selected by default * * @return string - the output of the select input / public function output_select_data($data, $name, $selected = '') { $name_version = empty($selected) ? $this->get_current_version($name) : $selected; $output = '<select id="updraftplus_clone_'.$name.'_options" name="updraftplus_clone_'.$name.'_options" data-'.$name.'_version="'.$name_version.'">'; foreach ($data as $value) { $output .= "<option value=\"$value\" "; if ($value == $name_version) $output .= 'selected="selected"'; $output .= ">".htmlspecialchars($value) . ($value == $name_version && 'region' != $name ? ' ' . __('(current version)', 'updraftplus') : '')."</option>\n"; } $output .= '</select>'; return $output; } /* * This function will output the clones network information * * @param string $url - the clone URL * * @return string - the clone network information / public function updraftplus_clone_info($url) { global $updraftplus; if (!empty($url)) { $content = '<div class="updraftclone_network_info">'; $content .= '<p>' . __('Your clone has started and will be available at the following URLs once it is ready.', 'updraftplus') . '</p>'; $content .= '<p><strong>' . __('Front page:', 'updraftplus') . '</strong> <a target="_blank" href="' . esc_html($url) . '">' . esc_html($url) . '</a></p>'; $content .= '<p><strong>' . __('Dashboard:', 'updraftplus') . '</strong> <a target="_blank" href="' . esc_html(trailingslashit($url)) . 'wp-admin">' . esc_html(trailingslashit($url)) . 'wp-admin</a></p>'; $content .= '</div>'; $content .= '<p><a target="_blank" href="'.$updraftplus->get_url('my-account').'">'.__('You can find your temporary clone information in your updraftplus.com account here.', 'updraftplus').'</a></p>'; } else { $content = '<p>' . __('Your clone has started, network information is not yet available but will be displayed here and at your teamupdraft.com account once it is ready.', 'updraftplus') . '</p>'; $content .= '<p><a target="_blank" href="' . $updraftplus->get_url('my-account') . '">' . __('You can find your temporary clone information in your updraftplus.com account here.', 'updraftplus') . '</a></p>'; } return $content; } /* * This function will build and return an array of major WordPress versions, the array is built by calling the WordPress version API once every 24 hours and adding any new entries to our existing array of versions. * * @param array $supported_wp_versions - an array of supported WordPress versions * * @return array - an array of WordPress major versions / private function get_wordpress_versions($supported_wp_versions) { if (empty($supported_wp_versions)) $supported_wp_versions[] = $this->get_current_version('wp'); $key = array_search($this->get_current_version('wp'), $supported_wp_versions); if ($key) { $supported_wp_versions = array_slice($supported_wp_versions, $key); } $version_array = $supported_wp_versions; return $version_array; } /* * This function will get the current version the server is running for the passed in item e.g WordPress or PHP * * @param string $name - the thing we want to get the version for e.g WordPress or PHP * * @return string - returns the current version of the passed in item / public function get_current_version($name) { $version = ''; if ('php' == $name) { $parts = explode(".", PHP_VERSION); $version = $parts[0] . "." . $parts[1]; } elseif ('wp' == $name) { global $updraftplus; $wp_version = $updraftplus->get_wordpress_version(); $parts = explode(".", $wp_version); $version = $parts[0] . "." . $parts[1]; } return $version; } /* * Show which remote storage settings are partially setup error, or if manual auth is supported show the manual auth UI / public function show_admin_warning_if_remote_storage_with_partial_settings() { if ((isset($_REQUEST['page']) && 'updraftplus' == $_REQUEST['page']) \|\| (defined('DOING_AJAX') && DOING_AJAX)) { $enabled_services = UpdraftPlus_Storage_Methods_Interface::get_enabled_storage_objects_and_ids(array_keys($this->storage_service_with_partial_settings)); foreach ($this->storage_service_with_partial_settings as $method => $method_name) { if (empty($enabled_services[$method]['object']) \|\| empty($enabled_services[$method]['instance_settings']) \|\| !$enabled_services[$method]['object']->supports_feature('manual_authentication')) { $this->show_admin_warning(sprintf(__('The following remote storage (%s) have only been partially configured, manual authorization is not supported with this remote storage, please try again and if the problem persists contact support.', 'updraftplus'), $method), 'error'); } else { $this->show_admin_warning($enabled_services[$method]['object']->get_manual_authorisation_template(), 'error'); } } } else { $this->show_admin_warning('UpdraftPlus: '.sprintf(__('The following remote storage (%s) have only been partially configured, if you are having problems you can try to manually authorise at the UpdraftPlus settings page.', 'updraftplus'), implode(', ', $this->storage_service_with_partial_settings)).' <a href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus&tab=settings">'.__('Return to UpdraftPlus configuration', 'updraftplus').'</a>', 'error'); } } /* * Show remote storage settings are empty warning / public function show_admin_warning_if_remote_storage_setting_are_empty() { if ((isset($_REQUEST['page']) && 'updraftplus' == $_REQUEST['page']) \|\| (defined('DOING_AJAX') && DOING_AJAX)) { $this->show_admin_warning(sprintf(__('You have requested saving to remote storage (%s), but without entering any settings for that storage.', 'updraftplus'), implode(', ', $this->storage_service_without_settings)), 'error'); } else { $this->show_admin_warning('UpdraftPlus: '.sprintf(__('You have requested saving to remote storage (%s), but without entering any settings for that storage.', 'updraftplus'), implode(', ', $this->storage_service_without_settings)).' <a href="'.UpdraftPlus_Options::admin_page_url().'?page=updraftplus&tab=settings">'.__('Return to UpdraftPlus configuration', 'updraftplus').'</a>', 'error'); } } /* * Show remote storage warning when one or more cloud storage options are selected but the add-ons are not installed / public function show_admin_warning_if_remote_storage_without_addons() { global $updraftplus; $storage_service_without_addons = implode(', ', $this->storage_service_without_addons_settings); $notice_label1 = sprintf(__('You have selected storage options which are not part of your version of %s.', 'updraftplus'), 'UpdraftPlus'); $notice_label2 = sprintf(__('To backup to %s, please upgrade to %s.', 'updraftplus'), $storage_service_without_addons, '<a target="_blank" href="'.esc_url($updraftplus->get_url('premium')).'">UpdraftPlus Premium</a>'); $notice_label3 = sprintf(__('Where are my %s backups stored?', 'updraftplus'), 'UpdraftPlus'); $notice_label4 = '<a href="'.esc_url(UpdraftPlus_Options::admin_page_url()).'?page=updraftplus&tab=settings">'.sprintf(__('Return to %s configuration', 'updraftplus'), 'UpdraftPlus').'</a>'; $notice_label5 = sprintf(__('To see which remote storage locations are included in free and premium, please see here: %s', 'updraftplus'), '<a target="_blank" href="'.esc_url('https://updraftplus.com/freevspremium/').'">'.$notice_label3.'</a>'); if ((isset($_REQUEST['page']) && 'updraftplus' == $_REQUEST['page']) \|\| (defined('DOING_AJAX') && DOING_AJAX)) { $this->show_admin_warning($notice_label1.' '.$notice_label2.' '.$notice_label5, 'error'); } else { $this->show_admin_warning('UpdraftPlus: '.$notice_label1.' '.$notice_label2.' '.$notice_label5.' '.$notice_label4, 'error'); } } /* * Receive Heartbeat data and respond. * * Processes data received via a Heartbeat request, and returns additional data to pass back to the front end. * * @param array $response - Heartbeat response data to pass back to front end. * @param array $data - Data received from the front end (unslashed). / public function process_status_in_heartbeat($response, $data) { if (!UpdraftPlus_Options::user_can_manage() \|\| !is_array($response) \|\| empty($data['updraftplus'])) return $response; try { $response['updraftplus'] = $this->get_activejobs_list(UpdraftPlus_Manipulation_Functions::wp_unslash($data['updraftplus'])); } catch (Exception $e) { $log_message = 'PHP Fatal Exception error ('.get_class($e).') has occurred during get active job list. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); $response['updraftplus'] = array( 'fatal_error' => true, 'fatal_error_message' => $log_message ); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during get active job list. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); $response['updraftplus'] = array( 'fatal_error' => true, 'fatal_error_message' => $log_message ); } if (isset($data['updraftplus']['updraft_credentialtest_nonce'])) { if (!wp_verify_nonce($data['updraftplus']['updraft_credentialtest_nonce'], 'updraftplus-credentialtest-nonce')) { $response['updraftplus']['updraft_credentialtest_nonce'] = wp_create_nonce('updraftplus-credentialtest-nonce'); } } $response['updraftplus']['time_now'] = get_date_from_gmt(gmdate('Y-m-d H:i:s'), 'D, F j, Y H:i'); return $response; } /* * Show warning about restriction implied by the hosting company (can only perform a full backup once per month, incremental backup should not go above one per day) / public function show_admin_warning_one_backup_per_month() { global $updraftplus; $hosting_company = $updraftplus->get_hosting_info(); $txt1 = sprintf(__('Your website is hosted with %s (%s).', 'updraftplus'), $hosting_company['name'], $hosting_company['website']); $txt2 = sprintf(__('%s permits UpdraftPlus to perform only one backup per month.', 'updraftplus'), $hosting_company['name']).' '.__('Thus, we recommend you choose a full backup when performing a manual backup and to use that option when creating a scheduled backup.', 'updraftplus'); $txt3 = __('Due to the restriction, some settings can be automatically adjusted, disabled or not available.', 'updraftplus'); $this->show_plugin_page_admin_warning('<strong>'.__('Warning', 'updraftplus').':</strong> '.$txt1.' '.$txt2.' '.$txt3, 'update-nag notice notice-warning', true); } /* * Find out if the current request is a backup download request, and proceed with the download if it is / public function maybe_download_backup_from_email() { global $pagenow; if (UpdraftPlus_Options::user_can_manage() && (!defined('DOING_AJAX') \|\| !DOING_AJAX) && UpdraftPlus_Options::admin_page() === $pagenow && isset($_REQUEST['page']) && 'updraftplus' === $_REQUEST['page'] && isset($_REQUEST['action']) && 'updraft_download_backup' === $_REQUEST['action']) { $findexes = empty($_REQUEST['findex']) ? array(0) : $_REQUEST['findex']; $timestamp = empty($_REQUEST['timestamp']) ? '' : $_REQUEST['timestamp']; $nonce = empty($_REQUEST['nonce']) ? '' : $_REQUEST['nonce']; $type = empty($_REQUEST['type']) ? '' : $_REQUEST['type']; if (empty($timestamp) \|\| empty($nonce) \|\| empty($type)) wp_die(esc_html__('The download link is broken, you may have clicked the link from untrusted source', 'updraftplus'), '', array('back_link' => true)); $backup_history = UpdraftPlus_Backup_History::get_history(); if (!isset($backup_history[$timestamp]['nonce']) \|\| $backup_history[$timestamp]['nonce'] !== $nonce) wp_die(esc_html__("The download link is broken or the backup file is no longer available", 'updraftplus'), '', array('back_link' => true)); $this->do_updraft_download_backup($findexes, $type, $timestamp, 2, false, ''); exit; // we don't need anything else but an exit } } /* * Print the phpseclib-notice-related scripts / public function print_phpseclib_notice_scripts() { static $printed = false; if ($printed) return; $printed = true; ?> <script> jQuery(function($) { $('div.ud-phpseclib-notice').on('click', 'button.notice-dismiss', function (event) { event.stopImmediatePropagation(); $.ajax(ajaxurl, { type: 'POST', data: { action: 'updraft_ajax', subaction: 'dismiss_phpseclib_notice', nonce: '<?php echo esc_js(wp_create_nonce('updraftplus-credentialtest-nonce')); ?>', }, error: function(xhr, status, error_code) { alert(error_code+':'+status); } }); }); }); </script> <?php } /* * Allow HTML input elements on the unfinished restoration dialog ensuring the HTML form element doesn't get stripped during the call of wp_kses_post * * @param Array $allowed_html Allowed HTML elements * @return Array The filtered allowed HTML elements / public function kses_allow_input_tags_on_unfinished_restoration_dialog($allowed_html) { if (!isset($allowed_html['input'])) $allowed_html['input'] = array(); $allowed_html['input']['type'] = true; $allowed_html['input']['name'] = true; $allowed_html['input']['value'] = true; $allowed_html['input']['id'] = true; return $allowed_html; } /* * Adds the 'display' property to the list of allowed CSS styles for wp_kses. * * This function is typically used with the `safe_style_css` filter to ensure * that the `display` property is not stripped when sanitizing inline styles * using wp_kses or related functions. * * @param array $css The array of currently allowed CSS properties. * @return array The modified array of allowed CSS properties including 'display'. / public function kses_allow_style_display($css) { $css[] = 'display'; return $css; } /* * Returns an array of allowed HTML tags and their attributes for sanitization purposes. * * This function defines a set of HTML tags and attributes that are considered safe * and can be used in specific contexts. The attributes are defined for each tag * to ensure only the intended attributes are allowed. * * @return array<string, array<string, bool>> An associative array where the keys are HTML tag names * and the values are arrays of allowed attributes for * each tag. The attribute arrays use attribute names * as keys and `true` as the value to indicate the attribute * is allowed. / public function kses_allow_tags() { return array( 'div' => array( 'id' => true, 'class' => true, 'style' => true, ), 'h3' => array( 'style' => true, ), 'input' => array( 'id' => true, 'class' => true, 'type' => true, 'name' => true, 'value' => true, 'checked' => true, 'style' => true, 'min' => true, 'step' => true, ), 'select' => array( 'id' => true, 'class' => true, 'name' => true, 'value' => true, 'style' => true, ), 'option' => array( 'value' => true, 'selected' => true, ), 'label' => array( 'id' => true, 'class' => true, 'style' => true, 'for' => true, ), 'br' => array(), 'em' => array(), 'a' => array( 'id' => true, 'class' => true, 'style' => true, 'href' => true, 'target' => true, 'onclick' => true, 'data-type' => true, 'data-incremental' => true, ), 'span' => array( 'id' => true, 'class' => true, 'style' => true, ), 'img' => array( 'id' => true, 'class' => true, 'style' => true, 'src' => true, 'width' => true, 'height' => true, 'alt' => true, ), 'p' => array( 'id' => true, 'class' => true, 'style' => true, ), ); } /* * Print the unfinished restoration dialog scripts / public function print_unfinished_restoration_dialog_scripts() { ?> <script> jQuery(function($) { $('.show_admin_restore_in_progress_notice').on('click', 'button#updraft_restore_abort', function(e) { e.preventDefault(); jQuery('#updraft_restore_continue_action').val('updraft_restore_abort'); jQuery(this).parent('form').trigger('submit'); }); }); </script> <?php } /* * Print CSS rules for the unfinished restoration dialog */ public function print_unfinished_restoration_dialog_styles() { ?> <style> .show_admin_restore_in_progress_notice .updraft_admin_restore_dialog .unfinished-restoration { font-size: 120% !important; } .show_admin_restore_in_progress_notice .updraft_admin_restore_dialog { padding-top: 12px; padding-bottom: 12px; } .show_admin_restore_in_progress_notice .updraft_admin_restore_dialog button { margin-right: 5px; } </style> <?php } }	340.85 KB	2025-10-09 08:53
📄 backup.php <?php if (!defined('UPDRAFTPLUS_DIR')) die('No direct access allowed'); if (!class_exists('UpdraftPlus_PclZip')) updraft_try_include_file('includes/class-zip.php', 'require_once'); /** * This file contains code that is only needed/loaded when a backup is running / class UpdraftPlus_Backup { private $index = 0; private $manifest_path; private $zipfiles_added; private $zipfiles_added_thisrun = 0; public $zipfiles_dirbatched; public $zipfiles_batched; public $zipfiles_skipped_notaltered; private $symlink_reversals = array(); private $makezip_recursive_batchedbytes; private $zip_split_every = 419430400; // 400MB private $zip_last_ratio = 1; private $whichone; private $zip_basename = ''; private $zipfiles_lastwritetime; // 0 = unknown; false = failed public $binzip = 0; private $dbhandle; private $dbhandle_isgz; private $whichdb; private $whichdb_suffix; // Array of entities => times private $altered_since = -1; // Time for the current entity private $makezip_if_altered_since = -1; private $excluded_extensions = false; private $excluded_wildcards = false; private $excluded_prefixes = false; private $use_zip_object = 'UpdraftPlus_ZipArchive'; public $debug = false; public $updraft_dir; private $site_name; private $wpdb_obj; private $job_file_entities = array(); private $first_run = 0; // Record of zip files created private $backup_files_array = array(); // Used when deciding to use the 'store' or 'deflate' zip storage method private $extensions_to_not_compress = array(); // Append to this any skipped tables private $skipped_tables; // When initialised, a boolean public $last_storage_instance; // The absolute upper limit that will be considered for a zip batch (in bytes) private $zip_batch_ceiling; private $backup_excluded_patterns = array(); // Bytes of uncompressed data written since last open private $db_current_raw_bytes = 0; private $table_prefix; private $table_prefix_raw; private $many_rows_warning = false; private $expected_rows = false; // @var Boolean private $try_split = false; private $zip_microtime_start; public $current_service; private $existing_files; private $existing_files_rawsize; private $existing_zipfiles_size; private $dbinfo; private $duplicate_tables_exist = false; private $first_linked_index; private $current_pruning_instance_id = ''; private $hash_list_of_complete_pruned_files = array(); private $pruning_number_of_files = 10; private $minimum_time_to_cache_pruned_files = 25; // seconds /* * Current processing remote storage instance id * * @var String / public $current_instance; /* * Backup entity name for which a zip backup file is currently making * * @var String / public $make_zipfile_source; // private $source; /* * Class constructor * * @param Array\|String $backup_files - files to backup, or (string)'no' * @param Integer $altered_since - only backup files altered since this time (UNIX epoch time) / public function __construct($backup_files, $altered_since = -1) { global $updraftplus; $this->site_name = $this->get_site_name(); $this->debug = UpdraftPlus_Options::get_updraft_option('updraft_debug_mode'); $this->updraft_dir = $updraftplus->backups_dir_location(); updraft_try_include_file('includes/class-database-utility.php', 'require_once'); if ('no' === $backup_files) { $this->use_zip_object = 'UpdraftPlus_PclZip'; return; } $this->extensions_to_not_compress = array_unique(array_map('strtolower', array_map('trim', explode(',', UPDRAFTPLUS_ZIP_NOCOMPRESS)))); $this->backup_excluded_patterns = array( array( // all in one wp migration pattern: WP_PLUGIN_DIR/all-in-one-wp-migration/storage//.wpress, `ai1wm-backups` folder in wp-content is already implicitly handled on the UDP settings with a `backups` predefined exclusion rule for `others` directory 'directory' => realpath(WP_PLUGIN_DIR).DIRECTORY_SEPARATOR.'all-in-one-wp-migration'.DIRECTORY_SEPARATOR.'storage', 'regex' => '/.+\.wpress$/is', ), ); $this->altered_since = $altered_since; $resumptions_since_last_successful = $updraftplus->current_resumption - $updraftplus->last_successful_resumption; // false means 'tried + failed'; whereas 0 means 'not yet tried' // Disallow binzip on OpenVZ when we're not sure there's plenty of memory if (0 === $this->binzip && (!defined('UPDRAFTPLUS_PREFERPCLZIP') \|\| !UPDRAFTPLUS_PREFERPCLZIP) && (!defined('UPDRAFTPLUS_NO_BINZIP') \|\| !UPDRAFTPLUS_NO_BINZIP) && ($updraftplus->current_resumption < 9 \|\| $resumptions_since_last_successful < 2)) { if (@file_exists('/proc/user_beancounters') && @file_exists('/proc/meminfo') && @is_readable('/proc/meminfo')) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $meminfo = @file_get_contents('/proc/meminfo', false, null, 0, 200);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (is_string($meminfo) && preg_match('/MemTotal:\s+(\d+) kB/', $meminfo, $matches)) { $memory_mb = $matches[1]/1024; // If the report is of a large amount, then we're probably getting the total memory on the hypervisor (this has been observed), and don't really know the VPS's memory $vz_log = "OpenVZ; reported memory: ".round($memory_mb, 1)." MB"; if ($memory_mb < 1024 \|\| $memory_mb > 8192) { $openvz_lowmem = true; $vz_log .= " (will not use BinZip)"; } $updraftplus->log($vz_log); } } if (empty($openvz_lowmem)) { $updraftplus->log('Checking if we have a zip executable available'); $binzip = $updraftplus->find_working_bin_zip(); if (is_string($binzip)) { $updraftplus->log("Zip engine: found/will use a binary zip: $binzip"); $this->binzip = $binzip; $this->use_zip_object = 'UpdraftPlus_BinZip'; } } } // In tests, PclZip was found to be 25% slower than ZipArchive if ('UpdraftPlus_PclZip' != $this->use_zip_object && empty($this->binzip) && ((defined('UPDRAFTPLUS_PREFERPCLZIP') && UPDRAFTPLUS_PREFERPCLZIP == true) \|\| !class_exists('ZipArchive') \|\| !class_exists('UpdraftPlus_ZipArchive') \|\| (!extension_loaded('zip') && !method_exists('ZipArchive', 'AddFile')))) { global $updraftplus; $updraftplus->log("Zip engine: ZipArchive (a.k.a. php-zip) is not available or is disabled (will use PclZip (much slower) if needed)"); $this->use_zip_object = 'UpdraftPlus_PclZip'; } $this->zip_batch_ceiling = (defined('UPDRAFTPLUS_ZIP_BATCH_CEILING') && UPDRAFTPLUS_ZIP_BATCH_CEILING > 104857600) ? UPDRAFTPLUS_ZIP_BATCH_CEILING : 200 * 1048576; if (defined('UPDRAFTPLUS_PRUNING_NUMBER_OF_FILES') && (int) UPDRAFTPLUS_PRUNING_NUMBER_OF_FILES > $this->pruning_number_of_files) $this->pruning_number_of_files = UPDRAFTPLUS_PRUNING_NUMBER_OF_FILES; if (defined('UPDRAFTPLUS_MIN_TIME_TO_CACHE_PRUNED_FILES') && (int) UPDRAFTPLUS_MIN_TIME_TO_CACHE_PRUNED_FILES > $this->minimum_time_to_cache_pruned_files) $this->minimum_time_to_cache_pruned_files = UPDRAFTPLUS_MIN_TIME_TO_CACHE_PRUNED_FILES; add_filter('updraftplus_exclude_file', array($this, 'backup_exclude_file'), 10, 2); } /** * Get a site name suitable for use in the backup filename * * @return String / private function get_site_name() { // Get the blog name and rip out known-problematic characters. Remember that we may need to be able to upload this to any FTP server or cloud storage, where filename support may be unknown $site_name = str_replace('__', '_', preg_replace('/[^A-Za-z0-9_]/', '', str_replace(' ', '_', substr(get_bloginfo(), 0, 32)))); if (!$site_name \|\| preg_match('#^_+$#', $site_name)) { // Try again... $parsed_url = parse_url(home_url(), PHP_URL_HOST); $parsed_subdir = untrailingslashit(parse_url(home_url(), PHP_URL_PATH)); if ($parsed_subdir && '/' != $parsed_subdir) $parsed_url .= str_replace(array('/', '\\'), '_', $parsed_subdir); $site_name = str_replace('__', '_', preg_replace('/[^A-Za-z0-9_]/', '', str_replace(' ', '_', substr($parsed_url, 0, 32)))); if (!$site_name \|\| preg_match('#^_+$#', $site_name)) $site_name = 'WordPress_Backup'; } // Allow an over-ride. Careful about introducing characters not supported by your filesystem or cloud storage. return apply_filters('updraftplus_blog_name', $site_name); } /* * Public, because called from the 'More Files' add-on * * @param String\|Array $create_from_dir Directory/ies to create the zip * @param String $whichone Entity being backed up (e.g. 'plugins', 'uploads') * @param String $backup_file_basename Name of backup file * @param Integer $index Index of zip in the sequence * @param Integer\|Boolean $first_linked_index First linked index in the sequence, or false * * @return Boolean\|Array - list of files, or false for failure / public function create_zip($create_from_dir, $whichone, $backup_file_basename, $index, $first_linked_index = false) { // Note: $create_from_dir can be an array or a string if (function_exists('set_time_limit')) set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT); $original_index = $index; $this->index = $index; $this->first_linked_index = (false === $first_linked_index) ? 0 : $first_linked_index; $this->whichone = $whichone; global $updraftplus; $this->zip_split_every = max((int) $updraftplus->jobdata_get('split_every'), UPDRAFTPLUS_SPLIT_MIN)1048576; if ('others' != $whichone) $updraftplus->log("Beginning creation of dump of $whichone (split every: ".round($this->zip_split_every/1048576, 1)." MB)"); if (is_string($create_from_dir) && !file_exists($create_from_dir)) { $flag_error = true; $updraftplus->log("Does not exist: $create_from_dir"); if ('mu-plugins' == $whichone) { if (!function_exists('get_mu_plugins')) include_once(ABSPATH.'wp-admin/includes/plugin.php'); $mu_plugins = get_mu_plugins(); if (count($mu_plugins) == 0) { $updraftplus->log("There are no mu-plugins to backup. Will not raise an error."); $flag_error = false; } } if ($flag_error) $updraftplus->log(sprintf(__("%s - could not back this entity up; the corresponding directory does not exist (%s)", 'updraftplus'), $whichone, $create_from_dir), 'error'); return false; } $itext = empty($index) ? '' : $index+1; $base_path = $backup_file_basename.'-'.$whichone.$itext.'.zip'; $full_path = $this->updraft_dir.'/'.$base_path; $time_now = time(); // This is compatible with filenames which indicate increments, as it is looking only for the current increment if (file_exists($full_path) \|\| $updraftplus->is_uploaded($base_path)) { // Gather any further files that may also exist $files_existing = array(); while (file_exists($full_path) \|\| $updraftplus->is_uploaded($base_path)) { $files_existing[] = $base_path; if (file_exists($full_path)) { $time_mod = (int) @filemtime($full_path);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $updraftplus->log($base_path.": this file has already been created (age: ".round($time_now-$time_mod, 1)." s)"); if ($time_mod > 100 && ($time_now - $time_mod) < 30) { UpdraftPlus_Job_Scheduler::terminate_due_to_activity($base_path, $time_now, $time_mod); } } $index++; // This is compatible with filenames which indicate increments, as it is looking only for the current increment $base_path = $backup_file_basename.'-'.$whichone.($index+1).'.zip'; $full_path = $this->updraft_dir.'/'.$base_path; } } // Temporary file, to be able to detect actual completion (upon which, it is renamed) // Jun-13 - be more aggressive in removing temporary files from earlier attempts - anything >=600 seconds old of this kind UpdraftPlus_Filesystem_Functions::clean_temporary_files('_'.$updraftplus->file_nonce."-$whichone", 600); // Firstly, make sure that the temporary file is not already being written to - which can happen if a resumption takes place whilst an old run is still active $zip_name = $full_path.'.tmp'; $time_mod = file_exists($zip_name) ? filemtime($zip_name) : 0; if (file_exists($zip_name) && $time_mod>100 && ($time_now-$time_mod)<30) { UpdraftPlus_Job_Scheduler::terminate_due_to_activity($zip_name, $time_now, $time_mod); } if (file_exists($zip_name)) { $updraftplus->log("File exists ($zip_name), but was not modified within the last 30 seconds, so we assume that any previous run has now terminated (time_mod=$time_mod, time_now=$time_now, diff=".($time_now-$time_mod).")"); } // Now, check for other forms of temporary file, which would indicate that some activity is going on (even if it hasn't made it into the main zip file yet) // Note: this doesn't catch PclZip temporary files $d = dir($this->updraft_dir); $match = '_'.$updraftplus->file_nonce."-".$whichone; while (false !== ($e = $d->read())) { if ('.' == $e \|\| '..' == $e \|\| !is_file($this->updraft_dir.'/'.$e)) continue; $ziparchive_match = preg_match("/$match(?:[0-9])\.zip\.tmp\.[A-Za-z0-9]+$/i", $e); $binzip_match = preg_match("/^zi([A-Za-z0-9]){6}$/", $e); $pclzip_match = preg_match("/^pclzip-[a-z0-9]+.(?:gz\|tmp)$/", $e); if ($time_now-filemtime($this->updraft_dir.'/'.$e) < 30 && ($ziparchive_match \|\| (0 != $updraftplus->current_resumption && ($binzip_match \|\| $pclzip_match)))) { UpdraftPlus_Job_Scheduler::terminate_due_to_activity($this->updraft_dir.'/'.$e, $time_now, filemtime($this->updraft_dir.'/'.$e)); } } @$d->close();// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. clearstatcache(); if (isset($files_existing)) { // Because of zip-splitting, the mere fact that files exist is not enough to indicate that the entity is finished. For that, we need to also see that no subsequent file has been started. // Q. What if the previous runner died in between zips, and it is our job to start the next one? A. The next temporary file is created before finishing the former zip, so we are safe (and we are also safe-guarded by the updated value of the index being stored in the database). return $files_existing; } $this->log_account_space(); $this->zip_microtime_start = microtime(true); // The paths in the zip should then begin with '$whichone', having removed WP_CONTENT_DIR from the front $zipcode = $this->make_zipfile($create_from_dir, $backup_file_basename, $whichone); if (true !== $zipcode) { $updraftplus->log("ERROR: Zip failure: Could not create $whichone zip (".$this->index." / $index)"); $updraftplus->log(sprintf(__('Could not create %s zip.', 'updraftplus'), $whichone).' '.__('Consult the log file for more information.', 'updraftplus'), 'error'); // The caller is required to update $index from $this->index return false; } else { $itext = empty($this->index) ? '' : $this->index+1; $full_path = $this->updraft_dir.'/'.$backup_file_basename.'-'.$whichone.$itext.'.zip'; if (file_exists($full_path.'.tmp')) { if (@filesize($full_path.'.tmp') === 0) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $updraftplus->log("Did not create $whichone zip (".$this->index.") - not needed"); @unlink($full_path.'.tmp');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } else { $checksum_description = ''; $checksums = $updraftplus->which_checksums(); foreach ($checksums as $checksum) { $cksum = hash_file($checksum, $full_path.'.tmp'); $updraftplus->jobdata_set($checksum.'-'.$whichone.$this->index, $cksum); if ($checksum_description) $checksum_description .= ', '; $checksum_description .= "$checksum: $cksum"; } @rename($full_path.'.tmp', $full_path);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $timetaken = max(microtime(true)-$this->zip_microtime_start, 0.000001); $kbsize = filesize($full_path)/1024; $updraftplus->jobdata_set('filesize-'.$whichone.$this->index, filesize($full_path)); $rate = round($kbsize/$timetaken, 1); $updraftplus->log("Created $whichone zip (".$this->index.") - ".round($kbsize, 1)." KB in ".round($timetaken, 1)." s ($rate KB/s) ($checksum_description)"); // We can now remove any left-over temporary files from this job } } elseif ($this->index > $original_index) { $updraftplus->log("Did not create $whichone zip (".$this->index.") - not needed (2)"); // Added 12-Feb-2014 (to help multiple morefiles) $this->index--; } else { $updraftplus->log("Looked-for $whichone zip (".$this->index.") was not found (".basename($full_path).".tmp)", 'warning'); } UpdraftPlus_Filesystem_Functions::clean_temporary_files('_'.$updraftplus->file_nonce."-$whichone", 0); $this->maybe_cloud_backup(basename($full_path), $whichone, $this->index); } // Remove cache list files as well, if there are any UpdraftPlus_Filesystem_Functions::clean_temporary_files('_'.$updraftplus->file_nonce."-$whichone", 0, true); // Create the results array to send back (just the new ones, not any prior ones) $files_existing = array(); $res_index = $original_index; for ($i = $original_index; $i<= $this->index; $i++) { $itext = empty($i) ? '' : ($i+1); $full_path = $this->updraft_dir.'/'.$backup_file_basename.'-'.$whichone.$itext.'.zip'; if (file_exists($full_path) \|\| $updraftplus->is_uploaded($backup_file_basename.'-'.$whichone.$itext.'.zip')) { $files_existing[$res_index] = $backup_file_basename.'-'.$whichone.$itext.'.zip'; } $res_index++; } return $files_existing; } /* * This method is for calling outside of a cloud_backup() context. It constructs a list of services for which prune operations should be attempted, and then calls prune_retained_backups() if necessary upon them. / public function do_prune_standalone() { global $updraftplus; $services = (array) $updraftplus->just_one($updraftplus->jobdata_get('service')); $prune_services = array(); foreach ($services as $service) { if ('none' === $service \|\| '' == $service) continue; $objname = "UpdraftPlus_BackupModule_{$service}"; if (!class_exists($objname) && file_exists(UPDRAFTPLUS_DIR.'/methods/'.$service.'.php')) { updraft_try_include_file('methods/'.$service.'.php', 'include_once'); } if (class_exists($objname)) { $remote_obj = new $objname; $prune_services[$service]['all'] = array($remote_obj, null); } else { $updraftplus->log("Could not prune from service $service: remote method not found"); } } if (!empty($prune_services)) $this->prune_retained_backups($prune_services); } /* * This function will check if backup archives exist and have a usable manifest if so it will attempt to send them for upload * * @param String $file - the name of the zip file * @param String $whichone - the entity type * @param Integer $index - the entity index * * @return void / private function maybe_cloud_backup($file, $whichone, $index) { global $updraftplus; // Check if the feature is enabled if (!defined('UPDRAFTPLUS_UPLOAD_AFTER_CREATE') \|\| UPDRAFTPLUS_UPLOAD_AFTER_CREATE) { if ($updraftplus->is_uploaded($file) \|\| !is_file($this->updraft_dir.'/'.$file)) return; $updraftplus->jobdata_set('filesize-'.$whichone.$index, filesize($this->updraft_dir.'/'.$file)); $backupable_entities = $updraftplus->get_backupable_file_entities(true); $undone_files = array(); if (!isset($backupable_entities[$whichone]) && ('db' != substr($whichone, 0, 2))) return; $manifest = $this->updraft_dir.'/'.$file.'.list.tmp'; if (!file_exists($manifest)) return; $manifest_contents = json_decode(file_get_contents($manifest), true); if (empty($manifest_contents) \|\| empty($manifest_contents['files'])) return; $undone_files[$whichone.$index] = $file; $this->cloud_backup($undone_files, 'partialclouduploading'); // reset the jobstatus as we may have just uploaded a backup set $updraftplus->jobdata_set('jobstatus', 'filescreating'); } } /* * Dispatch to the relevant function * * @param Array $backup_array - List of archives for the backup * @param String $stage - The stage we are uploading at (clouduploading, partialclouduploading) / public function cloud_backup($backup_array, $stage = 'clouduploading') { global $updraftplus; $services = (array) $updraftplus->just_one($updraftplus->jobdata_get('service')); $remote_storage_instances = $updraftplus->jobdata_get('remote_storage_instances', array()); // We need to make sure that the loop below actually runs if (empty($services)) $services = array('none'); $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_enabled_storage_objects_and_ids($services, $remote_storage_instances); $total_instances_count = 0; foreach ($storage_objects_and_ids as $service) { if ($service['object']->supports_feature('multi_options')) $total_instances_count += count($service['instance_settings']); } $updraftplus->jobdata_set('jobstatus', $stage); $updraftplus->register_wp_http_option_hooks(); $upload_status = $updraftplus->jobdata_get('uploading_substatus'); if (!is_array($upload_status) \|\| !isset($upload_status['t'])) { $upload_status = array('i' => 0, 'p' => 0, 't' => max(1, $total_instances_count)count($backup_array)); $updraftplus->jobdata_set('uploading_substatus', $upload_status); } elseif (is_array($upload_status) && isset($upload_status['t'])) { $upload_status['t'] = $upload_status['i'] + max(1, $total_instances_count)count($backup_array); $updraftplus->jobdata_set('uploading_substatus', $upload_status); } $do_prune = array(); // If there was no check-in last time, then attempt a different service first - in case a time-out on the attempted service leads to no activity and everything stopping if (count($services) >1 && $updraftplus->no_checkin_last_time) { $updraftplus->log('No check-in last time: will try a different remote service first'); array_push($services, array_shift($services)); // Make sure that the 'no worthwhile activity' detector isn't flumoxed by the starting of a new upload at 0% if ($updraftplus->current_resumption > 9) $updraftplus->jobdata_set('uploaded_lastreset', $updraftplus->current_resumption); if (1 == ($updraftplus->current_resumption % 2) && count($services)>2) array_push($services, array_shift($services)); } $errors_before_uploads = $updraftplus->error_count(); foreach ($services as $ind => $service) { try { $instance_id_count = 0; $total_instance_ids = ('none' !== $service && '' !== $service && $storage_objects_and_ids[$service]['object']->supports_feature('multi_options')) ? count($storage_objects_and_ids[$service]['instance_settings']) : 1; // Used for logging by record_upload_chunk() $this->current_service = $service; // Used when deciding whether to delete the local file $this->last_storage_instance = ($ind+1 >= count($services) && $instance_id_count+1 >= $total_instance_ids && $errors_before_uploads == $updraftplus->error_count()) ? true : false; $log_extra = $this->last_storage_instance ? ' (last)' : ''; $updraftplus->log("Cloud backup selection (".($ind+1)."/".count($services)."): ".$service." with instance (".($instance_id_count+1)."/".$total_instance_ids.")".$log_extra); if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ('none' == $service \|\| '' == $service) { $updraftplus->log('No remote despatch: user chose no remote backup service'); // Still want to mark as "uploaded", to signal that nothing more needs doing. (Important on incremental runs with no cloud storage). foreach ($backup_array as $file) { if ($updraftplus->is_uploaded($file)) { $updraftplus->log("Already uploaded: $file"); } else { $updraftplus->uploaded_file($file, true); } $fullpath = $this->updraft_dir.'/'.$file; if (file_exists($fullpath.'.list.tmp')) { $updraftplus->log("Deleting zip manifest ({$file}.list.tmp)"); unlink($fullpath.'.list.tmp'); } } $this->prune_retained_backups(array('none' => array('all' => array(null, null)))); } elseif (!empty($storage_objects_and_ids[$service]['object']) && !$storage_objects_and_ids[$service]['object']->supports_feature('multi_options')) { $remote_obj = $storage_objects_and_ids[$service]['object']; $do_prune = array_merge_recursive($do_prune, $this->upload_cloud($remote_obj, $service, $backup_array, '')); } elseif (!empty($storage_objects_and_ids[$service]['instance_settings'])) { foreach ($storage_objects_and_ids[$service]['instance_settings'] as $instance_id => $options) { if ($instance_id_count > 0) { $this->last_storage_instance = ($ind+1 >= count($services) && $instance_id_count+1 >= $total_instance_ids && $errors_before_uploads == $updraftplus->error_count()) ? true : false; $log_extra = $this->last_storage_instance ? ' (last)' : ''; $updraftplus->log("Cloud backup selection (".($ind+1)."/".count($services)."): ".$service." with instance (".($instance_id_count+1)."/".$total_instance_ids.")".$log_extra); } // Used for logging by record_upload_chunk() $this->current_instance = $instance_id; if (!isset($options['instance_enabled'])) $options['instance_enabled'] = 1; // if $remote_storage_instances is not empty then we are looping over a list of instances the user wants to backup to so we want to ignore if the instance is enabled or not if (1 == $options['instance_enabled'] \|\| !empty($remote_storage_instances)) { $remote_obj = $storage_objects_and_ids[$service]['object']; $remote_obj->set_options($options, true, $instance_id); $do_prune = array_merge_recursive($do_prune, $this->upload_cloud($remote_obj, $service, $backup_array, $instance_id)); } else { $updraftplus->log("This instance id ($instance_id) is set as inactive."); } $instance_id_count++; } } } catch (Exception $e) { $log_message = 'Exception ('.get_class($e).') occurred during backup uploads to the '.$service.'. Exception Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; $updraftplus->log($log_message); error_log($log_message); $updraftplus->log(sprintf(__('A PHP exception (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during backup uploads to the '.$service.'. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; $updraftplus->log($log_message); error_log($log_message); $updraftplus->log(sprintf(__('A PHP fatal error (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); } } if (!empty($do_prune) && 'clouduploading' == $stage) $this->prune_retained_backups($do_prune); $updraftplus->register_wp_http_option_hooks(false); } /* * This method will start the upload of the backups to the chosen remote storage method and return an array of files to be pruned and their location. * * @param Object $remote_obj - the remote storage object * @param String $service - the name of the service we are uploading to * @param Array $backup_array - an array that contains the backup files we want to upload * @param String $instance_id - the instance id we are using * @return Array - an array with information about what files to prune and where they are located / private function upload_cloud($remote_obj, $service, $backup_array, $instance_id) { global $updraftplus; $do_prune = array(); if ('' == $instance_id) { $updraftplus->log("Beginning dispatch of backup to remote ($service)"); } else { $updraftplus->log("Beginning dispatch of backup to remote ($service) (instance identifier $instance_id)"); } $errors_before_uploads = $updraftplus->error_count(); $sarray = array(); foreach ($backup_array as $bind => $file) { if ($updraftplus->is_uploaded($file, $service, $instance_id)) { if ('' == $instance_id) { $updraftplus->log("Already uploaded to $service: $file", 'notice', false, true); } else { $updraftplus->log("Already uploaded to $service / $instance_id: $file", 'notice', false, true); } // If this is the last instance and this file has already been uploaded then we need to mark it as complete in order to get the local file cleaned up. if (!empty($this->last_storage_instance)) $updraftplus->uploaded_file($file); } else { $sarray[$bind] = $file; } } if (count($sarray) > 0) { $pass_to_prune = $remote_obj->backup($sarray); if ('remotesend' != $service) { $do_prune[$service][$instance_id] = array($remote_obj, $pass_to_prune); } else { $do_prune[$service]['default'] = array($remote_obj, $pass_to_prune); } // Check there are no errors in the uploads, if none then call upload_completed() if it exists otherwise mark as complete if ($errors_before_uploads == $updraftplus->error_count()) { if (is_callable(array($remote_obj, 'upload_completed'))) { $result = $remote_obj->upload_completed(); if ($result) $updraftplus->mark_upload_complete($service); } else { $updraftplus->mark_upload_complete($service); } } } else { // We still need to make sure that prune is run on this remote storage method, even if all entities were previously uploaded $do_prune[$service]['all'] = array($remote_obj, null); } return $do_prune; } /* * Group the backup history into sets for retention processing and indicate the retention rule to apply to each group. This is a 'default' function which just puts them all in together. * * @param Array $backup_history * * @return Array / private function group_backups($backup_history) { return array(array('sets' => $backup_history, 'process_order' => 'keep_newest')); } /* * Logs a message; with the message being logged to the database also only if that has not been done in the last 3 seconds. Useful for better overall performance on slow database servers with rapid logging. * * @uses UpdraftPlus::log() * * @param String $message - the message to log * @param String $level - the log level / private function log_with_db_occasionally($message, $level = 'notice') { global $updraftplus; static $last_db = false; if (time() > $last_db + 3) { $last_db = time(); $skip_dblog = false; } else { $skip_dblog = true; } return $updraftplus->log($message, $level, false, $skip_dblog); } /* * Prunes historical backups, according to the user's settings * * @param Array $services - An associative array with list of services as key and remote object and boolean flag as values to prune on. This must be an array (i.e. it is not flexible like some other places) * * @return void / public function prune_retained_backups($services) { global $updraftplus, $wpdb; if ('' != $updraftplus->jobdata_get('remotesend_info')) { $updraftplus->log("Prune old backups from local store: skipping, as this was a remote send operation"); return; } if (method_exists($wpdb, 'check_connection') && (!defined('UPDRAFTPLUS_SUPPRESS_CONNECTION_CHECKS') \|\| !UPDRAFTPLUS_SUPPRESS_CONNECTION_CHECKS)) { if (!$wpdb->check_connection(false)) { UpdraftPlus_Job_Scheduler::reschedule(60); $updraftplus->log('It seems the database went away; scheduling a resumption and terminating for now'); UpdraftPlus_Job_Scheduler::record_still_alive(); die; } } // If they turned off deletion on local backups, then there is nothing to do if (!UpdraftPlus_Options::get_updraft_option('updraft_delete_local', 1) && 1 == count($services) && array_key_exists('none', $services)) { $updraftplus->log("Prune old backups from local store: nothing to do, since the user disabled local deletion and we are using local backups"); return; } $this->hash_list_of_complete_pruned_files = $updraftplus->jobdata_get('hash_list_of_complete_pruned_files'); if (!is_array($this->hash_list_of_complete_pruned_files)) $this->hash_list_of_complete_pruned_files = array(); $updraftplus->jobdata_set_multi(array('jobstatus' => 'pruning', 'prune' => 'begun')); // Number of backups to retain - files $updraft_retain = UpdraftPlus_Options::get_updraft_option('updraft_retain', 2); $updraft_retain = is_numeric($updraft_retain) ? $updraft_retain : 1; // Number of backups to retain - db $updraft_retain_db = UpdraftPlus_Options::get_updraft_option('updraft_retain_db', $updraft_retain); $updraft_retain_db = is_numeric($updraft_retain_db) ? $updraft_retain_db : 1; $updraftplus->log("Retain: beginning examination of existing backup sets; user setting: retain_files=$updraft_retain, retain_db=$updraft_retain_db"); // Returns an array, most recent first, of backup sets $backup_history = UpdraftPlus_Backup_History::get_history(); $ignored_because_imported = array(); // Remove non-native (imported) backups, which are neither counted nor pruned. It's neater to do these in advance, and log only one line. $functional_backup_history = $backup_history; foreach ($functional_backup_history as $backup_time => $backup_to_examine) { if (isset($backup_to_examine['native']) && false == $backup_to_examine['native']) { $ignored_because_imported[] = $backup_time; unset($functional_backup_history[$backup_time]); } } if (!empty($ignored_because_imported)) { $updraftplus->log("These backup set(s) were imported from a remote location, so will not be counted or pruned. Skipping: ".implode(', ', $ignored_because_imported)); } $backupable_entities = $updraftplus->get_backupable_file_entities(true); $database_backups_found = array(); $file_entities_backups_found = array(); foreach ($backupable_entities as $entity => $info) { $file_entities_backups_found[$entity] = 0; } if (false === ($backup_db_groups = apply_filters('updraftplus_group_backups_for_pruning', false, $functional_backup_history, 'db'))) { $backup_db_groups = $this->group_backups($functional_backup_history); } $updraftplus->log("Number of backup sets in history: ".count($backup_history)."; groups (db): ".count($backup_db_groups)); foreach ($backup_db_groups as $group_id => $group) { // N.B. The array returned by UpdraftPlus_Backup_History::get_history() is already sorted, with most-recent first if (empty($group['sets']) \|\| !is_array($group['sets'])) continue; $sets = $group['sets']; // Sort the groups into the desired "keep this first" order $process_order = (!empty($group['process_order']) && 'keep_oldest' == $group['process_order']) ? 'keep_oldest' : 'keep_newest'; if ('keep_oldest' == $process_order) ksort($sets); $rule = !empty($group['rule']) ? $group['rule'] : array('after-howmany' => 0, 'after-period' => 0, 'every-period' => 1, 'every-howmany' => 1); foreach ($sets as $backup_datestamp => $backup_to_examine) { $files_to_prune = array(); $nonce = empty($backup_to_examine['nonce']) ? '???' : $backup_to_examine['nonce']; // $backup_to_examine is an array of file names, keyed on db/plugins/themes/uploads // The new backup_history array is saved afterwards, so remember to unset the ones that are to be deleted $this->log_with_db_occasionally(sprintf("Examining (for databases) backup set with group_id=$group_id, nonce=%s, datestamp=%s (%s)", $nonce, $backup_datestamp, gmdate('M d Y H:i:s', $backup_datestamp))); // "Always Keep" Backups should be counted in the count of how many have been retained for purposes of the "how many to retain" count... but if that count is already matched, it's not a problem $is_always_keep = !empty($backup_to_examine['always_keep']); // Auto-backups are only counted or deleted once we have reached the retain limit - before that, they are skipped $is_autobackup = !empty($backup_to_examine['autobackup']); $remote_sent = (!empty($backup_to_examine['service']) && ((is_array($backup_to_examine['service']) && in_array('remotesend', $backup_to_examine['service'])) \|\| 'remotesend' === $backup_to_examine['service'])) ? true : false; $any_deleted_via_filter_yet = false; // Databases foreach ($backup_to_examine as $key => $data) { if ('db' != strtolower(substr($key, 0, 2)) \|\| '-size' == substr($key, -5, 5)) continue; if (empty($database_backups_found[$key])) $database_backups_found[$key] = 0; if ($nonce == $updraftplus->nonce \|\| $nonce == $updraftplus->file_nonce) { $this->log_with_db_occasionally("This backup set is the backup set just made, so will not be deleted."); $database_backups_found[$key]++; continue; } if ($is_always_keep) { if ($database_backups_found[$key] < $updraft_retain) { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an 'Always Keep' backup, and we have not yet reached any retain limits, so it should be counted in the count of how many have been retained for purposes of the 'how many to retain' count. It will not be pruned. Skipping."); $database_backups_found[$key]++; } else { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an 'Always Keep' backup, so it will not be pruned. Skipping."); } continue; } if ($is_autobackup) { if ($any_deleted_via_filter_yet) { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an automatic backup, but we have previously deleted a backup due to a limit, so it will be pruned (but not counted towards numerical limits)."); $prune_it = true; } elseif ($database_backups_found[$key] < $updraft_retain_db) { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an automatic backup, and we have not yet reached any retain limits, so it will not be counted or pruned. Skipping."); continue; } else { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an automatic backup, and we have already reached retain limits, so it will be pruned."); $prune_it = true; } } else { $prune_it = false; } if ($remote_sent) { $prune_it = true; $this->log_with_db_occasionally("$backup_datestamp: $key: was sent to remote site; will remove from local record (only)"); } // All non-auto backups must be run through this filter (in date order) regardless of the current state of $prune_it - so that filters are able to track state. $prune_it_before_filter = $prune_it; if (!$is_autobackup) $prune_it = apply_filters('updraftplus_prune_or_not', $prune_it, 'db', $backup_datestamp, $key, $database_backups_found[$key], $rule, $group_id); // Apply the final retention limit list (do not increase the 'retained' counter before seeing if the backup is being pruned for some other reason) if (!$prune_it && !$is_autobackup) { if ($database_backups_found[$key] + 1 > $updraft_retain_db) { $prune_it = true; $fname = is_string($data) ? $data : $data[0]; $this->log_with_db_occasionally("$backup_datestamp: $key: this set includes a database (".$fname."); db count is now ".$database_backups_found[$key]); $this->log_with_db_occasionally("$backup_datestamp: $key: over retain limit ($updraft_retain_db); will delete this database"); } } if ($prune_it) { if (!$prune_it_before_filter) $any_deleted_via_filter_yet = true; if (!empty($data)) { $size_key = $key.'-size'; $size = isset($backup_to_examine[$size_key]) ? $backup_to_examine[$size_key] : null; foreach ($services as $service => $instance_ids_to_prune) { foreach ($instance_ids_to_prune as $instance_id_to_prune => $sd) { $this->current_pruning_instance_id = $instance_id_to_prune; if ('none' != $service && '' != $service && $sd[0]->supports_feature('multi_options')) { $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array($service)); if ('all' == $instance_id_to_prune) { foreach ($storage_objects_and_ids[$service]['instance_settings'] as $saved_instance_id => $options) { $this->current_pruning_instance_id = $saved_instance_id; $sd[0]->set_options($options, false, $saved_instance_id); $this->prune_file($service, $data, $sd[0], $sd[1], array($size)); } } else { $opts = $storage_objects_and_ids[$service]['instance_settings'][$instance_id_to_prune]; $sd[0]->set_options($opts, false, $instance_id_to_prune); $this->prune_file($service, $data, $sd[0], $sd[1], array($size)); } } else { $this->current_pruning_instance_id = empty($service) ? 'none' : $service; $this->prune_file($service, $data, $sd[0], $sd[1], array($size)); } } } } $this->current_pruning_instance_id = ''; unset($backup_to_examine[$key]); UpdraftPlus_Job_Scheduler::record_still_alive(); } elseif (!$is_autobackup) { $database_backups_found[$key]++; } $backup_to_examine = $this->remove_backup_set_if_empty($backup_to_examine, $backupable_entities); if (empty($backup_to_examine)) { unset($functional_backup_history[$backup_datestamp]); unset($backup_history[$backup_datestamp]); $this->maybe_save_backup_history_and_reschedule($backup_history); } else { $functional_backup_history[$backup_datestamp] = $backup_to_examine; $backup_history[$backup_datestamp] = $backup_to_examine; } } } } if (false === ($backup_files_groups = apply_filters('updraftplus_group_backups_for_pruning', false, $functional_backup_history, 'files'))) { $backup_files_groups = $this->group_backups($functional_backup_history); } $updraftplus->log("Number of backup sets in history: ".count($backup_history)."; groups (files): ".count($backup_files_groups)); // Now again - this time for the files foreach ($backup_files_groups as $group_id => $group) { // N.B. The array returned by UpdraftPlus_Backup_History::get_history() is already sorted, with most-recent first if (empty($group['sets']) \|\| !is_array($group['sets'])) continue; $sets = $group['sets']; // Sort the groups into the desired "keep this first" order $process_order = (!empty($group['process_order']) && 'keep_oldest' == $group['process_order']) ? 'keep_oldest' : 'keep_newest'; // Youngest - i.e. smallest epoch - first if ('keep_oldest' == $process_order) ksort($sets); $rule = !empty($group['rule']) ? $group['rule'] : array('after-howmany' => 0, 'after-period' => 0, 'every-period' => 1, 'every-howmany' => 1); foreach ($sets as $backup_datestamp => $backup_to_examine) { $files_to_prune = array(); $nonce = empty($backup_to_examine['nonce']) ? '???' : $backup_to_examine['nonce']; // $backup_to_examine is an array of file names, keyed on db/plugins/themes/uploads // The new backup_history array is saved afterwards, so remember to unset the ones that are to be deleted $this->log_with_db_occasionally(sprintf("Examining (for files) backup set with nonce=%s, datestamp=%s (%s)", $nonce, $backup_datestamp, gmdate('M d Y H:i:s', $backup_datestamp))); // "Always Keep" Backups should be counted in the count of how many have been retained for purposes of the "how many to retain" count... but if that count is already matched, it's not a problem $is_always_keep = !empty($backup_to_examine['always_keep']); // Auto-backups are only counted or deleted once we have reached the retain limit - before that, they are skipped $is_autobackup = !empty($backup_to_examine['autobackup']); $remote_sent = (!empty($backup_to_examine['service']) && ((is_array($backup_to_examine['service']) && in_array('remotesend', $backup_to_examine['service'])) \|\| 'remotesend' === $backup_to_examine['service'])) ? true : false; $any_deleted_via_filter_yet = false; $file_sizes = array(); // Files foreach ($backupable_entities as $entity => $info) { if (!empty($backup_to_examine[$entity])) { // This should only be able to happen if you import backups with a future timestamp if ($nonce == $updraftplus->nonce \|\| $nonce == $updraftplus->file_nonce) { $updraftplus->log("This backup set is the backup set just made, so will not be deleted."); $file_entities_backups_found[$entity]++; continue; } if ($is_always_keep) { if ($file_entities_backups_found[$entity] < $updraft_retain) { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an 'Always Keep' backup, and we have not yet reached any retain limits, so it should be counted in the count of how many have been retained for purposes of the 'how many to retain' count. It will not be pruned. Skipping."); $file_entities_backups_found[$entity]++; } else { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an 'Always Keep' backup, so it will not be pruned. Skipping."); } continue; } if ($is_autobackup) { if ($any_deleted_via_filter_yet) { $this->log_with_db_occasionally("This backup set was an automatic backup, but we have previously deleted a backup due to a limit, so it will be pruned (but not counted towards numerical limits)."); $prune_it = true; } elseif ($file_entities_backups_found[$entity] < $updraft_retain) { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an automatic backup, and we have not yet reached any retain limits, so it will not be counted or pruned. Skipping."); continue; } else { $this->log_with_db_occasionally("This backup set ($backup_datestamp) was an automatic backup, and we have already reached retain limits, so it will be pruned."); $prune_it = true; } } else { $prune_it = false; } if ($remote_sent) { $prune_it = true; } // All non-auto backups must be run through this filter (in date order) regardless of the current state of $prune_it - so that filters are able to track state. $prune_it_before_filter = $prune_it; if (!$is_autobackup) $prune_it = apply_filters('updraftplus_prune_or_not', $prune_it, 'files', $backup_datestamp, $entity, $file_entities_backups_found[$entity], $rule, $group_id); // The "more than maximum to keep?" counter should not be increased until we actually know that the set is being kept. Before version 1.11.22, we checked this before running the filter, which resulted in the counter being increased for sets that got pruned via the filter (i.e. not kept) - and too many backups were thus deleted if (!$prune_it && !$is_autobackup) { if ($file_entities_backups_found[$entity] >= $updraft_retain) { $this->log_with_db_occasionally("$entity: over retain limit ($updraft_retain); will delete this file entity"); $prune_it = true; } } if ($prune_it) { if (!$prune_it_before_filter) $any_deleted_via_filter_yet = true; $prune_this = $backup_to_examine[$entity]; if (is_string($prune_this)) $prune_this = array($prune_this); foreach ($prune_this as $k => $prune_file) { if ($remote_sent) { $updraftplus->log("$entity: $backup_datestamp: was sent to remote site; will remove from local record (only)"); } $size_key = (0 == $k) ? $entity.'-size' : $entity.$k.'-size'; $size = (isset($backup_to_examine[$size_key])) ? $backup_to_examine[$size_key] : null; $files_to_prune[] = $prune_file; $file_sizes[] = $size; } unset($backup_to_examine[$entity]); } elseif (!$is_autobackup) { $file_entities_backups_found[$entity]++; } } } // Sending an empty array is not itself a problem - except that the remote storage method may not check that before setting up a connection, which can waste time: especially if this is done every time around the loop. if (!empty($files_to_prune)) { // Actually delete the files foreach ($services as $service => $instance_ids_to_prune) { foreach ($instance_ids_to_prune as $instance_id_to_prune => $sd) { $this->current_pruning_instance_id = $instance_id_to_prune; if ("none" != $service && '' != $service && $sd[0]->supports_feature('multi_options')) { $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array($service)); if ('all' == $instance_id_to_prune) { foreach ($storage_objects_and_ids[$service]['instance_settings'] as $saved_instance_id => $options) { $this->current_pruning_instance_id = $saved_instance_id; $sd[0]->set_options($options, false, $saved_instance_id); $this->prune_file($service, $files_to_prune, $sd[0], $sd[1], $file_sizes); } } else { $opts = $storage_objects_and_ids[$service]['instance_settings'][$instance_id_to_prune]; $sd[0]->set_options($opts, false, $instance_id_to_prune); $this->prune_file($service, $files_to_prune, $sd[0], $sd[1], $file_sizes); } } else { $this->current_pruning_instance_id = empty($service) ? 'none' : $service; $this->prune_file($service, $files_to_prune, $sd[0], $sd[1], $file_sizes); } UpdraftPlus_Job_Scheduler::record_still_alive(); } } } $this->current_pruning_instance_id = ''; $backup_to_examine = $this->remove_backup_set_if_empty($backup_to_examine, $backupable_entities); if (empty($backup_to_examine)) { unset($backup_history[$backup_datestamp]); $this->maybe_save_backup_history_and_reschedule($backup_history); } else { $backup_history[$backup_datestamp] = $backup_to_examine; } // Loop over backup sets } // Look over backup groups } $updraftplus->log("Retain: saving new backup history (sets now: ".count($backup_history).") and finishing retain operation"); UpdraftPlus_Backup_History::save_history($backup_history, false); do_action('updraftplus_prune_retained_backups_finished'); $updraftplus->jobdata_set('prune', 'finished'); } /* * The purpose of this is to save the backup history periodically - for the benefit of setups where the pruning takes longer than the total allow run time (e.g. if the network communications to the remote storage have delays in, and there are a lot of sets to scan) * * @param Array $backup_history - the backup history to possible save / private function maybe_save_backup_history_and_reschedule($backup_history) { static $last_saved_at = 0; if (!$last_saved_at) $last_saved_at = time(); if (time() - $last_saved_at >= 10) { global $updraftplus; $updraftplus->log("Retain: saving new backup history, because at least 10 seconds have passed since the last save (sets now: ".count($backup_history).")"); UpdraftPlus_Backup_History::save_history($backup_history, false); UpdraftPlus_Job_Scheduler::something_useful_happened(); $last_saved_at = time(); } } /* * Examine a backup set; if it is empty (no files or DB), then remove the associated log file * * @param Array $backup_to_examine - backup set * @param Array $backupable_entities - compare with this list of backup entities * * @return Array\|Boolean - if it was empty, false is returned / private function remove_backup_set_if_empty($backup_to_examine, $backupable_entities) { global $updraftplus; // Get new result, post-deletion; anything left in this set? $contains_files = 0; foreach ($backupable_entities as $entity => $info) { if (isset($backup_to_examine[$entity])) { $contains_files = 1; break; } } $contains_db = 0; foreach ($backup_to_examine as $key => $data) { if ('db' == strtolower(substr($key, 0, 2)) && '-size' != substr($key, -5, 5)) { $contains_db = 1; break; } } // Delete backup set completely if empty, o/w just remove DB // We search on the four keys which represent data, allowing other keys to be used to track other things if (!$contains_files && !$contains_db) { $updraftplus->log("This backup set is now empty; will remove from history"); if (isset($backup_to_examine['nonce'])) { $fullpath = $this->updraft_dir."/log.".$backup_to_examine['nonce'].".txt"; if (is_file($fullpath)) { $updraftplus->log("Deleting log file (log.".$backup_to_examine['nonce'].".txt)"); @unlink($fullpath);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } else { $updraftplus->log("Corresponding log file (log.".$backup_to_examine['nonce'].".txt) not found - must have already been deleted"); } } else { $updraftplus->log("No nonce record found in the backup set, so cannot delete any remaining log file"); } return false; } else { $updraftplus->log("This backup set remains non-empty (f=$contains_files/d=$contains_db); will retain in history"); return $backup_to_examine; } } /* * Prune files from remote and local storage * * @param String $service Service to prune (one only) * @param Array\|String $dofiles An array of files (or a single string for one file) * @param Array $method_object specific method object * @param Array $object_passback specific passback object * @param Array $file_sizes size of files / private function prune_file($service, $dofiles, $method_object = null, $object_passback = null, $file_sizes = array()) { global $updraftplus; if (!is_array($dofiles)) $dofiles = array($dofiles); if (!apply_filters('updraftplus_prune_file', true, $dofiles, $service, $method_object, $object_passback, $file_sizes)) { $updraftplus->log("Prune: service=$service: skipped via filter"); return; } foreach ($dofiles as $dofile) { $fullpath = $this->updraft_dir.'/'.$dofile; if (empty($dofile) \|\| !file_exists($fullpath)) continue; $updraftplus->log("Delete file: $dofile, service=$service"); // delete it if it's locally available $updraftplus->log("Deleting local copy ($dofile)"); unlink($fullpath); if (file_exists($fullpath.'.list.tmp')) { $updraftplus->log("Deleting zip manifest ({$dofile}.list.tmp)"); unlink($fullpath.'.list.tmp'); } } // Despatch to the particular method's deletion routine if (!is_null($method_object)) { $files = $sizes = array(); $pruning_start_time_for_current_instance_id = microtime(true); foreach ($dofiles as $actual_index => $file) { $hashed_file = md5($this->current_pruning_instance_id.$file); if (in_array($hashed_file, $this->hash_list_of_complete_pruned_files)) continue; $files[] = $file; $sizes[] = $file_sizes[$actual_index]; $this->hash_list_of_complete_pruned_files[] = $hashed_file; if (count($dofiles) !== $actual_index+1 && 0 != ($actual_index+1) % $this->pruning_number_of_files) continue; // only proceed with deletion at every multiples of ten (default) or if it's already at the end of files $method_object->delete($files, $object_passback, $sizes); if (count($dofiles) === $actual_index+1 \|\| (floor(microtime(true)-$pruning_start_time_for_current_instance_id)) >= $this->minimum_time_to_cache_pruned_files) { $this->hash_list_of_complete_pruned_files = array_unique($this->hash_list_of_complete_pruned_files); $updraftplus->jobdata_set('hash_list_of_complete_pruned_files', $this->hash_list_of_complete_pruned_files); // only cache already-done files when it reaches the minimum time, which is 25 seconds by default $pruning_start_time_for_current_instance_id = microtime(true); } $files = $sizes = array(); } } } /* * Log the amount account space free/used, if possible / private function log_account_space() { global $updraftplus; $hosting_bytes_free = $updraftplus->get_hosting_disk_quota_free(); if (is_array($hosting_bytes_free)) { $perc = round(100$hosting_bytes_free[1]/(max($hosting_bytes_free[2], 1)), 1); $updraftplus->log(sprintf('Free disk space in account: %s (%s used)', round($hosting_bytes_free[3]/1048576, 1)." MB", "$perc %")); } } /** * Returns the basename up to and including the nonce (but not the entity) * * @param Integer $use_time epoch time to use * @return String / private function get_backup_file_basename_from_time($use_time) { global $updraftplus; return apply_filters('updraftplus_get_backup_file_basename_from_time', 'backup_'.get_date_from_gmt(gmdate('Y-m-d H:i:s', $use_time), 'Y-m-d-Hi').'_'.$this->site_name.'_'.$updraftplus->file_nonce, $use_time, $this->site_name); } /* * Find the zip files in a given directory for a given nonce * * @param String $dir - directory to look in * @param String $match_nonce - backup ID to match * * @return Array / private function find_existing_zips($dir, $match_nonce) { $zips = array(); if (!$handle = opendir($dir)) return $zips; while (false !== ($entry = readdir($handle))) { if ('.' == $entry \|\| '..' == $entry) continue; if (preg_match('/^backup_(\d{4})-(\d{2})-(\d{2})-(\d{2})(\d{2})_._([0-9a-f]{12})-([\-a-z]+)([0-9]+)?\.zip$/i', $entry, $matches)) { if ($matches[6] !== $match_nonce) continue; $timestamp = mktime($matches[4], $matches[5], 0, $matches[2], $matches[3], $matches[1]); $entity = $matches[7]; $index = empty($matches[8]) ? '0' : $matches[8]; $zips[$entity][$index] = array($timestamp, $entry); } } return $zips; } /** * Get information on whether a particular file exists in a set * * @param Array $files should be an array as returned by find_existing_zips()] * @param String $entity entty of the file (e.g. 'plugins') * @param Integer $index Index within the files array * @return String\|Boolean - false if the file does not exist; otherwise, the basename / private function file_exists($files, $entity, $index = 0) { if (isset($files[$entity]) && isset($files[$entity][$index])) { $file = $files[$entity][$index]; // Return the filename return $file[1]; } else { return false; } } /* * This function is resumable * * @param String $job_status Current status * * @return Array - array of backed-up files / private function backup_dirs($job_status) { global $updraftplus; if (!$updraftplus->backup_time) $updraftplus->backup_time_nonce(); $use_time = $updraftplus->backup_time; $backup_file_basename = $this->get_backup_file_basename_from_time($use_time); $backup_array = array(); // Was there a check-in last time? If not, then reduce the amount of data attempted if ('finished' != $job_status && $updraftplus->current_resumption >= 2) { // NOTYET: Possible amendment to original algorithm; not just no check-in, but if the check in was very early (can happen if we get a very early checkin for some trivial operation, then attempt something too big) // 03-Sep-2015 - came across a case (HS#2052) where there apparently was a check-in 'last time', but no resumption was scheduled because the 'useful_checkin' jobdata was not* last time - which must indicate dying at a very unfortunate/unlikely point in the code. As a result, the split was not auto-reduced. Consequently, we've added !$updraftplus->newresumption_scheduled as a condition on the first check here (it was already on the second), as if no resumption is scheduled then whatever checkin there was last time was only partial. This was on GoDaddy, for which a number of curious I/O event combinations have been seen in recent months - their platform appears to have some odd behaviour when PHP is killed off. // 04-Sep-2015 - move the '$updraftplus->current_resumption<=10' check to the inner loop (instead of applying to this whole section), as I see no reason for that restriction (case seen in HS#2064 where it was required on resumption 15) if ($updraftplus->no_checkin_last_time \|\| !$updraftplus->newresumption_scheduled \|\| $updraftplus->resumption_scheduled_for_cleanup) { // Apr 2015: !$updraftplus->newresumption_scheduled added after seeing a log where there was no activity on resumption 9, and extra resumption 10 then tried the same operation. if ($updraftplus->current_resumption - $updraftplus->last_successful_resumption > 2 \|\| !$updraftplus->newresumption_scheduled) { $this->try_split = true; } elseif ($updraftplus->current_resumption <= 10) { $maxzipbatch = $updraftplus->jobdata_get('maxzipbatch', 26214400); if ((int) $maxzipbatch < 1) $maxzipbatch = 26214400; $new_maxzipbatch = max(floor($maxzipbatch * 0.75), 20971520); if ($new_maxzipbatch < $maxzipbatch) { $updraftplus->log("No check-in was detected on the previous run - as a result, we are reducing the batch amount (old=$maxzipbatch, new=$new_maxzipbatch)"); $updraftplus->jobdata_set('maxzipbatch', $new_maxzipbatch); $updraftplus->jobdata_set('maxzipbatch_ceiling', $new_maxzipbatch); } } } } if ('finished' != $job_status && !UpdraftPlus_Filesystem_Functions::really_is_writable($this->updraft_dir)) { $updraftplus->log("Backup directory (".$this->updraft_dir.") is not writable, or does not exist"); $updraftplus->log(sprintf(__("Backup directory (%s) is not writable, or does not exist.", 'updraftplus'), $this->updraft_dir), 'error'); return array(); } $this->job_file_entities = $updraftplus->jobdata_get('job_file_entities'); // This is just used for the visual feedback (via the 'substatus' key) $which_entity = 0; // e.g. plugins, themes, uploads, others // $whichdir might be an array (if $youwhat is 'more') // Returns an array (keyed off the entity) of ($timestamp, $filename) arrays $existing_zips = $this->find_existing_zips($this->updraft_dir, $updraftplus->file_nonce); $possible_backups = $updraftplus->get_backupable_file_entities(true); foreach ($possible_backups as $youwhat => $whichdir) { if (!isset($this->job_file_entities[$youwhat])) { $updraftplus->log("No backup of $youwhat: excluded by user's options"); continue; } $index = (int) $this->job_file_entities[$youwhat]['index']; if (empty($index)) $index=0; $indextext = (0 == $index) ? '' : (1+$index); $zip_file = $this->updraft_dir.'/'.$backup_file_basename.'-'.$youwhat.$indextext.'.zip'; // Split needed? $split_every = max((int) $updraftplus->jobdata_get('split_every'), 250); if (false != ($existing_file = $this->file_exists($existing_zips, $youwhat, $index)) && filesize($this->updraft_dir.'/'.$existing_file) > $split_every1048576) { $index++; $this->job_file_entities[$youwhat]['index'] = $index; $updraftplus->jobdata_set('job_file_entities', $this->job_file_entities); } // Populate prior parts of $backup_array, if we're on a subsequent zip file if ($index > 0) { for ($i=0; $i<$index; $i++) { $itext = (0 == $i) ? '' : ($i+1); // Get the previously-stored filename if possible (which should be always); failing that, base it on the current run $zip_file = (isset($this->backup_files_array[$youwhat]) && isset($this->backup_files_array[$youwhat][$i])) ? $this->backup_files_array[$youwhat][$i] : $backup_file_basename.'-'.$youwhat.$itext.'.zip'; $backup_array[$youwhat][$i] = $zip_file; $z = $this->updraft_dir.'/'.$zip_file; $itext = (0 == $i) ? '' : $i; $fs_key = $youwhat.$itext.'-size'; if (file_exists($z)) { $backup_array[$fs_key] = filesize($z); } elseif (isset($this->backup_files_array[$fs_key])) { $backup_array[$fs_key] = $this->backup_files_array[$fs_key]; } } } // I am not certain that all the conditions in here are possible. But there's no harm. if ('finished' == $job_status) { // Add the final part of the array if ($index > 0) { $zip_file = (isset($this->backup_files_array[$youwhat]) && isset($this->backup_files_array[$youwhat][$index])) ? $this->backup_files_array[$youwhat][$index] : $backup_file_basename.'-'.$youwhat.($index+1).'.zip'; $z = $this->updraft_dir.'/'.$zip_file; $fs_key = $youwhat.$index.'-size'; $backup_array[$youwhat][$index] = $zip_file; if (file_exists($z)) { $backup_array[$fs_key] = filesize($z); } elseif (isset($this->backup_files_array[$fs_key])) { $backup_array[$fs_key] = $this->backup_files_array[$fs_key]; } } else { $zip_file = (isset($this->backup_files_array[$youwhat]) && isset($this->backup_files_array[$youwhat][0])) ? $this->backup_files_array[$youwhat][0] : $backup_file_basename.'-'.$youwhat.'.zip'; $backup_array[$youwhat] = $zip_file; $fs_key=$youwhat.'-size'; if (file_exists($zip_file)) { $backup_array[$fs_key] = filesize($zip_file); } elseif (isset($this->backup_files_array[$fs_key])) { $backup_array[$fs_key] = $this->backup_files_array[$fs_key]; } } } else { $which_entity++; $updraftplus->jobdata_set('filecreating_substatus', array('e' => $youwhat, 'i' => $which_entity, 't' => count($this->job_file_entities))); if ('others' == $youwhat) $updraftplus->log("Beginning backup of other directories found in the content directory (index: $index)"); // Apply a filter to allow add-ons to provide their own method for creating a zip of the entity $created = apply_filters('updraftplus_backup_makezip_'.$youwhat, $whichdir, $backup_file_basename, $index); // If the filter did not lead to something being created, then use the default method if ($created === $whichdir) { // http://www.phpconcept.net/pclzip/user-guide/53 / First parameter to create is: An array of filenames or dirnames, or A string containing the filename or a dirname, or A string containing a list of filename or dirname separated by a comma. / if ('others' == $youwhat) { $dirlist = $updraftplus->backup_others_dirlist(true); } elseif ('uploads' == $youwhat) { $dirlist = $updraftplus->backup_uploads_dirlist(true); } else { $dirlist = $whichdir; if (is_array($dirlist)) $dirlist = array_shift($dirlist); } if (!empty($dirlist)) { $created = $this->create_zip($dirlist, $youwhat, $backup_file_basename, $index); // Now, store the results if (!is_string($created) && !is_array($created)) $updraftplus->log("$youwhat: create_zip returned an error"); } else { $updraftplus->log("No backup of $youwhat: there was nothing found to backup"); } } if ($created != $whichdir && (is_string($created) \|\| is_array($created))) { if (is_string($created)) $created =array($created); foreach ($created as $fname) { if (isset($backup_array[$youwhat]) && in_array($fname, $backup_array[$youwhat])) continue; $backup_array[$youwhat][$index] = $fname; $itext = (0 == $index) ? '' : $index; // File may have already been uploaded and removed so get the size from jobdata if (file_exists($this->updraft_dir.'/'.$fname)) { $backup_array[$youwhat.$itext.'-size'] = filesize($this->updraft_dir.'/'.$fname); } else { $backup_array[$youwhat.$itext.'-size'] = $updraftplus->jobdata_get('filesize-'.$youwhat.$index); } $index++; } } $this->job_file_entities[$youwhat]['index'] = $this->index; $updraftplus->jobdata_set('job_file_entities', $this->job_file_entities); } } return $backup_array; } /* * This uses a saved status indicator; its only purpose is to indicate total completion; there is no actual danger, just wasted time, in resuming when it was not needed. So the saved status indicator just helps save resources. * * @param Integer $resumption_no Check for first run * * @return Array / public function resumable_backup_of_files($resumption_no) { global $updraftplus; // Backup directories and return a numerically indexed array of file paths to the backup files $bfiles_status = $updraftplus->jobdata_get('backup_files'); $this->backup_files_array = $updraftplus->jobdata_get('backup_files_array'); if (!is_array($this->backup_files_array)) $this->backup_files_array = array(); if ('finished' == $bfiles_status) { $updraftplus->log("Creation of backups of directories: already finished"); // Check for recent activity foreach ($this->backup_files_array as $files) { if (!is_array($files)) $files =array($files); foreach ($files as $file) $updraftplus->check_recent_modification($this->updraft_dir.'/'.$file); } } elseif ('begun' == $bfiles_status) { $this->first_run = apply_filters('updraftplus_filerun_firstrun', 0); if ($resumption_no > $this->first_run) { $updraftplus->log("Creation of backups of directories: had begun; will resume"); } else { $updraftplus->log("Creation of backups of directories: beginning"); } $updraftplus->jobdata_set('jobstatus', 'filescreating'); $this->backup_files_array = $this->backup_dirs($bfiles_status); $updraftplus->jobdata_set('backup_files_array', $this->backup_files_array); $updraftplus->jobdata_set('backup_files', 'finished'); $updraftplus->jobdata_set('jobstatus', 'filescreated'); } else { // This is not necessarily a backup run which is meant to contain files at all $updraftplus->log('This backup run is not intended for files - skipping'); return array(); } / // DOES NOT WORK: there is no crash-safe way to do this here - have to be renamed at cloud-upload time instead $new_backup_array = array(); foreach ($backup_array as $entity => $files) { if (!is_array($files)) $files=array($files); $outof = count($files); foreach ($files as $ind => $file) { $nval = $file; if (preg_match('/^(backup_[\-0-9]{15}_._[0-9a-f]{12}-[\-a-z]+)([0-9]+)?\.zip$/i', $file, $matches)) { $num = max((int)$matches[2],1); $new = $matches[1].$num.'of'.$outof.'.zip'; if (file_exists($this->updraft_dir.'/'.$file)) { if (@rename($this->updraft_dir.'/'.$file, $this->updraft_dir.'/'.$new)) { $updraftplus->log(sprintf("Renaming: %s to %s", $file, $new)); $nval = $new; } } elseif (file_exists($this->updraft_dir.'/'.$new)) { $nval = $new; } } $new_backup_array[$entity][$ind] = $nval; } } / return $this->backup_files_array; } /** * This function is resumable, using the following method: * Each table is written out to ($final_filename).table.tmp * When the writing finishes, it is renamed to ($final_filename).table * When all tables are finished, they are concatenated into the final file * * @param String $already_done Status of backup * @param String $whichdb Indicated which database is being backed up * @param Array $dbinfo is only used when whichdb != 'wp'; and the keys should be: user, pass, name, host, prefix * * @return Boolean\|String - the basename of the database backup, or false for failure / public function backup_db($already_done = 'begun', $whichdb = 'wp', $dbinfo = array()) { global $updraftplus, $wpdb; $this->whichdb = $whichdb; $this->whichdb_suffix = ('wp' == $whichdb) ? '' : $whichdb; if (!$updraftplus->backup_time) $updraftplus->backup_time_nonce(); if (!$updraftplus->opened_log_time) $updraftplus->logfile_open($updraftplus->nonce); if ('wp' == $this->whichdb) { $this->wpdb_obj = $wpdb; // The table prefix after being filtered - i.e. what filters what we'll actually backup $this->table_prefix = $updraftplus->get_table_prefix(true); // The unfiltered table prefix - i.e. the real prefix that things are relative to $this->table_prefix_raw = $updraftplus->get_table_prefix(false); $dbinfo['host'] = DB_HOST; $dbinfo['name'] = DB_NAME; $dbinfo['user'] = DB_USER; $dbinfo['pass'] = DB_PASSWORD; } else { if (!is_array($dbinfo) \|\| empty($dbinfo['host'])) return false; // The methods that we may use: check_connection (WP>=3.9), get_results, get_row, query $this->wpdb_obj = new UpdraftPlus_WPDB_OtherDB($dbinfo['user'], $dbinfo['pass'], $dbinfo['name'], $dbinfo['host']); if (!empty($this->wpdb_obj->error)) { $updraftplus->log($dbinfo['user'].'@'.$dbinfo['host'].'/'.$dbinfo['name'].' : database connection attempt failed'); $updraftplus->log($dbinfo['user'].'@'.$dbinfo['host'].'/'.$dbinfo['name'].' : '.__('database connection attempt failed.', 'updraftplus').' '.__('Connection failed: check your access details, that the database server is up, and that the network connection is not firewalled.', 'updraftplus'), 'error'); return $updraftplus->log_wp_error($this->wpdb_obj->error); } $this->table_prefix = $dbinfo['prefix']; $this->table_prefix_raw = $dbinfo['prefix']; } $this->dbinfo = $dbinfo; do_action('updraftplus_backup_db_begin', $whichdb, $dbinfo, $already_done, $this); UpdraftPlus_Database_Utility::set_sql_mode(array(), array('ANSI_QUOTES'), $this->wpdb_obj); $errors = 0; $use_time = apply_filters('updraftplus_base_backup_timestamp', $updraftplus->backup_time); $file_base = $this->get_backup_file_basename_from_time($use_time); $backup_file_base = $this->updraft_dir.'/'.$file_base; if ('finished' == $already_done) return basename($backup_file_base).'-db'.(('wp' == $whichdb) ? '' : $whichdb).'.gz'; if ('encrypted' == $already_done) return basename($backup_file_base).'-db'.(('wp' == $whichdb) ? '' : $whichdb).'.gz.crypt'; $updraftplus->jobdata_set('jobstatus', 'dbcreating'.$this->whichdb_suffix); $binsqldump = $updraftplus->find_working_sqldump(); $total_tables = 0; // WP 3.9 onwards - https://core.trac.wordpress.org/browser/trunk/src/wp-includes/wp-db.php?rev=27925 - check_connection() allows us to get the database connection back if it had dropped if ('wp' == $whichdb && method_exists($this->wpdb_obj, 'check_connection') && (!defined('UPDRAFTPLUS_SUPPRESS_CONNECTION_CHECKS') \|\| !UPDRAFTPLUS_SUPPRESS_CONNECTION_CHECKS)) { if (!$this->wpdb_obj->check_connection(false)) { UpdraftPlus_Job_Scheduler::reschedule(60); $updraftplus->log("It seems the database went away; scheduling a resumption and terminating for now"); UpdraftPlus_Job_Scheduler::record_still_alive(); die; } } // SHOW FULL - so that we get to know whether it's a BASE TABLE or a VIEW $all_tables = $this->wpdb_obj->get_results("SHOW FULL TABLES", ARRAY_N); if (empty($all_tables) && !empty($this->wpdb_obj->last_error)) { $all_tables = $this->wpdb_obj->get_results("SHOW TABLES", ARRAY_N); $all_tables = array_map(array($this, 'cb_get_name_base_type'), $all_tables); } else { $all_tables = array_map(array($this, 'cb_get_name_type'), $all_tables); } // If this is not the WP database, then we do not consider it a fatal error if there are no tables if ('wp' == $whichdb && 0 == count($all_tables)) { $extra = ($updraftplus->newresumption_scheduled) ? ' - '.__('please wait for the rescheduled attempt', 'updraftplus') : ''; $updraftplus->log("Error: No WordPress database tables found (SHOW TABLES returned nothing)".$extra); $updraftplus->log(__("No database tables found", 'updraftplus').$extra, 'error'); die; } // Put the options table first UpdraftPlus_Database_Utility::init($this->whichdb, $this->table_prefix_raw, $this->wpdb_obj); usort($all_tables, array('UpdraftPlus_Database_Utility', 'backup_db_sorttables')); $all_table_names = array_map(array($this, 'cb_get_name'), $all_tables); if (!UpdraftPlus_Filesystem_Functions::really_is_writable($this->updraft_dir)) { $updraftplus->log("The backup directory (".$this->updraft_dir.") could not be written to (could be account/disk space full, or wrong permissions)."); $updraftplus->log($this->updraft_dir.": ".__('The backup directory is not writable (or disk space is full) - the database backup is expected to shortly fail.', 'updraftplus'), 'warning'); // Why not just fail now? We saw a bizarre case when the results of really_is_writable() changed during the run. } // This check doesn't strictly get all possible duplicates; it's only designed for the case that can happen when moving between deprecated Windows setups and Linux $this->duplicate_tables_exist = false; foreach ($all_table_names as $table) { if (strtolower($table) != $table && in_array(strtolower($table), $all_table_names)) { $this->duplicate_tables_exist = true; $updraftplus->log("Tables with names differing only based on case-sensitivity exist in the MySQL database: $table / ".strtolower($table)); } } $how_many_tables = count($all_tables); $stitch_files = array(); $found_options_table = false; $is_multisite = is_multisite(); $anonymisation_options = $updraftplus->jobdata_get('anonymisation_options', array()); if (!empty($anonymisation_options)) { $updraftplus->log("Anonymisation options have been set, so mysqldump (which does not support them) will be disabled."); } // Gather the list of files that look like partial table files once only $potential_stitch_files = array(); $table_file_prefix_base= $file_base.'-db'.$this->whichdb_suffix.'-table-'; if (false !== ($dir_handle = opendir($this->updraft_dir))) { while (false !== ($e = readdir($dir_handle))) { // The 'r' in 'tmpr' indicates that the new scheme is being used. N.B. That does not* imply that the table has a usable primary key. if (!is_file($this->updraft_dir.'/'.$e)) continue; if (preg_match('#'.$table_file_prefix_base.'.\.table\.tmpr?(\d+)\.gz$#', $e, $matches)) { // We need to stich them in order $potential_stitch_files[] = $e; } } } else { $updraftplus->log("Error: Failed to open directory for reading"); $updraftplus->log(__("Failed to open directory for reading:", 'updraftplus').' '.$this->updraft_dir, 'error'); } $errors_at_all_tables_start = $updraftplus->error_count(); foreach ($all_tables as $ti) { $table = $ti['name']; $stitch_files[$table] = array(); $table_type = $ti['type']; $errors_at_table_start = $updraftplus->error_count(); $this->many_rows_warning = false; $total_tables++; // Increase script execution time-limit to 15 min for every table. if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // The table file may already exist if we have produced it on a previous run $table_file_prefix = $file_base.'-db'.$this->whichdb_suffix.'-table-'.$table.'.table'; if ('wp' == $whichdb && (strtolower($this->table_prefix_raw.'options') == strtolower($table) \|\| ($is_multisite && (strtolower($this->table_prefix_raw.'sitemeta') == strtolower($table) \|\| strtolower($this->table_prefix_raw.'1_options') == strtolower($table))))) $found_options_table = true; // Already finished? if (file_exists($this->updraft_dir.'/'.$table_file_prefix.'.gz')) { $stitched = count($stitch_files, COUNT_RECURSIVE); $skip_dblog = (($stitched > 10 && 0 != $stitched % 20) \|\| ($stitched > 100 && 0 != $stitched % 100)); $updraftplus->log("Table $table: corresponding file already exists; moving on", 'notice', false, $skip_dblog); $max_record = false; foreach ($potential_stitch_files as $e) { // The 'r' in 'tmpr' indicates that the new scheme is being used. N.B. That does not* imply that the table has a usable primary key. if (preg_match('#'.$table_file_prefix.'\.tmpr?(\d+)\.gz$#', $e, $matches)) { // We need to stich them in order $stitch_files[$table][$matches[1]] = $e; if (false === $max_record \|\| $matches[1] > $max_record) $max_record = $matches[1]; } } $stitch_files[$table][$max_record+1] = $table_file_prefix.'.gz'; // Move on to the next table continue; } // === is needed with strpos/stripos, otherwise 'false' matches (i.e. prefix does not match) if (empty($this->table_prefix) \|\| (!$this->duplicate_tables_exist && 0 === stripos($table, $this->table_prefix)) \|\| ($this->duplicate_tables_exist && 0 === strpos($table, $this->table_prefix))) { // Skip table due to filter? if (!apply_filters('updraftplus_backup_table', true, $table, $this->table_prefix, $whichdb, $dbinfo)) { $updraftplus->log("Skipping table (filtered): $table"); if (empty($this->skipped_tables)) $this->skipped_tables = array(); // whichdb could be an int in which case to get the name of the database and the array key use the name from dbinfo $key = ('wp' === $whichdb) ? 'wp' : $dbinfo['name']; if (empty($this->skipped_tables[$key])) $this->skipped_tables[$key] = array(); $this->skipped_tables[$key][] = $table; $total_tables--; continue; } add_filter('updraftplus_backup_table_sql_where', array($this, 'backup_exclude_jobdata'), 3, 10); $updraftplus->jobdata_set('dbcreating_substatus', array('t' => $table, 'i' => $total_tables, 'a' => $how_many_tables)); // .tmp.gz is the current temporary file. When the row limit has been reached, it is moved to .tmp1.gz, .tmp2.gz, etc. (depending on which already exist). When we're all done, then they all get stitched in. $db_temp_file = $this->updraft_dir.'/'.$table_file_prefix.'.tmp.gz'; $updraftplus->check_recent_modification($db_temp_file); // Open file, store the handle if (false === $this->backup_db_open($db_temp_file, true)) return false; $table_status = $this->wpdb_obj->get_row("SHOW TABLE STATUS WHERE Name='$table'"); // Create the preceding SQL statements for the table $this->stow("# " . sprintf('Table: %s', UpdraftPlus_Manipulation_Functions::backquote($table)) . "\n"); // Meaning: false = don't yet know; true = know and have logged it; integer = the expected number $this->expected_rows = false; if (isset($table_status->Rows)) { $this->expected_rows = $table_status->Rows; } // If no check-in last time, then we could in future try the other method (but - any point in retrying slow method on large tables??) // New Jul 2014: This attempt to use bindump instead at a lower threshold is quite conservative - only if the last successful run was exactly two resumptions ago - may be useful to expand $bindump_threshold = (!$updraftplus->something_useful_happened && !empty($updraftplus->current_resumption) && (2 == $updraftplus->current_resumption - $updraftplus->last_successful_resumption)) ? 1000 : 8000; if (isset($table_status->Rows) && ($table_status->Rows > $bindump_threshold \|\| (defined('UPDRAFTPLUS_ALWAYS_TRY_MYSQLDUMP') && UPDRAFTPLUS_ALWAYS_TRY_MYSQLDUMP)) && is_string($binsqldump) && empty($anonymisation_options)) { if (!is_bool($this->expected_rows)) { $this->log_expected_rows($table, $this->expected_rows); $this->expected_rows = true; } $bindump = $this->backup_table_bindump($binsqldump, $table); } else { $bindump = false; } // Means "start of table". N.B. The meaning of an integer depends upon whether the table has a usable primary key or not. $start_record = true; $can_use_primary_key = apply_filters('updraftplus_can_use_primary_key_default', true, $table); foreach ($potential_stitch_files as $e) { // The 'r' in 'tmpr' indicates that the new scheme is being used. N.B. That does not imply that the table has a usable primary key. if (preg_match('#'.$table_file_prefix.'\.tmp(r)?(\d+)\.gz$#', $e, $matches)) { $stitch_files[$table][$matches[2]] = $e; if (true === $start_record \|\| $matches[2] > $start_record) $start_record = $matches[2]; // Legacy scheme. The purpose of this is to prevent backups failing if one is in progress during an upgrade to a new version that implements the new scheme if ('r' !== $matches[1]) $can_use_primary_key = false; } } // Legacy file-naming scheme in use if (false === $can_use_primary_key && true !== $start_record) { $start_record = ($start_record + 100) * 1000; } if (true !== $bindump) { while (!is_array($start_record) && !is_wp_error($start_record)) { $start_record = $this->backup_table($table, $table_type, $start_record, $can_use_primary_key); if (is_integer($start_record) \|\| is_array($start_record)) { $this->backup_db_close(); // Add one here in case no records were returned - don't want to over-write the previous file $use_record = is_array($start_record) ? (isset($start_record['next_record']) ? $start_record['next_record']+1 : false) : $start_record; if (!$can_use_primary_key) $use_record = (ceil($use_record/100000)-1) * 100; if (false !== $use_record) { // N.B. Renaming using the next record is intentional - it allows UD to know where to resume from. $rename_base = $table_file_prefix.'.tmp'.($can_use_primary_key ? 'r' : '').$use_record.'.gz'; rename($db_temp_file, $this->updraft_dir.'/'.$rename_base); $stitch_files[$table][$use_record] = $rename_base; } elseif (is_array($start_record) && 'view' == strtolower($table_type)) { $rename_base = $table_file_prefix.'-view.tmp.gz'; rename($db_temp_file, $this->updraft_dir.'/'.$rename_base); $stitch_files[$table][] = $rename_base; } UpdraftPlus_Job_Scheduler::something_useful_happened(); if (false === $this->backup_db_open($db_temp_file, true)) return false; } elseif (is_wp_error($start_record)) { $message = "Error (table=$table, type=$table_type) (".$start_record->get_error_code()."): ".$start_record->get_error_message(); $updraftplus->log($message); // If it's a view, then the problem isn't recoverable; but views don't contain actual data except in the definition, which is likely in code, so we should not consider this a fatal error $level = 'error'; if ('view' == strtolower($table_type) && 'table_details_error' == $start_record->get_error_code()) { $level = 'warning'; $this->stow("# $message\n"); } $updraftplus->log(__("Failed to backup database table:", 'updraftplus').' '.$start_record->get_error_message().' ('.$start_record->get_error_code().')', $level); } } } // If we got this far, then there were enough resources; the warning can be removed if (!empty($this->many_rows_warning)) $updraftplus->log_remove_warning('manyrows_'.$this->whichdb_suffix.$table); $this->backup_db_close(); if ($updraftplus->error_count() > $errors_at_table_start) { $updraftplus->log('Errors occurred during backing up the table; therefore the open file will be removed'); @unlink($db_temp_file); // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } else { // Renaming the file indicates that writing to it finished rename($db_temp_file, $this->updraft_dir.'/'.$table_file_prefix.'.gz'); UpdraftPlus_Job_Scheduler::something_useful_happened(); $final_stitch_value = empty($stitch_files[$table]) ? 1 : max(array_keys($stitch_files[$table])) + 1; $stitch_files[$table][$final_stitch_value] = $table_file_prefix.'.gz'; $total_db_size = 0; // This is more verbose than it would be if we weren't supporting PHP 5.2 foreach ($stitch_files[$table] as $basename) { $total_db_size += filesize($this->updraft_dir.'/'.$basename); } $updraftplus->log("Table $table: finishing file(s) (".count($stitch_files[$table]).', '.round($total_db_size/1024, 1).' KB)', 'notice', false, false); } } else { $total_tables--; $updraftplus->log("Skipping table (lacks our prefix (".$this->table_prefix.")): $table"); if (empty($this->skipped_tables)) $this->skipped_tables = array(); // whichdb could be an int in which case to get the name of the database and the array key use the name from dbinfo $key = ('wp' === $whichdb) ? 'wp' : $dbinfo['name']; if (empty($this->skipped_tables[$key])) $this->skipped_tables[$key] = array(); $this->skipped_tables[$key][] = $table; } } if ('wp' == $whichdb) { if (!$found_options_table) { if ($is_multisite) { $updraftplus->log(__('The database backup has failed', 'updraftplus').' - '.__('no options or sitemeta table was found', 'updraftplus'), 'warning', 'optstablenotfound'); } else { $updraftplus->log(__('The database backup has failed', 'updraftplus').' - '.__('the options table was not found', 'updraftplus'), 'warning', 'optstablenotfound'); } $time_this_run = time()-$updraftplus->opened_log_time; if ($time_this_run > 2000) { // Have seen this happen; not sure how, but it was apparently deterministic; if the current process had been running for a long time, then apparently all database commands silently failed. // If we have been running that long, then the resumption may be far off; bring it closer UpdraftPlus_Job_Scheduler::reschedule(60); $updraftplus->log("Have been running very long, and it seems the database went away; scheduling a resumption and terminating for now"); UpdraftPlus_Job_Scheduler::record_still_alive(); die; } } else { $updraftplus->log_remove_warning('optstablenotfound'); } } if ($updraftplus->error_count() > $errors_at_all_tables_start) { $updraftplus->log('Errors occurred whilst backing up the tables; will cease and wait for resumption'); die; } // Race detection - with zip files now being resumable, these can more easily occur, with two running side-by-side $backup_final_file_name = $backup_file_base.'-db'.$this->whichdb_suffix.'.gz'; $time_now = time(); $time_mod = (int) @filemtime($backup_final_file_name);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (file_exists($backup_final_file_name) && $time_mod>100 && ($time_now-$time_mod)<30) { UpdraftPlus_Job_Scheduler::terminate_due_to_activity($backup_final_file_name, $time_now, $time_mod); } if (file_exists($backup_final_file_name)) { $updraftplus->log("The final database file ($backup_final_file_name) exists, but was not modified within the last 30 seconds (time_mod=$time_mod, time_now=$time_now, diff=".($time_now-$time_mod)."). Thus we assume that another UpdraftPlus terminated; thus we will continue."); } // Finally, stitch the files together if (!function_exists('gzopen')) { $updraftplus->log("PHP function is disabled; abort expected: gzopen()"); } $decompress_mode = (defined('UPDRAFTPLUS_DB_STICH_DECOMPRESS') && UPDRAFTPLUS_DB_STICH_DECOMPRESS); if (false === $this->backup_db_open($backup_final_file_name, true)) return false; $this->backup_db_header(); // Re-open in plain binary append mode if (!$decompress_mode) { $this->backup_db_close(); if (false === $this->backup_db_open($backup_final_file_name, false, true)) return false; } // We delay the unlinking because if two runs go concurrently and fail to detect each other (should not happen, but there's no harm in assuming the detection failed) then that would lead to files missing from the db dump $unlink_files = array(); $sind = 1; // Happily they have the same syntax (as far as we need it) // Concatenating gz files produces a valid gz file. So, decompressing is not necessary. We retain the possibility for debugging and the possibility of broken implementations. $open_function = $decompress_mode ? 'gzopen' : 'fopen'; $fgets_function = $decompress_mode ? 'gzgets' : 'fgets'; $close_function = $decompress_mode ? 'gzclose' : 'fclose'; foreach ($stitch_files as $table => $table_stitch_files) { ksort($table_stitch_files); foreach ($table_stitch_files as $table_file) { $updraftplus->log("{$table_file} ($sind/$how_many_tables/$open_function): adding to final database dump"); if (filesize($this->updraft_dir.'/'.$table_file) < 27 && '.gz' == substr($table_file, -3, 3)) { // It's a null gzip file. Don't waste time on gzopen/gzgets/gzclose. This micro-optimisation was added after seeing a site with >3000 files that was running out of time (it could apparently process 30 files/second) $unlink_files[] = $this->updraft_dir.'/'.$table_file; } elseif (!$handle = call_user_func($open_function, $this->updraft_dir.'/'.$table_file, 'r')) { $updraftplus->log("Error: Failed to open database file for reading: {$table_file}"); $updraftplus->log(__("Failed to open database file for reading:", 'updraftplus').' '.$table_file, 'error'); $errors++; } else { while ($line = call_user_func($fgets_function, $handle, 65536)) { $this->stow($line); } call_user_func($close_function, $handle); $unlink_files[] = $this->updraft_dir.'/'.$table_file; } $sind++; // Came across a database with 7600 tables... adding them all took over 500 seconds; and so when the resumption started up, no activity was detected if (0 == $sind % 100) UpdraftPlus_Job_Scheduler::something_useful_happened(); } } // Re-open in gz append mode if (!$decompress_mode) { $this->backup_db_close(); if (false === $this->backup_db_open($backup_final_file_name, true, true)) return false; } // DB triggers if ($this->wpdb_obj->get_results("SHOW TRIGGERS")) { // N.B. DELIMITER is not a valid SQL command; you cannot pass it to the server. It has to be interpreted by the interpreter - e.g. /usr/bin/mysql, or UpdraftPlus, and used to interpret what follows. The effect of this is that using it means that some SQL clients will stumble; but, on the other hand, failure to use it means that others that don't have special support for CREATE TRIGGER may stumble, because they may feed incomplete statements to the SQL server. Since /usr/bin/mysql uses it, we choose to support it too (both reading and writing). // Whatever the delimiter is set to needs to be used in the DROP TRIGGER and CREATE TRIGGER commands in this section further down. $this->stow("DELIMITER ;;\n\n"); foreach ($all_tables as $ti) { $table = $ti['name']; if (!empty($this->skipped_tables)) { if ('wp' == $this->whichdb) { if (in_array($table, $this->skipped_tables['wp'])) continue; } elseif (isset($this->skipped_tables[$this->dbinfo['name']])) { if (in_array($table, $this->skipped_tables[$this->dbinfo['name']])) continue; } } $table_triggers = $this->wpdb_obj->get_results($wpdb->prepare("SHOW TRIGGERS LIKE %s", $table), ARRAY_A); if ($table_triggers) { $this->stow("\n\n# Triggers of ".UpdraftPlus_Manipulation_Functions::backquote($table)."\n\n"); foreach ($table_triggers as $trigger) { $trigger_name = $trigger['Trigger']; $trigger_time = $trigger['Timing']; $trigger_event = $trigger['Event']; $trigger_statement = $trigger['Statement']; // Since trigger name can include backquotes and trigger name is typically enclosed with backquotes as well, the backquote escaping for the trigger name can be done by adding a leading backquote $quoted_escaped_trigger_name = UpdraftPlus_Manipulation_Functions::backquote(str_replace('`', '``', $trigger_name)); $this->stow("DROP TRIGGER IF EXISTS $quoted_escaped_trigger_name;;\n"); $trigger_query = "CREATE TRIGGER $quoted_escaped_trigger_name $trigger_time $trigger_event ON ".UpdraftPlus_Manipulation_Functions::backquote($table)." FOR EACH ROW $trigger_statement;;"; $this->stow("$trigger_query\n\n"); } } } $this->stow("DELIMITER ;\n\n"); } // DB Stored Routines $stored_routines = UpdraftPlus_Database_Utility::get_stored_routines(); if (is_array($stored_routines) && !empty($stored_routines)) { $stored_routines_log = $inaccessible_routines = ''; $stored_routines_delimiter_printed = false; $updraftplus->log("Dumping routines for database {$this->dbinfo['name']}"); foreach ($stored_routines as $routine) { if (empty($routine['Create '.ucfirst(strtolower($routine['Type']))])) { // The value displayed for the Create Procedure or Create Function field is NULL if the WP database user has only CREATE ROUTINE, ALTER ROUTINE, and/or EXECUTE privileges. @see https://dev.mysql.com/doc/refman/8.0/en/show-create-procedure.html $inaccessible_routines = $inaccessible_routines ? $inaccessible_routines.', '.$routine['Name'] : $routine['Name']; continue; } $stored_routines_log = "Dumping routine: {$routine['Name']}"; if (!$stored_routines_delimiter_printed) { $this->stow("\n\n# Dumping routines for database ".UpdraftPlus_Manipulation_Functions::backquote($this->dbinfo['name'])."\n\n"); $this->stow("DELIMITER ;;\n\n"); $stored_routines_delimiter_printed = true; } $routine_name = $routine['Name']; // Since routine name can include backquotes and routine name is typically enclosed with backquotes as well, the backquote escaping for the routine name can be done by adding a leading backquote $quoted_escaped_routine_name = UpdraftPlus_Manipulation_Functions::backquote(str_replace('`', '``', $routine_name)); $this->stow("DROP {$routine['Type']} IF EXISTS $quoted_escaped_routine_name;;\n\n"); $this->stow($routine['Create '.ucfirst(strtolower($routine['Type']))]."\n\n;;\n\n"); $updraftplus->log($stored_routines_log." - (Successful)"); } if ($inaccessible_routines) { $updraftplus->log(__('Dumping routines: ', 'updraftplus') . "({$inaccessible_routines})" . " - (". __('Failed', 'updraftplus') . " - " . __("Your WordPress database user doesn't have sufficient privileges to read these stored routines.", 'updraftplus') . " " .__('To be able to backup the routines, you must be the user named as the routine DEFINER(s), have the SHOW_ROUTINE privilege (for MySQL 8.0.20+ users), have the SELECT privilege at the global level, or have the CREATE ROUTINE, ALTER ROUTINE, or EXECUTE privilege granted at a scope that includes the routines.', 'updraftplus'). ")", 'warning'); } if ($stored_routines_delimiter_printed) $this->stow("DELIMITER ;\n\n"); } elseif (is_wp_error($stored_routines)) { $updraftplus->log($stored_routines->get_error_message()); } $this->stow("/!40101 SET CHARACTER_SET_CLIENT=@OLD_CHARACTER_SET_CLIENT /;\n"); $this->stow("/!40101 SET CHARACTER_SET_RESULTS=@OLD_CHARACTER_SET_RESULTS /;\n"); $this->stow("/!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION /;\n"); $this->stow("/!40101 SET SQL_MODE=@OLD_SQL_MODE /;\n"); $updraftplus->log($file_base.'-db'.$this->whichdb_suffix.'.gz: finished writing out complete database file ('.round(filesize($backup_final_file_name)/1024, 1).' KB)'); if (!$this->backup_db_close()) { $updraftplus->log('An error occurred whilst closing the final database file'); $updraftplus->log(__('An error occurred whilst closing the final database file', 'updraftplus'), 'error'); $errors++; } foreach ($unlink_files as $unlink_file) { @unlink($unlink_file);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } if ($errors > 0) return false; // We no longer encrypt here - because the operation can take long, we made it resumable and moved it to the upload loop $updraftplus->jobdata_set('jobstatus', 'dbcreated'.$this->whichdb_suffix); $checksums = $updraftplus->which_checksums(); $checksum_description = ''; foreach ($checksums as $checksum) { $cksum = hash_file($checksum, $backup_final_file_name); $updraftplus->jobdata_set($checksum.'-db'.(('wp' == $whichdb) ? '0' : $whichdb.'0'), $cksum); if ($checksum_description) $checksum_description .= ', '; $checksum_description .= "$checksum: $cksum"; } $updraftplus->log("Total database tables backed up: $total_tables (".basename($backup_final_file_name).", size: ".filesize($backup_final_file_name).", $checksum_description)"); return basename($backup_final_file_name); } /** * Log the number of expected rows (both to the backup log, and database backup file) * * @param String $table - table name * @param Integer $expected_rows - number of rows * @param Boolean $via_count - if the expected number comes via a SELECT COUNT() call * @param Boolean $log_in_backup - whether to log in the backup file (not just the backup log file) / private function log_expected_rows($table, $expected_rows, $via_count = false, $log_in_backup = true) { global $updraftplus; $description = $via_count ? 'via COUNT' : 'approximate'; $updraftplus->log("Table $table: Total expected rows ($description): ".$expected_rows); if ($log_in_backup) $this->stow("# Approximate rows expected in table: $expected_rows\n"); if ($expected_rows > UPDRAFTPLUS_WARN_DB_ROWS) { $this->many_rows_warning = true; $updraftplus->log(sprintf(__("Table %s has very many rows (%s) - we hope your web hosting company gives you enough resources to dump out that table in the backup.", 'updraftplus'), $table, $expected_rows).' '.__('If not, you will need to either remove data from this table, or contact your hosting company to request more resources.', 'updraftplus'), 'warning', 'manyrows_'.$this->whichdb_suffix.$table); } } /* * This function will return a SQL WHERE clause to exclude updraft jobdata * * @param array $where - an array of where clauses to add to * @param string $table - the table we want to add a where clause for * * @return array - returns an array of where clauses for the table / public function backup_exclude_jobdata($where, $table) { // Don't include the job data for any backups - so that when the database is restored, it doesn't continue an apparently incomplete backup global $updraftplus; $table_prefix = $updraftplus->get_table_prefix(false); // or we can just use $this->table_prefix_raw ?? if ('wp' == $this->whichdb && (!empty($table_prefix) && strtolower($table_prefix.'sitemeta') == strtolower($table))) { $where[] = 'meta_key NOT LIKE "updraft_jobdata_%"'; } elseif ('wp' == $this->whichdb && (!empty($table_prefix) && strtolower($table_prefix.'options') == strtolower($table))) { // These might look similar, but the quotes are different if ('win' == strtolower(substr(PHP_OS, 0, 3))) { $updraft_jobdata = "'updraft_jobdata_%'"; $site_transient_update = "'_site_transient_update_%'"; } else { $updraft_jobdata = '"updraft_jobdata_%"'; $site_transient_update = '"_site_transient_update_%"'; } $where[] = 'option_name NOT LIKE '.$updraft_jobdata.' AND option_name NOT LIKE '.$site_transient_update.''; } return $where; } /* * Produce a dump of the table using a mysqldump binary * * @param String $potsql - the path to the mysqldump binary * @param String $table_name - the name of the table being dumped * * @return Boolean - success status / private function backup_table_bindump($potsql, $table_name) { $microtime = microtime(true); global $updraftplus, $wpdb; // Deal with Windows/old MySQL setups with erroneous table prefixes differing in case // Can't get binary mysqldump to make this transformation // $dump_as_table = ($this->duplicate_tables_exist == false && stripos($table, $this->table_prefix) === 0 && strpos($table, $this->table_prefix) !== 0) ? $this->table_prefix.substr($table, strlen($this->table_prefix)) : $table; $pfile = md5(time().rand()).'.tmp'; file_put_contents($this->updraft_dir.'/'.$pfile, "[mysqldump]\npassword=\"".addslashes($this->dbinfo['pass'])."\"\n"); $where_array = apply_filters('updraftplus_backup_table_sql_where', array(), $table_name, $this); if ('win' === strtolower(substr(PHP_OS, 0, 3))) { // On Windows, the PHP escapeshellarg() replaces % char with white space, so we change the % char to [percent_sign] but change it back later after escapeshellarg finish processing it $where_array = str_replace('%', '[percent_sign]', $where_array); } $where = ''; if (!empty($where_array) && is_array($where_array)) { // N.B. Don't add a WHERE prefix here; most versions of mysqldump silently strip it out, but one was encountered that didn't. $first_loop = true; foreach ($where_array as $condition) { if (!$first_loop) $where .= " AND "; $where .= $condition; $first_loop = false; } } // Note: escapeshellarg() adds quotes around the string if ($where) $where = "--where=".escapeshellarg($where); if ('' !== $where && 'win' === strtolower(substr(PHP_OS, 0, 3))) { // change the [percent_sign] back to % char $where = str_replace('[percent_sign]', '%', $where); } if (strtolower(substr(PHP_OS, 0, 3)) == 'win') { $exec = "cd ".escapeshellarg(str_replace('/', '\\', $this->updraft_dir))." & "; } else { $exec = "cd ".escapeshellarg($this->updraft_dir)."; "; } // Allow --max_allowed_packet to be configured via constant. Experience has shown some customers with complex CMS or pagebuilder setups can have very large postmeta entries. $msqld_max_allowed_packet = (defined('UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET') && (is_int(UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET) \|\| is_string(UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET))) ? UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET : '12M'; $exec .= "$potsql --defaults-file=$pfile $where --max-allowed-packet=$msqld_max_allowed_packet --quote-names --add-drop-table"; static $mysql_version = null; if (null === $mysql_version) { $mysql_version = $wpdb->get_var('SELECT VERSION()'); if ('' == $mysql_version) $mysql_version = $wpdb->db_version(); } if ($mysql_version && version_compare($mysql_version, '5.1', '>=')) { $exec .= " --no-tablespaces"; } $exec .= " --skip-comments --skip-set-charset --allow-keywords --dump-date --extended-insert --user=".escapeshellarg($this->dbinfo['user'])." "; $host = $this->dbinfo['host']; if (preg_match('#^(.):(\d+)$#', $host, $matches)) { // The escapeshellarg() on $matches[2] is only to avoid tripping static analysis tools $exec .= "--host=".escapeshellarg($matches[1])." --port=".escapeshellarg($matches[2])." "; } elseif (preg_match('#^(.):(.)$#', $host, $matches) && file_exists($matches[2])) { $exec .= "--host=".escapeshellarg($matches[1])." --socket=".escapeshellarg($matches[2])." "; } else { $exec .= "--host=".escapeshellarg($host)." "; } $exec = apply_filters('updraftplus_mysqldump_arguments', $exec, $table_name, $potsql); $exec .= $this->dbinfo['name']." ".escapeshellarg($table_name); $ret = false; $any_output = false; $gtid_found = false; $writes = 0; $write_bytes = 0; $handle = (function_exists('popen') && function_exists('pclose')) ? popen($exec, 'r') : false; if ($handle) { while (!feof($handle)) { $w = fgets($handle, 1048576); if (is_string($w) && $w) { if (preg_match('/^SET @@GLOBAL.GTID_PURGED/i', $w)) $gtid_found = true; if ($gtid_found) { if (false !== strpos($w, ';')) $gtid_found = false; continue; } $this->stow($w); $writes++; $write_bytes += strlen($w); $any_output = true; } } $ret = pclose($handle); // The manual page for pclose() claims that only -1 indicates an error, but this is untrue if (0 != $ret) { $updraftplus->log("Binary mysqldump: error (code: $ret)"); // Keep counter of failures? Change value of binsqldump? $ret = false; } else { if ($any_output) { $updraftplus->log("Table $table_name: binary mysqldump finished (writes: $writes, bytes $write_bytes, return code $ret) in ".sprintf("%.02f", max(microtime(true)-$microtime, 0.00001))." seconds"); $ret = true; } } } else { $updraftplus->log("Binary mysqldump error: bindump popen failed"); } // Clean temporary files @unlink($this->updraft_dir.'/'.$pfile);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. return $ret; } /** * Write out the initial backup information for a table to the currently open file * * @param String $table - Full name of database table to backup * @param String $dump_as_table - Table name to use when writing out * @param String $table_type - Table type - 'VIEW' is supported; otherwise it is treated as an ordinary table * @param Array $table_structure - Table structure as returned by a DESCRIBE command / private function write_table_backup_beginning($table, $dump_as_table, $table_type, $table_structure) { $this->stow("\n# Delete any existing table ".UpdraftPlus_Manipulation_Functions::backquote($table)."\n\nDROP TABLE IF EXISTS " . UpdraftPlus_Manipulation_Functions::backquote($dump_as_table).";\n"); if ('VIEW' == $table_type) { $this->stow("DROP VIEW IF EXISTS " . UpdraftPlus_Manipulation_Functions::backquote($dump_as_table) . ";\n"); } $description = ('VIEW' == $table_type) ? 'view' : 'table'; $this->stow("\n# Table structure of $description ".UpdraftPlus_Manipulation_Functions::backquote($table)."\n\n"); $create_table = $this->wpdb_obj->get_results("SHOW CREATE TABLE ".UpdraftPlus_Manipulation_Functions::backquote($table), ARRAY_N); if (false === $create_table) { $this->stow("#\n# Error with SHOW CREATE TABLE for $table\n#\n"); } $create_line = UpdraftPlus_Manipulation_Functions::str_lreplace('TYPE=', 'ENGINE=', $create_table[0][1]); // Remove PAGE_CHECKSUM parameter from MyISAM - was internal, undocumented, later removed (so causes errors on import) if (preg_match('/ENGINE=([^\s;]+)/', $create_line, $eng_match)) { $engine = $eng_match[1]; if ('myisam' == strtolower($engine)) { $create_line = preg_replace('/PAGE_CHECKSUM=\d\s?/', '', $create_line, 1); } } if ($dump_as_table !== $table) $create_line = UpdraftPlus_Manipulation_Functions::str_replace_once($table, $dump_as_table, $create_line); $this->stow($create_line.' ;'); if (false === $table_structure) { $this->stow("#\n# Error getting $description structure of $table\n#\n"); } // Add a comment preceding the beginning of the data $this->stow("\n\n# ".sprintf("Data contents of $description %s", UpdraftPlus_Manipulation_Functions::backquote($table))."\n\n"); } /* * Suggest a beginning value for how many rows to fetch in each SELECT statement (before taking into account resumptions) * * @param String $table - the full table name * * @return Integer / private function get_rows_on_first_fetch($table) { // In future, we could run over the table definition; if it is all non-massive defined lengths, we could base a calculation on that. if ($this->table_prefix_raw.'term_relationships' == $table) { // This table is known to have very small data lengths $rows = 100000; } elseif (preg_match('/meta$/i', $table)) { // Meta-data rows tend to be short on average. 10MB / 4000 rows = 2.6KB/row, so this is still quite conservative. $rows = 4000; } else { // The very conservative default $rows = 1000; } return $rows; } /* * Suggest how many rows to fetch in each SELECT statement * * @param String $table - the table being fetched * @param Boolean $allow_further_reductions - whether to enable a second level of reductions (i.e. even less rows) * @param Boolean $is_first_fetch_for_table - whether this is the first fetch on this table * @param Integer\|Boolean $expected_rows - if an integer, an estimate of the number of rows * @param Boolean $expected_via_count - if $expected_rows is an integer, then this indicates whether the estimate was made via a SELECT COUNT() statement * * @return Integer / private function number_of_rows_to_fetch($table, $allow_further_reductions, $is_first_fetch_for_table, $expected_rows = false, $expected_via_count = false) { global $updraftplus; // This used to be fixed at 500; but we (after a long time) saw a case that looked like an out-of-memory even at this level. Now that we have implemented resumptions, the risk of timeouts is much lower (we just need to process enough rows). // October 2020: added further reductions // Listed in increasing order due to the handling below. At the end it gets quite drastic. Note, though, that currently we don't store this in the job-data. // A future improvement could, when things get drastic, grab and log data on the size of what is required, so that we can respond more dynamically. The strategy currently here will run out of road if memory falls short multiple times. See: https://stackoverflow.com/questions/4524019/how-to-get-the-byte-size-of-resultset-in-an-sql-query $fetch_rows_reductions = array(500, 250, 200, 100); $default_on_first_fetch = $this->get_rows_on_first_fetch($table); $known_bigger_than_table = (!is_bool($expected_rows) && $expected_rows && $expected_via_count && $default_on_first_fetch > 2 $expected_rows); if ($known_bigger_than_table) $allow_further_reductions = true; if ($allow_further_reductions) { // If we're relying on LIMIT with offsets, then we have to be mindful of how that performs $fetch_rows_reductions = array_merge($fetch_rows_reductions, array(50, 20, 5)); } // Remove any that are far out of range if ($known_bigger_than_table) { foreach ($fetch_rows_reductions as $k => $reduce_to) { if ($reduce_to > $expected_rows * 2 && count($fetch_rows_reductions) > 2) { unset($fetch_rows_reductions[$k]); } } } // If this is not the first fetch on a table, then get what was stored last time we set it (if we ever did). On the first fetch, reset back to the starting value (we presume problems are table-specific). // This means that the same value will persist whilst the table is being backed up, both during the current resumption, and subsequent ones $fetch_rows = $is_first_fetch_for_table ? $default_on_first_fetch : $updraftplus->jobdata_get('fetch_rows', $default_on_first_fetch); $fetch_rows_at_start = $fetch_rows; $resumptions_since_last_successful = $updraftplus->current_resumption - $updraftplus->last_successful_resumption; // Do we need to reduce the number of rows we attempt to fetch? // If something useful has happened on this run, then we don't try any reductions (we save them for a resumption after one on which nothing useful happened) if ($known_bigger_than_table \|\| (!$updraftplus->something_useful_happened && !empty($updraftplus->current_resumption) && $resumptions_since_last_successful > 1)) { $break_after = $is_first_fetch_for_table ? max($resumptions_since_last_successful - 1, 1) : 1; foreach ($fetch_rows_reductions as $reduce_to) { if ($fetch_rows > $reduce_to) { // Go down one level $fetch_rows = $reduce_to; $break_after--; if ($break_after < 1) break; } } $log_start = $updraftplus->current_resumption ? "Last successful resumption was $resumptions_since_last_successful runs ago" : "Table is relatively small"; $updraftplus->log("$log_start; fetch_rows will thus be: $fetch_rows (allow_further_reductions=$allow_further_reductions, is_first_fetch=$is_first_fetch_for_table, known_bigger_than_table=$known_bigger_than_table)"); } // If it has changed, then preserve it in the job for the next resumption (of this table) if ($fetch_rows_at_start !== $fetch_rows \|\| $is_first_fetch_for_table) $updraftplus->jobdata_set('fetch_rows', $fetch_rows); return apply_filters('updraftplus_number_of_rows_to_fetch', $fetch_rows, $table, $allow_further_reductions, $is_first_fetch_for_table, $expected_rows, $expected_via_count); } /** * Return a list of primary keys (N.B. the method should not be called unless the caller already knows that the table has a single/simple primary key) for rows that have "over-sized" data. * Currently this only examines the "posts" table and any other table with a longtext type, which are the primary causes of problems. If others are revealed in future, it can be generalised (e.g. examine the whole definition/all cells). * * @param String $table - the full table name * @param Array $structure - the table structure, as from WPDB::get_results("DESCRIBE ..."); * @param String $primary_key - the primary key to use; required if $structure is set (slightly redundant, since it can be derived from structure) * * @return Array - list of IDs / private function get_oversized_rows($table, $structure = array(), $primary_key = '') { if ($this->table_prefix_raw.'posts' != $table) { if (empty($structure) \|\| '' === $primary_key) return array(); foreach ($structure as $item) { if ('' !== $item->Field && 'longtext' === $item->Type) { $use_field = $item->Field; } } } else { $primary_key = 'id'; $use_field = 'post_content'; } if (!isset($use_field)) return array(); global $updraftplus; // Look for the jobdata_delete() call elsewhere in this class - the key name needs to match $jobdata_key = 'oversized_rows_'.$table; $oversized_list = $updraftplus->jobdata_get($jobdata_key); if (is_array($oversized_list)) return $oversized_list; $oversized_list = array(); // Allow over-ride via a constant $oversized_row_size = defined('UPDRAFTPLUS_OVERSIZED_ROW_SIZE') ? UPDRAFTPLUS_OVERSIZED_ROW_SIZE : 2048576; $sql = $this->wpdb_obj->prepare("SELECT ".UpdraftPlus_Manipulation_Functions::backquote($primary_key)." FROM ".UpdraftPlus_Manipulation_Functions::backquote($table)." WHERE LENGTH(".UpdraftPlus_Manipulation_Functions::backquote($use_field).") > %d ORDER BY ".UpdraftPlus_Manipulation_Functions::backquote($primary_key)." ASC", $oversized_row_size); $oversized_rows = $this->wpdb_obj->get_col($sql); // Upon an error, just return an empty list if (!is_array($oversized_rows)) return array(); $updraftplus->jobdata_set($jobdata_key, $oversized_rows); return $oversized_rows; } /* * Original version taken partially from phpMyAdmin and partially from Alain Wolf, Zurich - Switzerland to use the WordPress $wpdb object * Website: http://restkultur.ch/personal/wolf/scripts/db_backup/ * Modified by Scott Merrill (http://www.skippy.net/) * Subsequently heavily improved and modified * * This method should be called in a loop for a complete table backup (see the information for the returned parameter). The method may implement whatever strategy it likes for deciding when to return (the assumption is that when it does return with some results, the caller should register that something useful happened). * * @param String $table - Full name of database table to backup * @param String $table_type - Table type - 'VIEW' is supported; otherwise it is treated as an ordinary table * @param Integer\|Boolean $start_record - Specify the starting record, or true to start at the beginning. Our internal page size is fixed at 1000 (though within that we might actually query in smaller batches). * @param Boolean $can_use_primary_key - Whether it is allowed to perform quicker SELECTS based on the primary key. The intended use case for false is to support backups running during a version upgrade. N.B. This "can" is not absolute; there may be other constraints dealt with within this method. * * @return Integer\|Array\|WP_Error - a WP_Error to indicate an error; an array indicates that it finished (if it includes 'next_record' that means it finished via producing something); an integer to indicate the next page the case that there are more to do. / private function backup_table($table, $table_type = 'BASE TABLE', $start_record = true, $can_use_primary_key = true) { $process_pages = 100; // Preserve the passed-in value $original_start_record = $start_record; global $updraftplus; $microtime = microtime(true); $total_rows = 0; // Deal with Windows/old MySQL setups with erroneous table prefixes differing in case $dump_as_table = (false == $this->duplicate_tables_exist && 0 === stripos($table, $this->table_prefix) && 0 !== strpos($table, $this->table_prefix)) ? $this->table_prefix.substr($table, strlen($this->table_prefix)) : $table; $table_structure = $this->wpdb_obj->get_results("DESCRIBE ".UpdraftPlus_Manipulation_Functions::backquote($table)); if (!$table_structure) { // $updraftplus->log(__('Error getting table details', 'updraftplus') . ": $table", 'error'); $error_message = ''; if ($this->wpdb_obj->last_error) $error_message .= ' ('.$this->wpdb_obj->last_error.')'; return new WP_Error('table_details_error', $error_message); } // If at the beginning of the dump for a table, then add the DROP and CREATE statements if (true === $start_record) { $this->write_table_backup_beginning($table, $dump_as_table, $table_type, $table_structure); } // Some tables have optional data, and should be skipped if they do not work $table_sans_prefix = substr($table, strlen($this->table_prefix_raw)); $data_optional_tables = ('wp' == $this->whichdb) ? apply_filters('updraftplus_data_optional_tables', explode(',', UPDRAFTPLUS_DATA_OPTIONAL_TABLES)) : array(); if (in_array($table_sans_prefix, $data_optional_tables)) { if (!$updraftplus->something_useful_happened && !empty($updraftplus->current_resumption) && ($updraftplus->current_resumption - $updraftplus->last_successful_resumption > 2)) { $updraftplus->log("Table $table: Data skipped (previous attempts failed, and table is marked as non-essential)"); return array(); } } $table_data = array(); if ('VIEW' != $table_type) { $select_selected_fields = $insert_selected_fields = array(); $defs = array(); $integer_fields = array(); $binary_fields = array(); $bit_fields = array(); $bit_field_exists = false; $invisible_field_exists = false; // false means "not yet set"; a string means what it was set to; null means that there are multiple (and so not useful to us). If it is not a string, then $primary_key_type is invalid and should not be used. $primary_key = false; $primary_key_type = false; // $table_structure was from "DESCRIBE $table" foreach ($table_structure as $struct) { if (isset($struct->Key) && 'PRI' == $struct->Key && '' != $struct->Field) { $primary_key = (false === $primary_key) ? $struct->Field : null; $primary_key_type = $struct->Type; } if ((0 === strpos($struct->Type, 'tinyint')) \|\| (0 === strpos(strtolower($struct->Type), 'smallint')) \|\| (0 === strpos(strtolower($struct->Type), 'mediumint')) \|\| (0 === strpos(strtolower($struct->Type), 'int')) \|\| (0 === strpos(strtolower($struct->Type), 'bigint')) ) { $defs[strtolower($struct->Field)] = (null === $struct->Default) ? 'NULL' : $struct->Default; $integer_fields[strtolower($struct->Field)] = true; } if ((0 === strpos(strtolower($struct->Type), 'binary')) \|\| (0 === strpos(strtolower($struct->Type), 'varbinary')) \|\| (0 === strpos(strtolower($struct->Type), 'tinyblob')) \|\| (0 === strpos(strtolower($struct->Type), 'mediumblob')) \|\| (0 === strpos(strtolower($struct->Type), 'blob')) \|\| (0 === strpos(strtolower($struct->Type), 'longblob'))) { $binary_fields[strtolower($struct->Field)] = true; } $insert_selected_fields[] = UpdraftPlus_Manipulation_Functions::backquote(str_replace('`', '``', $struct->Field)); if (preg_match('/^bit(?:$([0-9]+)$)?$/i', trim($struct->Type), $matches)) { if (!$bit_field_exists) $bit_field_exists = true; $bit_fields[strtolower($struct->Field)] = !empty($matches[1]) ? max(1, (int) $matches[1]) : 1; // the reason why if bit fields are found then the fields need to be cast into binary type is that if mysqli_query function is being used, mysql will convert the bit field value to a decimal number and represent it in a string format whereas, if mysql_query function is being used, mysql will not convert it to a decimal number but instead will keep it retained as it is $struct->Field = "CAST(".UpdraftPlus_Manipulation_Functions::backquote(str_replace('`', '``', $struct->Field))." AS BINARY) AS ".UpdraftPlus_Manipulation_Functions::backquote(str_replace('`', '``', $struct->Field)); $select_selected_fields[] = $struct->Field; } else { $select_selected_fields[] = UpdraftPlus_Manipulation_Functions::backquote(str_replace('`', '``', $struct->Field)); } if (isset($struct->Extra) && preg_match('/\binvisible\b/i', $struct->Extra)) $invisible_field_exists = true; } $expected_via_count = false; // N.B. At this stage this is for optimisation, mainly targets what is used on the core WP tables (bigint(20)); a value can be relied upon, but false is not definitive. N.B. https://docs.oracle.com/cd/E17952_01/mysql-8.0-en/numeric-type-syntax.html (retrieved Aug 2021): "As of MySQL 8.0.17, the display width attribute is deprecated for integer data types; you should expect support for it to be removed in a future version of MySQL." MySQL 8.0.20 is not returning it. $use_primary_key = false; if ($can_use_primary_key && is_string($primary_key) && preg_match('#^(small\|medium\|big)?int(\(\| \|$)#i', $primary_key_type)) { $use_primary_key = true; // We don't bother re-counting if it's likely to be so large that we're not going to do anything with the result if (is_bool($this->expected_rows) \|\| $this->expected_rows < 1000) { $expected_rows = $this->wpdb_obj->get_var('SELECT COUNT('.UpdraftPlus_Manipulation_Functions::backquote($primary_key).') FROM '.UpdraftPlus_Manipulation_Functions::backquote($table)); if (!is_bool($expected_rows)) { $this->expected_rows = $expected_rows; $expected_via_count = true; } } $oversized_rows = $this->get_oversized_rows($table, $table_structure, $primary_key); if (preg_match('# unsigned$#i', $primary_key_type)) { if (true === $start_record) $start_record = -1; } else { if (true === $start_record) { $min_value = $this->wpdb_obj->get_var('SELECT MIN('.UpdraftPlus_Manipulation_Functions::backquote($primary_key).') FROM '.UpdraftPlus_Manipulation_Functions::backquote($table)); $start_record = (is_numeric($min_value) && $min_value) ? (int) $min_value - 1 : -1; } } } if (!is_bool($this->expected_rows)) { $log_expected_records = (true === $original_start_record); $this->log_expected_rows($table, $this->expected_rows, $expected_via_count, $log_expected_records); } $search = array("\x00", "\x0a", "\x0d", "\x1a"); $replace = array('\0', '\n', '\r', '\Z'); $where_array = apply_filters('updraftplus_backup_table_sql_where', array(), $table, $this); $where = ''; if (!empty($where_array) && is_array($where_array)) { $where = 'WHERE '.implode(' AND ', $where_array); } // Experimentation here shows that on large tables (we tested with 180,000 rows) on MyISAM, 1000 makes the table dump out 3x faster than the previous value of 100. After that, the benefit diminishes (increasing to 4000 only saved another 12%) $fetch_rows = $this->number_of_rows_to_fetch($table, $use_primary_key \|\| $start_record < 500000, true === $original_start_record, $this->expected_rows, $expected_via_count); if (!is_bool($this->expected_rows)) $this->expected_rows = true; $original_fetch_rows = $fetch_rows; $select_selected_fields = $bit_field_exists \|\| $invisible_field_exists ? implode(', ', $select_selected_fields) : ''; $enough_for_now = false; $began_writing_at = time(); $enough_data_after = 104857600; $enough_time_after = ($fetch_rows > 250) ? 15 : 9; // Loop which retrieves data do { if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // Reset back to that which has constructed before the loop began $final_where = $where; if ($use_primary_key) { // The point of this is to leverage the indexing on the private key to make the SELECT much faster than index-less paging $final_where = $where . ($where ? ' AND ' : 'WHERE '); // If it's -1, then we avoid mentioning a negative value, as the value may be unsigned $final_where .= UpdraftPlus_Manipulation_Functions::backquote($primary_key).((-1 === $start_record) ? ' >= 0' : " > $start_record"); $oversized_last_row_id = false; // Remove ones we've gone past foreach ($oversized_rows as $k => $row_id) { if ($start_record >= $row_id) { unset($oversized_rows[$k]); } else { $oversized_last_row_id = $row_id; // At this point we are only willing to fetch a single over-sized row. If this ever changes, we'll need to also keep track of their length. break; } } // Number the keys again from zero $oversized_rows = array_values($oversized_rows); if ($oversized_last_row_id) { $final_where .= " AND ". UpdraftPlus_Manipulation_Functions::backquote($primary_key)." <= $oversized_last_row_id"; } $limit_statement = sprintf('LIMIT %d', $fetch_rows); $order_by = 'ORDER BY '.UpdraftPlus_Manipulation_Functions::backquote($primary_key).' ASC'; } else { $order_by = ''; if (true === $start_record) $start_record = 0; $limit_statement = sprintf('LIMIT %d, %d', $start_record, $fetch_rows); } // $this->wpdb_obj->prepare() not needed (will throw a notice) as there are no parameters (all parts are already sanitised or cast to known-safe types if not sanitised here) $select_sql = "SELECT $select_selected_fields FROM ".UpdraftPlus_Manipulation_Functions::backquote($table)." $final_where $order_by $limit_statement"; if (defined('UPDRAFTPLUS_LOG_BACKUP_SELECTS') && UPDRAFTPLUS_LOG_BACKUP_SELECTS) $updraftplus->log($select_sql); // Allow the data to be filtered (e.g. anonymisation) $table_data = apply_filters('updraftplus_backup_table_results', $this->wpdb_obj->get_results($select_sql, ARRAY_A), $table, $this->table_prefix, $this->whichdb); if (null === $table_data) { $updraftplus->log("Database fetch error (null returned) when running: $select_sql"); } $oversized_changes = false; if (!$table_data) { // Nothing was found - not even the expected over-sized row; this means it was deleted - so don't try to use a limitation based on it again, or we may get an infinite loop. if (isset($oversized_last_row_id) && false !== $oversized_last_row_id) { if (false !== ($key = array_search($oversized_last_row_id, $oversized_rows))) { unset($oversized_rows[$key]); $oversized_changes = true; } } if ($oversized_changes) $updraftplus->jobdata_set('oversized_rows_'.$table, $oversized_rows); continue; } $insert_selected_fields = $invisible_field_exists ? ' (' . implode(', ', $insert_selected_fields) . ')' : ''; $entries = 'INSERT INTO '.UpdraftPlus_Manipulation_Functions::backquote($dump_as_table).$insert_selected_fields.' VALUES '; // \x08\\x09, not required $this_entry = ''; foreach ($table_data as $row) { $total_rows++; if ($this_entry) $this_entry .= ",\n "; $this_entry .= '('; $key_count = 0; foreach ($row as $key => $value) { if ($key_count) $this_entry .= ', '; $key_count++; if ($use_primary_key && strtolower($primary_key) == strtolower($key) && $value > $start_record) { $start_record = $value; foreach ($oversized_rows as $k => $row_id) { if ($start_record >= $row_id) { unset($oversized_rows[$k]); } else { break; } } } if (isset($integer_fields[strtolower($key)])) { // make sure there are no blank spots in the insert syntax, // yet try to avoid quotation marks around integers $value = (null === $value \|\| '' === $value) ? $defs[strtolower($key)] : $value; $value = ('' === $value) ? "''" : $value; $this_entry .= $value; } elseif (isset($binary_fields[strtolower($key)])) { if (null === $value) { $this_entry .= 'NULL'; } elseif ('' === $value) { $this_entry .= "''"; } else { $this_entry .= "0x" . bin2hex(str_repeat("0", floor(strspn($value, "0") / 4)).$value); } } elseif (isset($bit_fields[strtolower($key)])) { if (null === $value) { $this_entry .= 'NULL'; } else { mbstring_binary_safe_encoding(); $val_len = is_string($value) ? strlen($value) : 0; reset_mbstring_encoding(); $hex = ''; for ($i=0; $i<$val_len; $i++) { $hex .= sprintf('%02X', ord($value[$i])); } $this_entry .= "b'".str_pad($this->hex2bin($hex), $bit_fields[strtolower($key)], '0', STR_PAD_LEFT)."'"; } } else { $this_entry .= (null === $value) ? 'NULL' : "'" . str_replace($search, $replace, str_replace('\'', '\\\'', str_replace('\\', '\\\\', $value))) . "'"; } } $this_entry .= ')'; // Flush every 512KB if (strlen($this_entry) > 524288) { $this_entry .= ';'; if (strlen($this_entry) > 10485760) { // This is an attempt to prevent avoidable duplication of long strings in-memory, at the cost of one extra write $this->stow(" \n".$entries); $this->stow($this_entry); } else { $this->stow(" \n".$entries.$this_entry); } $this_entry = ''; // Potentially indicate that enough has been done to loop if ($this->db_current_raw_bytes > $enough_data_after \|\| time() - $began_writing_at > $enough_time_after) { $enough_for_now = true; } } } if ($this_entry) { $this_entry .= ';'; if (strlen($this_entry) > 10485760) { // This is an attempt to prevent avoidable duplication of long strings in-memory, at the cost of one extra write $this->stow(" \n".$entries); $this->stow($this_entry); } else { $this->stow(" \n".$entries.$this_entry); } } // Increment this before any potential changes to $fetch_rows if (!$use_primary_key) { $start_record += $fetch_rows; } // Potentially fetch more rows at once, if performance has been good on a sufficient number of rows // However - testing indicates that this makes very little difference to overall performance; MySQL's performance scales linearly with the number of rows requested. So optimisations here are unlikely to be worthwhile. (Probably better to remove LIMIT and ORDER BY entirely on tables that look small enough to fit into memory in one go) if (!$enough_for_now && $total_rows > 0 && $fetch_rows >= $original_fetch_rows && $fetch_rows < $original_fetch_rows * 8 && $this->db_current_raw_bytes > 10000 && $total_rows > 5000) { $bytes_per_row = $this->db_current_raw_bytes / $total_rows; // Increase the numbers of rows fetched if we still expect it to be less than 5MB, and the rate is acceptable if (2 * $fetch_rows * $bytes_per_row < 5242880) { // N.B. This does not persist across resumptions $fetch_rows = $fetch_rows * 2; $process_pages = $process_pages / 2; } } if ($process_pages > 0) $process_pages--; // The condition involving count($oversized_rows) is for when rows that were in oversized_rows got deleted before being fetched; the "ID < (row)" condition could result in no data being returned, even though the table isn't finished } while (!$enough_for_now && (count($table_data) > 0 \|\| (isset($oversized_rows) && count($oversized_rows) > 0)) && (-1 == $process_pages \|\| $process_pages > 0)); } $fetch_time = max(microtime(true)-$microtime, 0.00001); $updraftplus->log("Table $table: Rows added in this batch (next record: $start_record): $total_rows (uncompressed bytes in this segment=".$this->db_current_raw_bytes.") in ".sprintf('%.02f', $fetch_time).' seconds'); // If all data has been fetched, then write out the closing comment if (-1 == $process_pages \|\| 0 == count($table_data)) { $this->stow("\n# End of data contents of table ".UpdraftPlus_Manipulation_Functions::backquote($table)."\n\n"); // Keep the keyname here in sync with what is in self::get_oversized_rows() $updraftplus->jobdata_delete('oversized_rows_'.$table); return is_numeric($start_record) ? array('next_record' => (int) $start_record) : array(); } return is_numeric($start_record) ? (int) $start_record : $start_record; } /** * Convert hexadecimal (base16) number into binary (base2) and no need to worry about the platform-dependent of 32bit/64bit size limitation * * @param String $hex Hexadecimal number * @return String a base2 format of the given hexadecimal number / private function hex2bin($hex) { $table = array( '0' => '0000', '1' => '0001', '2' => '0010', '3' => '0011', '4' => '0100', '5' => '0101', '6' => '0110', '7' => '0111', '8' => '1000', '9' => '1001', 'a' => '1010', 'b' => '1011', 'c' => '1100', 'd' => '1101', 'e' => '1110', 'f' => '1111' ); $bin = ''; if (!preg_match('/^[0-9a-f]+$/i', $hex)) return ''; for ($i = 0; $i < strlen($hex); $i++) { $bin .= $table[strtolower(substr($hex, $i, 1))]; } return $bin; } /* * Encrypts the file if the option is set; returns the basename of the file (according to whether it was encrypted or not) * * @param String $file - file to encrypt * * @return array / public function encrypt_file($file) { global $updraftplus; $encryption = $updraftplus->get_job_option('updraft_encryptionphrase'); if (!is_string($encryption)) $encryption = ''; if (strlen($encryption) > 0) { $updraftplus->log("Attempting to encrypt backup file"); try { $result = apply_filters('updraft_encrypt_file', null, $file, $encryption, $this->whichdb, $this->whichdb_suffix); } catch (Exception $e) { $log_message = 'Exception ('.get_class($e).') occurred during encryption: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); // @codingStandardsIgnoreLine $log_message .= ' Backtrace: '.str_replace(array(ABSPATH, "\n"), array('', ', '), $e->getTraceAsString()); $updraftplus->log($log_message); $updraftplus->log(sprintf(__('A PHP exception (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); die(); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred during encryption. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); // @codingStandardsIgnoreLine $log_message .= ' Backtrace: '.str_replace(array(ABSPATH, "\n"), array('', ', '), $e->getTraceAsString()); $updraftplus->log($log_message); $updraftplus->log(sprintf(__('A PHP fatal error (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); die(); } if (null === $result) return basename($file); return $result; } else { return basename($file); } } /* * Close the database file currently being written * * @return Boolean / private function backup_db_close() { return $this->dbhandle_isgz ? gzclose($this->dbhandle) : fclose($this->dbhandle); } /* * Open a file, store its file handle, and reset the class variable db_current_raw_bytes back to zero. * * @param String $file Full path to the file to open * @param Boolean $allow_gz Use gzopen() if available, instead of fopen() * @param Boolean $append Use append mode for writing * * @return Resource\|Boolean - the opened file handle, or false for an error / public function backup_db_open($file, $allow_gz = true, $append = false) { $mode = $append ? 'ab' : 'w'; if ($allow_gz && function_exists('gzopen')) { $this->dbhandle = gzopen($file, $mode); $this->dbhandle_isgz = true; } else { $this->dbhandle = fopen($file, $mode); $this->dbhandle_isgz = false; } if (false === $this->dbhandle) { global $updraftplus; $updraftplus->log("ERROR: $file: Could not open the backup file for writing (mode: $mode)"); $updraftplus->log($file.": ".__("Could not open the backup file for writing", 'updraftplus'), 'error'); } $this->db_current_raw_bytes = 0; return $this->dbhandle; } /* * Adds a line to the database backup * * @param String $write_line - the line to write * * @return Integer\|Boolean - the number of octets written, or false for a failure (as returned by gzwrite() / fwrite) / private function stow($write_line) { if ('' === $write_line) return 0; $write_function = $this->dbhandle_isgz ? 'gzwrite' : 'fwrite'; if (false == ($ret = call_user_func($write_function, $this->dbhandle, $write_line))) { $this->log_with_db_occasionally("There was an error writing a line to the backup file: $write_line"); } $this->db_current_raw_bytes += strlen($write_line); return $ret; } /* * Stow the database backup header / private function backup_db_header() { global $updraftplus; $wp_version = $updraftplus->get_wordpress_version(); $mysql_version = $this->wpdb_obj->get_var('SELECT VERSION()'); if ('' == $mysql_version) $mysql_version = $this->wpdb_obj->db_version(); if ('wp' == $this->whichdb) { $wp_upload_dir = wp_upload_dir(); $this->stow("# WordPress MySQL database backup\n"); $this->stow("# Created by UpdraftPlus version ".$updraftplus->version." (https://updraftplus.com)\n"); $this->stow("# WordPress Version: $wp_version, running on PHP ".phpversion()." (".$_SERVER["SERVER_SOFTWARE"]."), MySQL $mysql_version\n"); $this->stow("# Backup of: ".untrailingslashit(site_url())."\n"); $this->stow("# Home URL: ".untrailingslashit(home_url())."\n"); $this->stow("# Content URL: ".untrailingslashit(content_url())."\n"); $this->stow("# Uploads URL: ".untrailingslashit($wp_upload_dir['baseurl'])."\n"); $this->stow("# Table prefix: ".$this->table_prefix_raw."\n"); $this->stow("# Filtered table prefix: ".$this->table_prefix."\n"); $this->stow("# ABSPATH: ".trailingslashit(ABSPATH)."\n"); $this->stow("# UpdraftPlus plugin slug: ".UPDRAFTPLUS_PLUGIN_SLUG."\n"); $this->stow("# Site info: multisite=".(is_multisite() ? '1' : '0')."\n"); if (is_multisite()) { // we're going to use the fallback function wp_get_sites (for older version). if (function_exists('get_sites') && class_exists('WP_Site_Query')) { $network_sites = get_sites(); } elseif (function_exists('wp_get_sites')) { $network_sites = wp_get_sites(); } if ($network_sites) { $multisite_data = array(); foreach ($network_sites as $site) { // get_sites() gives $site in object form whereas wp_get_sites() gives sites in array form. $site = (array) $site; $blog_id = intval($site['blog_id']); $switched = switch_to_blog($blog_id); $wp_upload_dir = wp_upload_dir(); $multisite_data[] = array( 'blog_id' => $blog_id, 'domain' => $site['domain'], 'path' => $site['path'], 'siteurl' => untrailingslashit(site_url()), 'home' => untrailingslashit(home_url()), 'uploads_url' => $wp_upload_dir['baseurl'], ); if ($switched) restore_current_blog(); } $this->stow("# Site info: multisite_data=".json_encode($multisite_data)."\n"); if (function_exists('get_main_site_id')) $this->stow("# Site info: multisite_main_site_id=".intval(get_main_site_id())."\n"); } } $this->stow("# Site info: sql_mode=".$this->wpdb_obj->get_var('SELECT @@SESSION.sql_mode')."\n"); add_filter('updraftplus_backup_db_header_site_info', array($this, 'backup_db_header_site_info_woocommerce')); // This filter allows a user to add extra information about site info. if (array() !== ($site_info = apply_filters('updraftplus_backup_db_header_site_info', array()))) { foreach ($site_info as $info) { $this->stow("# Site info: ".$info."\n"); } } $this->stow("# Site info: end\n"); } else { $this->stow("# MySQL database backup (supplementary database ".$this->whichdb.")\n"); $this->stow("# Created by UpdraftPlus version ".$updraftplus->version." (https://updraftplus.com)\n"); $this->stow("# WordPress Version: $wp_version, running on PHP ".phpversion()." (".$_SERVER["SERVER_SOFTWARE"]."), MySQL $mysql_version\n"); $this->stow("# ".sprintf('External database: (%s)', $this->dbinfo['user'].'@'.$this->dbinfo['host'].'/'.$this->dbinfo['name'])."\n"); $this->stow("# Backup created by: ".untrailingslashit(site_url())."\n"); $this->stow("# Table prefix: ".$this->table_prefix_raw."\n"); $this->stow("# Filtered table prefix: ".$this->table_prefix."\n"); } $label = $updraftplus->jobdata_get('label'); if (!empty($label)) $this->stow("# Label: $label\n"); $this->stow("\n# Generated: ".date("l j. F Y H:i T")."\n"); $this->stow("# Hostname: ".$this->dbinfo['host']."\n"); $this->stow("# Database: ".UpdraftPlus_Manipulation_Functions::backquote($this->dbinfo['name'])."\n"); if (!empty($this->skipped_tables[$this->whichdb])) { if ('wp' == $this->whichdb) { $this->stow("# Skipped tables: " . implode(', ', $this->skipped_tables['wp'])."\n"); } elseif (isset($this->skipped_tables[$this->dbinfo['name']])) { $this->stow("# Skipped tables: " . implode(', ', $this->skipped_tables[$this->dbinfo['name']])."\n"); } } $this->stow("# --------------------------------------------------------\n"); $this->stow("/!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT /;\n"); $this->stow("/!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS /;\n"); $this->stow("/!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION /;\n"); // N.B. Setting this as the mode matches the export behaviour of both mysqldump and phpMyAdmin $this->stow("/!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' /;\n"); $this->stow("/!40101 SET NAMES ".$updraftplus->get_connection_charset($this->wpdb_obj)." /;\n"); $this->stow("/!40101 SET foreign_key_checks = 0 /;\n\n"); // This filter allows a user to add their own arbitrary content. if (false !== ($header_append = apply_filters('updraftplus_backup_db_header_append', false))) { $this->stow($header_append); } } /* * This function recursively packs the zip, dereferencing symlinks but packing into a single-parent tree for universal unpacking * * @param String $fullpath Full path * @param String $use_path_when_storing Controls the path to use when storing in the zip file * @param String $original_fullpath Original path * @param Integer $startlevels How deep within the directory structure the recursive operation has gone * @param Array $exclude passed by reference so that we can remove elements as they are matched - saves time checking against already-dealt-with objects] * @return Boolean / private function makezip_recursive_add($fullpath, $use_path_when_storing, $original_fullpath, $startlevels, &$exclude) { global $updraftplus; // Only BinZip supports symlinks. This means that as a consistent outcome, the only think that can be done with directory symlinks is either a) potentially duplicate the data or b) skip it. Whilst with internal WP entities (e.g. plugins) we definitely want the data, in the case of user-selected directories, we assume the user knew what they were doing when they chose the directory - i.e. we can skip symlink-accessed data that's outside. if (is_link($fullpath) && is_dir($fullpath) && 'more' == $this->whichone) { $updraftplus->log("Directory symlink encounted in more files backup: $use_path_when_storing -> ".readlink($fullpath).": skipping"); return true; } static $updraft_dir_realpath; $updraft_dir_realpath = realpath($this->updraft_dir); // De-reference. Important to do to both, because on Windows only doing it to one can make them non-equal, where they were previously equal - something which we later rely upon $fullpath = realpath($fullpath); $original_fullpath = realpath($original_fullpath); // Is the place we've ended up above the original base? That leads to infinite recursion if (($fullpath !== $original_fullpath && strpos($original_fullpath, $fullpath) === 0) \|\| ($original_fullpath == $fullpath && ((1== $startlevels && strpos($use_path_when_storing, '/') !== false) \|\| (2 == $startlevels && substr_count($use_path_when_storing, '/') >1)))) { $updraftplus->log("Infinite recursion: symlink led us to $fullpath, which is within $original_fullpath"); $updraftplus->log(__("Infinite recursion: consult your log for more information", 'updraftplus'), 'error'); return false; } // This is sufficient for the ones we have exclude options for - uploads, others, wpcore $stripped_storage_path = (1 == $startlevels) ? $use_path_when_storing : substr($use_path_when_storing, strpos($use_path_when_storing, '/') + 1); if (false !== ($fkey = array_search($stripped_storage_path, $exclude))) { $updraftplus->log("Entity excluded by configuration option: $stripped_storage_path"); unset($exclude[$fkey]); return true; } $if_altered_since = $this->makezip_if_altered_since; if (is_file($fullpath)) { if (!empty($this->excluded_extensions) && $this->is_entity_excluded_by_extension($fullpath)) { $updraftplus->log("Entity excluded by configuration option (extension): ".basename($fullpath)); } elseif (!empty($this->excluded_prefixes) && $this->is_entity_excluded_by_prefix($fullpath)) { $updraftplus->log("Entity excluded by configuration option (prefix): ".basename($fullpath)); } elseif (!empty($this->excluded_wildcards) && $this->is_entity_excluded_by_wildcards(basename($fullpath))) { $updraftplus->log("Entity excluded by configuration option (wildcards): ".basename($fullpath)); } elseif (apply_filters('updraftplus_exclude_file', false, $fullpath)) { $updraftplus->log("Entity excluded by filter: ".basename($fullpath)); } elseif (is_readable($fullpath)) { $mtime = filemtime($fullpath); $key = ($fullpath == $original_fullpath) ? ((2 == $startlevels) ? $use_path_when_storing : $this->basename($fullpath)) : $use_path_when_storing.'/'.$this->basename($fullpath); if ($mtime > 0 && $mtime > $if_altered_since) { $this->zipfiles_batched[$fullpath] = $key; $this->makezip_recursive_batchedbytes += @filesize($fullpath);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. // @touch($zipfile); } else { $this->zipfiles_skipped_notaltered[$fullpath] = $key; } } else { $updraftplus->log("$fullpath: unreadable file"); $updraftplus->log(sprintf(__("%s: unreadable file - could not be backed up (check the file permissions and ownership)", 'updraftplus'), $fullpath), 'warning'); } } elseif (is_dir($fullpath)) { if ($fullpath == $updraft_dir_realpath) { $updraftplus->log("Skip directory (UpdraftPlus backup directory): $use_path_when_storing"); return true; } if (apply_filters('updraftplus_exclude_directory', false, $fullpath, $use_path_when_storing)) { $updraftplus->log("Skip filtered directory: $use_path_when_storing"); return true; } if (file_exists($fullpath.'/.donotbackup')) { $updraftplus->log("Skip directory (.donotbackup file found): $use_path_when_storing"); return true; } if (!isset($this->existing_files[$use_path_when_storing])) $this->zipfiles_dirbatched[] = $use_path_when_storing; if (!$dir_handle = @opendir($fullpath)) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $updraftplus->log("Failed to open directory: $fullpath"); $updraftplus->log(sprintf(__("Failed to open directory (check the file permissions and ownership): %s", 'updraftplus'), $fullpath), 'error'); return false; } while (false !== ($e = readdir($dir_handle))) { if ('.' == $e \|\| '..' == $e) continue; if (is_link($fullpath.'/'.$e)) { $deref = realpath($fullpath.'/'.$e); if (false === $deref) { $updraftplus->log("$fullpath/$e: unfollowable link"); $updraftplus->log(sprintf(__("%s: unfollowable link - could not be followed to back up (readlink=%s).", 'updraftplus'), $use_path_when_storing.'/'.$e, readlink($fullpath.'/'.$e)).' '.__("Possible causes include that the link points to an invalid or inaccessible location.", 'updraftplus'), 'warning', "unrlink-$e"); } elseif (is_file($deref)) { $use_stripped = $stripped_storage_path.'/'.$e; if (false !== ($fkey = array_search($use_stripped, $exclude))) { $updraftplus->log("Entity excluded by configuration option: $use_stripped"); unset($exclude[$fkey]); } elseif (!empty($this->excluded_extensions) && $this->is_entity_excluded_by_extension($e)) { $updraftplus->log("Entity excluded by configuration option (extension): $use_stripped"); } elseif (!empty($this->excluded_prefixes) && $this->is_entity_excluded_by_prefix($e)) { $updraftplus->log("Entity excluded by configuration option (prefix): $use_stripped"); } elseif (!empty($this->excluded_wildcards) && $this->is_entity_excluded_by_wildcards($use_stripped)) { $updraftplus->log("Entity excluded by configuration option (wildcards): $use_stripped"); } elseif (apply_filters('updraftplus_exclude_file', false, $deref, $use_stripped)) { $updraftplus->log("Entity excluded by filter: $use_stripped"); } elseif (is_readable($deref)) { $mtime = filemtime($deref); if ($mtime > 0 && $mtime > $if_altered_since) { $this->zipfiles_batched[$deref] = $use_path_when_storing.'/'.$e; $this->makezip_recursive_batchedbytes += @filesize($deref);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // @touch($zipfile); } else { $this->zipfiles_skipped_notaltered[$deref] = $use_path_when_storing.'/'.$e; } } else { $updraftplus->log("$deref: unreadable file (de-referenced from the link $e in $fullpath)"); $updraftplus->log(sprintf(__("%s: unreadable file - could not be backed up"), $deref), 'warning'); } } elseif (is_dir($deref)) { $this->symlink_reversals[$deref] = $fullpath.'/'.$e; $this->makezip_recursive_add($deref, $use_path_when_storing.'/'.$e, $original_fullpath, $startlevels, $exclude); } } elseif (is_file($fullpath.'/'.$e)) { $use_stripped = $stripped_storage_path.'/'.$e; if (false !== ($fkey = array_search($use_stripped, $exclude))) { $updraftplus->log("Entity excluded by configuration option: $use_stripped"); unset($exclude[$fkey]); } elseif (!empty($this->excluded_extensions) && $this->is_entity_excluded_by_extension($e)) { $updraftplus->log("Entity excluded by configuration option (extension): $use_stripped"); } elseif (!empty($this->excluded_prefixes) && $this->is_entity_excluded_by_prefix($e)) { $updraftplus->log("Entity excluded by configuration option (prefix): $use_stripped"); } elseif (!empty($this->excluded_wildcards) && $this->is_entity_excluded_by_wildcards($use_stripped)) { $updraftplus->log("Entity excluded by configuration option (wildcards): $use_stripped"); } elseif (apply_filters('updraftplus_exclude_file', false, $fullpath.'/'.$e)) { $updraftplus->log("Entity excluded by filter: $use_stripped"); } elseif (is_readable($fullpath.'/'.$e)) { $mtime = filemtime($fullpath.'/'.$e); if ($mtime > 0 && $mtime > $if_altered_since) { $this->zipfiles_batched[$fullpath.'/'.$e] = $use_path_when_storing.'/'.$e; $this->makezip_recursive_batchedbytes += @filesize($fullpath.'/'.$e);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } else { $this->zipfiles_skipped_notaltered[$fullpath.'/'.$e] = $use_path_when_storing.'/'.$e; } } else { $updraftplus->log("$fullpath/$e: unreadable file"); $updraftplus->log(sprintf(__("%s: unreadable file - could not be backed up", 'updraftplus'), $use_path_when_storing.'/'.$e), 'warning', "unrfile-$e"); } } elseif (is_dir($fullpath.'/'.$e)) { $use_stripped = $stripped_storage_path.'/'.$e; if ('wpcore' == $this->whichone && 'updraft' == $e && basename($use_path_when_storing) == 'wp-content' && (!defined('UPDRAFTPLUS_WPCORE_INCLUDE_UPDRAFT_DIRS') \|\| !UPDRAFTPLUS_WPCORE_INCLUDE_UPDRAFT_DIRS)) { // This test, of course, won't catch everything - it just aims to make things better by default $updraftplus->log("Directory excluded for looking like a sub-site's internal UpdraftPlus directory (enable by defining UPDRAFTPLUS_WPCORE_INCLUDE_UPDRAFT_DIRS): ".$use_path_when_storing.'/'.$e); } elseif (!empty($this->excluded_wildcards) && $this->is_entity_excluded_by_wildcards($use_stripped)) { $updraftplus->log("Entity excluded by configuration option (wildcards): $use_stripped"); } else { // no need to add_empty_dir here, as it gets done when we recurse $this->makezip_recursive_add($fullpath.'/'.$e, $use_path_when_storing.'/'.$e, $original_fullpath, $startlevels, $exclude); } } } closedir($dir_handle); } else { $updraftplus->log("Unexpected: path ($use_path_when_storing) fails both is_file() and is_dir()"); } return true; } /* * Get a list of excluded extensions * * @param Array $exclude - settings passed in * * @return Array / private function get_excluded_extensions($exclude) { if (!is_array($exclude)) $exclude = array(); $exclude_extensions = array(); foreach ($exclude as $ex) { if (preg_match('/^ext:(.+)$/i', $ex, $matches)) { $exclude_extensions[] = strtolower($matches[1]); } } if (defined('UPDRAFTPLUS_EXCLUDE_EXTENSIONS')) { $exclude_from_define = explode(',', UPDRAFTPLUS_EXCLUDE_EXTENSIONS); foreach ($exclude_from_define as $ex) { $exclude_extensions[] = strtolower(trim($ex)); } } return $exclude_extensions; } /* * Get a list of excluded prefixes * * @param Array $exclude - settings passed in * * @return Array - each is listed in lower case / private function get_excluded_prefixes($exclude) { if (!is_array($exclude)) $exclude = array(); $exclude_prefixes = array(); foreach ($exclude as $pref) { if (preg_match('/^prefix:(.+)$/i', $pref, $matches)) { $exclude_prefixes[] = strtolower($matches[1]); } } return $exclude_prefixes; } /* * List all the wildcard patterns from the given excluded items * * @param Array $exclude the list of excluded items which may contain not just wildcard patterns but also specific file/directory names as well * * $exclude argument may contains data in an array format like below: * [ * "snapshots" // definitely not a wildcard parttern, this could be directories/files named `snapshots` which are located in the root/parent directory * "2021/03/image.jpg", // not a wildcard parttern, this could be files/directories named `image.jpg` which are located in the 2021/03/ directory * "ext:zip", // not a wildcard pattern, this is to exclude all files that end with `zip` extension * "prefix:file-", // not a wildcard pattern, this is to exclude all files that begin with `file-` prefix * "2021/04", // not a wildcard pattern, this is to exclude all files/directories which are located in the 2021/04 directory * "backup", // wildcard pattern that excludes all files/directories beginning with `backup` in the root/parent directory "2021/optimise", // wildcard pattern that excludes all files/directories that have `optimise` anywhere in their names in the `2021` directory * "2021/04/.tmp" // wildcard pattern that excludes all files/directories ending with `optimise` anywhere in their names in the `2021/04` directory ] * * @return Array an array of wildcard patterns * * After the $exclude has gone through the regex parsing step, only excluded items containing valid wildcard patterns got captured and will return them in an array in a format like below: * * [ * [ * "directory_path" => "", * "pattern" => "backup" ], * [ * "directory_path" => "2021\", * "pattern" => "optimise" * ], * [ * "directory_path" => "2021\04\", * "pattern" => ".tmp" ] * ] / private function get_excluded_wildcards($exclude) { if (!is_array($exclude)) $exclude = array(); $excluded_wildcards = array(); foreach ($exclude as $wch) { // https://regex101.com/r/dMFI0P/1/ if (preg_match('#(.(?<!\\\)/)?(.?(?<!\\\)\.)#i', $wch, $matches)) { // the regex will make sure only excluded items containing valid wildcard patterns get captured, it will lookup for asterisk char(s) at the very end of the string right after the last path separator (if any). e.g. foo/bar/baz $excluded_wildcards[] = array( // in case the excluded item has doubled separators (e.g. dir1//dir2//file) or if the user added a directory separator at the beginning then trim and/or replace them 'directory_path' => preg_replace(array('/^[\/\s]/', '/\/\//', '/[\/\s]$/'), array('', '/', ''), $matches[1]), 'pattern' => $matches[2] ); } } return $excluded_wildcards; } /** * Check whether or not the given entity(file/directory) is excluded from the backup by matching it against a set of wildcard patterns * * @param String $entity the file/directory's stripped path * @return Boolean true if the entity is excluded, false otherwise / private function is_entity_excluded_by_wildcards($entity) { $entity_basename = untrailingslashit($entity); $entity_basename = substr_replace($entity_basename, '', 0, (false === strrpos($entity_basename, '/') ? 0 : strrpos($entity_basename, '/') + 1)); foreach ($this->excluded_wildcards as $wch) { if (!is_array($wch) \|\| empty($wch)) continue; if (substr_replace($entity, '', (int) strrpos($entity, '/'), strlen($entity) - (int) strrpos($entity, '/')) !== $wch['directory_path']) continue; if ('' == substr($wch['pattern'], -1, 1) && '' == substr($wch['pattern'], 0, 1) && strlen($wch['pattern']) > 2) { $wch['pattern'] = substr($wch['pattern'], 1, strlen($wch['pattern'])-2); $wch['pattern'] = str_replace('\', '', $wch['pattern']); if (strpos($entity_basename, $wch['pattern']) !== false) return true; } elseif ('' == substr($wch['pattern'], -1, 1) && strlen($wch['pattern']) > 1) { $wch['pattern'] = substr($wch['pattern'], 0, strlen($wch['pattern'])-1); $wch['pattern'] = str_replace('\', '', $wch['pattern']); if (substr($entity_basename, 0, strlen($wch['pattern'])) == $wch['pattern']) return true; } elseif ('' == substr($wch['pattern'], 0, 1) && strlen($wch['pattern']) > 1) { $wch['pattern'] = substr($wch['pattern'], 1); $wch['pattern'] = str_replace('\', '', $wch['pattern']); if (strlen($entity_basename) >= strlen($wch['pattern']) && substr($entity_basename, strlen($wch['pattern'])-1) == $wch['pattern']) return true; } } return false; } private function is_entity_excluded_by_extension($entity) { foreach ($this->excluded_extensions as $ext) { if (!$ext) continue; $eln = strlen($ext); if (strtolower(substr($entity, -$eln, $eln)) == $ext) return true; } return false; } private function is_entity_excluded_by_prefix($entity) { $entity = basename($entity); foreach ($this->excluded_prefixes as $pref) { if (!$pref) continue; $eln = strlen($pref); if (strtolower(substr($entity, 0, $eln)) == $pref) return true; } return false; } private function unserialize_gz_cache_file($file) { if (!$whandle = gzopen($file, 'r')) return false; global $updraftplus; $emptimes = 0; $var = ''; while (!gzeof($whandle)) { $bytes = @gzread($whandle, 1048576);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (empty($bytes)) { $emptimes++; $updraftplus->log("Got empty gzread ($emptimes times)"); if ($emptimes>2) return false; } else { $var .= $bytes; } } gzclose($whandle); return $updraftplus->unserialize($var); } /** * Make Zip File. * * @param Array\|String $source Caution: $source is allowed to be an array, not just a filename * @param String $backup_file_basename Name of backup file * @param String $whichone Backup entity type (e.g. 'plugins') * @param Boolean $retry_on_error Set to retry upon error * @return Boolean / private function make_zipfile($source, $backup_file_basename, $whichone, $retry_on_error = true) { global $updraftplus; $original_index = $this->index; $itext = empty($this->index) ? '' : ($this->index+1); $destination_base = $backup_file_basename.'-'.$whichone.$itext.'.zip.tmp'; // $destination is the temporary file (ending in .tmp) $destination = $this->updraft_dir.'/'.$destination_base; // When to prefer PCL: // - We were asked to // - No zip extension present and no relevant method present // The zip extension check is not redundant, because method_exists segfaults some PHP installs, leading to support requests // We need meta-info about $whichone $backupable_entities = $updraftplus->get_backupable_file_entities(true, false); // This is only used by one corner-case in BinZip // $this->make_zipfile_source = (isset($backupable_entities[$whichone])) ? $backupable_entities[$whichone] : $source; $this->make_zipfile_source = (is_array($source) && isset($backupable_entities[$whichone])) ? (('uploads' == $whichone) ? dirname($backupable_entities[$whichone]) : $backupable_entities[$whichone]) : dirname($source); $this->existing_files = array(); // Used for tracking compression ratios $this->existing_files_rawsize = 0; $this->existing_zipfiles_size = 0; // Enumerate existing files // Usually first_linked_index is zero; the exception being with more files, where previous zips' contents are irrelevant for ($j = $this->first_linked_index; $j <= $this->index; $j++) { $jtext = (0 == $j) ? '' : $j+1; // This is, in a non-obvious way, compatible with filenames which indicate increments // $j does not need to start at zero; it should start at the index which the current entity split at. However, this is not directly known, and can only be deduced from examining the filenames. And, for other indexes from before the current increment, the searched-for filename won't exist (even if there is no cloud storage). So, this indirectly results in the desired outcome when we start from $j=0. $examine_zip = $this->updraft_dir.'/'.$backup_file_basename.'-'.$whichone.$jtext.'.zip'.(($j == $this->index) ? '.tmp' : ''); // This comes from https://wordpress.org/support/topic/updraftplus-not-moving-all-files-to-remote-server - where it appears that the jobdata's record of the split was done (i.e. database write), but the earlier* rename of the .tmp file was not done (i.e. I/O lost). i.e. In theory, this should be impossible; but, the sychnronicity apparently cannot be fully relied upon in some setups. The check for the index being one behind is being conservative - there's no inherent reason why it couldn't be done for other indexes. // Note that in this 'impossible' case, no backup data was being lost - the design still ensures that the on-disk backup is fine. The problem was a gap in the sequence numbering of the zip files, leading to user confusion. // Other examples of this appear to be in HS#1001 and #1047 if ($j != $this->index && !file_exists($examine_zip)) { $alt_examine_zip = $this->updraft_dir.'/'.$backup_file_basename.'-'.$whichone.$jtext.'.zip'.(($j == $this->index - 1) ? '.tmp' : ''); if ($alt_examine_zip != $examine_zip && file_exists($alt_examine_zip) && is_readable($alt_examine_zip) && filesize($alt_examine_zip)>0) { $updraftplus->log("Looked-for zip file not found; but non-zero .tmp zip was, despite not being current index ($j != ".$this->index." - renaming zip (assume previous resumption's IO was lost before kill)"); if (rename($alt_examine_zip, $examine_zip)) { clearstatcache(); } else { $updraftplus->log("Rename failed - backup zips likely to not have sequential numbers (does not affect backup integrity, but can cause user confusion)"); } } } // If the file exists, then we should grab its index of files inside, and sizes // Then, when we come to write a file, we should check if it's already there, and only add if it is not if (file_exists($examine_zip) && is_readable($examine_zip) && filesize($examine_zip) > 0) { // Do not use (which also means do not create) a manifest if the file is still a .tmp file, since this may not be complete. If we are in this place in the code from a resumption, creating a manifest here will mean the manifest becomes out-of-date if further files are added. $this->populate_existing_files_list_from_zip($examine_zip, substr($examine_zip, -4, 4) === '.zip'); // try_split is true if there have been no check-ins recently - or if it needs to be split anyway if ($j == $this->index) { if ($this->try_split) { if (filesize($examine_zip) > 501048576) { // We could, as a future enhancement, save this back to the job data, if we see a case that needs it $this->zip_split_every = max( (int) $this->zip_split_every/2, UPDRAFTPLUS_SPLIT_MIN1048576, min(filesize($examine_zip)-1048576, $this->zip_split_every) ); $updraftplus->jobdata_set('split_every', (int) ($this->zip_split_every/1048576)); $updraftplus->log("No check-in on last two runs; bumping index and reducing zip split to: ".round($this->zip_split_every/1048576, 1)." MB"); $do_bump_index = true; } unset($this->try_split); } elseif (filesize($examine_zip) > $this->zip_split_every) { $updraftplus->log(sprintf("Zip size is at/near split limit (%s MB / %s MB) - bumping index (from: %d)", filesize($examine_zip), round($this->zip_split_every/1048576, 1), $this->index)); $do_bump_index = true; } } } elseif (file_exists($examine_zip)) { $updraftplus->log("Zip file already exists, but is not readable or was zero-sized; will remove: ".basename($examine_zip)); @unlink($examine_zip);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } elseif ($updraftplus->is_uploaded(basename($examine_zip))) { $this->populate_existing_files_list_from_zip($examine_zip, true); } } $this->zip_last_ratio = ($this->existing_files_rawsize > 0) ? ($this->existing_zipfiles_size/$this->existing_files_rawsize) : 1; $this->zipfiles_added = 0; $this->zipfiles_added_thisrun = 0; $this->zipfiles_dirbatched = array(); $this->zipfiles_batched = array(); $this->zipfiles_skipped_notaltered = array(); $this->zipfiles_lastwritetime = time(); $this->zip_basename = $this->updraft_dir.'/'.$backup_file_basename.'-'.$whichone; if (!empty($do_bump_index)) $this->bump_index(); $error_occurred = false; // Store this in its original form // $this->source = $source; // Reset. This counter is used only with PcLZip, to decide if it's better to do it all-in-one $this->makezip_recursive_batchedbytes = 0; if (!is_array($source)) $source = array($source); $exclude = $updraftplus->get_exclude($whichone); $files_enumerated_at = $updraftplus->jobdata_get('files_enumerated_at'); if (!is_array($files_enumerated_at)) $files_enumerated_at = array(); $files_enumerated_at[$whichone] = time(); $updraftplus->jobdata_set('files_enumerated_at', $files_enumerated_at); $this->makezip_if_altered_since = is_array($this->altered_since) ? (isset($this->altered_since[$whichone]) ? $this->altered_since[$whichone] : -1) : -1; // Reset $got_uploads_from_cache = false; // Uploads: can/should we get it back from the cache? // \|\| 'others' == $whichone if (('uploads' == $whichone \|\| 'others' == $whichone) && function_exists('gzopen') && function_exists('gzread')) { $use_cache_files = false; $cache_file_base = $this->zip_basename.'-cachelist-'.$this->makezip_if_altered_since; // Cache file suffixes: -zfd.gz.tmp, -zfb.gz.tmp, -info.tmp, (possible)-zfs.gz.tmp if (file_exists($cache_file_base.'-zfd.gz.tmp') && file_exists($cache_file_base.'-zfb.gz.tmp') && file_exists($cache_file_base.'-info.tmp')) { // Cache files exist; shall we use them? $mtime = filemtime($cache_file_base.'-zfd.gz.tmp'); // Require < 30 minutes old if (time() - $mtime < 1800) { $use_cache_files = true; } $any_failures = false; if ($use_cache_files) { $var = $this->unserialize_gz_cache_file($cache_file_base.'-zfd.gz.tmp'); if (is_array($var)) { $this->zipfiles_dirbatched = $var; $var = $this->unserialize_gz_cache_file($cache_file_base.'-zfb.gz.tmp'); if (is_array($var)) { $this->zipfiles_batched = $var; if (file_exists($cache_file_base.'-info.tmp')) { $var = $updraftplus->unserialize(file_get_contents($cache_file_base.'-info.tmp')); if (is_array($var) && isset($var['makezip_recursive_batchedbytes'])) { $this->makezip_recursive_batchedbytes = $var['makezip_recursive_batchedbytes']; if (file_exists($cache_file_base.'-zfs.gz.tmp')) { $var = $this->unserialize_gz_cache_file($cache_file_base.'-zfs.gz.tmp'); if (is_array($var)) { $this->zipfiles_skipped_notaltered = $var; } else { $any_failures = true; } } else { $this->zipfiles_skipped_notaltered = array(); } } else { $any_failures = true; } } } else { $any_failures = true; } } else { $any_failures = true; } if ($any_failures) { $updraftplus->log("Failed to recover file lists from existing cache files"); // Reset it all $this->zipfiles_skipped_notaltered = array(); $this->makezip_recursive_batchedbytes = 0; $this->zipfiles_batched = array(); $this->zipfiles_dirbatched = array(); } else { $updraftplus->log("File lists recovered from cache files; sizes: ".count($this->zipfiles_batched).", ".count($this->zipfiles_batched).", ".count($this->zipfiles_skipped_notaltered).")"); $got_uploads_from_cache = true; } } } } $time_counting_began = time(); $this->excluded_extensions = $this->get_excluded_extensions($exclude); $this->excluded_prefixes = $this->get_excluded_prefixes($exclude); $this->excluded_wildcards = $this->get_excluded_wildcards($exclude); foreach ($source as $element) { // makezip_recursive_add($fullpath, $use_path_when_storing, $original_fullpath, $startlevels = 1, $exclude_array) if ('uploads' == $whichone) { if (empty($got_uploads_from_cache)) { $dirname = dirname($element); $basename = $this->basename($element); $add_them = $this->makezip_recursive_add($element, basename($dirname).'/'.$basename, $element, 2, $exclude); } else { $add_them = true; } } else { if (empty($got_uploads_from_cache)) { $add_them = $this->makezip_recursive_add($element, $this->basename($element), $element, 1, $exclude); } else { $add_them = true; } } if (is_wp_error($add_them) \|\| false === $add_them) $error_occurred = true; } $time_counting_ended = time(); // Cache the file scan, if it looks like it'll be useful // We use gzip to reduce the size as on hosts which limit disk I/O, the caching may make things worse // \|\| 'others' == $whichone if (('uploads' == $whichone \|\| 'others' == $whichone) && !$error_occurred && function_exists('gzopen') && function_exists('gzwrite')) { $cache_file_base = $this->zip_basename.'-cachelist-'.$this->makezip_if_altered_since; // Just approximate - we're trying to avoid an otherwise-unpredictable PHP fatal error. Caching only happens if file enumeration took a long time - so presumably there are very many. $memory_needed_estimate = 0; foreach ($this->zipfiles_batched as $k => $v) { $memory_needed_estimate += strlen($k)+strlen($v)+12; } // We haven't bothered to check if we just fetched the files from cache, as that shouldn't take a long time and so shouldn't trigger this // Let us suppose we need 15% overhead for gzipping $memory_limit = ini_get('memory_limit'); $memory_usage = round(@memory_get_usage(false)/1048576, 1);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $memory_usage2 = round(@memory_get_usage(true)/1048576, 1);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ($time_counting_ended-$time_counting_began > 20 && $updraftplus->verify_free_memory($memory_needed_estimate0.15) && $whandle = gzopen($cache_file_base.'-zfb.gz.tmp', 'w')) { $updraftplus->log("File counting took a long time (".($time_counting_ended - $time_counting_began)."s); will attempt to cache results (memory_limit: $memory_limit (used: {$memory_usage}M \| {$memory_usage2}M), estimated uncompressed bytes: ".round($memory_needed_estimate/1024, 1)." Kb)"); $buf = 'a:'.count($this->zipfiles_batched).':{'; foreach ($this->zipfiles_batched as $file => $add_as) { $k = addslashes($file); $v = addslashes($add_as); $buf .= 's:'.strlen($k).':"'.$k.'";s:'.strlen($v).':"'.$v.'";'; if (strlen($buf) > 1048576) { gzwrite($whandle, $buf, strlen($buf)); $buf = ''; } } $buf .= '}'; $final = gzwrite($whandle, $buf); unset($buf); if (!$final) { @unlink($cache_file_base.'-zfb.gz.tmp');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. @gzclose($whandle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } else { gzclose($whandle); if (!empty($this->zipfiles_skipped_notaltered)) { if ($shandle = gzopen($cache_file_base.'-zfs.gz.tmp', 'w')) { if (!gzwrite($shandle, serialize($this->zipfiles_skipped_notaltered))) { $aborted_on_skipped = true; } gzclose($shandle); } else { $aborted_on_skipped = true; } } if (!empty($aborted_on_skipped)) { @unlink($cache_file_base.'-zfs.gz.tmp');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. @unlink($cache_file_base.'-zfb.gz.tmp');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } else { $info_array = array('makezip_recursive_batchedbytes' => $this->makezip_recursive_batchedbytes); if (!file_put_contents($cache_file_base.'-info.tmp', serialize($info_array))) { @unlink($cache_file_base.'-zfs.gz.tmp');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. @unlink($cache_file_base.'-zfb.gz.tmp');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } if ($dhandle = gzopen($cache_file_base.'-zfd.gz.tmp', 'w')) { if (!gzwrite($dhandle, serialize($this->zipfiles_dirbatched))) { $aborted_on_dirbatched = true; } gzclose($dhandle); } else { $aborted_on_dirbatched = true; } if (!empty($aborted_on_dirbatched)) { // phpcs:disable Generic.PHP.NoSilencedErrors.Discouraged -- no error required if the file doesn't exist. @unlink($cache_file_base.'-zfs.gz.tmp'); @unlink($cache_file_base.'-zfd.gz.tmp'); @unlink($cache_file_base.'-zfb.gz.tmp'); @unlink($cache_file_base.'-info.tmp'); // phpcs:enable } } } } / Class variables that get altered: zipfiles_batched makezip_recursive_batchedbytes zipfiles_skipped_notaltered zipfiles_dirbatched Class variables that the result depends upon (other than the state of the filesystem): makezip_if_altered_since existing_files / } // Any not yet dispatched? Under our present scheme, at this point nothing has yet been despatched. And since the enumerating of all files can take a while, we can at this point do a further modification check to reduce the chance of overlaps. // This relies on us not* touch()ing the zip file to indicate to any resumption 'behind us' that we're already here. Rather, we're relying on the combined facts that a) if it takes us a while to search the directory tree, then it should do for the one behind us too (though they'll have the benefit of cache, so could catch very fast) and b) we touch immediately after finishing the enumeration of the files to add. // $retry_on_error is here being used as a proxy for 'not the second time around, when there might be the remains of the file on the first time around' if ($retry_on_error) $updraftplus->check_recent_modification($destination); // Here we're relying on the fact that both PclZip and ZipArchive will happily operate on an empty file. Note that BinZip won't (for that, may need a new strategy - e.g. add the very first file on its own, in order to 'lay down a marker') if (empty($do_bump_index)) touch($destination); if (count($this->zipfiles_dirbatched) > 0 \|\| count($this->zipfiles_batched) > 0) { $updraftplus->log(sprintf("Total entities for the zip file: %d directories, %d files (%d skipped as non-modified), %s MB", count($this->zipfiles_dirbatched), count($this->zipfiles_batched), count($this->zipfiles_skipped_notaltered), round($this->makezip_recursive_batchedbytes/1048576, 1))); // No need to warn if we're going to retry anyway. (And if we get killed, the zip will be rescanned for its contents upon resumption). $warn_on_failures = ($retry_on_error) ? false : true; $add_them = $this->makezip_addfiles($warn_on_failures); if (is_wp_error($add_them)) { foreach ($add_them->get_error_messages() as $msg) { $updraftplus->log("Error returned from makezip_addfiles: ".$msg); } $error_occurred = true; } elseif (false === $add_them) { $updraftplus->log("Error: makezip_addfiles returned false"); $error_occurred = true; } } // Reset these variables because the index may have changed since we began $itext = empty($this->index) ? '' : $this->index+1; $destination_base = $backup_file_basename.'-'.$whichone.$itext.'.zip.tmp'; $destination = $this->updraft_dir.'/'.$destination_base; // ZipArchive::addFile sometimes fails - there's nothing when we expected something. // Did not used to have \|\| $error_occurred here. But it is better to retry, than to simply warn the user to check his logs. if (((file_exists($destination) \|\| $this->index == $original_index) && @filesize($destination) < 90 && 'UpdraftPlus_ZipArchive' == $this->use_zip_object) \|\| ($error_occurred && $retry_on_error)) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // This can be made more sophisticated if feedback justifies it. Currently we just switch to PclZip. But, it may have been a BinZip failure, so we could then try ZipArchive if that is available. If doing that, make sure that an infinite recursion isn't made possible. $updraftplus->log("makezip_addfiles(".$this->use_zip_object.") apparently failed (file=".basename($destination).", type=$whichone, size=".filesize($destination).") - retrying with PclZip"); $saved_zip_object = $this->use_zip_object; $this->use_zip_object = 'UpdraftPlus_PclZip'; $ret = $this->make_zipfile($source, $backup_file_basename, $whichone, false); $this->use_zip_object = $saved_zip_object; return $ret; } // zipfiles_added > 0 means that $zip->close() has been called. i.e. An attempt was made to add something: something _should_ be there. // Why return true even if $error_occurred may be set? 1) Because in that case, a warning has already been logged. 2) Because returning false causes an error to be logged, which means it'll all be retried again. Also 3) this has been the pattern of the code for a long time, and the algorithm has been proven in the real-world: don't change what's not broken. // (file_exists($destination) \|\| $this->index == $original_index) might be an alternative to $this->zipfiles_added > 0 - ? But, don't change what's not broken. if (false == $error_occurred \|\| $this->zipfiles_added > 0) { return true; } else { $updraftplus->log("makezip failure: zipfiles_added=".$this->zipfiles_added.", error_occurred=".$error_occurred." (method=".$this->use_zip_object.")"); return false; } } /** * This function is an ugly, conservative workaround for https://bugs.php.net/bug.php?id=62119. It does not aim to always work-around, but to ensure that nothing is made worse. * * @param String $element * * @return String / private function basename($element) { $dirname = dirname($element); $basename_manual = preg_replace('#^[\\/]+#', '', substr($element, strlen($dirname))); $basename = basename($element); if ($basename_manual != $basename) { $locale = setlocale(LC_CTYPE, "0"); if ('C' == $locale) { setlocale(LC_CTYPE, 'en_US.UTF8'); $basename_new = basename($element); if ($basename_new == $basename_manual) $basename = $basename_new; setlocale(LC_CTYPE, $locale); } } return $basename; } /* * Determine if a file should be stored without compression * * @param String $file - the filename * * @return Boolean / private function file_should_be_stored_without_compression($file) { if (!is_array($this->extensions_to_not_compress)) return false; foreach ($this->extensions_to_not_compress as $ext) { $ext_len = strlen($ext); if (strtolower(substr($file, -$ext_len, $ext_len)) == $ext) return true; } return false; } /* * This method will add a manifest file to the backup zip * * @param String $whichone - the type of backup (e.g. 'plugins', 'themes') * * @return Boolean - success/failure status / private function updraftplus_include_manifest($whichone) { global $updraftplus; $manifest_name = "updraftplus-manifest.json"; $manifest = trailingslashit($this->updraft_dir).$manifest_name; $updraftplus->log(sprintf("Creating file manifest ($manifest_name) for incremental backup (included: %d, skipped: %d)", count($this->zipfiles_batched), count($this->zipfiles_skipped_notaltered))); if (false === ($handle = fopen($manifest, 'w+'))) return $updraftplus->log("Failed to open manifest file ($manifest_name)"); $this->manifest_path = $manifest; $version = 1; $go_to_levels = array( 'plugins' => 2, 'themes' => 2, 'uploads' => 3, 'others' => 3 ); $go_to_levels = apply_filters('updraftplus_manifest_go_to_level', $go_to_levels, $whichone); $go_to_level = isset($go_to_levels[$whichone]) ? $go_to_levels[$whichone] : 'all'; $directory = ''; if ('more' == $whichone) { foreach ($this->zipfiles_batched as $index => $dir) { $directory = '"directory":"' . dirname($index) . '",'; } } if (false === fwrite($handle, '{"version":'.$version.',"type":"'.$whichone.'",'.$directory.'"listed_levels":"'.$go_to_level.'","contents":{"directories":[')) $updraftplus->log("First write to manifest file failed ($manifest_name)"); // First loop: find out which is the last entry, so that we don't write the comma after it $last_dir_index = false; foreach ($this->zipfiles_dirbatched as $index => $dir) { if ('all' !== $go_to_level && substr_count($dir, '/') > $go_to_level - 1) continue; $last_dir_index = $index; } // Second loop: write out the entry foreach ($this->zipfiles_dirbatched as $index => $dir) { if ('all' !== $go_to_level && substr_count($dir, '/') > $go_to_level - 1) continue; fwrite($handle, json_encode($dir).(($index != $last_dir_index) ? ',' : '')); } // Now do the same for files fwrite($handle, '],"files":['); $last_file_index = false; foreach ($this->zipfiles_batched as $store_as) { if ('all' !== $go_to_level && substr_count($store_as, '/') > $go_to_level - 1) continue; $last_file_index = $store_as; } foreach ($this->zipfiles_skipped_notaltered as $store_as) { if ('all' !== $go_to_level && substr_count($store_as, '/') > $go_to_level - 1) continue; $last_file_index = $store_as; } foreach ($this->zipfiles_batched as $store_as) { if ('all' !== $go_to_level && substr_count($store_as, '/') > $go_to_level - 1) continue; fwrite($handle, json_encode($store_as).(($store_as != $last_file_index) ? ',' : '')); } foreach ($this->zipfiles_skipped_notaltered as $store_as) { if ('all' !== $go_to_level && substr_count($store_as, '/') > $go_to_level - 1) continue; fwrite($handle, json_encode($store_as).(($store_as != $last_file_index) ? ',' : '')); } fwrite($handle, ']}}'); fclose($handle); $this->zipfiles_batched[$manifest] = $manifest_name; $updraftplus->log("Successfully created file manifest (size: ".filesize($manifest).")"); return true; } // Q. Why don't we only open and close the zip file just once? // A. Because apparently PHP doesn't write out until the final close, and it will return an error if anything file has vanished in the meantime. So going directory-by-directory reduces our chances of hitting an error if the filesystem is changing underneath us (which is very possible if dealing with e.g. 1GB of files) /* * We batch up the files, rather than do them one at a time. So we are more efficient than open,one-write,close. * To call into here, the array $this->zipfiles_batched must be populated (keys=paths, values=add-to-zip-as values). It gets reset upon exit from here. * * @param Boolean $warn_on_failures - If set, then log at the 'warning' level * * @return Boolean\|WP_Error / private function makezip_addfiles($warn_on_failures) { global $updraftplus; // Used to detect requests to bump the size $bump_index = false; $ret = true; $zipfile = $this->zip_basename.((0 == $this->index) ? '' : ($this->index+1)).'.zip.tmp'; $maxzipbatch = $updraftplus->jobdata_get('maxzipbatch', 26214400); if ((int) $maxzipbatch < 1024) $maxzipbatch = 26214400; // Short-circuit the null case, because we want to detect later if something useful happened if (0 == count($this->zipfiles_dirbatched) && 0 == count($this->zipfiles_batched)) return true; // If on PclZip, then if possible short-circuit to a quicker method (makes a huge time difference - on a folder of 1500 small files, 2.6s instead of 76.6) // This assumes that makezip_addfiles() is only called once so that we know about all needed files (the new style) // This is rather conservative - because it assumes zero compression. But we can't know that in advance. $force_allinone = false; if (0 == $this->index && $this->makezip_recursive_batchedbytes < $this->zip_split_every) { // So far, we only have a processor for this for PclZip; but that check can be removed - need to address the below items // TODO: Is this really what we want? Always go all-in-one for < 500MB???? Should be more conservative? Or, is it always faster to go all-in-one? What about situations where we might want to auto-split because of slowness - check that that is still working. // TODO: Test this new method for PclZip - are we still getting the performance gains? Test for ZipArchive too. if ('UpdraftPlus_PclZip' == $this->use_zip_object && ($this->makezip_recursive_batchedbytes < 5121048576 \|\| (defined('UPDRAFTPLUS_PCLZIP_FORCEALLINONE') && UPDRAFTPLUS_PCLZIP_FORCEALLINONE == true && 'UpdraftPlus_PclZip' == $this->use_zip_object))) { $updraftplus->log("Only one archive required (".$this->use_zip_object.") - will attempt to do in single operation (data: ".round($this->makezip_recursive_batchedbytes/1024, 1)." KB, split: ".round($this->zip_split_every/1024, 1)." KB)"); // $updraftplus->log("PclZip, and only one archive required - will attempt to do in single operation (data: ".round($this->makezip_recursive_batchedbytes/1024, 1)." KB, split: ".round($this->zip_split_every/1024, 1)." KB)"); $force_allinone = true; // if(!class_exists('PclZip')) require_once(ABSPATH.'/wp-admin/includes/class-pclzip.php'); // $zip = new PclZip($zipfile); // $remove_path = ($this->whichone == 'wpcore') ? untrailingslashit(ABSPATH) : WP_CONTENT_DIR; // $add_path = false; // Remove prefixes // $backupable_entities = $updraftplus->get_backupable_file_entities(true); // if (isset($backupable_entities[$this->whichone])) { // if ('plugins' == $this->whichone \|\| 'themes' == $this->whichone \|\| 'uploads' == $this->whichone) { // $remove_path = dirname($backupable_entities[$this->whichone]); // To normalise instead of removing (which binzip doesn't support, so we don't do it), you'd remove the dirname() in the above line, and uncomment the below one. // #$add_path = $this->whichone; // } else { // $remove_path = $backupable_entities[$this->whichone]; // } // } // if ($add_path) { // $zipcode = $zip->create($this->source, PCLZIP_OPT_REMOVE_PATH, $remove_path, PCLZIP_OPT_ADD_PATH, $add_path); // } else { // $zipcode = $zip->create($this->source, PCLZIP_OPT_REMOVE_PATH, $remove_path); // } // if ($zipcode == 0) { // $updraftplus->log("PclZip Error: ".$zip->errorInfo(true), 'warning'); // return $zip->errorCode(); // } else { // UpdraftPlus_Job_Scheduler::something_useful_happened(); // return true; // } } } // 05-Mar-2013 - added a new check on the total data added; it appears that things fall over if too much data is contained in the cumulative total of files that were addFile'd without a close-open cycle; presumably data is being stored in memory. In the case in question, it was a batch of MP3 files of around 100MB each - 25 of those equals 2.5GB! $data_added_since_reopen = 0; // static $data_added_this_resumption = 0; // $max_data_added_any_resumption = $updraftplus->jobdata_get('max_data_added_any_resumption', 0); // The following array is used only for error reporting if ZipArchive::close fails (since that method itself reports no error messages - we have to track manually what we were attempting to add) $files_zipadded_since_open = array(); $zip = new $this->use_zip_object; if (file_exists($zipfile)) { $original_size = filesize($zipfile); // PHP 8.1 throws a deprecation notice if opening a zero-size file with ZipArchive, so in that situation, we remove and re-create it if ($original_size > 0) { $opencode = $zip->open($zipfile); clearstatcache(); } elseif (0 === $original_size) { unlink($zipfile); } else { $opencode = false; } } else { $original_size = 0; } if (0 === $original_size) { $create_code = (version_compare(PHP_VERSION, '5.2.12', '>') && defined('ZIPARCHIVE::CREATE')) ? ZIPARCHIVE::CREATE : 1; $opencode = $zip->open($zipfile, $create_code); } if (true !== $opencode) return new WP_Error('no_open', sprintf(__('Failed to open the zip file (%s) - %s', 'updraftplus'), $zipfile, $zip->last_error)); if (apply_filters('updraftplus_include_manifest', false, $this->whichone, $this)) { $this->updraftplus_include_manifest($this->whichone); } // Give binzip the help it needs to deal with directory symlinks if (!empty($this->symlink_reversals) && is_callable(array($zip, 'ud_notify_symlink_reversals'))) { $zip->ud_notify_symlink_reversals($this->symlink_reversals); } // Make sure all directories are created before we start creating files while ($dir = array_pop($this->zipfiles_dirbatched)) { $zip->addEmptyDir($dir); } $zipfiles_added_thisbatch = 0; // Go through all those batched files foreach ($this->zipfiles_batched as $file => $add_as) { if (!file_exists($file)) { $updraftplus->log("File has vanished from underneath us; dropping: $add_as"); continue; } $fsize = filesize($file); $large_file_warning_key = 'vlargefile_'.md5($this->whichone.'#'.$add_as); if (defined('UPDRAFTPLUS_SKIP_FILE_OVER_SIZE') && UPDRAFTPLUS_SKIP_FILE_OVER_SIZE && $fsize > UPDRAFTPLUS_SKIP_FILE_OVER_SIZE) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the check. $updraftplus->log("File is larger than the user-configured (UPDRAFTPLUS_SKIP_FILE_OVER_SIZE) maximum (is: ".round($fsize/1024, 1)." KB); will skip: ".$add_as); continue; } elseif ($fsize > UPDRAFTPLUS_WARN_FILE_SIZE) { $log_msg = __('A very large file was encountered: %s (size: %s Mb)', 'updraftplus'); // Was this warned about on a previous run? if ($updraftplus->warning_exists($large_file_warning_key)) { $updraftplus->log_remove_warning($large_file_warning_key); $large_file_warning_key .= '-2'; $log_msg .= ' - '.__('a second attempt is being made (upon further failure it will be skipped)', 'updraftplus'); } elseif ($updraftplus->warning_exists($large_file_warning_key.'-2') \|\| $updraftplus->warning_exists($large_file_warning_key.'-final')) { $updraftplus->log_remove_warning($large_file_warning_key.'-2'); $large_file_warning_key .= '-final'; $log_msg .= ' - '.__('two unsuccessful attempts were made to include it, and it will now be omitted from the backup', 'updraftplus'); } $updraftplus->log(sprintf($log_msg, $add_as, round($fsize/1048576, 1)), 'warning', $large_file_warning_key); if (preg_match('/-final$/', $large_file_warning_key)) continue; } // Skips files that are already added if (!isset($this->existing_files[$add_as]) \|\| $this->existing_files[$add_as] != $fsize) { @touch($zipfile);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $zip->addFile($file, $add_as); $zipfiles_added_thisbatch++; if (method_exists($zip, 'setCompressionName') && $this->file_should_be_stored_without_compression($add_as) && false == $zip->setCompressionName($add_as, ZipArchive::CM_STORE)) { $updraftplus->log("Zip: setCompressionName failed on: $add_as"); } // N.B., Since makezip_addfiles() can get called more than once if there were errors detected, potentially $zipfiles_added_thisrun can exceed the total number of batched files (if they get processed twice). $this->zipfiles_added_thisrun++; $files_zipadded_since_open[] = array('file' => $file, 'addas' => $add_as); $data_added_since_reopen += $fsize; // $data_added_this_resumption += $fsize; /* Conditions for forcing a write-out and re-open: - more than $maxzipbatch bytes have been batched - more than 2.0 seconds have passed since the last time we wrote - that adding this batch of data is likely already enough to take us over the split limit (and if that happens, then do actually split - to prevent a scenario of progressively tinier writes as we approach but don't actually reach the limit) - more than 500 files batched (should perhaps intelligently lower this as the zip file gets bigger - not yet needed) / // Add 10% margin. It only really matters when the OS has a file size limit, exceeding which causes failure (e.g. 2GB on 32-bit) // Since we don't test before the file has been created (so that zip_last_ratio has meaningful data), we rely on max_zip_batch being less than zip_split_every - which should always be the case $reaching_split_limit = ($this->zip_last_ratio > 0 && $original_size>0 && ($original_size + 1.1$data_added_since_reopen$this->zip_last_ratio) > $this->zip_split_every) ? true : false; if (!$force_allinone && ($zipfiles_added_thisbatch > UPDRAFTPLUS_MAXBATCHFILES \|\| $reaching_split_limit \|\| $data_added_since_reopen > $maxzipbatch \|\| (time() - $this->zipfiles_lastwritetime) > 2)) { // We are coming towards a limit and about to close the zip, check if this is a more file backup and the manifest file has made it into this zip if not add it if (apply_filters('updraftplus_include_manifest', false, $this->whichone, $this)) { $manifest = false; foreach ($files_zipadded_since_open as $info) { if ('updraftplus-manifest.json' == $info['file']) $manifest = true; } if (!$manifest) { @touch($zipfile);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $path = array_search('updraftplus-manifest.json', $this->zipfiles_batched); $zip->addFile($path, 'updraftplus-manifest.json'); $zipfiles_added_thisbatch++; if (method_exists($zip, 'setCompressionName') && $this->file_should_be_stored_without_compression($this->zipfiles_batched[$path])) { if (false == $zip->setCompressionName($this->zipfiles_batched[$path], ZipArchive::CM_STORE)) { $updraftplus->log("Zip: setCompressionName failed on: $this->zipfiles_batched[$path]"); } } // N.B., Since makezip_addfiles() can get called more than once if there were errors detected, potentially $zipfiles_added_thisrun can exceed the total number of batched files (if they get processed twice). $this->zipfiles_added_thisrun++; $files_zipadded_since_open[] = array('file' => $path, 'addas' => 'updraftplus-manifest.json'); $data_added_since_reopen += filesize($path); // $data_added_this_resumption += filesize($path); } } if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $something_useful_sizetest = false; if ($data_added_since_reopen > $maxzipbatch) { $something_useful_sizetest = true; $updraftplus->log("Adding batch to zip file (".$this->use_zip_object."): over ".round($maxzipbatch/1048576, 1)." MB added on this batch (".round($data_added_since_reopen/1048576, 1)." MB, ".count($this->zipfiles_batched)." files batched, $zipfiles_added_thisbatch (".$this->zipfiles_added_thisrun.") added so far); re-opening (prior size: ".round($original_size/1024, 1).' KB)'); } elseif ($zipfiles_added_thisbatch > UPDRAFTPLUS_MAXBATCHFILES) { $updraftplus->log("Adding batch to zip file (".$this->use_zip_object."): over ".UPDRAFTPLUS_MAXBATCHFILES." files added on this batch (".round($data_added_since_reopen/1048576, 1)." MB, ".count($this->zipfiles_batched)." files batched, $zipfiles_added_thisbatch (".$this->zipfiles_added_thisrun.") added so far); re-opening (prior size: ".round($original_size/1024, 1).' KB)'); } elseif (!$reaching_split_limit) { $updraftplus->log("Adding batch to zip file (".$this->use_zip_object."): over 2.0 seconds have passed since the last write (".round($data_added_since_reopen/1048576, 1)." MB, $zipfiles_added_thisbatch (".$this->zipfiles_added_thisrun.") files added so far); re-opening (prior size: ".round($original_size/1024, 1).' KB)'); } else { $updraftplus->log("Adding batch to zip file (".$this->use_zip_object."): possibly approaching split limit (".round($data_added_since_reopen/1048576, 1)." MB, $zipfiles_added_thisbatch (".$this->zipfiles_added_thisrun.") files added so far); last ratio: ".round($this->zip_last_ratio, 4)."; re-opening (prior size: ".round($original_size/1024, 1).' KB)'); } if (!$zip->close()) { // Though we will continue processing the files we've got, the final error code will be false, to allow a second attempt on the failed ones. This also keeps us consistent with a negative result for $zip->close() further down. We don't just retry here, because we have seen cases (with BinZip) where upon failure, the existing zip had actually been deleted. So, to be safe we need to re-scan the existing zips. $ret = false; $this->record_zip_error($files_zipadded_since_open, $zip->last_error, $warn_on_failures); } $zipfiles_added_thisbatch = 0; // This triggers a re-open, later unset($zip); $files_zipadded_since_open = array(); // Call here, in case we've got so many big files that we don't complete the whole routine if (filesize($zipfile) > $original_size) { // It is essential that this does not go above 1, even though in reality (and this can happen at the start, if just 1 file is added (e.g. due to >2.0s detection) the 'compressed' zip file may be bigger* than the files stored in it. When that happens, if the ratio is big enough, it can then fire the "approaching split limit" detection (very) prematurely $this->zip_last_ratio = ($data_added_since_reopen > 0) ? min((filesize($zipfile) - $original_size)/$data_added_since_reopen, 1) : 1; // We need a rolling update of this $original_size = filesize($zipfile); // Move on to next zip? if ($reaching_split_limit \|\| filesize($zipfile) > $this->zip_split_every) { $bump_index = true; // Take the filesize now because later we wanted to know we did clearstatcache() $bumped_at = round(filesize($zipfile)/1048576, 1); } // Need to make sure that something_useful_happened() is always called // How long since the current run began? If it's taken long (and we're in danger of not making it at all), or if that is foreseeable in future because of general slowness, then we should reduce the parameters. if (!$something_useful_sizetest) { UpdraftPlus_Job_Scheduler::something_useful_happened(); } else { // Do this as early as possible UpdraftPlus_Job_Scheduler::something_useful_happened(); $time_since_began = max(microtime(true)- $this->zipfiles_lastwritetime, 0.000001); $normalised_time_since_began = $time_since_began($maxzipbatch/$data_added_since_reopen); // Don't measure speed until after ZipArchive::close() $rate = round($data_added_since_reopen/$time_since_began, 1); $updraftplus->log(sprintf("A useful amount of data was added after this amount of zip processing: %s s (normalised: %s s, rate: %s KB/s)", round($time_since_began, 1), round($normalised_time_since_began, 1), round($rate/1024, 1))); // We want to detect not only that we need to reduce the size of batches, but also the capability to increase them. This is particularly important because of ZipArchive()'s (understandable, given the tendency of PHP processes being terminated without notice) practice of first creating a temporary zip file via copying before acting on that zip file (so the information is atomic). Unfortunately, once the size of the zip file gets over 100MB, the copy operation beguns to be significant. By the time you've hit 500MB on many web hosts the copy is the majority of the time taken. So we want to do more in between these copies if possible. / "Could have done more" - detect as: - A batch operation would still leave a "good chunk" of time in a run - "Good chunk" means that the time we took to add the batch is less than 50% of a run time - We can do that on any run after the first (when at least one ceiling on the maximum time is known) - But in the case where a max_execution_time is long (so that resumptions are never needed), and we're always on run 0, we will automatically increase chunk size if the batch took less than 6 seconds. / // At one stage we had a strategy of not allowing check-ins to have more than 20s between them. However, once the zip file got to a certain size, PHP's habit of copying the entire zip file first meant that it always* went over 18s, and thence a drop in the max size was inevitable - which was bad, because with the copy time being something that only grew, the outcome was less data being copied every time // Gather the data. We try not to do this unless necessary (may be time-sensitive) if ($updraftplus->current_resumption >= 1) { $time_passed = $updraftplus->jobdata_get('run_times'); if (!is_array($time_passed)) $time_passed = array(); list($max_time, $timings_string, $run_times_known) = UpdraftPlus_Manipulation_Functions::max_time_passed($time_passed, $updraftplus->current_resumption-1, $this->first_run);// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Unused parameter is present because the method returns an array. } else { // $run_times_known = 0; // $max_time = -1; $run_times_known = 1; $max_time = microtime(true)-$updraftplus->opened_log_time; } if ($normalised_time_since_began < 6 \|\| ($updraftplus->current_resumption >= 1 && $run_times_known >= 1 && $time_since_began < 0.6$max_time) \|\| (0 == $updraftplus->current_resumption && $max_time > 240)) { // How much can we increase it by? if ($normalised_time_since_began < 6 \|\| 0 == $updraftplus->current_resumption) { if ($run_times_known > 0 && $max_time > 0) { $new_maxzipbatch = min(floor(max($maxzipbatch6/$normalised_time_since_began, $maxzipbatch((0.6$max_time)/$normalised_time_since_began))), $this->zip_batch_ceiling); } else { // Maximum of 200MB in a batch $new_maxzipbatch = min(floor($maxzipbatch6/$normalised_time_since_began), $this->zip_batch_ceiling); } } else { // Use up to 60% of available time $new_maxzipbatch = min(floor($maxzipbatch((0.6$max_time)/$normalised_time_since_began)), $this->zip_batch_ceiling); } // Throttle increases - don't increase by more than 2x in one go - ??? // $new_maxzipbatch = floor(min(2$maxzipbatch, $new_maxzipbatch)); // Also don't allow anything that is going to be more than 18 seconds - actually, that's harmful because of the basically fixed time taken to copy the file // $new_maxzipbatch = floor(min(18$rate ,$new_maxzipbatch)); // Don't go above the split amount (though we expect that to be higher anyway, unless sending via email) $new_maxzipbatch = min($new_maxzipbatch, $this->zip_split_every); // Don't raise it above a level that failed on a previous run $maxzipbatch_ceiling = $updraftplus->jobdata_get('maxzipbatch_ceiling'); if (is_numeric($maxzipbatch_ceiling) && $maxzipbatch_ceiling > 201048576 && $new_maxzipbatch > $maxzipbatch_ceiling) { $updraftplus->log("Was going to raise maxzipbytes to $new_maxzipbatch, but this is too high: a previous failure led to the ceiling being set at $maxzipbatch_ceiling, which we will use instead"); $new_maxzipbatch = $maxzipbatch_ceiling; } // Final sanity check if ($new_maxzipbatch > 1048576) $updraftplus->jobdata_set('maxzipbatch', $new_maxzipbatch); if ($new_maxzipbatch <= 1048576) { $updraftplus->log("Unexpected new_maxzipbatch value obtained (time=$time_since_began, normalised_time=$normalised_time_since_began, max_time=$max_time, data points known=$run_times_known, old_max_bytes=$maxzipbatch, new_max_bytes=$new_maxzipbatch)"); } elseif ($new_maxzipbatch > $maxzipbatch) { $updraftplus->log("Performance is good - will increase the amount of data we attempt to batch (time=$time_since_began, normalised_time=$normalised_time_since_began, max_time=$max_time, data points known=$run_times_known, old_max_bytes=$maxzipbatch, new_max_bytes=$new_maxzipbatch)"); } elseif ($new_maxzipbatch < $maxzipbatch) { // Ironically, we thought we were speedy... $updraftplus->log("Adjust: Reducing maximum amount of batched data (time=$time_since_began, normalised_time=$normalised_time_since_began, max_time=$max_time, data points known=$run_times_known, new_max_bytes=$new_maxzipbatch, old_max_bytes=$maxzipbatch)"); } else { $updraftplus->log("Performance is good - but we will not increase the amount of data we batch, as we are already at the present limit (time=$time_since_began, normalised_time=$normalised_time_since_began, max_time=$max_time, data points known=$run_times_known, max_bytes=$maxzipbatch)"); } if ($new_maxzipbatch > 1048576) $maxzipbatch = $new_maxzipbatch; } // Detect excessive slowness // Don't do this until we're on at least resumption 7, as we want to allow some time for things to settle down and the maximum time to be accurately known (since reducing the batch size unnecessarily can itself cause extra slowness, due to PHP's usage of temporary zip files) // We use a percentage-based system as much as possible, to avoid the various criteria being in conflict with each other (i.e. a run being both 'slow' and 'fast' at the same time, which is increasingly likely as max_time gets smaller). if (!$updraftplus->something_useful_happened && $updraftplus->current_resumption >= 7) { UpdraftPlus_Job_Scheduler::something_useful_happened(); if ($run_times_known >= 5 && ($time_since_began > 0.8 * $max_time \|\| $time_since_began + 7 > $max_time)) { $new_maxzipbatch = max(floor($maxzipbatch0.8), 20971520); if ($new_maxzipbatch < $maxzipbatch) { $maxzipbatch = $new_maxzipbatch; $updraftplus->jobdata_set("maxzipbatch", $new_maxzipbatch); $updraftplus->log("We are within a small amount of the expected maximum amount of time available; the zip-writing thresholds will be reduced (time_passed=$time_since_began, normalised_time_passed=$normalised_time_since_began, max_time=$max_time, data points known=$run_times_known, old_max_bytes=$maxzipbatch, new_max_bytes=$new_maxzipbatch)"); } else { $updraftplus->log("We are within a small amount of the expected maximum amount of time available, but the zip-writing threshold is already at its lower limit (20MB), so will not be further reduced (max_time=$max_time, data points known=$run_times_known, max_bytes=$maxzipbatch)"); } } } else { UpdraftPlus_Job_Scheduler::something_useful_happened(); } } $data_added_since_reopen = 0; } else { // ZipArchive::close() can take a very long time, which we want to know about UpdraftPlus_Job_Scheduler::record_still_alive(); } clearstatcache(); $this->zipfiles_lastwritetime = time(); } } elseif (0 == $this->zipfiles_added_thisrun) { // Update lastwritetime, because otherwise the 2.0-second-activity detection can fire prematurely (e.g. if it takes >2.0 seconds to process the previously-written files, then the detector fires after 1 file. This then can have the knock-on effect of having something_useful_happened() called, but then a subsequent attempt to write out a lot of meaningful data fails, and the maximum batch is not then reduced. // Testing shows that calling time() 1000 times takes negligible time $this->zipfiles_lastwritetime = time(); } $this->zipfiles_added++; // Don't call something_useful_happened() here - nothing necessarily happens until close() is called if (0 == $this->zipfiles_added % 100) { $skip_dblog = ($this->zipfiles_added_thisrun > 0 \|\| 0 == $this->zipfiles_added % 1000) ? false : true; $updraftplus->log("Zip: ".basename($zipfile).": ".$this->zipfiles_added." files added (on-disk size: ".round(@filesize($zipfile)/1024, 1)." KB)", 'notice', false, $skip_dblog);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } if ($bump_index) { $updraftplus->log(sprintf("Zip size is at/near split limit (%s MB / %s MB) - bumping index (from: %d)", $bumped_at, round($this->zip_split_every/1048576, 1), $this->index)); $bump_index = false; $this->bump_index(); $zipfile = $this->zip_basename.($this->index+1).'.zip.tmp'; } if (empty($zip)) { $zip = new $this->use_zip_object; // Give binzip the help it needs to deal with directory symlinks if (!empty($this->symlink_reversals) && is_callable(array($zip, 'ud_notify_symlink_reversals'))) { $zip->ud_notify_symlink_reversals($this->symlink_reversals); } if (file_exists($zipfile)) { $original_size = filesize($zipfile); // PHP 8.1 throws a deprecation notice if opening a zero-size file with ZipArchive, so in that situation, we remove and re-create it if ($original_size > 0) { $opencode = $zip->open($zipfile); clearstatcache(); } elseif (0 === $original_size) { unlink($zipfile); } else { $opencode = false; } } else { $original_size = 0; } if (0 === $original_size) { $create_code = (version_compare(PHP_VERSION, '5.2.12', '>') && defined('ZIPARCHIVE::CREATE')) ? ZIPARCHIVE::CREATE : 1; $opencode = $zip->open($zipfile, $create_code); } if (true !== $opencode) return new WP_Error('no_open', sprintf(__('Failed to open the zip file (%s) - %s', 'updraftplus'), $zipfile, $zip->last_error)); } } // Reset array $this->zipfiles_batched = array(); $this->zipfiles_skipped_notaltered = array(); if (false == ($nret = $zip->close())) $this->record_zip_error($files_zipadded_since_open, $zip->last_error, $warn_on_failures); if (apply_filters('updraftplus_include_manifest', false, $this->whichone, $this)) { if (!empty($this->manifest_path) && file_exists($this->manifest_path)) { $updraftplus->log('Removing manifest file: '.basename($this->manifest_path).': '.(@unlink($this->manifest_path) ? 'OK' : 'failed'));// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } } $this->zipfiles_lastwritetime = time(); // May not exist if the last thing we did was bump if (file_exists($zipfile) && filesize($zipfile) > $original_size) UpdraftPlus_Job_Scheduler::something_useful_happened(); // Move on to next archive? if (file_exists($zipfile) && filesize($zipfile) > $this->zip_split_every) { $updraftplus->log(sprintf("Zip size has gone over split limit (%s, %s) - bumping index (%d)", round(filesize($zipfile)/1048576, 1), round($this->zip_split_every/1048576, 1), $this->index)); $this->bump_index(); } $manifest = preg_replace('/\.tmp$/', '.list.tmp', $zipfile); if (!file_exists($manifest)) $this->write_zip_manifest_from_zip($zipfile); clearstatcache(); return (false == $ret) ? false : $nret; } private function record_zip_error($files_zipadded_since_open, $msg, $warn = true) { global $updraftplus; if (!empty($updraftplus->cpanel_quota_readable)) { $hosting_bytes_free = $updraftplus->get_hosting_disk_quota_free(); if (is_array($hosting_bytes_free)) { $perc = round(100$hosting_bytes_free[1]/(max($hosting_bytes_free[2], 1)), 1); $quota_free_msg = sprintf('Free disk space in account: %s (%s used)', round($hosting_bytes_free[3]/1048576, 1)." MB", "$perc %"); $updraftplus->log($quota_free_msg); if ($hosting_bytes_free[3] < 104857650) { $quota_low = true; $quota_free_mb = round($hosting_bytes_free[3]/1048576, 1); $updraftplus->log(sprintf(__('Your free space in your hosting account is very low - only %s Mb remain', 'updraftplus'), $quota_free_mb), 'warning', 'lowaccountspace'.$quota_free_mb); } } } // Always warn of this if (is_string($msg) && strpos($msg, 'File Size Limit Exceeded') !== false && 'UpdraftPlus_BinZip' == $this->use_zip_object) { $updraftplus->log(sprintf(__('The zip engine returned the message: %s.', 'updraftplus'), 'File Size Limit Exceeded'). __('Go here for more information.', 'updraftplus').' https://teamupdraft.com/documentation/updraftplus/topics/backing-up/troubleshooting/what-should-i-do-if-i-see-the-message-file-size-limit-exceeded/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=unknown&utm_creative_format=unknown', 'warning', 'zipcloseerror-filesizelimit'); } elseif ($warn) { $warn_msg = __('A zip error occurred', 'updraftplus').' - '; if (!empty($quota_low)) { $warn_msg = sprintf(__('your web hosting account is full; please see: %s', 'updraftplus'), 'https://updraftplus.com/faqs/how-much-free-disk-space-do-i-need-to-create-a-backup/'); } else { $warn_msg .= __('check your log for more details.', 'updraftplus'); } $updraftplus->log($warn_msg, 'warning', 'zipcloseerror-'.$this->whichone); } $updraftplus->log("The attempt to close the zip file returned an error ($msg). List of files we were trying to add follows (check their permissions)."); foreach ($files_zipadded_since_open as $ffile) { $updraftplus->log("File: ".$ffile['addas']." (exists: ".(int) @file_exists($ffile['file']).", is_readable: ".(int) @is_readable($ffile['file'])." size: ".@filesize($ffile['file']).')', 'notice', false, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } } /* * Bump the zip index number. No parameters or returned value, since it is dealing with class variables. / private function bump_index() { global $updraftplus; $youwhat = $this->whichone; $timetaken = max(microtime(true)-$this->zip_microtime_start, 0.000001); $itext = (0 == $this->index) ? '' : ($this->index+1); $full_path = $this->zip_basename.$itext.'.zip'; $checksums = $updraftplus->which_checksums(); $checksum_description = ''; foreach ($checksums as $checksum) { $cksum = hash_file($checksum, $full_path.'.tmp'); $updraftplus->jobdata_set($checksum.'-'.$youwhat.$this->index, $cksum); if ($checksum_description) $checksum_description .= ', '; $checksum_description .= "$checksum: $cksum"; } $next_full_path = $this->zip_basename.($this->index+2).'.zip'; // We touch the next zip before renaming the temporary file; this indicates that the backup for the entity is not necessarily* finished touch($next_full_path.'.tmp'); if (file_exists($full_path.'.tmp') && filesize($full_path.'.tmp') > 0) { if (!rename($full_path.'.tmp', $full_path)) { $updraftplus->log("Rename failed for $full_path.tmp"); } else { $manifest = $full_path.'.list.tmp'; if (!file_exists($manifest)) $this->write_zip_manifest_from_zip($full_path); UpdraftPlus_Job_Scheduler::something_useful_happened(); } } $kbsize = filesize($full_path)/1024; $rate = round($kbsize/$timetaken, 1); $updraftplus->log("Created ".$this->whichone." zip (".$this->index.") - ".round($kbsize, 1)." KB in ".round($timetaken, 1)." s ($rate KB/s) (checksums: $checksum_description)"); $this->zip_microtime_start = microtime(true); // No need to add $itext here - we can just delete any temporary files for this zip UpdraftPlus_Filesystem_Functions::clean_temporary_files('_'.$updraftplus->file_nonce."-".$youwhat, 600); $prior_index = $this->index; $this->index++; $this->job_file_entities[$youwhat]['index'] = $this->index; $updraftplus->jobdata_set('job_file_entities', $this->job_file_entities); $this->maybe_cloud_backup(basename($full_path), $this->whichone, $prior_index); } /** * This function will populate class variables (given below) with a list of files found inside the passed in zip * * @param string $zip_path - the zip file name we want to list files for; must end in .tmp * @param boolean $read_from_manifest - a boolean to indicate if we should try to read from the manifest or not * * @uses self::$existing_files * @uses self::$existing_files_rawsize * @uses self::$existing_zipfiles_size * * @return void / private function populate_existing_files_list_from_zip($zip_path, $read_from_manifest) { global $updraftplus; // Get the name of the final manifest file if (preg_match('/\.tmp$/', $zip_path)) { $manifest = preg_replace('/\.tmp$/', '.list.tmp', $zip_path); } else { $manifest = $zip_path.'.list.tmp'; } if ($read_from_manifest && file_exists($manifest)) { $manifest_contents = json_decode(file_get_contents($manifest), true); if (empty($manifest_contents)) { $updraftplus->log("Zip manifest file found, but reading failed: ".basename($manifest)); } elseif (!empty($manifest_contents['files'])) { $this->existing_files = array_merge($this->existing_files, $manifest_contents['files'][0]); $updraftplus->log('Successfully read zip manifest file contents ('.basename($manifest).')'); return; } else { $updraftplus->log("Zip manifest file found, but no files contents were found: ".basename($manifest)); } } elseif ($read_from_manifest) { $updraftplus->log("No zip manifest file found; will create one"); } $zip = new $this->use_zip_object; if (true !== $zip->open($zip_path)) { $updraftplus->log("Could not open zip file to examine (".$zip->last_error."); will remove: ".basename($zip_path)); unlink($zip_path); } else { $this->existing_zipfiles_size += filesize($zip_path); // Don't put this in the for loop, or the magic __get() method which accessing the property invokes gets repeatedly called every time the loop goes round $numfiles = $zip->numFiles; if (false === $numfiles) { $updraftplus->log("Could not read any files from the zip (".$zip->last_error."): ".basename($zip_path)); $zip->close(); return; } for ($i=0; $i < $numfiles; $i++) { $si = $zip->statIndex($i); $name = $si['name']; // Exclude folders if ('/' == substr($name, -1)) continue; if (!isset($this->existing_files[$name])) { $this->existing_files[$name] = $si['size']; $this->existing_files_rawsize += $si['size']; } } @$zip->close();// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. $updraftplus->log(basename($zip_path).": Zip file already exists, with ".count($this->existing_files)." files"); // If this is a .tmp file (partial zip) then return we do not want to create an incomplete manifest file if (preg_match('/\.tmp$/', $zip_path)) return; $manifest = $zip_path.'.list-temp.tmp'; $this->write_zip_manifest_from_list($manifest, $this->existing_files); } } /* * This function will get a list of files found inside the passed in zip and call the function to create the zip manifest, returns true on success and false on failure * * @uses self::write_zip_manifest_from_list() * @param string $zip_path - the zip file path; must end in .tmp * * @return boolean - returns true on success and false on failure / private function write_zip_manifest_from_zip($zip_path) { global $updraftplus; $zip_files = array(); $zip = new $this->use_zip_object; if (true !== $zip->open($zip_path)) { $updraftplus->log("Could not open zip file to examine (".$zip->last_error."); file: ".basename($zip_path)); return false; } else { // Don't put this in the for loop, or the magic __get() method gets repeatedly called every time the loop goes round $numfiles = $zip->numFiles; if (false === $numfiles) $updraftplus->log("write_zip_manifest_from_zip(): Could not read any files from the zip: (".basename($zip_path).") Zip error: (".$zip->last_error.")"); for ($i=0; $i < $numfiles; $i++) { $si = $zip->statIndex($i); $name = $si['name']; // Exclude folders if ('/' == substr($name, -1)) continue; $zip_files[$name] = $si['size']; } @$zip->close();// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. } if (empty($zip_files)) { $updraftplus->log("Did not find any files in the zip: ".basename($zip_path)); return false; } if (preg_match('/\.tmp$/', $zip_path)) { $manifest = preg_replace('/\.tmp$/', '.list-temp.tmp', $zip_path); } else { $manifest = $zip_path.'.list-temp.tmp'; } $this->write_zip_manifest_from_list($manifest, $zip_files); return true; } /* * This function will create and write the contents of the zip manifest * * @param string $manifest - path of the manifest file * @param array $zip_files - an array of files and their sizes * * @return boolean - returns false on failure to write / private function write_zip_manifest_from_list($manifest, $zip_files) { global $updraftplus; $updraftplus->log('Creating zip file manifest ('.basename($manifest).')'); if (false === ($handle = fopen($manifest, 'w+'))) { $updraftplus->log('Failed to open zip manifest file ('.basename($manifest).')'); return false; } $version = 1; if (false === fwrite($handle, '{"version":'.$version.', "files":[{')) { $updraftplus->log('First write to manifest file failed ('.basename($manifest).')'); return false; } $last_dir_index = key(array_slice($zip_files, -1, 1, true)); foreach ($zip_files as $name => $size) { fwrite($handle, json_encode($name).' : '.$size.(($name != $last_dir_index) ? ',' : '')); } fwrite($handle, '}]}'); fclose($handle); $updraftplus->log("Successfully created zip file manifest (size: ".filesize($manifest).")"); $final_manifest = preg_replace('/\.list-temp.tmp$/', '.list.tmp', $manifest); rename($manifest, $final_manifest); } /* * Returns the member of the array with key (int)0, as a new array. This function is used as a callback for array_map(). * * @param Array $a - the array * * @return Array - with keys 'name' and 'type' / private function cb_get_name_base_type($a) { return array('name' => $a[0], 'type' => 'BASE TABLE'); } /* * Returns the members of the array with keys (int)0 and (int)1, as part of a new array. * * @param Array $a - the array * * @return Array - keys are 'name' and 'type' / private function cb_get_name_type($a) { return array('name' => $a[0], 'type' => $a[1]); } /* * Returns the member of the array with key (string)'name'. This function is used as a callback for array_map(). * * @param Array $a - the array * * @return Mixed - the value with key (string)'name' / private function cb_get_name($a) { return $a['name']; } /* * Exclude files from backup * * @param Boolean $filter initial boolean value of whether the given file is excluded or not * @param String $file the full path of the filename to be checked * @return Boolean true if the specified file will be excluded, false otherwise / public function backup_exclude_file($filter, $file) { foreach ($this->backup_excluded_patterns as $pattern) { if (0 === stripos($file, $pattern['directory']) && preg_match($pattern['regex'], $file)) return true; } return $filter; } /* * Adds WooCommerce-related information to the site info header for backup purposes. * * This method checks if WooCommerce is active and appends relevant information about * WooCommerce's state to the provided site info array. Specifically, it includes: * - Whether WooCommerce is active. * - Whether the High-Performance Order Storage (HPOS) feature is enabled. * * @param array $site_info The existing array of site information to which WooCommerce details will be appended. * @return array The updated site info array with WooCommerce-related details included. / public function backup_db_header_site_info_woocommerce($site_info) { if (class_exists('WooCommerce')) { $wc_version = defined('WC_VERSION') ? WC_VERSION : get_option('woocommerce_version'); $info = 'WooCommerce='.$wc_version; if (class_exists('Automattic\WooCommerce\Utilities\OrderUtil') && is_callable(array('Automattic\WooCommerce\Utilities\OrderUtil', 'custom_orders_table_usage_is_enabled')) && call_user_func(array('Automattic\WooCommerce\Utilities\OrderUtil', 'custom_orders_table_usage_is_enabled'))) { $info .= ',HPOS=enabled'; } $site_info[] = $info; } return $site_info; } } class UpdraftPlus_WPDB_OtherDB extends wpdb { /* * This adjusted bail() does two things: 1) Never dies and 2) logs in the UD log * * @param String $message Error text * @param String $error_code Error code * * @return Boolean */ public function bail($message, $error_code = '500') { global $updraftplus; if ('db_connect_fail' == $error_code) $message = 'Connection failed: check your access details, that the database server is up, and that the network connection is not firewalled.'; $updraftplus->log("WPDB_OtherDB error: $message ($error_code)"); // Now do the things that would have been done anyway if (class_exists('WP_Error')) { $this->error = new WP_Error($error_code, $message); } else { $this->error = $message; } return false; } }	229.38 KB	2025-10-09 08:53
📁 central	-	2025-10-09 08:53
📄 changelog-old.txt This file contains changelog entries that are not contained in the main readme.txt file (that file contains the newest entries). = 1.12.35 - 03/Mar/2017 = * FIX: Fix an issue causing corruption of interrupted Dropbox backups. All Dropbox users are recommended to update asap. * TWEAK: Fix a regression that prevented information about a faulty WP scheduler from being shown in recent releases (incomplete fix in 1.12.34) * TWEAK: submit_button() needs to be available (possible UpdraftCentral fatal when requesting filesystem creds) * TWEAK: Remove an ES5 JavaScript construct (incompatible with some old browsers) * TWEAK: Fix incorrect variable name in routine that triggered WP automatic update check * TWEAK: Fix a logic error whereby if Google Drive and Google Cloud were both in use and partially set up, a notice about completing the setup of Cloud could fail to show = 1.12.34 - 23/Feb/2017 = * FEATURE: Added the ability to allow other plugins to call an automatic backup more easily * FEATURE: Added the ability to select which tables you want to backup when using the 'Backup now' modal (Premium) * FIX: Re-scanning a Dropbox that contained more than 1000 backup archives only fetched the first 1000 (this was previously awaiting on Dropbox fixing a related bug on their API servers). * FIX: Escape table names to allow table names with hyphens in, when reading data * FIX: The "Advanced Tools" tab was appearing with no contents if you chose an unwritable backup directory (regression) * TRANSLATIONS: Remove bundled Swedish (sv), Spanish (Spain) (es_ES) and Czeck (Čeština‎, cs_CZ) translations, since these are now retrieved from wordpress.org. * TWEAK: Prevent a JavaScript message being logged when loading UD infrastructure on non-UD settings pages (e.g. plugins that integrate to do backups via UD) * TWEAK: Make it easier for other plugins to get/set UpdraftPlus options with less code * TWEAK: Make sure that the get_plugins() function is available before using it when generating notices * TWEAK: Add the updraftplus_exclude_directory and updraftplus_exclude_file filters allowing arbitrary backup exclusions from code * TWEAK: Add a work-around for a bug in some server/Firefox combinations in handling of the Content-Length header with non-ASCII characters * TWEAK: Cause an informational message to be shown in the Rackspace module if php-json is not enabled * TWEAK: Fix a regression that prevented information about a faulty WP scheduler from being shown in recent releases * TWEAK: Made alert regarding plupload's 'HTTP -200' error, when upload of file fails, more informative. * TWEAK: Internal changes to the remote storage method API (future improvements which build on these are planned) = 1.12.32 - 26/Jan/2017 = * FEATURE: Add UpdraftCentral (https://updraftcentral.com) UpdraftVault listener * FEATURE: Encryption and decryption is now chunked, meaning that large databases of any size can be encrypted without being prevented by memory limits * FIX: Fix a bug whereby if a backup set containing a manual "more files" element was imported via a remote scan, then an error would show concerning it when attempting to restore. * FIX: On certain combinations of changing the "more files to backup" settings, these changes might not be reflected in the "Backup Now" dialog without a page reload * FIX: Remove a PHP 5.5+-only construction that crept into 1.12.31 * TWEAK: Allow UpdraftCentral command classes to provide commands via the __call method * TWEAK: Move the existing backups table into the templating system * TWEAK: When trying to restore before cleaning up a previous restore, the detailed error message shown needed tweaking * TWEAK: Some refactoring of the dashboard JavaScript, to abstract/harmonise all AJAX calls * TWEAK: Removed the triple click and replaced it with standard double click * TWEAK: Some refactoring of the UpdraftCentral command interface, to facilitate reduction of duplicated dashboard control code * TWEAK: One less HTTP round-trip when deleting from the dashboard * TWEAK: Updated advanced tools to allow UpdraftCentral to use wipe settings and export / import * TWEAK: Revamped the 'Premium / Extensions' tab in the free version * TWEAK: Work around HTTP 400 error from Dropbox on servers with several-year old version of curl, caused by bad interaction between curl and Dropbox over a specific header * TWEAK: Add a notice advising of WP-Optimize (https://wordpress.org/plugins/wp-optimize/) to the available notices * TWEAK: Prevent an unwanted PHP log notice when using Google Drive * TWEAK: More file directories are now added using a directory browser * TWEAK: Update plugin update checker library (paid versions) to version 3.1, which fixes some PHP 7 issues = 1.12.30 - 23/Dec/2016 = * FIX: Fix a Dropbox APIv2 issue where paths containing certain characters were incorrectly being encoded * FEATURE: Add UpdraftCentral (https://updraftcentral.com) comment-control and advanced tools listeners * TWEAK: Starting an operation to retrieve a remote backup from UpdraftCentral succeeded, but gave a UI error in UC when doing so * TWEAK: Fix a Dropbox APIv2 issue where Team storage displayed an incorrect value * TWEAK: Support for the new AWS S3 Canada Central 1 and London regions * TWEAK: Some re-factoring of the settings page output code for easier maintenance * TWEAK: Some re-factoring of the notices code, to allow re-use in other projects * TWEAK: Make sure that a UpdraftCentral_Commands class is available before loading any external command classes, so that they can rely on its presence = 1.12.29 - 22/Nov/2016 = * FIX: Fix a PHP error in the notices code (regression in 1.12.28) * FIX: Manual database search and replace now outputs logged operation information (regression in 1.12.28) = 1.12.28 - 21/Nov/2016 = * TWEAK: The UPDRAFTPLUS_DROPBOX_API_V1 constant will be ignored from 28th June 2017 (when Dropbox turn off that API entirely) * TWEAK: A new internal infrastructure for handling user-visible notices in the dashboard and reports * TWEAK: Small layout tweak to fix a malformatted error message = 1.12.27 - 17/Nov/2016 = * FIX: The WP 4.7 compatibility tweak in 1.12.26 introduced a regression that caused the question to appear when unwanted on other WP versions. = 1.12.26 - 16/Nov/2016 = * COMPATIBILITY: On WordPress 4.7, the behaviour of shiny updates has changed, necessitating a small tweak to prevent an unwanted "do you really want to move away from this page?" question from the browser on the updates/plugins pages in some situations. * TWEAK: When the Dropbox quota state seems to imply that the next upload will fail, do not register this as an error before it actually happens. * TWEAK: When an error occurs when re-scanning Dropbox, make sure the error details are logged in the browser developer console * FIX: Fix ability to rescan a Dropbox sub-folder (regression in 1.12.25) = 1.12.25 - 12/Nov/2016 = * COMPATIBILITY: Dropbox APIv2 capability (see: https://updraftplus.com/dropbox-api-version-1-deprecation/) in 1.12.24 was not complete - this release now avoids all APIv1 use * TWEAK: The 'site information' advanced tool now contains information on loaded Apache modules. * TWEAK: Small layout tweak to fix a malformatted error message = 1.12.24 - 08/Nov/2016 = * FIX: When importing a single site into a multisite install as a new site (experimental feature), the main multisite URL was being incorrectly adjusted * FIX: Fix a bug with remote scans not returning more database archives correctly * COMPATIBILITY: Add Dropbox APIv2 capability (see: https://updraftplus.com/dropbox-api-version-1-deprecation/) * FEATURE: Look for mysqldump.exe in likely locations on Windows, for faster database backups * TWEAK: UpdraftVault, Amazon S3 and DreamObjects downloaders have been rewritten without race conditions * TWEAK: Introduce an abstraction layer for reporting on the status of restore operations * TWEAK: Deleting remote backup sets from the dashboard is now batched for sets with many archives, to avoid potential PHP timeouts on slow remote services * TWEAK: Updated bundled phpseclib library to version 1.0.4 * TWEAK: Introduce an internal templating layer, for improved long-term maintainability * TWEAK: When importing a single site into a multisite install as a new site, remove any cron entries for backup runs on the new site * TWEAK: Fix an inconsequential off-by-one in the chunked downloading algorithm so that the behaviour is as documented * TWEAK: Improve accessibility of Labelauty components with keyboard navigation * TWEAK: Tweak the algorithm for scheduling resumptions, to improve efficiency in the (once) seen corner-case of PHP usually having a predictable run-time, but with an instance of a much longer run-time * TWEAK: Slightly more logging when an S3 error condition occurs, allowing easier diagnosis * TWEAK: Add support for the new US East (Ohio) region to S3 * TWEAK: OneDrive authentication can now detect a block by CloudFlare, and direct the user accordingly * TWEAK: If there are remote storage methods needing authentication, then pop up a box showing this to the user - so that it does not rely on them spotting the dashboard notice or having read the instructions = 1.12.23 - 04/Oct/2016 = * FIX: Fix a bug in URL replacement when cloning from a flat configuration to a WP-in-own-directory configuration * FIX: The button for testing connections to extra databases added to the backup was not working * FIX: Direct dashboard logins from UpdraftCentral were not working on WP 3.2 - 3.4 sites * COMPATIBILITY: Will upgrade Dropbox OAuthv1 tokens to OAuthv2 (to handle Dropbox API v1 deprecation in summer 2017) * TWEAK: Deleting an already-deleted backup set from UpdraftCentral now produces a more informative error message * TWEAK: When restoring only a single site out of a multisite install, store less data in memory on irrelevant tables, and do less logging when skipping tables * TWEAK: Update bundled UDRPC library to version 1.4.9 - fixes a bug with the admin URL used for contact via UpdraftCentral on multisite * TWEAK: Explicitly store the UpdraftPlus object as a global * TWEAK: Prevent a pointless "unsaved settings" warning if settings were changed then the 'wipe' button used * TWEAK: When using the Importer add-on, allow backups from WordPress Backup to Dropbox to be wrapped in an extra 'wpb2d' folder * TWEAK: Strengthen protections against resuming an already-complete backup after migration on servers with misbehaving WP schedulers * TWEAK: Touch already-existing but incomplete files being downloaded, to reduce possibility of two processes downloading at once * TWEAK: Add a link to more information about UpdraftCentral in the advanced tool * TWEAK: The UPDRAFTPLUS_MYSQLDUMP_EXECUTABLE define can now be used on Windows (you will need to define a path to take advantage of it) * TWEAK: Introduce the UPDRAFTPLUS_SKIP_CPANEL_QUOTA_CHECK constant to allow skipping of trying to check cPanel quota = 1.12.21 - 08/Sep/2016 = * FIX: Fix a bug in the updater code that caused updates checks to be run more often than intended * TWEAK: Improve/tidy layout of the "Advanced Tools" tab * TWEAK: Make it more obvious in the file uploading widget when an upload is 100% complete * TWEAK: Prevent spurious OneDrive message being shown when re-scanning remote storage and not using OneDrive * TWEAK: OneDrive storage now uses the refresh token yes frequently (less HTTP calls) = 1.12.20 - 29/Aug/2016 = * FEATURE: OpenStack uploads (including Rackspace Cloudfiles) can now adapt their upload rate to network conditions, leading to much faster uploads on many networks * FEATURE: Updated the OneDrive configuration to make it easier to setup. A custom Microsoft Developer App is no longer required * FEATURE: The "Advanced Tools" tab now has tools for importing and exporting settings * TWEAK: Honour the "do not verify SSL certificates" setting with WebDAV storage on PHP 5.6+ * TWEAK: When there's a connection problem to updraftplus.com when claiming licences, provide more error info and guidance * TWEAK: In particular circumstances (malfunctioning WP scheduler, expert option to keep backups after despatching remotely selected (non-default)), zips could be sent to Google Drive more than once * TWEAK: Tweak issue in 1.12.18 with automatic backup pop-up appearing under another pop-up if you update themes via the themes pop-up (instead of the direct link) * TWEAK: When rescanning remote storage, don't log a potentially confusing message for an unconfigured storage module * TWEAK: Show a visual indicator and advice if an invalid hostname is entered for WebDAV * TWEAK: Removed the no-longer-useful debug backup buttons * TWEAK: Add a message when generating a key on a server without php-openssl, with information about how to make it faster * TWEAK: Prevent PHP installs which print PHP logging information to the browser from messing up the WebDAV settings in some situations * TWEAK: If PHP reports the current memory limit as a non-positive integer, do not display any message to the user about a low memory limit * TWEAK: If the user deletes their Google API project, then show clearer information on what to do when a backup fails * TWEAK: If you changed your OneDrive client ID, UD will now more clearly advise you of the need to re-authenticate * COMPATIBILITY: Updated the OneDrive authentication procedure to make it compatible with the new Microsoft Developer Apps = 1.12.18 - 03/Aug/2016 = * TWEAK: When Microsoft OneDrive quota is insufficient, the advisory message from UD now includes the available quota (as well as the used) * FEATURE: The Azure add-on/Premium now supports new-style Azure storage, as well as classic * FEATURE: The Rackspace enhanced wizard can now be accessed via UpdraftCentral * TWEAK: Fix a regression in recent WP versions which caused remote keys to not always be retained after a migration * TWEAK: When logging Azure upload locations, include the account name * TWEAK: Make the entering of settings for WebDAV more user-friendly * TWEAK: Update bundled select2 to version 4.0.3 * TWEAK: Clarify error message when a 'more files' location is not found * TWEAK: Add redirection_404 to the list of tables likely to be large, and not needing search/replacing * COMPATIBILITY: Compatible with WP 4.6 (previous paid versions have incompatibilities with the changes made to 'shiny updates/installs/deletes' in WP 4.6) = 1.12.17 - 19/Jul/2016 = * FIX: Previous free release included empty translation files * TWEAK: Add 'snapshots' to the default list of directories to exclude from the uploads backup (is used by another backup plugin - avoid backups-of-backups) * TWEAK: Add et_bloom_stats to the list of tables likely to be large, and not needing search/replacing = 1.12.16 - 07/Jul/2016 = * TWEAK: Log FTP progress upload less often (slight resource usage improvement) * TWEAK: For multi-archive backup sets, the HTML title attribute of download buttons had unnecessary duplicated information * TWEAK: Improve OneDrive performance by caching directory listings * TWEAK: Detect and handle a case in which OneDrive incorrectly reports a file as incompletely uploaded * FIX: OneDrive scanning of large directories for existing backup sets was only detecting the first 200 files = 1.12.15 - 06/Jul/2016 = * TWEAK: S3 now supports the new Mumbai region * TWEAK: If the user enters an AWS/S3 access key that looks prima facie invalid, then mention this in the error output * TWEAK: Make the message that the user is shown in the case of no network connectivity to updraftplus.com when connecting for updates (paid versions) clearer * TWEAK: Extend caching of enumeration of uploads that was introduced in 1.11.1 to other data in wp-content also * TWEAK: Avoid fatal error in Migrator if running via WP-CLI with the USER environment variable unset * TWEAK: When DB_CHARSET is defined but empty, treat it the same as if undefined * TWEAK: Add updraftplus_remotesend_udrpc_object_obtained action hook, allowing customisation of HTTP transport options for remote sending * TWEAK: Introduced new UPDRAFTPLUS_RESTORE_ALL_SETTINGS constant to assist in complicated load-balancing setups with duplicate install on the same URL * TWEAK: Update bundled tripleclick script to fix bug in teardown handler * TWEAK: Update bundled UDRPC library to version 1.4.8 * TWEAK: Patch Labelauty to be friendly to screen-readers * TWEAK: Suppress the UD updates check on paid versions that immediately follows a WP automatic core security update * TWEAK: Handle missing UpdraftCentral command classes more elegantly * FEATURE: Endpoint handlers for forthcoming updates and user management features in UpdraftCentral * TRANSLATIONS: Remove bundled German (de_DE) translation, since this is now retrieved from wordpress.org * FIX: Fix inaccurate reporting of the current Vault quota usage in the report email * FIX: Fix logic errors in processing return codes when no direct MySQL/MySQLi connection was possible in restoring that could cause UpdraftPlus to wrongly conclude that restoring was not possible = 1.12.13 - 07/Jun/2016 = * TWEAK: Default the S3 secret key field type to 'password' instead of 'text' * TWEAK: Do more checks for active output buffers prior to spooling files to the browser (to prevent memory overflows) * TWEAK: Update bundled UDRPC library to version 1.4.7 = 1.12.12 - 25/May/2016 = * FIX: When restoring a plugins backup on multisite, old plugins were inactivated but not always removed * TWEAK: Use POST instead of GET for OneDrive token requests - some new accounts seem to have begun requiring this * TWEAK: When backing up user-configured directories, don't log confusing/misleading messages for unzippable directory symlinks * TRANSLATIONS: wordpress.org is now serving up translations for fr_FR, pt_PT and ro_RO, so these can/have been removed from the plugin zip (1.2Mb released) = 1.12.11 - 19/May/2016 = * FIX: 1.12.8 (paid versions only) contained a regression that prevented S3 access if the user had a custom policy that did not include location permission. This fix means that the work-around of adding that permission to the policy is no longer required. * FIX: Fix a regression in 1.12.8 that prevented non-existent DreamObjects buckets from being created * FIX: Fix inaccurate reporting of the current Vault quota usage in the report email since 1.12.8 * FIX: The short-lived 1.12.10 had a duplicate copy of the plugin in the release zip * TWEAK: Detect a particular obscure PHP bug in some versions that is triggered by the Amazon S3 SDK, and automatically switch to the older SDK if it is hit (N.B. Not compatible with Frankfurt region). * TWEAK: Audit/update all use of wp_remote_ functions to reflect API changes in the upcoming WP 4.6 * TWEAK: Tweak to the settings saving, to avoid a false-positive trigger of a particular rule found in some mod_security installs * TWEAK: Update bundled UDRPC library to version 1.4.5 = 1.12.9 - 11/May/2016 = * FIX: In yesterday's 1.12.8, some previously accessible Amazon S3 buckets could no longer be accessed = 1.12.8 - 10/May/2016 = * FEATURE: Support S3's "infrequent access" storage class (Premium) * FIX: Fix bug in SFTP uploading algorithm that would corrupt archives if a resumption was necessary * TWEAK: Add information on UpdraftVault quota to reporting emails * TWEAK: Update the bundled AWS library to version 2.8.30 * TWEAK: Update the bundled Symfony library to version 2.8.5 * TWEAK: Update the bundled phpseclib library to version 1.0.2 (which includes a fix for SFTP on PHP 5.3) * TWEAK: Improve the overlapping runs detection when writing out individual database tables, for helping servers with huge tables without mysqldump * TWEAK: Prevent restoration from replacing the local record of keys of remote sites to send backups to (Migrator add-on) * TWEAK: Re-order the classes in class-zip.php, to help misbehaving XCache (and perhaps other opcode cache) instances * TWEAK: Do not include transient update availability data in the backup (which will be immediately out-of-date) * TWEAK: Updated the URLs of various S3-compatible providers to use SSL, where available * TWEAK: Added an endpoint drop-down for Dreamobjects, using their new/updated endpoint (currently only one choice, but they will have more in future) * TWEAK: Suppress a log message from UpdraftVault when that message is not in use * TWEAK: When key creation times out in the Migrator, display the error message in the UI = 1.12.6 - 30/Apr/2016 = * FIX: UpdraftVault quota usage was being shown incorrectly in recounts on sites connected to accounts backing up multiple sites * TWEAK: In accordance with Barracuda's previous announcement, copy.com no longer exists - https://techlib.barracuda.com/CudaDrive/EOL * TWEAK: Allow particular log lines to be cancelled * TWEAK: Explicitly set the separator when calling http_build_query(), to prevent problems with non-default configurations * TWEAK: Tweak the algorithm for sending data to a remote UD installation to cope with eventually-consistent filesystems that are temporarily inconsistent * TWEAK: Make the automatic backups advert prettier * TWEAK: Detect and combine file and database backups running on different schedules which coincide * TWEAK: Update bundled Select2 to version 4.0.2 * TWEAK: Update UDRPC library to version 1.4.3 * TWEAK: Update dashboard notices for 2017/18 = 1.12.5 - 08/Apr/2016 = * TWEAK: (Paid versions) - tweak the updater class so that it sends the information that updraftplus.com needs in order to correctly advise about language pack update availability. (If you are continuously seeing the same language pack update offered, then this may continue for a few more hours - please be patient!). * TWEAK: Detect another case and deal with an HTTP 413 response when sending chunked data on a direct site-to-site migration = 1.12.4 - 07/Apr/2016 = * FEATURE: Faster uploads to Dropbox, via adapting to network conditions: https://updraftplus.com/faster-dropbox-uploads/ * FEATURE: (Paid versions) Plugin now no longer bundles all translations - instead, WP's mechanism for downloading single translations, as/when needed, is used (reduces on-disk size by 12MB=36%)). * FIX: Deal with some database encryption phrases with special characters that were incorrectly processed * FIX: Deal with an error in the advanced retention rules processing code, that could lead to keeping the wrong backup set * FIX: Fix an unescaped string which could cause a JavaScript notice on the UD settings page in some non-English translations * FIX: The minimum allowed value for the split size was not previously taking effect when saving settings * TWEAK: When connection to an updraftplus.com UpdraftCentral dashboard, allow use of the alternative connection method * TWEAK: Suppress some known deprecation warnings on PHP 7 * TWEAK: Show OpenSSL/Mcrypt info in the log + debug info * TWEAK: Detect a completed upload to Dropbox masked by a race event from the WP scheduler * TWEAK: The drop-down in the 'Migrate' dialog will now update on a rescan without needing a page reload * TWEAK: (Paid versions) Update bundled plugin updater class (Yahnis Elsts) to version 3.0 * TWEAK: Add woocommerce_sessions to the list of tables of transient data * TWEAK: When saving settings, if invalid input is adjusted, this will be reflected back to the UI without a page load (not on all elements) * TWEAK: When saving settings, the schedule was written twice on non-multisite installs = 1.12.2 - 30/Mar/2016 = * TWEAK: When testing Amazon S3 bucket accessibility, slightly improve one of the corner-case checks * TWEAK: When creating an encryption key for direct Migration, or UpdraftCentral, allow the user to choose their key size (this helps with PHP installs lacking both OpenSSL and GMP, in which case key creation can be really slow) * TWEAK: Detect another case and deal with an HTTP 413 response when sending chunked data on a direct site-to-site migration = 1.12.1 - 24/Mar/2016 = * TWEAK: Update the bundled remote communications library - needed for some UpdraftCentral users = 1.12.0 - 23/Mar/2016 = * FEATURE: Compatible with the forthcoming (very soon!) UpdraftCentral remote control panel * COMPATIBILITY: Tested + supported on the upcoming WordPress 4.5 * FIX: On some setups, if no remote storage was configured (not recommended), then old backups were not being pruned * FIX: Make FTP active mode (very rarely seen) work correctly again * TWEAK: Added a hint to FTP users who appear to be firewalled on only the data channel when attempting to use encrypted FTP * TWEAK: Improve detection of the WordPress scheduler duplicating periodic events when the server is overloaded * TWEAK: Simplify main tab layout upon first use * TWEAK: Add some previously unbundled licence files * TWEAK: Prevent a couple of PHP notices being logged when running a manual search/replace * TWEAK: Add a filter to allow more over-riding of pruning = 1.11.29 - 27/Feb/2016 = * FIX: When saving settings on multisite, some connections to remote storage could drop and need to be re-made * FIX: Fix an inoperative button in the Clone dialog box * FIX: Fix an error upon automatic backups (Premium) in 2.11.28 * TWEAK: Updated readme to reflect > 700,000 active sites * TWEAK: When cloning a site and mod_rewrite is not available, give a warning pre-restore * TWEAK: Options saving on multisite is now much more efficient (in terms of database requests required) * TWEAK: Improve the scheduling algorithm in the case of hosts that allow very long runs times, and a network outage on the cloud storage * TWEAK: When connecting to updraftplus.com to claim a licence (paid versions), use the newer JSON-based protocol * TWEAK: Many and various internal improvements to structure of the admin page HTML, CSS and JS * TWEAK: The boxes for adding extra addresses for reporting, and extra DBs, now fade in = 1.11.27 - 17/Feb/2016 = * FEATURE: Automatic backups can take place before updates commissioned via WordPress.Com/JetPack remote site management (requires a not-yet-released version of JetPack - all current releases are insufficient, so please don't file reports about this yet) * FIX: Fixed a further logic error in the advanced backup retention options, potentially relevant if you had more than one extra rule, affecting the oldest backups * TWEAK: Resolve issue on some sites with in-dashboard downloads being interfered with by other site components * TWEAK: Auto-backups now hook to a newly-added more suitable action, on WP 4.4+ (https://core.trac.wordpress.org/ticket/30441) * TWEAK: Make WebDAV library not use a language construct that's not supported by HHVM * TWEAK: Change options in the "Backup Now" dialog as main settings are changed * TWEAK: Show the file options in the "Backup Now" dialog if/when alerting the user that they've chosen inconsistent options * TWEAK: When pruning old backups, save the history to the database at least every 10 seconds, to help with sites with slow network communications and short PHP timeouts = 1.11.26 - 13/Feb/2016 = * TWEAK: Prevent HTTP 500 download errors on some very large file/hosting setups * TWEAK: A tiny number of users had a badly laid-out settings screen until they refreshed their browser cache. This release prevents that. = 1.11.24 - 10/Feb/2016 = * FIX: Fixed further logic errors in the advanced backup retention options, potentially relevant if you had more than one extra rule * TWEAK: Saving of settings is now done over AJAX (i.e. without a page reload) * TWEAK: In-dashboard downloads now process the HTTP Range: header, allowing resumption of failed downloads via the browser * TWEAK: Tweak 'Existing Backups' table CSS, to allow more entities per row * TWEAK: Warn copy.com users of Barracuda ending the service - https://techlib.barracuda.com/CudaDrive/EOL * TWEAK: Rename the 'hidden' CSS class, to prevent clashes with other plugins/themes which load their CSS code onto UD's page (which they shouldn't be doing) * TWEAK: Fix newsletter sign-up link * TWEAK: Log and triple-click summary now mentions the total size of the backup (i.e. total of the compressed backup set) * TWEAK: Try to detect a very rare case of recoverable database read failure, and schedule a re-try * TWEAK: Suppress unnecessary warning message when Dropbox account info checking fails * TWEAK: Attempt to restart a large OneDrive upload in a particular case seen when OneDrive's end seems to get into confusion about state * TWEAK: Various bits of internal re-factoring to support future improvements = 1.11.23 - 26/Jan/2016 = * FIX: When migrating a sub-folder based multisite into a non-root install with different relative path to the source multisite (I can't think of any good reasons to do this), the search/replace could leave sub-sites unreachable without manual correction * FIX: Logic errors in the advanced backup retention options could lead to the oldest backups being deleted prematurely, and some backups not being deleted when they were overdue for deletion * FIX: Amazon S3 bucket creation wizard (in the S3 enhanced add-on) was not honouring the chosen region for new buckets * FIX: Upon restoration over an existing site, inactive plugins could remain post-restore (bug introduced in 1.11.20) * TWEAK: Various internal re-organisations, to improve modularity/re-use of the code * TWEAK: Internal CSS re-organisation to make future layout changes easier * TWEAK: The "stop" link in the backup progress indicator now halts the backup asap, instead of at the next scheduled resumption * TWEAK: Clarify the course of action needed if you attempt a Dropbox backup without Curl * TWEAK: Add support for the new Asia Pacific (Seoul) region to Amazon S3 * TWEAK: Make the automatic backup option box appear on the updates page for users who can update plugins or themes (not just core - previously it was assumed that these would always go together in the real world, but some managed hosts are now removing the core update capability from the default admin user, whilst leaving the others) * TWEAK: Change default zip split size to 400Mb on new installs * TWEAK: Clean up use of composer, to conform to proper usage standards, and update to current version (to avoid causing a problem for plugins using PSR-4 autoloaders) * TWEAK: Provide direct links to cart when choosing UpdraftPlus Vault storage * TWEAK: Add debug.log to the default exclusions in wp-content (when people leave debug logging on and forget, it can get huge) * TWEAK: On multisite, make sure that the site/blogs tables are placed early in the backup (assists with quickly scanning backup info) * TWEAK: Update to phpseclib 1.0.1 * TWEAK: Prevent a PHP notice when using SCP * TWEAK: Add new termmeta table to the default list of core tables (which is usually automatically detected) = 1.11.21 - 28/Dec/2015 = * TWEAK: If there's a problem connecting to UpdraftPlus Vault, in some situations the information on the cause was not easily readable * TWEAK: Slightly more logging on failed OneDrive operations, to aid problem-solving * TWEAK: Add wysija_email_user_stat to the list of potentially huge non-critical tables (which can get skipped in an emergency) * FIX: Package Pear/Exception.php, so that servers without it already can use Microsoft Azure blob storage * FIX: Prevent PHP fatal error on admin area in some restore scenarios = 1.11.20 - 21/Dec/2015 = * FEATURE: WordPress multisite backup administrators can now selectively restore data from a chosen site, instead of restoring the entire WordPress install - https://updraftplus.com/selectively-restoring-on-wordpress-multisite/ (requires WP 3.5+, UpdraftPlus Premium) * FEATURE: Import a WordPress single-site backup into WordPress multisite, as a new site (requires WP 3.5+, UpdraftPlus Premium) - https://updraftplus.com/information-on-importing-a-single-site-wordpress-backup-into-a-wordpress-network-i-e-multisite/ * FIX: Properly encode folder paths with Copy.Com, allowing some previously prevented folder names to work * FIX: In-dashboard decryption using some decryption keys with URL-encodable characters failed * FIX: Prevent PHP fatal error on settings page on a buggy old PHP version (5.2.10) when Google Cloud storage add-on not present * FIX: When using multiple remote storage providers, a race condition could lead to some old backups not being deleted on the storage not uploaded to last * FIX: Views are now placed after tables in the database backup * FIX: In-page uploader widget was not working on sub-domain based multisites in some dashboard access scenarios * FIX: Package Net/URL2 (PEAR), so that servers without it already can use Microsoft Azure blob storage * TWEAK: Upgrade Microsoft OneDrive API usage to latest version * TWEAK: Automatic backups are now hooked into the themes page in the network admin on WP multisite installs * TWEAK: Dashboard messages were not being clearly shown when trying to use UpdraftPlus Vault without PHP Curl available * TWEAK: Protect against other plugins loading incompatible Google SDKs when Google Cloud is being used * TWEAK: When trying to use S3, DreamObjects or UpdraftPlus Vault without PHP Curl available, make the cause of the problem more obvious * TWEAK: When sending data to remote site, keep re-trying on receipt of an HTTP 413 (request entity too large) down to 64Kb (instead of previous 128Kb) - a webserver was seen in the wild configured at this level * TWEAK: Detect the WordPress scheduler invoking a scheduled backup multiple times, in some cases where the existing semaphore lock wasn't helping (because the backup already finished, or the WP scheduler invoked multiple instances of the same event minutes apart - apparently possible when very heavily overloaded) * TWEAK: Detect an inconsistent semaphore locking state, and fix it (apparently only possible upon unexpected server crash) * TWEAK: Provide a button to cancel (not just continue) an interrupted restore * TWEAK: Work around buggy Ubuntu PHP versions - https://bugs.launchpad.net/ubuntu/+source/php5/+bug/1315888 * TWEAK: Make sure that backup options get passed on with continuation data, when resuming an interrupted restore * TWEAK: Catch a few untranslated strings (in the decryptor widget for encrypted backups) * TWEAK: Log more information if a connection to UpdraftPlus Vault fails * TWEAK: The internal info shown when triple-clicking a backup set's date had messed-up formatting = 1.11.18 - 25/Nov/2015 = * FEATURE: On hosts with low timeouts that kill restore operations half-way though, provide an obvious button on the dashboard to immediately resume; see: https://updraftplus.com/resuming-interrupted-restores/ * FEATURE: Usability improvements and ability to select file components in the 'Backup Now' dialog - https://updraftplus.com/improvements-to-the-backup-now-dialog-box/ * FEATURE: Full support for Microsoft Azure blob storage (UpdraftPlus Premium) * FEATURE: Allow all files beginning with a defined prefix to be excluded from the backup by inputting (for example) prefix:someprefix_,prefix:someotherprefix- in your exclusion settings - see: https://updraftplus.com/faqs/how-can-i-exclude-particular-filesdirectories-from-the-backup/ * FEATURE: UpdraftPlus Premium can now restore backups created by "Dropbox Backup" by WPAdm * COMPATIBILITY: Tested/supported on the forthcoming WordPress 4.4 * TWEAK: Faster zip file creation on PHP 7 with ZipArchive - https://updraftplus.com/faster-zip-file-creation-with-the-php-7-zip-engine/ * TWEAK: Improve settings tab: remove headings, tweak a few wordings, move "remote storage" section further up * TWEAK: Introduce UPDRAFTPLUS_SET_TIME_LIMIT internal constant * TWEAK: Quote the table name passed to MySQL in DESCRIBE statement * TWEAK: Prevent a PHP notice being logged during initial updates connection, and another when restoring third-party databases * TWEAK: Style previously unstyled button in some auto-backup scenarios * FIX: A few settings were not being deleted by the "Wipe Settings" button. * FIX: Importer would not correctly handle third-party backups where the files and zip were both in zip format, separately, and where they were restored together * FIX: With multi-archive backup sets, files in the top level of a backup of WP core or 'others' were not restored by an in-dashboard restore if they over-wrote an existing non-identical file if they were not in the first archive = 1.11.17 - 13/Nov/2015 = * FIX: Resolve a conflict with "Simple Calendar" (formerly "Google Calendar Events") since their re-written 3.0 release, when using Google Drive storage = 1.11.15 - 28/Oct/2015 = * FEATURE: Google Cloud Storage support (UpdraftPlus Premium) * FIX: Automatic backups of WordPress core prior to WP core upgrade in recent versions were including non-WP core files * FIX: OwnCloud 8.1's WebDAV server responds differently, breaking UD's communications: restore the ability to backup to OwnCloud WebDAV * TWEAK: Allow use of the Meta key for selecting multiple backup sets (as well as Control) * TWEAK: When sending backup data directly site-to-site (when migrating), handle the (very rare) case where a remote server complains of the chunk size after accepting previous chunks of the same size * TWEAK: Add message to final log line when sending backup set directly to a remote site, reminding the user of what to do next. * TWEAK: Tweak zip-splitting algorithm, to prevent delayed split on resumption when final file in the last-created zip is gigantic * TWEAK: By default, exclude directories that appear to be the UpdraftPlus internal directory of a site stored in a sub-directory when backing up WordPress core * TWEAK: In the debugging output, show more clearly when Curl is not installed * TWEAK: Remove trailing slashes from what WP returns as the uploads/plugins directories, in case the user has specified a manual directory over-ride and erroneously added a trailing slash * TWEAK: Replace all remaining http:// links to updraftplus.com with https:// * TWEAK: Raise some of the Google Drive network timeouts * TWEAK: Suppress an internal PHP notice when pruning backups in some circumstances * TRANSLATIONS: Various updated translations = 1.11.12 - 29/Sep/2015 = * FEATURE: More sophisticated rules for retention/deletion (UpdraftPlus Premium) - https://updraftplus.com/more-sophisticated-backup-retention/ * FEATURE: Delete multiple backups at once - https://updraftplus.com/deleting-multiple-backups/ * FEATURE: When choosing a monthly backup, you can now choose the starting date (e.g. choose 17th, not just choose the next week-day, e.g. next Monday) * FEATURE: You can exclude files with any particular extension by using the constant UPDRAFTPLUS_EXCLUDE_EXTENSIONS (comma-separate different extensions), or by inputting (for example) ext:.zip,ext:.mp4 in your exclusion settings. * FEATURE: Tested and supported on the forthcoming PHP 7.0 * FIX: SFTP uploads could hang after finishing, if more than one attempt was needed to upload the file * FIX: Stop causing JavaScript errors on WordPress 3.2 on the plugins page * TWEAK: UI improvement when choosing multiple storage options - https://updraftplus.com/a-prettier-way-to-choose-remote-storage-options/ * TWEAK: The storage selection drop-down (free version) now has icons to make it easier on the eye * TWEAK: Use UpdraftPlus Vault logo * TWEAK: Replace target="_new" with target="_blank" when opening new browser ports, to be more standards-compliant * TWEAK: Tweak the auto-split algorithm again to catch another case where it would have been better to split in a low-resource situation * TWEAK: When checking the backup integrity, allow for a multisite to not have a root options table; check sitemeta instead (unlikely, but theoretically possible) * TWEAK: Raise default Google Drive network timeout from 15 seconds - it's too possible to hit this on a slow uplink (e.g. congested ADSL) * TWEAK: Upgrade the bundled Google SDK to the most recent release (1.1.4) * TWEAK: Add previously-untranslated string * TWEAK: Suppress a PHP notice relating to a constant that needed quoting * TWEAK: Turn off reporting of PHP deprecation conditions if using phpseclib on PHP 7 (can break communications - phpseclib uses PHP4-style constructors) * TRANSLATIONS: Various updated translations = 1.11.9 - 04/Sep/2015 = * FIX: Dropbox introduced an un-documented, un-announced change to their server, which caused new site authentications in UpdraftPlus to no longer work. Now fixed with this release. * FIX: If backing up multiple extra directories under "more files", if large directories required a resumption, then inclusion of the files multiple times in the backup was possible. * TWEAK: Tweak the auto-split algorithm to not avoid firing in a particular case (that relies on a sequence of unlikely I/O events, seen on GoDaddy) if there's no resumption scheduled * TWEAK: Add mysql.sql to the (changeable) default configuration for excludes from wp-content - on WP Engine this is an unreadable file that they create that thus produces a backup warning * TWEAK: Add a dashboard warning (+ link to documentation) if UD appears to be incompletely installed * TWEAK: Add UPDRAFTPLUS_WEBDAV_NEVER_CHUNK constant for WebDAV servers that return the wrong error code when chunking fails * TWEAK: Introduce a UPDRAFTPLUS_REMOTESEND_DEFAULT_CHUNK_BYTES constant allowing the over-riding of the remote-send (Migrator) starting chunk size in wp-config.php (expert users) * TWEAK: Add CSS classes to dashboard updates notices, so that people can hide them more easily if they wish * TWEAK: If gzopen() is disabled, then test binzip without trying to use PclZip to verify the results * TWEAK: Add work-around for PHP bug https://bugs.php.net/bug.php?id=62852 = 1.11.6 - 22/Aug/2015 = * FIX: SFTP was not working in 1.11.4 for some servers (related to phpseclib library update and sources of random data) * FIX: 1.11.5 release had wrong version number in header for paying users; corrected with fresh release = 1.11.4 - 19/Aug/2015 = * FIX: Perform previously missing tweak on the database after restoring a multisite backup to an install with a different table prefix, which inhibited the ability to create new users on the main site in a network. * TWEAK: Remove an inefficiency when examining files to prune from Google Drive, reducing the amount of time needed. * TWEAK: Show a warning if UpdraftPlus's directory in wp-content/plugins has been manually renamed to include a space, which WordPress does not support * TWEAK: Skip search/replacing of the 'guid' column in the posts table when migrating (improves performance - and prevents possible re-appearances of blog articles in peoples' feed readers if double-migrating) * TWEAK: Upgraded the bundled phpseclib Math, Net and File libraries to current versions (1.0 branch) * TWEAK: Prevent PHP notice in log file when deleting FTP backup from dashboard * TRANSLATIONS: Updated translations, including Greek = 1.11.3 - 13/Aug/2015 = * FIX: Fix access to S3 for PHP 5.2 users using buckets in the US-WEST-1 region * FIX: Fix access to UpdraftPlus Vault for some PHP 5.2 users = 1.11.2 - 11/Aug/2015 = * TWEAK: Handle the results when someone with no UpdraftPlus Vault quota attempts to connect more gracefully = 1.11.1 - 10/Aug/2015 = * FEATURE: UpdraftPlus Vault storage - simple to set up storage from your trusted provider: https://updraftplus.com/landing/vault - with 1Gb of free storage for UpdraftPlus Premium customers ( https://updraftplus.com/shop/updraftplus-premium/ ) - and more storage available for anyone to purchase. All other storage options (Dropbox, Google Drive, etc.) remain available, of course! * FEATURE: S3 enhanced wizard now allows the user to optionally deny the new Amazon Web Services IAM user download and/or delete permissions, for an even more secure setup (at the cost of some convenience - you will need to download/restore/delete S3 backups outside of UpdraftPlus). * FEATURE: Amazon S3 in UpdraftPlus Premium now supports optional server-side encryption * FEATURE: An "UpdraftPlus" menu now appears on the WP admin bar, allowing quick access. * COMPATIBILITY: Tested and compatible with WordPress 4.3 * SPEED: For users' whose backups are created with a zip binary (the default engine, where available), CPU usage + zip creation times have been significantly reduced * SPEED: For users cloning a website with a large number of users and a changed table prefix, a long and slow series of SQL operations has been replaced with a single fast one * FIX: The chunk-uploading algorithm for Copy.Com could unnecessarily upload the same chunks multiple times. We have not had any reports, but we believe it's also theoretically possible that a Copy.Com upload could have been corrupted by the same issue, so recommend updating for all Copy.Com users. * FIX: Fix issue with site cloning whereby on sites with very large numbers of entries in the postmeta table that needed search/replacing, some could be omitted (in the case seen, the table had >600,000 entries) * FIX: Saving the settings immediately after authenticating with Copy.Com resulted in being redirected to WP's page for all settings. * FIX: If PHP was killed by the webserver during the process of pruning old backups, then this would not be retried until the next backup, thus potentially leaving more backups than desired around in remote storage in the meanwhile. * FIX: Log files sometimes failed to mention the MySQL version * TRANSLATIONS: Various updated translations - thanks to our translators * TWEAK: When choosing multiple remote storage options (Premium), these are now stacked via tabs, instead of vertically as before * TWEAK: More help for enormous sites on badly resourced web hosting: part of the enumeration of uploads needing backing up is now cached, allowing more to be time when time limits are short * TWEAK: Secret credentials (e.g. S3 secret key) in the admin area are now starred (as explained in our long-standing FAQ, this does nothing to protect against malicious WordPress co-admins on your site - https://updraftplus.com/faqs/in-the-administration-section-it-shows-my-amazon-ftp-etc-passwords-without-using-stars-is-this-safe/ - but at least we won't get asked about it so many times!). * TWEAK: Provide more direct help to the user if they are hosting with Strato and get the 'File Size Limit Exceeded' zip message * TWEAK: When migrating data directly to a remote site, if the remote site returns a 413 HTTP code ("Request Entity Too Large"), re-try using a smaller chunk size * TWEAK: Log when about to begin encryption of a database file (allowing the progress to be monitored more easily if there's a problem) * TWEAK: Detect a further case of an incompatible database (that is from a remote source and uses MySQL features not present on the destination server) and warn before attempting to import. * TWEAK: Make the error message shown if trying to restore an incompatible database (that is from a remote source and uses MySQL features not present on the destination server) clearer. * TWEAK: If the user uses "Backup Now" before saving their settings, warn them that the unsaved settings changes won't apply to this backup * TWEAK: Only warn about very large files found once for each file (rather than once per resumption) * TWEAK: Add the UPDRAFTPLUS_GOOGLEDRIVE_DISABLEGZIP constant - define it as true to work-around broken HTTP setups (possibly broken outgoing proxy?) when accessing Google Drive * TWEAK: When claiming an add-on (paid versions), the user's updraftplus.com password will automatically be forgotten once it is no longer needed * TWEAK: Handle the case of the user typing in an invalid number of backups to retain more elegantly * TWEAK: No longer require the php-mcrypt module for Dropbox * TWEAK: Also retry a smaller chunk size if it looks like mod_security unhelpfully replaced a 413 HTTP code with a 200 success message despite the operation actually failing for this reason, or if it looks like sending is just timing out before the PHP timeout (so that we don't get notified). * TWEAK: Added new CA root certificates to store (http://curl.haxx.se/ca/cacert.pem) * TWEAK: If the Migrator's direct-send component drops its chunk size, then store this information so that it doesn't have to go through the cycle of finding the best chunk size the next time. * TWEAK: Added UPDRAFTPLUS_IPV4_ONLY constant to prevent use of IPv6 (currently implemented by Google Drive only) * TWEAK: Deal with a case where the web host appears to be losing disk I/O near kill time, despite later database writes going through (so, the order of operations was insufficient to guarantee what had been completed). This issue was only cosmetic - backup sets were intact (hence "tweak", not "fix") * TWEAK: Increase HTTP timeout for remote site-to-site operations * TWEAK: Don't cause the 'debug' tab to abort rendering if the web host has disabled the gzopen() function (which is an odd/pointless thing to do) * TWEAK: Resolve PHP 'strict standards' coding internal notice in Google Drive module = 1.10.3 - 2015-06-09 = * FEATURE: Migration component can now send backup data directly from one WP site to another - https://updraftplus.com/shop/updraftplus-premium/ * FEATURE: Support active mode FTP servers (extremely rare) * FIX: The error message when choosing no components to restore was empty * FIX: Restore ability to run on WordPress 3.5 (actually fixed in downloads of 1.10.1 after 2015-05-13) * FIX: Some automatic pre-upgrade backups were not marked internally as such, leading UD to delete the oldest scheduled backup prematurely backups prematurely * TWEAK: Reduce HTTP round-trips when checking presence + downloading backup archives in a restore/migrate operation * TWEAK: Alert the user earlier if they're trying to use a database with a character set not supported by MySQL * TWEAK: Use separate internal jobs for separate downloads, and thus avoid race conditions when updating job data (symptom: download widgets that don't show current information) * TWEAK: Add constant UPDRAFTPLUS_SFTP_TIMEOUT allowing users to over-ride (via wp-config.php) the default SFTP timeout (default now: 15 seconds). * TWEAK: Make Copy.Com filter out non-backups from remote file listings at an earlier stage * TWEAK: Log more information when a curl error occurs when getting a OneDrive access token * TWEAK: Code re-arrangement in OneDrive library to deal with sites using the obsolete PHP safe_mode * TWEAK: Clearer message for users whose access to paid plugin updates has expired (paid versions) * TWEAK: Improve detection of started pre-upgrade automatic backups in case of webserver misbehaviour * TWEAK: Fix untranslated message when confirming the wiping of settings * TWEAK: Replace more non-SSL links to updraftplus.com with SSL links * TWEAK: Use a POST instead of a GET during one of the restore sub-stages (avoids a false positive on some mod_security setups) * TWEAK: Improve backup-file-naming routine to reduce the times when no ASCII name can be found (ASCII is preferred as not all cloud storage methods will accept arbitrary characters in filenames) * TWEAK: Don't keep a log file (unless debug mode is on) for scheduled tasks that result in the result that nothing needs backing up * TWEAK: Remove cache files from Cherry Framework child themes upon migration (framework misbehaves if cache files are present after URL change) = 1.10.1 - 2015-05-12 = * FEATURE: Microsoft OneDrive support (Premium version) - full support (including chunked/resumable uploading and downloading) * FEATURE: Allow prevention of backup of unwanted tables, via a filter; see: https://updraftplus.com/faqs/how-can-i-exclude-a-specific-table-from-the-backup/ * FIX: Restore window would not open if date contained a single quote character in it (which was possible only in some languages) * FIX: Restore the ability of PHP installations (< 1%) without curl to use Google Drive (broke when Google introduced a new SSL certificate at their end which PHP couldn't handle properly without extra help). * TWEAK: Add woocommerce_order_items and relevanssi_log to the list of potentially huge tables that won't need search/replacing * TWEAK: Add link to admin email setting and fix broken link to reporting add-on in free version * TWEAK: Provide more direct help for paid users getting blocked by the security shield when connecting for updates access * TWEAK: Small tweak in zip-splitting algorithm if it looks likely that there are insufficient resources with no further resumptions yet scheduled * TWEAK: "Migrate" dialogue, when the Migrator is installed, now contains a widget to use directly (instead of just directing to other route) * TWEAK: Ask user to confirm if they navigate away from the settings page with unsaved changes * TWEAK: Replace some non-SSL links to updraftplus.com with SSL links, and replace all non-SSL readme links * TWEAK: Add UPDRAFTPLUS_DBSCAN_TIMEOUT constant to control how much time is allowed for scanning database, and make the default vary instead of constant (will help users with absolutely enormous databases). * TWEAK: Provide clearer guidance to users with a wrong updraftplus.com password entered for updates * TWEAK: When cloning a site with Jetpack, automatically clear Jetpack invalid connection status * TWEAK: Prevent some old admin notices from being repeated when saving settings = 1.9.64 - 2015-04-20 = * FEATURE: (Premium) Added wizard to make it easier to create limited-access AWS users (requires PHP 5.3.3) * SECURITY: Fix non-persistent back-end XSS vulnerability, reported by Sucuri - https://updraftplus.com/new-security-vulnerability-found-across-significant-numbers-of-wordpress-plugins-including-updraftplus/ * FIX: Fix failure to access some files (e.g. for downloading or deleting) in Google Drive folders that contained >100 UpdraftPlus backup archives (thanks to IanUK for his help) * TWEAK: Amazon S3 reduced redundancy storage (a feature of UpdraftPlus Premium) now requires use of PHP 5.3.3 or later. * TWEAK: Various fixes to bring automatic backups code up to date with WP 4.2 release candidate 1 (there were some changes since beta 3, which worked since UD 1.9.62) * TWEAK: Update to version 2.0 of plugin updater class (https://github.com/YahnisElsts/plugin-update-checker) - necessary on WP 4.2 to prevent shiny updates after the first failing when 3rd party plugins exist, and to suppress a PHP notice on the plugins page. * TWEAK: Add wp_rp_tags to the list of potentially huge tables that won't need search/replacing * TRANSLATION: New Slovenian translation, courtesy of Clav Icula = 1.9.63 - 2015-04-03 = * TWEAK: Revert to previous global SSL CA bundle: it seems Amazon S3 still has servers with 1024-bit SSL certificates = 1.9.62 - 2015-04-01 = * FEATURE: Automatic backups now integrate with the forthcoming WP 4.2's "shiny plugin updates" * COMPATIBILITY: Tested and marked compatible with the forthcoming WordPress 4.2 (tested up to beta 3) * FIX: Fix regression in 1.9.60 for corner-case of S3 users with no permission to check their bucket's location (but permission to write to it). * TWEAK: Make "settings saved" message disappear after a few seconds, to prevent UI clutter * TWEAK: Decrease UI clutter in backup time selection * TWEAK: Update to latest global SSL CA bundle, removing again 1024-bit root CAs (last attempted in 1.9.26, but S3 still had some legacy servers). Modern web browsers have not accepted these for 6 months now. (SSL verification can be turned off in the expert options). * TWEAK: Defeat WP Download Manager Google Drive plugin's loading of its SDK on all pages (conflicting with UD when UD attempts to backup to Google Drive) * TWEAK: Detect case of old MySQL on Windows with table prefix that varies by case (and hence WP actually only works by accident) - produce a consistent backup that can be restored on any MySQL server. * TWEAK: Add dashboard notice with links to more resources, for free users who've been installed >4 weeks (with option to dismiss notice) * TWEAK: Add itsec_log to the list of tables of non-essential/not-needing-search/replace + likely to be large tables for backup strategy * TWEAK: Improvement to scheduling algorithm in case where WP's scheduler starts same resumption multiple times - prevent next attempt being delayed longer than necessary * TWEAK: Add a header to report emails indicating the job ID - helps when debugging * TWEAK: Detect + show a more helpful error message if blocked by CloudFlare when connecting for updates (paid versions) * TWEAK: Make it easier to use custom Dropbox API keys, via UPDRAFTPLUS_CUSTOM_DROPBOX_APP constant (define to true in wp-config.php) * TWEAK: Tweak debug output of webserver information to avoid triggering a (silly) mod_security rule in some setups * TWEAK: Alert the user if using Amazon S3 if they do not have the PHP XML Writer module available * TWEAK: Log the fact that local deletions are being skipped, if the user set that option. * TWEAK: Give timestamp of WPB2D backups without relying upon location of SQL file * TWEAK: Detect a situation on migration where the uploads path is changed (from a site that began pre-WP 3.5) that was previously undetected * TRANSLATIONS: French translation updated from less than half to complete, thanks to Erwan François. Various other translations updated (many thanks to all translators). = 1.9.60 - 2015-02-24 = * FEATURE: When using "Backup Now", and keeping the UpdraftPlus settings page open, a broken WP scheduler will not prevent the backup's progress. * FEATURE: Amazon's "EU Central 1" Frankfurt region now supported again (Amazon began requiring their new signature method at this location - probably a sign of things to come everywhere). PHP 5.3.3 required for this region. * FEATURE: Database backup files can now be handled when uncompressed - i.e., you can remove the gzip compression, and use the resulting file (useful for large backups on slow/limited hosting: pre-decompressing the file will reduce the processing time needed) * FEATURE: Introduced new in-page auto-backup widget that can resume, and thus cope with a backup of any size. This feature is in preparation of WP 4.2's major re-write of the updating user experience flow. * TWEAK: Update PHP-Opencloud (Rackspace) and dependency libraries to current versions. * TWEAK: Make sure that activity is recorded periodically when adding database tables to the final database backup (found a site with over 7,500 tables) * TWEAK: Don't bother to attempt to detect double-gz compression on setups where it can't be handled (where gzseek() has been disabled in the PHP configuration) * TWEAK: Added free/Premium comparison table to the free version * TWEAK: Importer (part of UpdraftPlus Premium) can now import generic .sql, .sql.gz and .sql.bz2 files * TWEAK: Don't show the "memory limit" warning in a case where the value could not be accurately detected * TWEAK: If the user chooses the "email" remote storage method, then a warning will be added if the archive being sent is bigger than most mailservers can carry (and will be removed if it is successfully sent), thus giving the user a hint as to the failure cause (if they overlooked the existing warning in the email settings). * TWEAK: The importer (part of UpdraftPlus Premium) can now import the latest BackupWordPress format databases * TWEAK: Flush output buffer explicitly when closing the browser connection - prevents delayed feedback on some setups * TWEAK: Automatic backups are now offered if you go to the 'Plugins' page, and update via the 'More information' iframe * TWEAK: Trim spaces from Google Drive client_id/secret - some users didn't spot that they introduced whitespace when copy-pasting * TWEAK: Add "Simple Visitor Stats" and "Simple Feed Stats" tables to the list of tables that may have large amounts of data, and which don't need search/replacing when migrating * TWEAK: When restoring plugins and themes, log the list of entities being restored (helps with tracing problems) * TWEAK: Deal with CloudFTP/StorageMadeEasy returning directory listings in a non-standard format, when rescanning remote backups * TWEAK: Version numbering scheme for paid versions changed; see: https://updraftplus.com/change-in-updraftpluss-version-numbering-scheme-for-paid-versions/ * TRANSLATIONS: Updated translations in several languages (many thanks for our translators) * FIX: For imported 3rd-party backups, the 'Existing Backups' tab (only) was showing "Unknown Source" instead of the detected source. = 1.9.52 - 2015-02-07 = * FIX: Fix issue when migrating (hence, in Premium versions only) backups with very large options tables output by mysqldump, which could cause the site URL to finish with an incorrect value = 1.9.51 - 2015-02-03 = * SECURITY: Prevent nonce leak that could allow logged-in users who aren't admins (if you have any) to access backups, UpdraftPlus settings and perform other harmful actions. No issue exists for users of UpdraftPlus Premium, or if you have the stand-alone "Automatic Backups" or "No Adverts" add-ons, or if your site has no untrusted users who can log in (or whilst have dismissed the "Automatic Backups" notice on the updates page). Credit to Sucuri (http://sucuri.net) for identifying this issue, and notifying us of it. = 1.9.50 - 2015-01-29 = * TWEAK: Importer now supports a previously-unseen format for WordPress Backup 2 Dropbox backups * TWEAK: Fix cron calculation that could have prevented UpdraftPlus loading when using ALTERNATE_WP_CRON (see 1.9.45) * TWEAK: If insufficient permissions exist when restoring, then exit maintenance mode when this is detected; and handle the case of having create but not drop permissions more elegantly * TWEAK: Defeat some other plugins/themes which load their CSS code onto UpdraftPlus settings page and break things * TWEAK: Prevent a "not tested on this version of WP" message showing for a short time after install of a new version, when it only applied to the previous version * TWEAK: Reduce HTTP timeout when checking for available plugin updates (paid versions) from 10 to 5 seconds * TWEAK: Tidy up the post-restore screen a little - one less info box. * TWEAK: When a restore finishes, WP Super Cache's cache will be emptied (if present), to prevent confusion caused by cached pre-restore pages. * TWEAK: Slight change to how the 'mothership' for updates is calculated, for more flexibility in our in-house testing * TWEAK: Log more informative error if user chooses 'FTP' for their remote storage, but adds no FTP settings * TWEAK: Change "any other directory" to "any other file/directory" in the "more files" add-on, to better reflect its capabilities * TWEAK: Make sure that "more files" will skip UD's temporary directory, if asked to backup a parent directory of it * TWEAK: Default to https for updates checking, with fallback to http (only relevant to versions from updraftplus.com) * TWEAK: Prevent 'Strict Standards' PHP coding notice with WebDAV on PHP 5.5 * TWEAK: Provide clickable link through to the admin email address in the reporting settings * TWEAK: If the gzopen or gzread functions are disabled in the PHP install, then the message saying so omitted to say which one (or both) * FIX: WebDAV upload method could very occasionally fail to detect upload error conditions = 1.9.46 - 2014-12-29 = * FEATURE: Chunked/resumable uploads are now supported for SFTP * FIX: Scan for existing backup sets added manually to local storage in recent versions could overlook some unless clicked twice, in non-GMT timezones * TWEAK: Work-around issue in Manage WP worker plugin which caused a crash when authenticating with Dropbox * TWEAK: Prevent PHP notice when listing files on SFTP server * TWEAK: Reset an internal upload counter used to detect activity when a cloud storage switch is made due to no apparent activity - could prevent some large, long-running uploads on hosts with little available execution time = 1.9.45 - 2014-12-20 = * FIX: Fix case in which the database imported from a BackWPUp backup could be falsely identified as missing (introduced in 1.9.40) * FIX: WordPress installs with ALTERNATE_WP_CRON set could skip some scheduled backups (since 1.9.19, so it appears that the conditions required to cause this bug are rare) = 1.9.44 - 2014-12-13 = * TRANSLATIONS: Add new incomplete translations (ready for the wordpress.org change to take translation availability into account when searching for plugins): Norwegian Bokmål, Norwegian Nynorsk, Finnish, Hebrew, Catalan, Vietnamese, Bengali * FIX: Fix a failure to detect the progress properly for large backup sets, introduced in 1.9.40 = 1.9.43 - 2014-12-11 = * FIX: Fix bug in 'lock admin' feature causing lock-outs even with the correct password * TWEAK: Site is put in maintenance mode whilst database restore takes place = 1.9.42 - 2014-12-08 = * FIX: Fix bug in 1.9.40 that caused some cloud storage uploads to be terminated. * FIX: Restore functionality for Premium users on older WP versions (3.1 - 3.5) = 1.9.40 - 2014-12-04 = * FEATURE: The auto-backup addon (UpdraftPlus Premium) can now run before WordPress automatic updates * FEATURE: Lock access to your UpdraftPlus settings (Premium) - https://updraftplus.com/lock-updraftplus-settings/ * FEATURE: The full log file viewer is now real-time - it updates as the backup progresses * FEATURE: When downloading from remote storage via the settings page, stalled downloads are now automatically restarted (relevant for large backups with low web-server PHP time-outs) * FIX: Manual search/replace expert tool was broken in early downloads of 1.9.31 * FIX: Suppress bogus messages about missing files from 3rd party tar backups when restoring * FIX: If backing up multiple "more files" locations (Premium), then paths that were identical in both locations could be omitted from the second location * FIX: With the reporting add-on, any mails sent by other plugins after UpdraftPlus had finished (which has never been seen in the wild) would have corrupted contents * TWEAK: The tab for downloading/restoring backups has been simplified * TWEAK: Item for UpdraftPlus now appears in the network admin menu, for super-admins on network installs * TWEAK: Labels (Premium) are now maintained and can be detected for locally-imported database backups * TWEAK: Automatic backups are now labelled * TWEAK: The "retain" settings now do not apply for auto-backups (Premium), unless at least the specified number of non-auto-backups has already been retained. * TWEAK: Time selector now accepts typed hours without the trailing zero * TWEAK: Extended BackWPUp importer to handle older BackWPUp backups lacking manifests * TWEAK: Removed Bitcasa storage option, due to closing down of API (November 15th 2014) * TWEAK: When an invalid JSON response is received during restore stage 2, display the data directly (not just in the error console, where not everyone will think of looking). * TWEAK: 3rd party backups which are missing expected entities are now handled more gracefully * TWEAK: The fancy report now tells the user what paths are in the zips for any additional paths they configured to add to the backup * TWEAK: Add a swifter resumption in one corner case (efficiency) * TWEAK: If a zip error is encountered on cPanel, then the free disk space is checked, to potentially give the user more information on probable causes * TWEAK: You can now remove your updraftplus.com password from the settings (paid version) without losing your access to updates * TWEAK: Suppress top advert if the user is on their first go (free version - danger of too many notices) * TWEAK: Don't display the post-restoration message "if your backup set...", since we can work this out ourselves * TWEAK: Supply extra help to the user if the backup directory is not writable. * TWEAK: SCP remote storage now logs chunk progress * TWEAK: Provide a database encryption phrase text entry in the restore options (rather than needing to enter it in the settings) * TWEAK: Set the PclZip temporary directory to the Updraft directory if unset, to keep its temporary files out of the way more easily * COMPATIBILITY: Tested with the forthcoming WordPress 4.1 * TRANSLATIONS: New Dansk / Danish translation by Lars Lund and Lasse Jensen = 1.9.31 - 2014-10-24 = * TWEAK: Bitcasa now gives a deprecation warning (Bitcasa are closing down their API on November 15th 2014) * TWEAK: Fix bug causing PHP notices in Migrator add-on search/replace * TWEAK: Add support for Amazon S3's new Frankfurt region * TWEAK: Add work-around for bug in the ancient PHP 5.2.6 (May 2008!) if binary zip not available = 1.9.30 - 2014-10-21 = * FEATURE: Add the capability to handle BackupWordPress database zip backups (https://updraftplus.com/shop/importer/) * FEATURE: Add capability to apply labels to backups (Premium - https://updraftplus.com/shop/updraftplus-premium/) * TWEAK: Logs are now shown in a pop-out window with a separate download button * TWEAK: Detect select/poll lengthy timeouts when uploading to Dropbox, and prevent overlapping activity * TWEAK: Add constant UPDRAFTPLUS_NOAUTOBACKUPS to programmatically disable the automatic backups add-on * TWEAK: Rename UpdraftPlus Dropbox class, to avoid clash with Ninja Forms upload add-on * TWEAK: Made the output of the HTTP (curl) debugging tool more informative * TWEAK: Add web.config file to make updraft directory unviewable on IIS * TWEAK: If the user tries to import a WordPress Network backup into a single-site install, then detect and warn * TWEAK: In the free version, avoid unexpectedly changing the daily backup time when other settings are saved * TWEAK: Improve the immediate retry strategy in case of zip failure (saves time and/or notifying the user to manually check the log) * TWEAK: Correctly detect language on WP 4.0 onwards, when suggesting helping with translation * TWEAK: When connecting for updates to updraftplus.com (Premium), indicate if it was the username or password that was wrong * TWEAK: Alert user if they are trying to use Google Drive with a direct-IP address site URL forbidden by Google's policy * TWEAK: Prevent a corner-case where excessive logging could occur upon restoration * TWEAK: Be less strict with case when looking for supported patterns in the Importer add-on (https://updraftplus.com/shop/importer/) * TWEAK: Search/replace the postmeta table faster * DEPRECATED: Bitcasa support has been deprecated, and the links removed from the free version. (Existing Premium users using Bitcasa will continue to be able to do so). See: https://updraftplus.com/bitcasas-current-direction-unclear/ * FIX: Fix corner-case in URL search/replace when migrating a site that had WP in a different directory to the site home, and migration to a sub-directory of the original site. * FIX: Autobackup setting (https://updraftplus.com/shop/autobackup/) failed to save properly if turned off on first usage * TRANSLATION: New Farsi (Persian, fa_IR) translation, courtesy of Jamshidpour, Ashkan Ghadimi, Mohammad (2online4.ir) and Nasiri Amirreza = 1.9.26 - 2014/09/22 = * TWEAK: There are still some Amazon S3 servers validated via a Verisign 1024-bit certificate, causing backup to fail due to SSL validation failure. Revert to previous collection of root SSL certificates in order to still allow access to these servers (see: https://blog.mozilla.org/security/2014/09/08/phasing-out-certificates-with-1024-bit-rsa-keys/) * TWEAK: If Google Drive reports that the quota will be exceeded, then make this feedback more obvious to the user without reading the log * TWEAK: If the user enters an S3 path with an erroneous preceding slash, then remove it * FIX: Amazon S3 RRS settings (Premium) were not being applied on archives smaller than 5Mb * TRANSLATION: New Română (Romanian, ro_RO) translation, courtesy of Augustin-Mihai Mufturel and Teodor Muraru = 1.9.25 - 2014/09/17 = * FEATURE: Copy (https://copy.com) cloud storage support (Premium - https://updraftplus.com/shop/updraftplus-premium/) * FEATURE: The search/replace expert tool can now work on selected tables only * PERFORMANCE: Use PageVisibility API to be more intelligent about when we need to poll for progress in the dashboard * FIX: The Migrator add-on would fetch more database rows than it should, increasing the (low) risk of hitting memory limits, and increasing the time needed on enormous sites * FIX: Some Google Drive backups could get uploaded twice, if you were using multiple storage backends * FIX: If user set the option to not verify SSL certificates, then this option was not honoured for all methods * FIX: If user had never saved their settings (and hence using no cloud backup), then old backup sets were not pruned * TWEAK: Inform the user of possible plugin compatibility issues if they are about to restore a site onto a webserver running a PHP major version older than the original backup. * TWEAK: Detect database disconnection when search/replacing, and reconnect if possible; and to try less rows in case it was a memory limit * TWEAK: Allow wildcards at either end in exclusion items (e.g. backups) * TWEAK: Add option to control how many rows are search/replaced at once * TWEAK: Prevent PHP notice being generated on first Google Drive authentication * TWEAK: Update Bitcasa console link to new location * TRANSLATIONS: New Portuguese (Portugal) translation (pt_PT) - thanks to Pedro Mendonça * TRANSLATIONS: Updated translations for Dutch, Italian, Swedish, Russian, Czech, Greek, Portuguese (Brazilian) = 1.9.19 - 2014/08/19 = * FEATURE: Omit any directory from the backup (recursively) by creating a file called .donotbackup within it * PERFORMANCE: Lazy-load more code * PERFORMANCE: Prevent no-op search/replacements when restoring * FIX: Fix a corner-case where a backup might be able to continue but no attempt was made after using PclZip * FIX: Fix a corner-case (race condition) where UD might try to upload the same archive twice * FIX: Detection of pre-WP 3.5 hard-coded uploads paths upon site clone had stopped working * FIX: Fix bug in Importer add-on which could halt restorations of 3rd-party backups from the BackupWordPress plugin * FIX: Fix bug in the informational disk space consumption calculation in the expert tools section * TWEAK: Catch + log errors thrown by phpMailer * TWEAK: Merge Google SDK tweak from https://github.com/google/google-api-php-client/pull/189 to deal with buggy curl/proxy combinations with Google Drive * TWEAK: Prevent PHP log notice being generated on "Backup Now" * TWEAK: Change default zip split size to 500Mb on new installs * TWEAK: Scheduling algorithm tweak for more efficiency with very large backups when PHP is allowed to run long * TWEAK: Do not rely on PHP's disk_free_space() when it returns (int)0 * TWEAK: Check database connection after auto-backup * TWEAK: More helpful message if uploading a backup when local storage is not writable * TWEAK: Extra logic to survive out-of-memory MySQL conditions in extreme cases; plus introduce UPDRAFTPLUS_ALWAYS_TRY_MYSQLDUMP constant * TWEAK: Tweak Amazon S3 logic so that it can cope with a situation where there is no permission to request its location (but there is permission for all other operations) * TWEAK: Workaround for PHP bug #62119 which could cause some files beginning with a non-ASCII character to be dropped * TWEAK: Warn the user if they are running on Apache without mod_rewrite and restore a site with permalinks requiring mod_rewrite * TWEAK: If Premium user was backing up non-WP tables, then optimize the backup table order * TWEAK: Deal with case when uploading very large backups to Google Drive on overloaded servers with unreliable network where activity check might misfire * TRANSLATIONS: Updated translations: Hungarian, Swedish, Russian, Brazilian (Portuguese), Spanish, Czeck, Dutch, Turkish, German = 1.9.17 - 2014/07/16 = * FEATURE: Can now import/restore/migrate backups created by WordPress Backup To Dropbox (Premium) * FIX: Fix bug in Importer add-on that prevented some potential warnings about the integrity of the 3rd party backup zip being displayed * FIX: Some errors upon S3 downloads were not being passed back up to the settings page for display * FIX: Update "Rackspace Enhanced" add-on for compatibility with current Rackspace API * TWEAK: Prevent spurious messages about quota for users who have upgraded their Bitcasa account to infinite storage * TWEAK: Prevent some unnecessary duplication of work when resuming a database backup (since 1.9.13) * TWEAK: Dropbox now supports use of WP_PROXY_ settings (proxy needs to support HTTP GET/POST/PUT) * TWEAK: Add work-around for "Google Drive as CDN" plugin's inclusion of incompatible Google SDK * TWEAK: "More Files" add-on now lets you list single files for inclusion * TRANSLATIONS: Many translations updated = 1.9.15 - 2014/06/09 = * FEATURE: New search/replace expert tool (Premium) * TWEAK: UI has been simplified - see: https://updraftplus.com/gentle-re-design/ * TWEAK: "Backup Now" now avoids the WordPress scheduler - thus meaning it can work on sites where the WordPress scheduler is broken (e.g. Heart Internet) * TWEAK: Make sure that server HTTP-level errors are shown directly to the user at the 'Processing files...' stage of a restore * TWEAK: Amend SQL which prevented options/sitemeta tables backing up at full speed on large sites * TWEAK: Dropbox will now display some error messages more prominently, where relevant * TWEAK: Dropbox account user's name is stored when you authorise * TWEAK: Show link to FAQ if user's zip upload is corrupt * TWEAK: Work around annoying Google Drive issue whereby Google's end sometimes returns an incomplete list of folders * TWEAK: Interpret time in imported backup sets as being in destination WP install's timezone * TWEAK: Auto-correct Dropbox folder configuration if the user erroneously enters a full URL instead of a folder path * TWEAK: Bitcasa back-end now checks account quota and logs a warning if it looks like it will be exceeded * TWEAK: Email reports created by UpdraftPlus (free) now include the latest blog headlines from updraftplus.com * TWEAK: Make sure all relevant restoration options in restore dialogue are shown (works around Firefox issue upon page reload/navigation) * FIX: Reporting add-on could mis-display number of warnings when saying "X errors, Y warnings". * TRANSLATION: New Tagalog translation (thanks to Kristen Macasero) = 1.9.13 - 2014/05/19 = * FEATURE: Google Drive now works without the PHP curl module being needed * FEATURE: UpdraftPlus Premium can now backup non-WordPress tables and external databases; database encryption is also now a Premium feature; see: https://updraftplus.com/backing-external-databases/ * FIX: Work around conflicts with the Google Analyticator and Appointments+ plugins when using Google Drive since 1.9.4 (see: http://wordpress.org/support/topic/dont-unconditionally-load-old-google-sdk) * FIX: Work around conflict with some XCache setups that prevented activation since 1.9.4 * FIX: Make all S3 SSL settings take effect * FIX: Fix packet size calculation issue upon restore that could cause false detection of over-large packets * FIX: Prevent unnecessary abortion of restore if PHP's (deprecated) safe_mode is on (PHP 5.3 and below) * FIX: When migrating a multisite with a different table prefix, make sure the user role list is maintained on each site * FIX: Rescan of remote FTP storage was not using configured path * TWEAK: Now tested on PHP 5.5 * TWEAK: Migrator can now cope with situations where the development site was developed under multiple URLs without the developer cleaning up * TWEAK: Remove several PHP strict coding standards messages, and a deprecation warning on PHP 5.5+ when using Bitcasa * TWEAK: Add Counterize tables to the custom lists of tables that do not need search/replacing upon migration / are non-vital data * TWEAK: Check for DB connection having been dropped before pruning old backups (WP 3.9+) * TWEAK: Make sure that if the user has not configured the Google Drive API in their Google account, then they are alerted * TRANSLATIONS: Updated Greek, Czech, German, Spanish, French, Dutch, Portuguese (Brazilian), Russian, Swedish and Turkish translations = 1.9.5 - 2014/04/25 = * FIX: Backups were not uploaded successfully if you were using both an encrypted database and Google Drive storage in 1.9.4 = 1.9.4 - 2014/04/23 = * FEATURE: New remote storage back-end for OpenStack Swift * FEATURE: New remote storage back-end for Bitcasa (Premium - https://updraftplus.com/shop/updraftplus-premium/) * FEATURE: New Google Drive back-end now uses new SDK; resulting new capabilities include ability to rescan remote storage, and chunked downloading for huge files; also requires a shorter list of permissions * FEATURE: Restore backups that were created by the plugin BackWPup (Premium - https://updraftplus.com/shop/updraftplus-premium/) * FIX: WebDAV storage: remove requirement for PEAR to be pre-installed on server * FIX: Fix restoration on sites where WP did not have direct filesystem access * FIX: Fix regex which prevented download progress of mu-plugins zip displaying correctly * FIX: Fix issue preventing some useful information about URL changes being included in the migration log file * FIX: Restore compatibility with WordPress 3.2 (if you're using that, you're overdue an upgrade by some years!) * TWEAK: Enable new locations for plupload Flash/Silverlight widgets (for non-HTML5 browsers) in WP3.9+ (later reverted by core devs, but is harmless in case they re-introduce) * TWEAK: Take advantage of WP 3.9+'s new method (if available) for maintaining DB connectivity on very long runs * TWEAK: Add filter so that programmers can allow the options page to be shown to non-admins * TWEAK: Add filter allowing programmers to forbid a backup * TWEAK: Detect and adapt to cases where the site is moved to a system with different case-sensitivity and the database record of the theme is now wrong * TWEAK: Prevent erroneous warning about a missing table in the database backup on some WPMU installs that began life as a very old WP version * TWEAK: Introduce constant allowing users of pre-release WP installs to disable notices about using a version of WP that UpdraftPlus has not been tested on. * TWEAK: Make Dropbox uploads at least 25% faster (in our testing) by increasing the chunk size * TWEAK: Reduce number of rows fetched from MySQL if no activity took place on the previous resumption * TWEAK: AWS image in settings page will now use https if dashboard access is https - prevents non-https warnings in recent browsers * TWEAK: Hook into Better WP Security so that it doesn't tell the user that they have no backup plugin * TWEAK: New debugging tool to test remote HTTP connectivity * TWEAK: Tweak the MySQL version detection in the 'debug' section of the admin page to prevent a PHP message being thrown on PHP 5.5+/WP3.9+ * TRANSLATION: New Czech (cs_CZ) translation; thanks to Martin Křížek * TRANSLATION: Updated Russian, Swedish, Dutch and Portuguese translations = 1.9.0 - 2014/03/26 = * COMPATIBILITY: Tested on and updated for forthcoming WordPress 3.9 * FIX: Prevent SQL errors on restore if SQL command was over-sized and split awkwardly (very hard to trigger) * FIX: Fix subtle race condition that prevented uploads of large archives on Amazon S3 in some very limited situations * FEATURE: Ability to restore and migrate from backups produced by other backup plugins (Premium) (supported: BackUpWordPress and Simple Backups (zip-based; though, if you have a tar-backup, you can re-pack it easily)) * FEATURE: Feature to re-scan remote storage (allows detection of existing backups after a restore to an earlier site version, and allows quicker moving of data from site to site when migrating) * FEATURE: SFTP add-on (https://updraftplus.com/shop/sftp/) now supports key-based logins (as well as password-based) * TWEAK: Add a warning message and link to helpful page for people whose WP schedulers don't seem to be working (at least 4 overdue jobs in the queue) * TWEAK: Introduce a filter allowing users to add a bespoke scheduling option (e.g. every 2 days) * TWEAK: When backup is sent by email attachment, the email now indicates the originating site more clearly * TWEAK: Display a dashboard warning if you are using a version of UpdraftPlus that has not been tested on your current WordPress version * TWEAK: Add work-around for bad hard-coded data in Elegant Themes Theme Builder when restoring * TWEAK: Log a message when Dropbox authentication completes (prevent user confusion if the most recent message is pre-success) * TRANSLATIONS: New Arabic translation (thanks to Omar Amassine - me at omar.ma, Ahmed Fahmy and Riyadh Altayib) * TRANSLATIONS: Updated Spanish translation (thanks to Pablo Laguna - laguna.sanchez at gmail.com) * TRANSLATIONS: Updated Nederlands / Dutch translation (thanks to Dennis Hunink - dennishunink at me.com) * TRANSLATIONS: New Turkish translation (various translators - not yet complete) = 1.8.13 - 2014/03/07 = * FIX: Fix bug that prevented changes to your schedule being saved on network (WPMU) installs (Multisite add-on) = 1.8.12 - 2014/02/27 = * FIX: Prevent spurious warning message showing when authenticating new Dropbox connections (introduced in 1.8.11) * TWEAK: Add support for Amazon S3's China + government zones = 1.8.11 - 2014/02/27 = * FIX: Deal with some unlikely multisite migration combinations * FEATURE: Allow the 'exclude' options (for omitting files/directories from the backup) to go to any level (i.e. can now exclude entities which are deep in the directory tree) * FEATURE: "More Files" add-on (and hence Premium) now allows adding as many non-WP directories as you like * FEATURE: Allow use of Amazon S3's Reduced Redundancy Storage (via add-on/Premium) * FEATURE: Allow all messages to be centrally logged in syslog/Event Log (via add-on/Premium) * RELIABILITY: Allow skipping of data from tables whose data is explicitly known to be inessential if at least 2 attempts to backup the data fail (e.g. lack of resources on low-budget hosts with huge tables, e.g. StatPress data) - as an alternative to total backup failure. * TWEAK: Prevent spurious warning message if the site (uploads) is empty and using /usr/bin/zip * TWEAK: Work-around for quirky FTP server for which PHP loses the communication if SIZE is called for a non-existent file * TWEAK: Show table prefix in debugging information, and add quick links to install useful debugging plugins * TWEAK: Limit amount of to-database logging when backing up uploads if the user is not using dated directories (speed-up) * TWEAK: Split zip earlier if progress made in the past but not recently (should help with some ultra-low-resource hosts, e.g. one.com) * TWEAK: "Custom Content Type Manager" plugin has bad hard-coded cache data; detect + fix this on restore * TRANSLATIONS: Updated translations for Russian, Dutch, German and Portuguese (Brazilian) = 1.8.8 - 2014/01/27 = * FIX: Correctly detect table prefix on some WPMU installs that had been upgraded from an earlier version than 3.0 (i.e. very old) * FIX: Files directly in wp-content/uploads (from a 1.8.5 backup and not in any sub-directory) were being restored one directory too high * UPDATED: Updated Swedish, Portuguese and Dutch translations * UPDATED: Update root certificates to match latest CURL/Mozilla version * TWEAK: Automatically change http(s):// to webdav(s):// in WebDAV URLs if the user overlooks the instructions * TWEAK: If SHOW TABLES returns no tables, then schedule a re-try later (presume the DB connection had been dropped) * TWEAK: Preceed warnings in the log file with [Warning] * TWEAK: Prevent a very rare PHP segfault due to https://bugs.php.net/bug.php?id=51425 * TWEAK: Show the filename being unpacked during restore (helps with troubleshooting if there are very many zips) * TWEAK: Premium plugin now shows information about pending/past update/support expiries + links to renewal page * TWEAK: Show all defined constants in the debug dialog * TWEAK: Detect + deal with situations where the webserver double-gzipped the database file * TWEAK: Display a warning in the FTP configuration section if the hosting company disabled FTP functions * TWEAK: Make sure that WebDAV notices are included in UD's log file = 1.8.5 - 2014/01/09 = * FEATURE: Add option to exclude specified files from the 'uploads' backup. The default option will omit backing up backups created by at least 2 other backup plugins. * FEATURE: New Brazilian Portuguese translation - thanks to Lucien Raven and Tom Fonseca * FEATURE: Migrator search/replace now handles JSON and object-encoded data * UPDATED: Updated Swedish translation * FIX: When advising the user that his remaining Dropbox quota is insufficient, take into account parts of the file already uploaded * FIX: Delete Old Directories button in 1.8.2 was using a PHP 5.3+ feature: restore PHP 5.2 compatibility * FIX: Reporting add-on was incorrectly inflating the number displayed for the total error count if there were warnings * FIX: Prevent a bogus warning appearing when the user has filtered the base table prefix * TWEAK: Give more feedback to user when FTP login fails. Also, improve automatic switch to non-SSL FTP if SSL FTP fails to cover more situations. * TWEAK: Add informational text about the implications of not choosing any remote storage method * TWEAK: Supply the "Delete Old Directories" button directly with the message advising users to press it * TWEAK: If using WP Slimstats, don't search/replace the slimstats table when migrating (referer data should be left intact); and this table is often gigantic, so this hugely speeds up restores/migrations * TWEAK: Handle odd file permissions setups more skilfully when restoring/migrating * TWEAK: Automatically rescan for new backup sets if none were previously known (saves a click when manually importing) * TWEAK: Force a shorter pathname to be used when unpacking zip files (prevent maximum pathname limits being hit) * TWEAK: Tweak CSS to work-around other plugins that dump their CSS code on all settings pages and break modals (in this case, Events Manager) * TWEAK: Hide the instruction for users of Opera unless the user agent header indicates Opera * TWEAK: Speed migrations by skipping redundant search/replace scan on term_relationships table (which can never have URLs in it) = 1.8.2 - 2013/12/13 = * FIX: Various small fixes to the initial release of 1.8.1 * TWEAK: Restorer now switches theme if database is restored to indicate a non-existent theme, and Migrator temporarily disables caching plugins during Migration * TWEAK: Improve handling of MySQL's maximum packet size - attempt to raise it, and leave some margin * TWEAK: Move the Rackspace SDK around to prevent problems on systems with limited maximum pathname lengths * TWEAK: Provide a link to the log file at the top of the restoration page = 1.8.1 - 2013/12/10 = * FEATURE: New "Reporting" add-on - more sophisticated/flexible backup reports (https://updraftplus.com/shop/reporting/) * FEATURE: New enhanced add-on for Rackspace Cloud Files users, allowing them to create a new sub-user with exclusive access to the backup container (https://updraftplus.com/shop/cloudfiles-enhanced/) (PHP 5.3.3+ required for this feature) * FEATURE: Add region-selection (Dallas/Chicago/Northern Virginia/Sydney/Hong Kong) to Rackspace Cloud Files (PHP 5.3.3+ required for this feature) * FEATURE: Add option to 'Backup Now' dialog to not despatch this backup to the cloud * FIX: Fix bug in restore of wpcore (Premium) with certain options when backup set was from a previously restored backup with the same certain options * FIX: After restoring a site, only delete the backup set from local storage if it was also stored in the cloud (prevents the user having to upload the backup set twice if they want to re-run the restore) * FIX: Improve detection of extremely long-running/slow jobs * FIX: Fix issue with Rackspace Cloudfiles on WPMU installs * TWEAK: Mark as tested up to WordPress 3.8 * TWEAK: Restore operations are now logged * TWEAK: Detect the database connection dropping and recover (seen on a very slow site where PHP ran continuously for 30 mins) * TWEAK: Change how permalinks are flushed post-restore. This spares the user from having to manually visit the permalinks page if they had plugins that altered their permalink structure (e.g. WooCommerce). * TWEAK: Require fewer file permissions when restoring/migrating * TWEAK: Remove various spurious PHP notices caught by the post-1.7.41 extra logging * TWEAK: Compress the log file before emailing it, if it is over 6Mb * TWEAK: Make sure some potential error messages from Dropbox are displayed properly * TWEAK: Work around sites with site/home URL settings in the WP DB that erroneously have a trailing slash * TWEAK: Log PHP notices for all job types = 1.7.41 - 2013/11/16 = * FIX: Work around bug in some old PHP versions on Windows when creating database dump * FIX: If binary mysqldump failed, then retry * TWEAK: Log PHP notices in the log file * TWEAK: Allow primitive exclusion based on filename suffixes = 1.7.39 - 2013/11/11 = * FIX: Correct calculation of which old backups to delete when automatic pre-plugin/theme backups run * FIX: Binzip could block if the zip binary produced a lot of unexpected output * FIX: Fix a corner-case where a setting needed manual updating post-migration on WP 3.4+earlier sites with custom uploads path * FIX: Prevent the settings page needing a refresh if the server temporarily goes away * TWEAK: For reasons unknown, Google's new cloud console removes parameters after the first from the redirect_uri; this breaks new Google Drive authentications. To work around this, we have adjusted our redirect_uri to use only one parameter. * TWEAK: Removed a couple of clicks from the install procedure for add-ons * TWEAK: Handle migration URL rewrites where content directory location has been manually altered * TWEAK: Change default number of backups to retain on new installs from 1 to 2 * TWEAK: Add extra file permissions check before restoring (prevent unexpected aborts) * TWEAK: Suppress a spurious 'insufficient visitors' warning for some sites with long-running backups * TWEAK: Prevent spurious message about unexpected SQL if restoring a backup with very large tables produced by mysqldump * TWEAK: Catch some more untranslated strings * TRANSLATIONS: New Russian translation; updated German and Polish translations = 1.7.35 - 2013/10/26 = * FIX: Fix potential problem whereby some tables could be missed from the backup on WPMU (WP multisite) installs. Strongly recommended that all WPMU users update and take a fresh backup. * FIX: Work around http://bugs.mysql.com/62077 (could cause permanently stuck lock on databases with wrong collocations - if you have this problem, then no backups happen) * TWEAK: Don't use binzip method on OpenVZ with low memory * TWEAK: Suppress a couple of spurious messages in the log * TWEAK: Add facility to quickly download log files in the 'expert settings' section = 1.7.34 - 2013/10/21 = * FEATURE: Options in the "Backup Now" dialog to exclude files or database from the backup (https://updraftplus.com/more-flexibility-in-backup-now/) * FEATURE: Use binary mysqldump, if available, for much faster dumps of large tables * FEATURE: New Ελληνική / Greek translation (el): Κώστας Θερμογιάννης (Kostas Thermoyiannis) - http://tovivlio.net * FIX: Fix a JavaScript error in Internet Explorer 8 * FIX: Under very unusual circumstances, it was still possible for multiple backup jobs to occur * FIX: For non-English installs, the email indicating backup success sometimes failed to send * FIX: Fix obscure table name error if WP was using bespoke database setup without delete access * FIX: On multi-site installs, settings changes could be lost if they were made during an ongoing backup * TWEAK: Now marked as WordPress 3.7 compatible * TWEAK: Raw files list in expert section now makes log files directly downloadable * TWEAK: Detect available disk quota in CPanel account (if relevant), log, and warn if low * TWEAK: Amazon S3 backend now can use WP proxy settings (if any) * TWEAK: All multisite settings pages have now been moved to the network admin section * TWEAK: Restorer now handles hand-moved non-default WP site directories (where they differ from the website base directory) * TWEAK: Migrator can now migrate sub-domain-based WPMU installs with no manual steps required * TWEAK: Internationalised the add-ons management page (Premium) * TWEAK: Switch zip engines from ZipArchive earlier if it appears to be broken * TWEAK: Now cleans up some previously un-caught temporary files if the backup aborted unexpectedly * TWEAK: Remove bogus warning about W3TC object cache * TWEAK: Backup log file now includes SHA1 checksums * TWEAK: Add warning for user if their max_execution_time is very low * TWEAK: Make fewer HTTP requests when tracking download status * TWEAK: Under certain conditions, the report email could wrongly state that files were included in a db-only backup * TWEAK: Improve detection of recent activity on resumptions when zips split * TWEAK: Prevent some warning messages from being shown twice * TWEAK: Remove the "that's a lot of rows" warning once the table successfully finishes being dumped * TWEAK: Cache the results of looking for a zip executable for the duration of the job * TWEAK: Some badly-written plugins place their own code on UD's settings page, and break the layout; overcome this * TWEAK: Add a warning for people using encryption without mcrypt installed (slow) * TWEAK: Suppress useless warning when using BinZip and only empty directories exist in 'others' backup = 1.7.20 - 2013/09/20 = * TWEAK: Add semaphore locking to prevent WP's cron system kicking off multiple jobs on overloaded systems * TWEAK: Catch and display some previously uncaught AJAX notices when restoring, and display information on the restore process earlier = 1.7.18 - 2013/09/17 = * FEATURE: <a href="https://updraftplus.com/shop/morestorage/">New "more storage" add-on</a>, enabling backing up to multiple storage destinations * FEATURE: New progress meter on dashboard page when a backup is running * FEATURE: SCP support (in the <a href="https://updraftplus.com/shop/sftp/">SFTP/FTPS/SCP add-on</a>) * FEATURE: If (and only if) your settings page is open, then UpdraftPlus will automatically perform tricks to help backups run even if your WordPress install has its scheduler disabled (of course, enabling your scheduler would better). * FIX: Fix bug whereby clicking on 'rescan' lost track of backups sent to remote storage * FIX: Fix obscure bug that could cause WPMU installs to not backup all tables * FIX: Fix unwanted warning message if the uploads folder was empty * FIX: Show timestamps of available backup sets in local time zone * FIX: Email subjects and contents use local time zone * FIX: Fix mangled pathnames for PclZip one-shot attempts * FIX: Fix bug that caused files to be dropped if one was in a sub-directory of the entity and named (entire name) "0" * FIX: Show correct title on page when upgrading * FIX: Fix one-character typo that could cause Dropbox uploads to not continue if Dropbox threw a transient error from their end * FIX: Permanent solution to conflict with W3TC's object cache (and removal of advisory notice) * FIX: Correctly show estimated size of 'others' backup within the expert section * FIX: Fix small typo in inline decrypter that led to viewer reading an incomplete message * TWEAK: Warn the user if they seem to be a on a dev website that is not visited + so can't backup (https://updraftplus.com/faqs/why-am-i-getting-warnings-about-my-site-not-having-enough-visitors/) * TWEAK: More detection of possible overlaps (use temporary files as evidence) * TWEAK: Extra check that the directory is writable before unpacking zip in restore (so user gets friendly error message instead of trickier one) * TWEAK: Provide option to remember the "automatic backup" setting * TWEAK: <a href="https://updraftplus.com/shop/webdav/">The WebDAV add-on</a> now has support for WebDAV servers that don't support Content-Range (e.g. ownCloud) = 1.7.3 - 2013/08/26 = * FIX: Some Dropbox connect errors were being lost * FIX: Fix detection of availability of binary zip method on PHP installs where popen() is available put proc_open() is disabled * FIX: (Premium): WP Core and More Files remaining locally/not being despatched to cloud storage * TWEAK: More logging of the success (or not) of backups sent via email * TWEAK: Remember hint from previous job if PHP is allowed to run for more than 300 seconds at a time = 1.7.1 - 2013/08/20 = * FIX: Fix error preventing file backups in 1.7.0 for PHP installs without the ZipArchive class. * TWEAK: Only include phpseclib in the path when required = 1.7.0 - 2013/08/20 = * FEATURE: Split large sites into multiple zips (see: https://updraftplus.com/splitting-large-sites-into-multiple-archives/) * FEATURE: Fix time add-on can now also choose the day of the week * FEATURE: New add-on/Premium feature - Automatic Backups (automatically take backups before plugin/theme updates) - https://updraftplus.com/shop/autobackup/ * FEATURE: Svensk / Swedish translation (sv_SE) by Steve Sandström (http://www.brandicon.se) * FEATURE: Français / French translation (fr_FR) by ufo3D - http://ufo-3d.fr/ and Thomas Jacobsen - http://123informatique.ch/ - with help from Françoise Lhermitte - http://www.ajwan.net * TWEAK: Save the result of looking for a binary zip (don't re-test) * TWEAK: Show 'Last log message' in dashboard using local time zone * TWEAK: Log file times are now recorded relative to the backup start, rather than the current resumption start * TWEAK: More code-tidying and optimisation * TWEAK: Warn the user if the WordPress scheduler is disabled * TWEAK: Many + various extra sanity-checks for possible problems * TWEAK: Warn user if trying to upload an above-limit (>10Gb) file to Google Drive * TWEAK: Reduce memory usage during restore * TWEAK: No longer require mbstring extension for Dropbox * TWEAK: Move JavaScript into separate file, and make strings translatable * INTERNALS: PclZip and BinZip methods now have feature parity with ZipArchive (can resume+split, more logging) * TWEAK/FIX: When restoring/migrating, split SQL commands to avoid exceeding MySQL's max_allowed_packet * FIX: Make sure output buffering is off when sending files from the browser (prevents memory exhaustion) * FIX: Prevent double-backup (very unusual combination of circumstances) * FIX: Some Windows webserver configurations could have corruption of filenames in WordPress core backups (recoverable) * FIX: Remove temporary files created by PclZip (where PclZip is used) = 1.6.46 - 2013/07/11 = * FEATURE: New storage back-end for any S3-compatible provider (e.g. Google Cloud Storage, Eucalyptus, Cloudian, many more - tested with Dreamobjects and original S3) * FEATURE: Delete existing backup sets manually (deletes both local + cloud copies). Also show backup set debugging info in expert options; and counter now dynamically updates without refresh. * FEATURE: Restorations + migrations can now be attempted even if the user lacks CREATE TABLE or DROP TABLE permissions * FEATURE: Italiano/Italian translation by Francesco Carpana (f.carpana at gmail.com) * FEATURE: Chinese (zh_CN) translation by K L Wang (http://klwang.info) * FEATURE: Re-worked error handling internally, leading to users now being notified prominently of warning-level conditions (non-fatal conditions, but things the user should be advised of) * FEATURE: Allow some hiding of secrets in the admin area (see: https://updraftplus.com/faqs/in-the-administration-section-it-shows-my-amazon-ftp-etc-passwords-without-using-stars-is-this-safe/) * FEATURE: Restorer now obtains files at an earlier stage, allowing analysis + more intelligent presentation of options and applicable warnings pre-restore. Now warns if you are migrating without having chosen search/replace of DB. Also pre-decrypts the database, which lessens the risk of timeouts. * FEATURE: Allow entries in the list of files to exclude from backup to end in a wildcard (). Change default exclusion for content dir to include backup to catch other backup plugins' archives. * FIX: "Wipe settings" wipes S3 + DreamObjects settings (they were retained previously) * FIX: Suppress spurious "Table prefix has changed" message * FIX: Now copes on restores/migrations if you've moved around your WP_CONTENT_DIR/WP_PLUGIN_DIR/UPLOADS folder * FIX: Escape output of logging lines (prevents on-page JavaScript breakage if error from cloud service contained unescaped quotes) * FIX: Fix syntax error in rarely-triggered part of scheduling calculation algorithm that could cause a dramatic slow-down * FIX: Tweak the no-activity-for-a-while-when-writing-zip detector to not fire prematurely (found an extreme corner-case where this caused a problem) * FIX: The "Test (cloud method) settings" button would fail if credentials contained a backslash (\), due to WP's automatic doubling of backslashes * FIX: When restoring, don't make failure to remove a temporary directory an abortion condition * FIX: Database dump now retains NULL values for string fields (instead of making them empty strings) * FIX: Remove directories that cause an error during restoration when user restores from a backup made from a previously-restored site without removing old directories when requested. * TWEAK: Detect WP installs with broken plugins that add extra white-space (thus breaking AJAX output) * TWEAK: When running on (old) MySQL 4.1, replace TYPE= with ENGINE= for compatibility with later MySQL versions * TWEAK: Detect which MySQL engines are available on the restoring side, and switch if the requested engine is not available; remove PAGE_CHECKSUM and TRANSACTIONAL options if engine was (M)aria. Always remove (removed from upstream) PAGE_CHECKSUM from MyISAM. * TWEAK: Batch database rows by the 1000 instead of 100 - proved to be 3x faster on massive MyISAM tables * TWEAK: Abort a restoration if the first CREATE TABLE command produces an error (rather than continue and likely have many more) * TWEAK: Replace one use of method_exists() to prevent triggering segfault in some faulty PHP installs * TWEAK: Allow an extra attempt if in "over-time" - allows recovery from transient errors (e.g. cloud service temporary outage) in over-time. * TWEAK: Work-around WP installs with broken caching setups where cache deletion is not working * TWEAK: If ZipArchive::close() fails, then log the list of files we were trying to add at the time * TWEAK: Detect generous amounts of time allowed for running better, and schedule appropriately * TWEAK: Add detection of jQuery errors in the admin page, and direct users with such errors to a help page * TWEAK: More aggressively clean up temporary files (can lower temporary disk space requirements) * TWEAK: Provide the error message sent by Google upon initial Drive authentication errors. * TWEAK: Found a case where PHP's is_writable() erroneously returns true - actually test a write * TWEAK: Use pseudo-namespacing on the CloudFiles library to prevent clashes with other plugins (pre-emptive - no known conflicts exist) * TWEAK: Use higher priority on cron backup schedules call to prevent other plugins which call WP wrongly from over-writing new cron schedules (e.g. BackupBuddy) = 1.6.17 - 2013/06/06 = * FEATURE: News blog - https://updraftplus.com/news/ - please subscribe if you want to stay up to date with news of new features, tips, and special offers. RSS link: http://feeds.feedburner.com/UpdraftPlus * FEATURE: Restoration/migration now copes with a change of table prefix, and asks WordPress to recreate your .htaccess/web.config file * FEATURE: Add support for DreamHost DreamObjects (http://dreamhost.com/cloud/dreamobjects/) * FEATURE: Polski / Polish (pl_PL) translation: thanks to Bartosz Kaczmarek (barth.kaczmarek at gmail.com) * FEATURE: Add expert options to count expected uncompressed backup size, show/delete active jobs, and PHP info * FEATURE: Send backup reports to multiple addresses (comma-separate the addresses you wish to use) * FIX: Inform users of Dropbox tokens which stop working * FIX: Don't flag an error if mu-plugins are selected, but none are found and WordPress agrees that none exist * COMPATIBILITY: WordPress multisite post-3.5 does not store blog uploads separately from main uploads directory * COMPATIBILITY: Now marked as compatible with WordPress 3.6 * TWEAK: When errors occur, list them in the notification email and attach the log file * TWEAK: Use only one transient per job, and clean it up upon completion * TWEAK: Added a "Clone/Migrate" button to give a visual clue for people wanting to do this * TWEAK: More verbose error reporting from PclZip * TWEAK: After database restoration, permalinks are flushed (often helps regenerate .htaccess+web.config files) * TWEAK: Database backups now put the options table first, to allow earlier changing of site URL upon migration * TWEAK: Show PHP + web server versions in the debug information * TWEAK: More sophisticated attempts to get a writable backup directory, and more helpful messages if we can't * TWEAK: Some more logging, data-gathering and algorithm-tweaking to especially improve the chances for people with astonishingly slow web hosting, but also tweaks that improve efficiency everywhere, especially for larger backup sets. * TWEAK: Migrator plugin now does search+replace after each table (instead of after them all) * TWEAK: Clean up temporary files earlier where safe+possible (can lower disk space requirements) * TWEAK: Re-scan of known sets now removes those known to be gone from the list * TWEAK: Made a few things use AJAX instead of full page loads * TWEAK: Replace Rackspace logo with current version * TWEAK: Make missing PHP component warnings more prominent * TWEAK: Warn users if they have W3 Total Cache's object cache (which has a bug that affects scheduled tasks) active. * TWEAK: Add a notice for users who have turned on debugging (some forget to turn it off, then ask for support when they see lots of debugging notices) = 1.6.2 - 05/11/2013 = * FIX: Prevent PHP fatal error on some database restores = 1.6.1 - 05/06/2013 = * FEATURE: New "Migrator" add-on for moving sites from one WordPress install to another (https://updraftplus.com/shop/) * FEATURE: The "More files" add-on can now backup any files from anywhere on your filesystem (not just parts of WordPress) * FEATURE: The "More files" add-on can now exclude specified directories from the backup of WordPress core * FEATURE: Dropbox and Google Drive now check available quota before uploading * FEATURE: Nederlands / Dutch (nl_NL) translation: thanks to Hans van der Vlist - hansvandervlist at gmail.com * FEATURE: The SFTP/FTPS add-on now supports implicit encryption (so now both explicit + implicit are supported) * FIX: Google Drive now requires additional permissions to download your files - you will need to re-authenticate if you are downloading or restoring. * FIX: Fix serious corruption issue in larger Rackspace Cloud Files backups (fixed a bug in Rackspace's Cloud Files library) * FIX: Fix mcrypt call in Dropbox module to be compatible with PHP 5.2 on Windows, and with ancient FreeBSD versions which have no /dev/urandom * FIX: Allow top-level "Restore" button even if no backup sets currently known (to allow uploading some) * FIX: Fixed issues hindering restoration on web hosting setups with file permissions that invoked WP's remote filesystem methods * TWEAK: Database backup now includes more info about original WP install (e.g. WP/PHP versions) * TWEAK: The "More files" add-on now allows the user to choose whether to restore wp-config.php or not (and gives help) * TWEAK: Added an approximate expected row count when beginning to dump out a table * TWEAK: Remove the Google Drive URL prefix automatically for those who don't spot the instruction to do so = 1.5.22 - 04/16/2013 = * FIX: 1.5.21 broke Dropbox authentication for some users. Upgrade if you had that issue. = 1.5.21 - 04/15/2013 = * FEATURE: Now restores databases (we recommend the MySQL command-line for versions created with previous versions of UpdraftPlus) * FEATURE: Rackspace Cloud Files support (http://www.rackspace.com/cloud/files/) * FEATURE: Built-in multi-uploader, allowing easier restoration of old backup sets * FEATURE: Allow instant downloading of the most recently modified log file * FEATURE: Built in drag-and-drop database decrypter for manual decryption * FEATURE: Deutsch / German translation: thanks to Marcel Herrguth - mherrguth at mrgeneration.de * FEATURE: Magyar / Hungarian translation: thanks to Szépe Viktor - http://www.szepe.net * FEATURE: Spanish / Español translation: thanks to Fernando Villasmil - villasmil.fernando at gmail.com * FEATURE: Added encryption (used by default) to Amazon S3 communications * FEATURE: New "more files" add-on, allowing backup of WordPress core and non-WordPress files * RELIABILITY: Various algorithm tweaks to help larger sites on lower resources. Largest site a known user has: 1.5Gb * RELIABILITY/FEATURE: Ship up-to-date SSL certificates, and added expert options to prefer server SSL CA certificates, and to disable peer verification * SPEED: Batch INSERT commands in database backups, for much faster restoration (typically 95% faster) * SPEED/RELIABILITY: FTP and FTPS (not SFTP) are now chunked and resumable (both download and upload), subject to your FTP server responding correctly to SIZE * SPEED: Re-factoring of admin-area and some backup code into separate lazy-loaded files, to reduce memory consumption on sites generally * FIX: Clear PHP's file stat cache when checking for zip file activity - fixes potential halt on very enormous sites or sites with very low PHP timeouts. * FIX: Caught some untranslated strings * FIX: Respect WordPress's WP_MAX_MEMORY_LIMIT constant * FIX: Remove timezone display from local time - WordPress's get_date_from_gmt function does not completely do what the manual says it does * FIX: A small typo slipped into 1.5.5 which prevented some Google Drive users from setting up new installations * FIX: Fix strict coding warnings on PHP 5.4 * TWEAK: In fix-time add-on, fade UI when relevant * TWEAK: Improved UI of downloader * TWEAK: Decrease FTP timeouts to improve our chances of getting back an error before PHP aborts * TWEAK: Tweaked al relevant methods to follow the general SSL CA certificate options = 1.5.5 - 03/26/2013 = * Now translatable - .pot file included (translators welcome!) * When restoring, you can now select only some components to restore * History of previous backups can re-scan to find backups manually imported (e.g. via FTP) (trunk has drag-and-drop uploader) * Multisite add-on (https://updraftplus.com/shop/) now stores/restores blogs and mu-plugins separately * Display UpdraftPlus's disk space usage * Internationalisation hooks in main body of plugin * Correctly remove old 'other' directories from a restoration when requested * Various layout + niceness fixes upon restoration * Prevent deletion of local archives upon failed restoration when there was no cloud storage * Various usability tweaks for the admin UI, including showing multisite warning only on UD's pages * Fix incorrect restoration (since 1.4.0) of directory-less paths from 'others' zip * Fix prevention of Dropbox re-authentication when Dropbox returns 5xx first time (library error) * Clear Dropbox credentials if the user explicitly re-authenticates * Clean up temporary files left behind by zipArchive::addFile * Tweak Dropbox library to work from behind very weird proxies that double-surround the HTTP header * Improved help for people with broken schedulers * Fix FTP download error = 1.4.48 - 03/11/2013 = * Improve batching on zip creation for sites with very large files * Unlimited early resumption if zip file creation takes too long * Suppress some warning notices that can break JavaScript on sites with notices sent to the browser * Earlier warning/failure if backup directory was not writable * Hooks for Dropbox folders add-on * More scheduler/overlap tweaks, to assist enormous uploads * When the temporary directory is within the site, store+display relatively (removes need to modify upon site move) * Sort existing backups display by date * Use WordPress time for creation of filenames * Fix bug in 1.4.47 which caused problems on new site installs * Prevent erroneous warning when backup zip (usually uploads) has no files = 1.4.30 - 03/04/2013 = * Hooks for WebDAV support via add-on = 1.4.29 - 02/23/2013 = * Now remembers what cloud service you used for historical backups, if you later switch * Now performs user downloads from the settings page asynchronously, meaning that enormous backups can be fetched this way * Fixed bug which forced GoogleDrive users to re-authenticate unnecessarily * Fixed apparent race condition that broke some backups * Include disk free space warning * More intelligent scheduling of resumptions, leading to faster completion on hosts with low max_execution_time values * Polls and updates in-page backup history status (no refresh required) * Hooks for SFTP + encrypted FTP add-on = 1.4.14 - 02/19/2013 = * Display final status message in email * Clean-up any old temporary files detected = 1.4.13 - 02/18/2013 = * Some extra hooks for "fix time" add-on (https://updraftplus.com/shop/fix-time/) * Some internal simplification * Small spelling + text fixes = 1.4.11 - 02/13/2013 = * Various branding tweaks - <a href="https://updraftplus.com">launch of updraftplus.com</a> * Important fix for people with non-encrypted database backups = 1.4.9 - 02/12/2013 = * Do more when testing Amazon S3 connectivity (catches users with bucket but not file access) * Tweak algorithm for detecting useful activity to further help gigantic sites = 1.4.7 - 02/09/2013 = * Tweak for some Amazon EU West 1 bucket users = 1.4.6 - 02/07/2013 = * Amazon S3 now works for users with non-US buckets * Further tweak to overlap detection = 1.4.2 - 02/06/2013 = * More Amazon S3 logging which should help people with wrong details * More race/overlap detection, and more flexible rescheduling = 1.4.0 - 02/04/2013 = * Zip file creation is now resumable; and thus the entire backup operation is; there is now no "too early to resume" point. So even the most enormous site backups should now be able to proceed. * Prefer PHP's native zip functions if available - 25% speed-up on zip creation = 1.3.22 - 01/31/2013 = * More help for really large uploads; dynamically alter the maximum number of resumption attempts if something useful is still happening = 1.3.20 - 01/30/2013 = * Add extra error checking in S3 method (can prevent logging loop) = 1.3.19 - 01/29/2013 = * Since 1.3.3, the 'Last Backup' indicator in the control panel had not been updating = 1.3.18 - 01/28/2013 = * Made 'expert mode' easier to operate, and tidier options for non-expert users. * Some (not total) compliance with PHP's strict coding standards mode * More detail provided when failing to authorise with Google = 1.3.15 - 01/26/2013 = * Various changes to Google Drive authentication to help those who don't enter the correct details first time, or who later need to change accounts. = 1.3.12 - 01/25/2013 = * 1.3.0 to 1.3.8 had a fatal flaw for people with large backups. * 1.3.0 to 1.3.9 gave erroneous information in the email reports on what the backup contained. * Fixed DropBox authentication for some users who were having problems = 1.3.8 - 01/24/2013 = * Fixed faulty assumptions in 'resume' code, now leading to more reliable resuming * Removed some duplicate code; first attempt and resumptions now uses same code * Added further parameters that should be removed on a wipe operation * More logging of detected double runs = 1.3.2 - 01/23/2013 = * Internal reorganisation, enabling UpdraftPlus Premium = 1.2.46 - 01/22/2013 = * Easier Dropbox setup (we are now an official production app) * New button to delete all existing settings * Admin console now displays rolling status updates * Feature: choose how many files and databases to retain separately * Fixed bug with checking access token on Google Drive restore * Fixed bug producing copious warnings in PHP log * Fixed bug in automated restoration processes * Possibly fixed settings saving bug in RTL installations * Fix erroneous display of max_execution_time warning * Better logging when running a DB debug session * Better detection/handling of overlapping/concurrent runs = 1.2.31 - 01/15/2013 = * Fixed bug with Dropbox deletions * Fixed cases where Dropbox failed to resume chunked uploading * Can now create uncreated zip files on a resumption attempt * FTP method now supports SSL (automatically detected) * New "Test FTP settings" button * Less noise when debugging is turned off * Fix bug (in 1.2.30) that prevented some database uploads completing = 1.2.20 - 01/12/2013 = * Dropbox no longer limited to 150Mb uploads * Dropbox can upload in chunks and resume uploading chunks * Improved Dropbox help text = 1.2.18 - 01/11/2013 = * Revert Dropbox to CURL-only - was not working properly with WordPress's built-in methods * Add note that only up to 150Mb is possible for a Dropbox upload, until we change our API usage * Fix unnecessary repetition of database dump upon resumption of a failed backup = 1.2.14 - 01/08/2013 = * Dropbox support (no chunked uploading yet, but otherwise complete) * Make the creation of the database dump also resumable, for people with really slow servers * Database table backups are now timed * FTP logging slightly improved * Dropbox support uses WordPress's built-in HTTP functions = 1.1.16 - 01/07/2013 = * Requested feature: more frequent scheduling options requested * Fixed bug which mangled default suggestion for backup working directory on Windows * Provide a 'Test S3 Settings' button for Amazon S3 users = 1.1.11 - 01/04/2013 = * Bug fix: some backup runs were erroneously being identified as superfluous and cancelled = 1.1.9 - 12/31/2012 = * Big code re-factoring; cloud access methods now modularised, paving way for easier adding of new methods. Note that Google Drive users may need to re-authenticate - please check that your backups are working. * Fix bug whereby some resumptions of failed backups were erroneously cancelled * Database encryption made part of what is resumable = 1.0.16 - 12/24/2012 = * Improve race detection and clean up already-created files when detected = 1.0.15 - 12/22/2012 = * Fixed bug that set 1Tb (instead of 1Mb) chunk sizes for Google Drive uploads * Added link to some screenshots to help with Google Drive setup * Allowed use of existing Amazon S3 buckets with restrictive policies (previously, we tested for the bucket's existence by running a create operation on it, which may not be permitted) * Use WordPress's native HTTP functions for greater reliability when performing Google Drive authorisation * Deal with WP-Cron racey double events (abort superseded backups) * Allow user to download logs from admin interface = 1.0.5 - 12/13/2012 = * Tweaked default Google Drive options = 1.0.4 - 12/10/2012 = * Implemented resumption/chunked uploading on Google Drive - much bigger sites can now be backed up * Fixed bug whereby setting for deleting local backups was lost * Now marked as 1.0, since we are feature-complete with targeted features for this release * Made description fuller = 0.9.20 - 12/06/2012 = * Updated to latest S3.php library with chunked uploading patch * Implemented chunked uploading on Amazon S3 - much bigger sites can now be backed up with S3 = 0.9.10 - 11/22/2012 = * Completed basic Google Drive support (thanks to Sorin Iclanzan, code taken from "Backup" plugin under GPLv3+); now supporting uploading, purging and restoring - i.e. full UpdraftPlus functionality * Licence change to GPLv3+ (from GPLv2+) to allow incorporating Sorin's code * Tidied/organised the settings screen further = 0.9.2 - 11/21/2012 = * Failed uploads can now be re-tried, giving really big blogs a better opportunity to eventually succeed uploading = 0.8.51 - 11/19/2012 = * Moved screenshot into assets, reducing plugin download size = 0.8.50 - 10/13/2012 = * Important new feature: backup other directories found in the WP content (wp-content) directory (not just plugins/themes/uploads, as in original Updraft) = 0.8.37 - 10/12/2012 = * Don't whinge about Google Drive authentication if that method is not current = 0.8.36 - 10/03/2012 = * Support using sub-directories in Amazon S3 * Some more debug logging for Amazon S3 = 0.8.33 - 09/19/2012 = * Work around some web hosts with invalid safe_mode configurations = 0.8.32 - 09/17/2012 = * Fix a subtle bug that caused database tables from outside of this WordPress install to be backed up = 0.8.31 - 09/08/2012 = * Fixed error deleting old S3 backups. If your expired S3 backups were not deleted, they should be in future - but you will need to delete manually those that expired before you installed this update. * Fixed minor bug closing log file * Marked as working with WordPress 3.4.2 = 0.8.29 - 06/29/2012 = * Marking as tested up to WordPress 3.4.1 = 0.8.28 - 06/06/2012 = * Now experimentally supports Google Drive (thanks to Sorin Iclanzan, code re-used from his Google Drive-only 'backup' plugin) * New feature: backup files and database on separate schedules * Tidied and improved retain behaviour = 0.7.7 - 05/29/2012 = * Implementation of a logging mechanism to allow easier debugging and development = 0.7.4 - 05/21/2012 = * Removed CloudFront method; I have no way of testing this * Backup all tables found in the database that have this site's table prefix * If encryption fails, then abort (don't revert to not encrypting) * Added ability to decrypt encrypted database backups * Added ability to opt out of backing up each file group * Now adds database character set, the lack of which before made database backups unusable without modifications * Version number bump to make clear that this is an improvement on the original Updraft, and is now tried and tested = 0.1.3 - 01/16/2012 = * Force backup of all tables found in database (vanilla Updraft only backed up WP core tables) * Tweak notification email to include site name = 0.1 - 08/10/2011 = * A fork of Updraft Backup/Restore 0.6.1 by Paul Kehrer with the following improvements * Replaced deprecated function calls (in WordPress 3.2.1) * Removed all warnings from basic admin page with WP_DEBUG on * Implemented encrypted backup (but not yet automatic restoration) on database * Some de-uglification of admin interface	124.28 KB	2025-10-09 08:53
📄 class-updraftplus.php <?php if (!defined('UPDRAFTPLUS_DIR')) die('No direct access allowed'); class UpdraftPlus { public $version; public $plugin_title = 'UpdraftPlus Backup/Restore'; // Choices will be shown in the admin menu in the order used here public $backup_methods = array( 'updraftvault' => 'UpdraftVault', 'dropbox' => 'Dropbox', 's3' => 'Amazon S3', 'cloudfiles' => 'Rackspace Cloud Files', 'googledrive' => 'Google Drive', 'onedrive' => 'Microsoft OneDrive', 'ftp' => 'FTP', 'azure' => 'Microsoft Azure', 'sftp' => 'SFTP / SCP', 'googlecloud' => 'Google Cloud', 'backblaze' => 'Backblaze', 'webdav' => 'WebDAV', 's3generic' => 'S3-Compatible (Generic)', 'pcloud' => 'pCloud', 'openstack' => 'OpenStack (Swift)', 'dreamobjects' => 'DreamObjects', 'email' => 'Email' ); public $errors = array(); public $nonce; public $file_nonce; public $logfile_name = ""; public $logfile_handle = false; public $backup_time; public $job_time_ms; public $opened_log_time; private $backup_dir; private $jobdata; public $something_useful_happened = false; public $have_addons = false; // Used to schedule resumption attempts beyond the tenth, if needed public $current_resumption; public $last_successful_resumption; public $newresumption_scheduled = false; public $resumption_scheduled_for_cleanup = false; public $cpanel_quota_readable = false; public $error_reporting_stop_when_logged = false; private $combine_jobs_around; // Used for reporting private $attachments; private $remotestorage_extrainfo = array(); public $no_checkin_last_time; private $removed_autoloaders = array(); private $no_deprecation_warnings = false; private $backup_is_already_complete = false; private $error_count_before_cloud_backup = 0; private $semaphore; private $backup_semaphore; /** * Class constructor / public function __construct() { global $pagenow; // Initialisation actions - takes place on plugin load // phpcs:disable WordPress.WP.AlternativeFunctions.file_system_operations_fopen,WordPress.WP.AlternativeFunctions.file_system_operations_fread,WordPress.WP.AlternativeFunctions.file_system_operations_fclose,WordPress.WP.AlternativeFunctions.file_system_operations_readfile,WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents,WordPress.WP.AlternativeFunctions.file_system_operations_fwrite -- suggesting using the interactive WP Filesystem API (or any other API) for read-access to files is absurd; and all write operations in this file are non-interactive, to known-writable directories if ($fp = fopen(UPDRAFTPLUS_DIR.'/updraftplus.php', 'r')) { $file_data = fread($fp, 1024); if (preg_match("/Version: ([\d\.]+)(\r\|\n)/", $file_data, $matches)) { $this->version = $matches[1]; } fclose($fp); } $load_classes = array( 'UpdraftPlus_Backup_History' => 'includes/class-backup-history.php', 'UpdraftPlus_Encryption' => 'includes/class-updraftplus-encryption.php', 'UpdraftPlus_Manipulation_Functions' => 'includes/class-manipulation-functions.php', 'UpdraftPlus_Filesystem_Functions' => 'includes/class-filesystem-functions.php', 'UpdraftPlus_Storage_Methods_Interface' => 'includes/class-storage-methods-interface.php', 'UpdraftPlus_Job_Scheduler' => 'includes/class-job-scheduler.php', 'UpdraftPlus_HTTP_Error_Descriptions' => 'includes/class-http-error-descriptions.php', 'UpdraftPlus_Database_Utility' => 'includes/class-database-utility.php', 'UpdraftPlus_Migrator_Lite' => 'includes/migrator-lite.php', ); foreach ($load_classes as $class => $relative_path) { if (!class_exists($class)) updraft_try_include_file(''.$relative_path, 'include_once'); } if (!class_exists('UpdraftPlus_Addons_Migrator')) { new UpdraftPlus_Migrator_Lite(); } // Create admin page add_action('init', array($this, 'initialize_required_settings')); // Run earlier than default - hence earlier than other components // admin_menu runs earlier, and we need it because options.php wants to use $updraftplus_admin before admin_init happens add_action(apply_filters('updraft_admin_menu_hook', 'admin_menu'), array($this, 'admin_menu'), 9); // Not a mistake: admin-ajax.php calls only admin_init and not admin_menu add_action('admin_init', array($this, 'admin_menu'), 9); add_action('admin_init', array($this, 'wordpress_55_updates_potential_migration')); // The two actions which we schedule upon add_action('updraft_backup', array($this, 'backup_files')); add_action('updraft_backup_database', array($this, 'backup_database')); // The three actions that can be called from "Backup Now" add_action('updraft_backupnow_backup', array($this, 'backupnow_files')); add_action('updraft_backupnow_backup_database', array($this, 'backupnow_database')); add_action('updraft_backupnow_backup_all', array($this, 'backup_all')); // backup_all as an action is legacy (Oct 2013) - there may be some people who wrote cron scripts to use it add_action('updraft_backup_all', array($this, 'backup_all')); // This is our runs-after-backup event, whose purpose is to see if it succeeded or failed, and resume/mom-up etc. add_action('updraft_backup_resume', array($this, 'backup_resume'), 10, 3); // If files + db are on different schedules but are scheduled for the same time, then combine them add_filter('schedule_event', array($this, 'schedule_event')); add_action('plugins_loaded', array($this, 'plugins_loaded')); // Since the WordPress version 5.5, we are no longer forcing an auto update by hooking the auto_update_plugin filter because WordPress does something different to its auto-update interface if (version_compare($this->get_wordpress_version(), '5.5', '<')) { // Auto update plugin add_filter('auto_update_plugin', array($this, 'maybe_auto_update_plugin'), 20, 2); } // Prevent iThemes Security from telling people that they have no backups (and advertising them another product on that basis!) add_filter('itsec_has_external_backup', '__return_true', 999); add_filter('itsec_external_backup_link', array($this, 'itsec_external_backup_link'), 999); add_filter('itsec_scheduled_external_backup', array($this, 'itsec_scheduled_external_backup'), 999); add_action('updraft_report_remotestorage_extrainfo', array($this, 'report_remotestorage_extrainfo'), 10, 3); // Prevent people using WP < 5.5 upgrading from being baffled by WP's obscure error message. See: https://core.trac.wordpress.org/ticket/27196 if (version_compare($this->get_wordpress_version(), '5.4.99999999', '<')) { add_filter('upgrader_source_selection', array($this, 'upgrader_source_selection'), 10, 4); } // register_deactivation_hook(__FILE__, array($this, 'deactivation')); if (!empty($_POST) && !empty($_GET['udm_action']) && 'vault_disconnect' == $_GET['udm_action'] && !empty($_POST['udrpc_message']) && !empty($_POST['reset_hash'])) { add_action('wp_loaded', array($this, 'wp_loaded_vault_disconnect'), 1); } // Remove the notice on the Updates page that confuses users who already have backups installed if ('update-core.php' == $pagenow) { // added filter here instead of admin.php because the jetpack_just_in_time_msgs filter applied in init hook add_filter('jetpack_just_in_time_msgs', '__return_false', 20); } // Cron to clean temporary files even in the absence of a new backup job beginning add_action('updraftplus_clean_temporary_files', 'UpdraftPlus_Filesystem_Functions::clean_temporary_files', 10); if (!wp_next_scheduled('updraftplus_clean_temporary_files')) { wp_schedule_event(time(), 'twicedaily', 'updraftplus_clean_temporary_files'); } // phpcs:enable } /* * Enables automatic updates for the plugin. * * @access public * @see __construct * @internal uses auto_update_plugin filter * * @param Bool $update Whether the item has automatic updates enabled * @param Object $item Object holding the asset to be updated * @return bool True of automatic updates enabled, false if not / public function maybe_auto_update_plugin($update, $item) { if (!isset($item->plugin) \|\| basename(UPDRAFTPLUS_DIR).'/updraftplus.php' !== $item->plugin) return $update; $option_auto_update_settings = (array) get_site_option('auto_update_plugins', array()); return in_array($item->plugin, $option_auto_update_settings, true); } /* * Called by the WP action updraft_report_remotestorage_extrainfo * * @param String $service * @param String $info_html - the HTML version of the extra info * @param String $info_plain - the plain text version of the extra info / public function report_remotestorage_extrainfo($service, $info_html, $info_plain) { $this->remotestorage_extrainfo[$service] = array('pretty' => $info_html, 'plain' => $info_plain); } /* * WP filter upgrader_source_selection. We use it to tweak the error message shown when an install of a new version is prevented by the existence of an existing version (i.e. us!), to give the user some actual useful information instead of WP's default. * * @param String $source File source location. * @param String $remote_source Remote file source location. * @param WP_Upgrader $upgrader_object WP_Upgrader instance. * @param Array $hook_extra Extra arguments passed to hooked filters. * * @return String - filtered value / public function upgrader_source_selection($source, $remote_source, $upgrader_object, $hook_extra = array()) {// phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found -- Filter use static $been_here_already = false; if ($been_here_already \|\| !is_array($hook_extra) \|\| empty($hook_extra['type']) \|\| 'plugin' !== $hook_extra['type'] \|\| empty($hook_extra['action']) \|\| 'install' !== $hook_extra['action'] \|\| empty($source) \|\| 'updraftplus' !== basename(untrailingslashit($source)) \|\| !class_exists('ReflectionObject')) return $source; $been_here_already = true; $reflect = new ReflectionObject($upgrader_object); $properties = $reflect->getProperty('strings'); if (!$properties->isPublic() \|\| !is_array($upgrader_object->strings) \|\| empty($upgrader_object->strings['folder_exists'])) return $source; $upgrader_object->strings['folder_exists'] .= ' '.__('A version of UpdraftPlus is already installed.', 'updraftplus').' '.__('WordPress will only allow you to install your new version after first de-installing the existing one.', 'updraftplus').' '.__('That is safe - all your settings and backups will be retained.', 'updraftplus').' '.__('So, go to the "Plugins" page, de-activate and de-install UpdraftPlus, and then try again.', 'updraftplus'); return $source; } /* * WordPress filter itsec_scheduled_external_backup - from iThemes Security * * @return Boolean - filtered value / public function itsec_scheduled_external_backup() { return wp_next_scheduled('updraft_backup') ? true : false; } /* * WordPress filter itsec_external_backup_link - from iThemes security * * @return String - filtered value / public function itsec_external_backup_link() { return UpdraftPlus_Options::admin_page_url().'?page=updraftplus'; } /* * This method will disconnect UpdraftVault accounts. * * @return Array - returns the saved options if an error is encountered. / public function wp_loaded_vault_disconnect() { $opts = UpdraftPlus_Storage_Methods_Interface::update_remote_storage_options_format('updraftvault'); if (is_wp_error($opts)) { if ('recursion' !== $opts->get_error_code()) { $msg = "UpdraftVault (".$opts->get_error_code()."): ".$opts->get_error_message(); $this->log($msg); error_log("UpdraftPlus: $msg"); } // The saved options had a problem; so, return the new ones return $opts; } elseif (!empty($opts['settings'])) { foreach ($opts['settings'] as $storage_options) { if (!empty($storage_options['token']) && $storage_options['token']) { $site_id = $this->siteid(); $hash = hash('sha256', $site_id.':::'.$storage_options['token']); if ($hash == $_POST['reset_hash']) { $this->log('This site has been remotely disconnected from UpdraftVault'); updraft_try_include_file('methods/updraftvault.php', 'include_once'); $vault = new UpdraftPlus_BackupModule_updraftvault(); $vault->ajax_vault_disconnect(); // Die, as the vault method has already sent output die; } else { $this->log('An invalid request was received to disconnect this site from UpdraftVault'); } } echo json_encode(array('disconnected' => 0)); } } die; } /* * Gets an RPC object, and sets some defaults on it that we always want * * @param string $indicator_name indicator name * @return array / public function get_udrpc($indicator_name = 'migrator.updraftplus.com') { $this->ensure_phpseclib(); if (!class_exists('UpdraftPlus_Remote_Communications_V2')) include_once(apply_filters('updraftplus_class_udrpc_path', UPDRAFTPLUS_DIR.'/vendor/team-updraft/common-libs/src/updraft-rpc/class-udrpc2.php', $this->version)); $ud_rpc = new UpdraftPlus_Remote_Communications_V2($indicator_name); $ud_rpc->set_can_generate(true); return $ud_rpc; } /* * Ensure that the indicated phpseclib classes are available * * @return Boolean\|WP_Error Boolean true if the given classes is already included or autoloader is successfully registered, otherwise WP Error / public function ensure_phpseclib() { if (!$this->phpseclib_requirements_met()) { $this->maybe_log_phpseclib_warnings(); // return new WP_Error('phpseclib_php_version', "PHP Secure Communication Library doesn't meet the minimum PHP requirements."); } $this->no_deprecation_warnings_on_php7(); $ret = true; // From phpseclib/phpseclib/phpseclib/bootstrap.php - we nullify it there, but log here instead if (extension_loaded('mbstring')) { // 2 - MB_OVERLOAD_STRING // @codingStandardsIgnoreLine if (ini_get('mbstring.func_overload') & 2) { // We go on to try anyway, in case the caller wasn't using an affected part of phpseclib // @codingStandardsIgnoreLine $ret = new WP_Error('mbstring_func_overload', 'Overloading of string functions using mbstring.func_overload is not supported by phpseclib.'); } } $phpseclib_dir = UPDRAFTPLUS_DIR.'/vendor/phpseclib/phpseclib/phpseclib'; if (false === strpos(get_include_path(), $phpseclib_dir)) set_include_path(get_include_path().PATH_SEPARATOR.$phpseclib_dir); spl_autoload_register(array($this, 'autoload_phpseclib_class')); return $ret; } /* * Load phpseclib class automatically. Note that this method is hooked into the PHP's spl_auto_register and this is exclusively used for phpseclib only * * @param String $class A class name that's going to be used for instantiating an object * @return Void / public function autoload_phpseclib_class($class) { if (!preg_match('#^phpseclib_#', $class)) return; // only deals with class prefixed with "phpseclib_", because we use that prefix to our customised phpseclib class and to call/instantiate object of phpseclib classes (e.g. new phpseclib_Crypt_RSA = new phpseclib\Crypt\RSA) $phpseclib_dir = UPDRAFTPLUS_DIR.'/vendor/phpseclib/phpseclib/phpseclib'; $class = str_replace('_', '/', $class); // turn the class name into paths by replacing underscores from the given class with slashes, this is to change our customised phpseclib class name to a fully qualified phpseclib v2 namespace $class = preg_replace('#^phpseclib/(.+)$#', "$1", $class); // take out the 'phpseclib' from the beginning of the class name as we already have the root directory of phpseclib defined in the $phpseclib_dir variable if (file_exists($phpseclib_dir.'/'.$class.'.php') == true) { // check whether the class name that has been transformed into directory paths mathces with one of the phpseclib class files $phpseclib_class_v2 = 'phpseclib\\'.str_replace('/', '\\', $class); $phpseclib_updraft_class = 'phpseclib_'.str_replace('/', '_', $class); updraft_try_include_file('vendor/autoload.php', 'require_once'); // load the composer autoload.php every time our customised phpseclib class is called (if not already loaded) if (class_exists($phpseclib_class_v2) && !class_exists($phpseclib_updraft_class)) class_alias($phpseclib_class_v2, $phpseclib_updraft_class); // phpcs:ignore PHPCompatibility.FunctionUse.NewFunctions.class_aliasFound -- the use of class_alias here to map our customised phpseclib class to the real one owned by the phpseclib v2 class (e.g. phpseclib_Crypt_RSA => phpseclib\Crypt\RSA) } } /* * Ugly, but necessary to prevent debug output breaking the conversation when the user has debug turned on / private function no_deprecation_warnings_on_php7() { // PHP_MAJOR_VERSION is defined in PHP 5.2.7+ // We don't test for PHP > 7 because the specific deprecated element will be removed in PHP 8 - and so no warning should come anyway (and we shouldn't suppress other stuff until we know we need to). // @codingStandardsIgnoreLine if (defined('PHP_MAJOR_VERSION') && PHP_MAJOR_VERSION == 7) { $old_level = error_reporting(); // @codingStandardsIgnoreLine $new_level = $old_level & ~E_DEPRECATED; if ($old_level != $new_level) error_reporting($new_level); $this->no_deprecation_warnings = true; } } /* * Attempt to close the connection to the browser, optionally with some output sent first, whilst continuing execution * * @param String $txt - JSON-encoded output to send / public function close_browser_connection($txt = '') { // Close browser connection so that it can resume AJAX polling header('Content-Length: '.(empty($txt) ? '0' : 4+strlen($txt))); header('Connection: close'); header('Content-Type: application/json'); // Used to be 'none', but all inputs to this method are JSON-encoded if (function_exists('session_id') && session_id()) session_write_close(); echo "\r\n\r\n"; echo $txt; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- All inputs to this method are already JSON-encoded, and the output context is not HTML // These two added - 19-Feb-15 - started being required on local dev machine, for unknown reason (probably some plugin that started an output buffer). $ob_level = ob_get_level(); while ($ob_level > 0) { ob_end_flush(); $ob_level--; } flush(); if (function_exists('fastcgi_finish_request')) fastcgi_finish_request(); if (function_exists('litespeed_finish_request')) litespeed_finish_request(); } /* * Returns the number of bytes free, if it can be detected; otherwise, false * Presently, we only detect CPanel. If you know of others, then feel free to contribute! / public function get_hosting_disk_quota_free() { if ((defined('UPDRAFTPLUS_SKIP_CPANEL_QUOTA_CHECK') && UPDRAFTPLUS_SKIP_CPANEL_QUOTA_CHECK) \|\| $this->detect_safe_mode() \|\| !@is_dir('/usr/local/cpanel') \|\| !function_exists('popen') \|\| (!@is_executable('/usr/local/bin/perl') && !@is_executable('/usr/local/cpanel/3rdparty/bin/perl'))) return false;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $perl = (@is_executable('/usr/local/cpanel/3rdparty/bin/perl')) ? '/usr/local/cpanel/3rdparty/bin/perl' : '/usr/local/bin/perl';// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $exec = "UPDRAFTPLUSKEY=updraftplus $perl ".UPDRAFTPLUS_DIR."/includes/get-cpanel-quota-usage.pl"; // A case was seen of a web hosting company that disabled pclose() but not popen() $handle = (function_exists('popen') && function_exists('pclose')) ? @popen($exec, 'r') : false; // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!is_resource($handle)) return false; $found = false; $lines = 0; while (false === $found && !feof($handle) && $lines<100) { $lines++; $w = fgets($handle); // Used, limit, remain if (preg_match('/RESULT: (\d+) (\d+) (\d+) /', $w, $matches)) { $found = true; } } $ret = pclose($handle); // The manual page for pclose() claims that only -1 indicates an error, but this is untrue if (false === $found \|\| 0 != $ret) return false; if ((int) $matches[2]<100 \|\| ($matches[1] + $matches[3] != $matches[2])) return false; $this->cpanel_quota_readable = true; return $matches; } /* * Fetch information about the most recently modified log file * * @return Array - lists the modification time, the full path to the log file, and the log's nonce (ID) / public function last_modified_log() { $updraft_dir = $this->backups_dir_location(); $log_file = ''; $mod_time = false; $nonce = ''; if ($handle = @opendir($updraft_dir)) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. while (false !== ($entry = readdir($handle))) { // The latter match is for files created internally by zipArchive::addFile if (preg_match('/^log\.([a-z0-9]+)\.txt$/i', $entry, $matches)) { $mtime = filemtime($updraft_dir.'/'.$entry); if ($mtime > $mod_time) { $mod_time = $mtime; $log_file = $updraft_dir.'/'.$entry; $nonce = $matches[1]; } } } @closedir($handle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } return array($mod_time, $log_file, $nonce); } /* * This function may get called multiple times, so write accordingly / public function admin_menu() { // We are in the admin area: now load all that code global $updraftplus_admin; if (empty($updraftplus_admin)) updraft_try_include_file('admin.php', 'include_once'); if (isset($_GET['wpnonce']) && isset($_GET['page']) && isset($_GET['action']) && 'updraftplus' == $_GET['page'] && 'downloadlatestmodlog' == $_GET['action'] && wp_verify_nonce($_GET['wpnonce'], 'updraftplus_download')) { list($mod_time, $log_file, $nonce) = $this->last_modified_log();// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Unused parameter is present because the method returns an array. if ($mod_time >0) { if (is_readable($log_file)) { header('Content-type: text/plain'); readfile($log_file); exit; } else { add_action('all_admin_notices', array($this, 'show_admin_warning_unreadablelog')); } } else { add_action('all_admin_notices', array($this, 'show_admin_warning_nolog')); } } } /* * WP action http_api_curl * * @param Resource $handle A curl handle returned by curl_init() * * @return the handle (having potentially had some options set upon it) / public function http_api_curl($handle) { if (defined('UPDRAFTPLUS_IPV4_ONLY') && UPDRAFTPLUS_IPV4_ONLY) { curl_setopt($handle, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4); } return $handle; } /* * Used as a central location (to avoid repetition) to register or de-register hooks into the WP HTTP API * * @param Boolean $register - true to register, false to de-register / public function register_wp_http_option_hooks($register = true) { if ($register) { add_filter('http_request_args', array($this, 'modify_http_options')); add_action('http_api_curl', array($this, 'http_api_curl')); } else { remove_filter('http_request_args', array($this, 'modify_http_options')); remove_action('http_api_curl', array($this, 'http_api_curl')); } } /* * Used as a WordPress options filter (http_request_args) * * @param Array $opts - existing options * * @return Array - modified options / public function modify_http_options($opts) { if (!is_array($opts)) return $opts; if (!UpdraftPlus_Options::get_updraft_option('updraft_ssl_useservercerts')) $opts['sslcertificates'] = UPDRAFTPLUS_DIR.'/includes/cacert.pem'; $opts['sslverify'] = UpdraftPlus_Options::get_updraft_option('updraft_ssl_disableverify') ? false : true; return $opts; } /* * Initialize all settings required for the plugin to work properly / public function initialize_required_settings() { // Tell WordPress where to find the translations load_plugin_textdomain('updraftplus', false, basename(dirname(__FILE__)).'/languages/'); do_action('updraftplus_load_translations_for_udcentral'); $this->handle_url_actions(); $this->updraftplus_single_site_maintenance_init(); } /* * Handle actions passed on to method plugins; e.g. Google OAuth 2.0 - ?action=updraftmethod-googledrive-auth&page=updraftplus * Nov 2013: Google's new cloud console, for reasons as yet unknown, only allows you to enter a redirect_uri with a single URL parameter... thus, we put page second, and re-add it if necessary. Apr 2014: Bitcasa already do this, so perhaps it is part of the OAuth2 standard or best practice somewhere. * Also handle action=downloadlog * * @return Void - may not necessarily return at all, depending on the action / private function handle_url_actions() { // First, basic security check: must be an admin page, with ability to manage options, with the right parameters // Also, only on GET because WordPress on the options page repeats parameters sometimes when POST-ing via the _wp_referer field if (isset($_SERVER['REQUEST_METHOD']) && ('GET' == $_SERVER['REQUEST_METHOD'] \|\| 'POST' == $_SERVER['REQUEST_METHOD']) && (isset($_GET['action']) && is_string($_GET['action']))) { if (preg_match("/^updraftmethod-([a-z]+)-([a-z]+)$/", $_GET['action'], $matches) && file_exists(UPDRAFTPLUS_DIR.'/methods/'.$matches[1].'.php') && UpdraftPlus_Options::user_can_manage()) { $_GET['page'] = 'updraftplus'; $_REQUEST['page'] = 'updraftplus'; $method = $matches[1]; $call_method = "action_".$matches[2]; $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids(array($method)); $instance_id = (isset($_GET['updraftplus_instance']) && is_string($_GET['updraftplus_instance'])) ? $_GET['updraftplus_instance'] : ''; if ('POST' == $_SERVER['REQUEST_METHOD'] && isset($_POST['state']) && is_string($_POST['state'])) { $state = urldecode($_POST['state']); } elseif (isset($_GET['state']) && is_string($_GET['state'])) { $state = $_GET['state']; } // If we don't have an instance_id but the state is set then we are coming back to finish the auth and should extract the instance_id from the state if ('' == $instance_id && isset($state) && false !== strpos($state, ':')) { $parts = explode(':', $state); $instance_id = $parts[1]; } if (!preg_match('/^[-A-Z0-9]+$/i', $instance_id)) die('Invalid input.'); if (empty($storage_objects_and_ids[$method]['instance_settings'][$instance_id])) { error_log("UpdraftPlus::handle_url_actions(): no such instance ID found in settings."); return; } $opts = $storage_objects_and_ids[$method]['instance_settings'][$instance_id]; if (!isset($storage_objects_and_ids[$method]['object']) \|\| !is_object($storage_objects_and_ids[$method]['object'])) { updraft_try_include_file('methods/'.$method.'.php', 'include_once'); $call_class = "UpdraftPlus_BackupModule_".$method; if (!class_exists($call_class)) die(esc_html($call_class)." class couldn't be found"); $backup_obj = new $call_class; } else { $backup_obj = $storage_objects_and_ids[$method]['object']; } $backup_obj->set_options($opts, false, $instance_id); $this->register_wp_http_option_hooks(); try { if (method_exists($backup_obj, $call_method)) { call_user_func(array($backup_obj, $call_method)); } } catch (Exception $e) { $this->log(sprintf(__("%s error: %s", 'updraftplus'), $method, $e->getMessage().' ('.$e->getCode().')', 'error')); } $this->register_wp_http_option_hooks(false); } elseif (isset($_GET['page']) && 'updraftplus' === $_GET['page'] && 'downloadlog' === $_GET['action'] && isset($_GET['updraftplus_backup_nonce']) && is_string($_GET['updraftplus_backup_nonce']) && preg_match("/^[0-9a-f]{12}$/", $_GET['updraftplus_backup_nonce']) && UpdraftPlus_Options::user_can_manage()) { // No WordPress nonce is needed here or for the next, since the backup is already nonce-based $updraft_dir = $this->backups_dir_location(); $log_file = $updraft_dir.'/log.'.$_GET['updraftplus_backup_nonce'].'.txt'; if (is_readable($log_file)) { header('Content-type: text/plain'); if (!empty($_GET['force_download'])) header('Content-Disposition: attachment; filename="'.basename($log_file).'"'); readfile($log_file); exit; } else { add_action('all_admin_notices', array($this, 'show_admin_warning_unreadablelog')); } } elseif (isset($_GET['page']) && 'updraftplus' === $_GET['page'] && 'downloadfile' == $_GET['action'] && isset($_GET['updraftplus_file']) && is_string($_GET['updraftplus_file']) && preg_match('/^backup_([\-0-9]{15})_._([0-9a-f]{12})-db([0-9]+)?+\.(gz\.crypt)$/i', $_GET['updraftplus_file']) && UpdraftPlus_Options::user_can_manage()) { // Though this (venerable) code uses the action 'downloadfile', in fact, it's not that general: it's just for downloading a decrypted copy of encrypted databases, and nothing else $updraft_dir = $this->backups_dir_location(); $file = $_GET['updraftplus_file']; $spool_file = $updraft_dir.'/'.basename($file); if (is_readable($spool_file)) { $dkey = (isset($_GET['decrypt_key']) && is_string($_GET['decrypt_key'])) ? stripslashes($_GET['decrypt_key']) : ''; $this->spool_file($spool_file, $dkey); exit; } else { add_action('all_admin_notices', array($this, 'show_admin_warning_unreadablefile')); } } elseif ('updraftplus_spool_file' === $_GET['action'] && !empty($_GET['what']) && !empty($_GET['backup_timestamp']) && is_numeric($_GET['backup_timestamp']) && UpdraftPlus_Options::user_can_manage()) { // At some point, it may be worth merging this with the previous section $updraft_dir = $this->backups_dir_location(); $findex = isset($_GET['findex']) ? (int) stripslashes((string) $_GET['findex']) : 0; $backup_timestamp = stripslashes((string) $_GET['backup_timestamp']); $what = stripslashes((string) $_GET['what']); $backup_set = UpdraftPlus_Backup_History::get_history($backup_timestamp); $filename = null; if (!empty($backup_set)) { if ('db' != substr($what, 0, 2)) { $backupable_entities = $this->get_backupable_file_entities(); if (!isset($backupable_entities[$what])) $filename = false; } if (false !== $filename && isset($backup_set[$what])) { if (is_string($backup_set[$what]) && 0 == $findex) { $filename = $backup_set[$what]; } elseif (isset($backup_set[$what][$findex])) { $filename = $backup_set[$what][$findex]; } } } if (empty($filename) \|\| !is_readable($updraft_dir.'/'.basename($filename))) { echo json_encode(array('result' => __('UpdraftPlus notice:', 'updraftplus').' '.__('The given file was not found, or could not be read.', 'updraftplus'))); exit; } $dkey = (isset($_GET['decrypt_key']) && is_string($_GET['decrypt_key'])) ? stripslashes($_GET['decrypt_key']) : ""; $this->spool_file($updraft_dir.'/'.basename($filename), $dkey); exit; } } } /** * This function will check if this is a multisite and if our maintenance mode file is present if so return a service unavailable * * @return void / private function updraftplus_single_site_maintenance_init() { if (!is_multisite()) return; $wp_upload_dir = wp_upload_dir(); $subsite_dir = $wp_upload_dir['basedir'].'/'; if (!file_exists($subsite_dir.'.maintenance')) return; $timestamp = file_get_contents($subsite_dir.'.maintenance'); $time = time(); if ($time - $timestamp > 3600) { unlink($subsite_dir.'.maintenance'); return; } wp_die('<h1>'.esc_html__('Under Maintenance', 'updraftplus') .'</h1><p>'.esc_html(__('Briefly unavailable for scheduled maintenance.', 'updraftplus').' '.__('Check back in a minute.', 'updraftplus')).'</p>'); } /* * Get the installation's base table prefix, optionally allowing the result to be filtered * * @param Boolean $allow_override - allow the result to be filtered * * @return String / public function get_table_prefix($allow_override = false) { global $wpdb; if (is_multisite() && !defined('MULTISITE')) { // In this case (which should only be possible on installs upgraded from pre WP 3.0 WPMU), $wpdb->get_blog_prefix() cannot be made to return the right thing. $wpdb->base_prefix is not explicitly marked as public, so we prefer to use get_blog_prefix if we can, for future compatibility. $prefix = $wpdb->base_prefix; } else { $prefix = $wpdb->get_blog_prefix(0); } return $allow_override ? apply_filters('updraftplus_get_table_prefix', $prefix) : $prefix; } /* * Get the site's identifier * * @return String / public function siteid() { $sid = get_site_option('updraftplus-addons_siteid'); if (!is_string($sid) \|\| empty($sid)) { $sid = md5(rand().microtime(true).home_url()); update_site_option('updraftplus-addons_siteid', $sid); } return $sid; } public function show_admin_warning_unreadablelog() { global $updraftplus_admin; $updraftplus_admin->show_admin_warning('<strong>'.__('UpdraftPlus notice:', 'updraftplus').'</strong> '.__('The log file could not be read.', 'updraftplus')); } public function show_admin_warning_nolog() { global $updraftplus_admin; $updraftplus_admin->show_admin_warning('<strong>'.__('UpdraftPlus notice:', 'updraftplus').'</strong> '.__('No log files were found.', 'updraftplus')); } public function show_admin_warning_unreadablefile() { global $updraftplus_admin; $updraftplus_admin->show_admin_warning('<strong>'.__('UpdraftPlus notice:', 'updraftplus').'</strong> '.__('The given file was not found, or could not be read.', 'updraftplus')); } /* * Runs upon the WP action plugins_loaded / public function plugins_loaded() { // The Google Analyticator plugin does something horrible: loads an old version of the Google SDK on init, always - which breaks us if ((defined('DOING_CRON') && DOING_CRON) \|\| (defined('DOING_AJAX') && DOING_AJAX && isset($_REQUEST['subaction']) && 'backupnow' == $_REQUEST['subaction']) \|\| (isset($_GET['page']) && 'updraftplus' == $_GET['page'] )) { remove_action('init', 'ganalyticator_stats_init'); // Appointments+ does the same; but provides a cleaner way to disable it @define('APP_GCAL_DISABLE', true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } add_filter('updraftcentral_remotecontrol_command_classes', array($this, 'updraftcentral_remotecontrol_command_classes')); add_action('updraftcentral_command_class_wanted', array($this, 'updraftcentral_command_class_wanted')); add_action('updraftcentral_listener_pre_udrpc_action', array($this, 'updraftcentral_listener_pre_udrpc_action')); add_action('updraftcentral_listener_post_udrpc_action', array($this, 'updraftcentral_listener_post_udrpc_action')); add_filter('updraftcentral_host_plugins', array($this, 'attach_updraftcentral_host')); if (file_exists(UPDRAFTPLUS_DIR.'/central/factory.php')) updraft_try_include_file('central/factory.php', 'include_once'); $load_classes = array(); if (defined('UPDRAFTPLUS_THIS_IS_CLONE')) { if (is_numeric(UPDRAFTPLUS_THIS_IS_CLONE) && UPDRAFTPLUS_THIS_IS_CLONE < 2) define('DONOTCACHEPAGE', true); $load_classes['UpdraftPlus_Temporary_Clone_Dash_Notice'] = 'includes/updraftclone/temporary-clone-dash-notice.php'; $load_classes['UpdraftPlus_Temporary_Clone_User_Notice'] = 'includes/updraftclone/temporary-clone-user-notice.php'; $load_classes['UpdraftPlus_Temporary_Clone_Restore'] = 'includes/updraftclone/temporary-clone-restore.php'; $load_classes['UpdraftPlus_Temporary_Clone_Auto_Login'] = 'includes/updraftclone/temporary-clone-auto-login.php'; $load_classes['UpdraftPlus_Temporary_Clone_Status'] = 'includes/updraftclone/temporary-clone-status.php'; add_filter('get_avatar_url', array($this, 'get_avatar_url'), 99); } foreach ($load_classes as $class => $relative_path) { if (!class_exists($class)) updraft_try_include_file(''.$relative_path, 'include_once'); } } /* * Attach this updraftplus plugin as host of the UpdraftCentral libraries * (e.g. "central" folder) * * @param array $hosts List of plugins having the "central" library integrated into them * * @return array / public function attach_updraftcentral_host($hosts) { $hosts[] = 'updraftplus'; return $hosts; } /* * Get the character set for the current database connection * * @uses WPDB::determine_charset() - exists on WP 4.6+ * * @param Object\|Null $wpdb - WPDB object; if none passed, then use the global one * * @return String / public function get_connection_charset($wpdb = null) { if (null === $wpdb) { global $wpdb; } $charset = (defined('DB_CHARSET') && DB_CHARSET) ? DB_CHARSET : 'utf8mb4'; if (method_exists($wpdb, 'determine_charset')) { $charset_collate = $wpdb->determine_charset($charset, ''); if (!empty($charset_collate['charset'])) $charset = $charset_collate['charset']; } return $charset; } /* * Runs upon the action updraftcentral_listener_pre_udrpc_action / public function updraftcentral_listener_pre_udrpc_action() { $this->register_wp_http_option_hooks(); } /* * Runs upon the action updraftcentral_listener_post_udrpc_action / public function updraftcentral_listener_post_udrpc_action() { $this->register_wp_http_option_hooks(false); } /* * Register our class. WP filter updraftcentral_remotecontrol_command_classes. * * @param Array $command_classes sends across the command class * * @return Array - filtered value / public function updraftcentral_remotecontrol_command_classes($command_classes) { if (is_array($command_classes)) $command_classes['updraftplus'] = 'UpdraftCentral_UpdraftPlus_Commands'; if (is_array($command_classes)) $command_classes['updraftvault'] = 'UpdraftCentral_UpdraftVault_Commands'; return $command_classes; } /* * Load the class when required * * @param string $command_php_class Sends across the php class type / public function updraftcentral_command_class_wanted($command_php_class) { if ('UpdraftCentral_UpdraftPlus_Commands' == $command_php_class) { updraft_try_include_file('includes/class-updraftcentral-updraftplus-commands.php', 'include_once'); } elseif ('UpdraftCentral_UpdraftVault_Commands' == $command_php_class) { updraft_try_include_file('includes/updraftvault.php', 'include_once'); } } /* * This function allows you to manually set the nonce and timestamp for the current backup job. If none are provided then it will create new ones. * * @param Boolean\|string $nonce - the nonce you want to set * @param Boolean\|string $timestamp - the timestamp you want to set * * @return string - returns the backup nonce that has been set / public function backup_time_nonce($nonce = false, $timestamp = false) { $this->job_time_ms = microtime(true); if (false === $timestamp) $timestamp = time(); if (false === $nonce) $nonce = substr(md5(time().rand()), 20); $this->backup_time = $timestamp; $this->file_nonce = apply_filters('updraftplus_incremental_backup_file_nonce', $nonce); $this->nonce = $nonce; return $nonce; } /* * Get the WordPress version * * @return String - the version / public function get_wordpress_version() { static $got_wp_version = false; if (!$got_wp_version) { // This doesn't need to be global, but is kept just in case version.php changes its way of doing things in a future WP core release global $wp_version; include(ABSPATH.WPINC.'/version.php'); $got_wp_version = $wp_version; } return $got_wp_version; } /* * Get the UpdraftPlus version and convert it to the correct format to be used in filenames * * @return String - the file version number / public function get_updraftplus_file_version() { if ($this->use_unminified_scripts()) return ''; $version_parts = explode('.', $this->version); $version_parts = array_slice($version_parts, 0, 3); $version = implode('.', $version_parts); return '-'.str_replace('.', '-', $version).'.min'; } /* * Opens the log file, writes a standardised header, and stores the resulting name and handle in the class variables logfile_name/logfile_handle/opened_log_time (and possibly backup_is_already_complete) * * @param String $nonce - Used in the log file name to distinguish it from other log files. Should be the job nonce. * @returns void / public function logfile_open($nonce) { $this->logfile_name = $this->get_logfile_name($nonce); $this->backup_is_already_complete = $this->found_backup_complete_in_logfile($nonce, false); $this->logfile_handle = fopen($this->logfile_name, 'a'); $this->opened_log_time = microtime(true); $this->write_log_header(array($this, 'log')); } /* * Opens the log file, and finds if backup_is_already_complete * * @param String $nonce - Used in the log file name to distinguish it from other log files. Should be the job nonce. * @param Boolean $use_existing_result - Whether to use any existing result or not * * @return boolean - returns true if the backup is complete otherwise returns false / public function found_backup_complete_in_logfile($nonce, $use_existing_result = true) { static $checked_files = array(); if (isset($checked_files[$nonce]) && $use_existing_result) return $checked_files[$nonce]; $logfile_name = $this->get_logfile_name($nonce); if (!file_exists($logfile_name)) return false; $backup_is_already_complete = false; $seek_to = max((filesize($logfile_name) - 340), 1); $handle = fopen($logfile_name, 'r'); if (is_resource($handle)) { // Returns 0 on success if (0 === @fseek($handle, $seek_to)) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $bytes_back = filesize($logfile_name) - $seek_to; // Return to the end of the file $read_recent = fread($handle, $bytes_back); // Move to end of file - ought to be redundant if ((false !== strpos($read_recent, ') The backup apparently succeeded') \|\| false !== strpos($read_recent, ') The backup succeeded')) && false !== strpos($read_recent, 'and is now complete')) { $backup_is_already_complete = true; } } fclose($handle); } $checked_files[$nonce] = $backup_is_already_complete; return $backup_is_already_complete; } /* * Returns the logfile name for a given job * * @param String $nonce - Used in the log file name to distinguish it from other log files. Should be the job nonce. * @return string / public function get_logfile_name($nonce) { $updraft_dir = $this->backups_dir_location(); return $updraft_dir."/log.$nonce.txt"; } /* * Writes a standardised header to the log file, using the specified logging function, which needs to be compatible with (or to be) UpdraftPlus::log() * * @param callable $logging_function / public function write_log_header($logging_function) { global $wpdb; $updraft_dir = $this->backups_dir_location(); call_user_func($logging_function, 'Opened log file at time: '.date('r').' on '.network_site_url()); $wp_version = $this->get_wordpress_version(); $mysql_version = $wpdb->get_var('SELECT VERSION()'); if ('' == $mysql_version) $mysql_version = $wpdb->db_version(); $safe_mode = $this->detect_safe_mode(); $memory_limit = ini_get('memory_limit'); $memory_usage = round(@memory_get_usage(false)/1048576, 1);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $memory_usage2 = round(@memory_get_usage(true)/1048576, 1);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // Attempt to raise limit to avoid false positives if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $max_execution_time = (int) @ini_get("max_execution_time");// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $mp = (int) $wpdb->get_var("SELECT @@session.max_allowed_packet"); $proxy = new WP_HTTP_Proxy(); $logline = "UpdraftPlus WordPress backup plugin (https://updraftplus.com): ".$this->version." WP: ".$wp_version." PHP: ".phpversion()." (".PHP_SAPI.", ".(function_exists('php_uname') ? @php_uname() : PHP_OS).") MySQL: $mysql_version (max packet size=$mp) WPLANG: ".get_locale()." Server: ".$_SERVER["SERVER_SOFTWARE"]." safe_mode: $safe_mode max_execution_time: $max_execution_time memory_limit: $memory_limit (used: {$memory_usage}M \| {$memory_usage2}M) multisite: ".(is_multisite() ? (is_subdomain_install() ? 'Y (sub-domain)' : 'Y (sub-folder)') : 'N')." openssl: ".(defined('OPENSSL_VERSION_TEXT') ? OPENSSL_VERSION_TEXT : 'N')." mcrypt: ".(function_exists('mcrypt_encrypt') ? 'Y' : 'N')." LANG: ".getenv('LANG')." WP Proxy: ".($proxy->is_enabled() ? 'enabled' : 'disabled')." ZipArchive::addFile: ";// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // method_exists causes some faulty PHP installations to segfault, leading to support requests if (version_compare(phpversion(), '5.2.0', '>=') && extension_loaded('zip')) { $logline .= 'Y'; } else { $logline .= (class_exists('ZipArchive') && method_exists('ZipArchive', 'addFile')) ? "Y" : "N"; } if (0 === $this->current_resumption) { $memlim = $this->memory_check_current(); if ($memlim<65 && $memlim>0) { $this->log(sprintf(__('The amount of memory (RAM) allowed for PHP is very low (%s Mb) - you should increase it to avoid failures due to insufficient memory (consult your web hosting company for more help)', 'updraftplus'), round($memlim, 1)), 'warning', 'lowram'); } if ($max_execution_time>0 && $max_execution_time<20) { call_user_func($logging_function, sprintf(__('The amount of time allowed for WordPress plugins to run is very low (%s seconds) - you should increase it to avoid backup failures due to time-outs (consult your web hosting company for more help - it is the max_execution_time PHP setting; the recommended value is %s seconds or more)', 'updraftplus'), $max_execution_time, 90), 'warning', 'lowmaxexecutiontime'); } } call_user_func($logging_function, $logline); $hosting_bytes_free = $this->get_hosting_disk_quota_free(); if (is_array($hosting_bytes_free)) { $perc = round(100$hosting_bytes_free[1]/(max($hosting_bytes_free[2], 1)), 1); $quota_free = ' / '.sprintf('Free disk space in account: %s (%s used)', round($hosting_bytes_free[3]/1048576, 1)." MB", "$perc %"); if ($hosting_bytes_free[3] < 104857650) { $quota_free_mb = round($hosting_bytes_free[3]/1048576, 1); call_user_func($logging_function, sprintf(__('Your free space in your hosting account is very low - only %s Mb remain', 'updraftplus'), $quota_free_mb), 'warning', 'lowaccountspace'.$quota_free_mb); } } else { $quota_free = ''; } $disk_free_space = function_exists('disk_free_space') ? @disk_free_space($updraft_dir) : false;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // == rather than === here is deliberate; support experience shows that a result of (int)0 is not reliable. i.e. 0 can be returned when the real result should be false. if (false == $disk_free_space) { call_user_func($logging_function, "Free space on disk containing Updraft's temporary directory: Unknown".$quota_free); } else { call_user_func($logging_function, "Free space on disk containing Updraft's temporary directory: ".round($disk_free_space/1048576, 1)." MB".$quota_free); $disk_free_mb = round($disk_free_space/1048576, 1); if ($disk_free_space < 501048576) call_user_func($logging_function, sprintf(__('Your free disk space is very low - only %s Mb remain', 'updraftplus'), round($disk_free_space/1048576, 1)), 'warning', 'lowdiskspace'.$disk_free_mb); } } /** * This function will read the next chunk from the log file and return it's contents and last read byte position * * @param String $nonce - the UpdraftPlus file nonce * * @return array - an empty array if there is no log file or an array with log file contents and last read byte position / public function get_last_log_chunk($nonce) { $this->logfile_name = $this->get_logfile_name($nonce); if (file_exists($this->logfile_name)) { $contents = ''; $seek_to = max(0, $this->jobdata_get('clone_first_byte', 0)); $first_byte = $seek_to; $handle = fopen($this->logfile_name, 'r'); if (is_resource($handle)) { // Returns 0 on success if (0 === @fseek($handle, $seek_to)) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. while (strlen($contents) < 1048576 && ($buffer = fgets($handle, 262144)) !== false) { $contents .= $buffer; $seek_to += 262144; } $this->jobdata_set('clone_first_byte', $seek_to); } fclose($handle); } return array('log_contents' => $contents, 'first_byte' => $first_byte); } return array(); } /* * * Verifies that the indicated amount of memory is available * * @param Integer $how_many_bytes_needed - how many bytes need to be available * * @return Boolean - whether the needed number of bytes is available / public function verify_free_memory($how_many_bytes_needed) { // This returns in MB $memory_limit = $this->memory_check_current(); if (!is_numeric($memory_limit)) return false; $memory_limit = $memory_limit 1048576; $memory_usage = round(@memory_get_usage(false), 1);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $memory_usage2 = round(@memory_get_usage(true), 1);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ($memory_limit - $memory_usage > $how_many_bytes_needed && $memory_limit - $memory_usage2 > $how_many_bytes_needed) return true; return false; } /** * Logs the given line, adding (relative) time stamp and newline * Note these subtleties of log handling: * - Messages at level 'error' are not logged to file - it is assumed that a separate call to log() at another level will take place. This is because at level 'error', messages are translated; whereas the log file is for developers who may not know the translated language. Messages at level 'error' are for the user. * - Messages at level 'error' do not persist through the job (they are only saved with save_backup_to_history(), and never restored from there - so only the final save_backup_to_history() errors * persist); we presume that either a) they will be cleared on the next attempt, or b) they will occur again on the final attempt (at which point they will go to the user). But... * - messages at level 'warning' persist. These are conditions that are unlikely to be cleared, not-fatal, but the user should be informed about. The $uniq_id field (which should not be numeric) can then be used for warnings that should only be logged once * $skip_dblog = true is suitable when there's a risk of excessive logging, and the information is not important for the user to see in the browser on the settings page * The uniq_id field is also used with PHP event detection - it is set then to 'php_event' - which is useful for anything hooking the action to detect * * @param string $line the log line * @param string $level the log level: notice, warning, error. If suffixed with a hyphen and a destination, then the default destination is changed too. * @param boolean $uniq_id each of these will only be logged once * @param boolean $skip_dblog if true, then do not write to the database * @return null / public function log($line, $level = 'notice', $uniq_id = false, $skip_dblog = false) { $destination = 'default'; if (preg_match('/^([a-z]+)-([a-z]+)$/', $level, $matches)) { $level = $matches[1]; $destination = $matches[2]; } if ('error' == $level \|\| 'warning' == $level) { if ('error' == $level && 0 == $this->error_count()) $this->log('An error condition has occurred for the first time during this job'); if ($uniq_id) { $this->errors[$uniq_id] = array('level' => $level, 'message' => $line); } else { $this->errors[] = array('level' => $level, 'message' => $line); } // Errors are logged separately if ('error' == $level) return; // It's a warning $warnings = $this->jobdata_get('warnings'); if (!is_array($warnings)) $warnings = array(); if ($uniq_id) { $warnings[$uniq_id] = $line; } else { $warnings[] = $line; } $this->jobdata_set('warnings', $warnings); } if (false === ($line = apply_filters('updraftplus_logline', $line, $this->nonce, $level, $uniq_id, $destination))) return; if ($this->logfile_handle) { // Record log file times relative to the backup start, if possible $rtime = (!empty($this->job_time_ms)) ? microtime(true)-$this->job_time_ms : microtime(true)-$this->opened_log_time; fwrite($this->logfile_handle, sprintf("%08.03f", round($rtime, 3))." (".$this->current_resumption.") ".(('notice' != $level) ? '['.ucfirst($level).'] ' : '').$line."\n"); } switch ($this->jobdata_get('job_type')) { case 'download': // Download messages are keyed on the job (since they could be running several), and type // The values of the POST array were checked before $findex = empty($_POST['findex']) ? 0 : $_POST['findex']; if (!empty($_POST['timestamp']) && !empty($_POST['type'])) $this->jobdata_set('dlmessage_'.$_POST['timestamp'].'_'.$_POST['type'].'_'.$findex, $line); break; case 'restore': // if ('debug' != $level) echo $line."\n"; break; default: if (!$skip_dblog && 'debug' != $level) UpdraftPlus_Options::update_updraft_option('updraft_lastmessage', $line." (".date_i18n('M d H:i:s').")", false); break; } if (defined('UPDRAFTPLUS_CONSOLELOG') && UPDRAFTPLUS_CONSOLELOG) echo $line."\n"; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- This constant can only be set deliberately by a user who is indicating he requires raw output on in a console (i.e. non-HTML) context if (defined('UPDRAFTPLUS_BROWSERLOG') && UPDRAFTPLUS_BROWSERLOG) echo esc_html($line)."<br>\n"; } /* * Remove any logged warnings with the specified identifier. (The use case for this is that you can warn of something that may be about to happen (with a probably crash if it does), and then remove the warning if it did not happen). * * @see self::log() * * @param String $uniq_id - the identifier, previously passed to self::log() / public function log_remove_warning($uniq_id) { $warnings = $this->jobdata_get('warnings'); if (!is_array($warnings)) $warnings = array(); // Avoid an unnecessary database write if nothing changed if (isset($warnings[$uniq_id])) { unset($warnings[$uniq_id]); $this->jobdata_set('warnings', $warnings); } unset($this->errors[$uniq_id]); } /* * Indicate whether or not a warning is logged with a specific identifier * * @see self::log() * * @param String $uniq_id - the identifier, previously passed to self::log() * * @return Boolean / public function warning_exists($uniq_id) { $warnings = $this->jobdata_get('warnings'); return !empty($warnings[$uniq_id]); } /* * For efficiency, you can also feed false or a string into this function * * @param Boolean\|String\|WP_Error $err - the errors * @param Boolean $echo - whether to echo() the error(s) * @param Boolean $logerror - whether to pass errors to UpdraftPlus::log() * @return Boolean - returns false for convenience / public function log_wp_error($err, $echo = false, $logerror = false) { if (false === $err) return false; if (is_string($err)) { $this->log("Error message: $err"); if ($echo) $this->log(sprintf(__('Error: %s', 'updraftplus'), $err), 'notice-warning'); if ($logerror) $this->log($err, 'error'); return false; } foreach ($err->get_error_messages() as $msg) { $this->log("Error message: $msg"); if ($echo) $this->log(sprintf(__('Error: %s', 'updraftplus'), $msg), 'notice-warning'); if ($logerror) $this->log($msg, 'error'); } $codes = $err->get_error_codes(); if (is_array($codes)) { foreach ($codes as $code) { $data = $err->get_error_data($code); if (!empty($data)) { $ll = (is_string($data)) ? $data : serialize($data); $this->log("Error data (".$code."): ".$ll); } } } // Returns false so that callers can return with false more efficiently if they wish return false; } /* * This function will construct the restore information log line using the passed in parameters and then log the line using $this->log(); * * @param array $restore_information - an array of restore information * * @return void / public function log_restore_update($restore_information) { $this->log("RINFO:".json_encode($restore_information), 'notice-progress'); } /* * Outputs data to the browser. * Will also fill the buffer on nginx systems after a specified amount of time. * * @param String $line The text to output. This may validly include HTML. * * @return void / public function output_to_browser($line) { echo wp_kses_post($line); if (false === stripos($_SERVER['SERVER_SOFTWARE'], 'nginx')) return; // Change it to what was actually output $line = wp_kses_post($line); static $strcount = 0; static $time = 0; $buffer_size = 65536; // The default NGINX config uses a buffer size of 32 or 64k, depending on the system. So we use 64K. if (0 == $time) $time = time(); $strcount += strlen($line); if ((time() - $time) >= 8) { // if the string count is > the buffer size, we reset, as it's likely the string was already sent. if ($strcount > $buffer_size) { $time = time(); $strcount = $strcount - $buffer_size; return; } echo str_repeat(' ', $buffer_size-$strcount); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Absurd false positive // reset values $time = time(); $strcount = 0; } } /* * Get the maximum packet size on the WPDB MySQL connection, in bytes, after (optionally) attempting to raise it to 32MB if it appeared to be lower. * A default value equal to 1MB is returned if the true value could not be found - it has been found reasonable to assume that at least this is available. * * @param Boolean $first_raise * @param Boolean $log_it * * @return Integer / public function max_packet_size($first_raise = true, $log_it = true) { global $wpdb; $mp = (int) $wpdb->get_var("SELECT @@session.max_allowed_packet"); // Default to 1MB $mp = (is_numeric($mp) && $mp > 0) ? $mp : 1048576; // 32MB if ($first_raise && $mp < 33554432) { $save = $wpdb->show_errors(false); $req = @$wpdb->query("SET GLOBAL max_allowed_packet=33554432");// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. $wpdb->show_errors($save); if (!$req) $this->log("Tried to raise max_allowed_packet from ".round($mp/1048576, 1)." MB to 32 MB, but failed (".$wpdb->last_error.", ".serialize($req).")"); $mp = (int) $wpdb->get_var("SELECT @@session.max_allowed_packet"); // Default to 1MB $mp = (is_numeric($mp) && $mp > 0) ? $mp : 1048576; } if ($log_it) $this->log("Max packet size: ".round($mp/1048576, 1)." MB"); return $mp; } /* * Q. Why is this abstracted into a separate function? A. To allow poedit and other parsers to pick up the need to translate strings passed to it (and not pick up all of those passed to log()). * 1st argument = the line to be logged (obligatory) * Further arguments = parameters for sprintf() * * @return null / public function log_e() { $args = func_get_args(); // Get first argument $pre_line = array_shift($args); // Log it whilst still in English if (is_wp_error($pre_line)) { $this->log_wp_error($pre_line); } else { // Now run (v)sprintf on it, using any remaining arguments. vsprintf = sprintf but takes an array instead of individual arguments $this->log(vsprintf($pre_line, $args)); // This is slightly hackish, in that we have no way to use a different level or destination. In that case, the caller should instead call log() twice with different parameters, instead of using this convenience function. $this->log(vsprintf($pre_line, $args), 'notice-restore'); } } /* * This function is used by cloud methods to provide standardised logging, but more importantly to help us detect that meaningful activity took place during a resumption run, so that we can schedule further resumptions if it is worthwhile * * @param Number $percent - the amount of the file uploaded * @param String $extra - anything extra to include in the log message * @param Boolean $file_path - the full path to the file being uploaded * @param Boolean $log_it - whether to pass the message to UpdraftPlus::log() * @return Void / public function record_uploaded_chunk($percent, $extra = '', $file_path = false, $log_it = true) { // Touch the original file, which helps prevent overlapping runs if ($file_path) touch($file_path); // What this means in effect is that at least one of the files touched during the run must reach this percentage (so lapping round from 100 is OK) if ($percent > 0.7 ($this->current_resumption - max($this->jobdata_get('uploaded_lastreset'), 9))) UpdraftPlus_Job_Scheduler::something_useful_happened(); // Log it global $updraftplus_backup; $log = empty($updraftplus_backup->current_service) ? '' : ucfirst($updraftplus_backup->current_service)." chunked upload: $percent % uploaded"; if ($log && $log_it) $this->log($log.($extra ? " ($extra)" : '')); // If we are on an 'overtime' resumption run, and we are still meaningfully uploading, then schedule a new resumption // Our definition of meaningful is that we must maintain an overall average of at least 0.7% per run, after allowing 9 runs for everything else to get going // i.e. Max 100/.7 + 9 = 150 runs = 760 minutes = 12 hrs 40, if spaced at 5 minute intervals. However, our algorithm now decreases the intervals if it can, so this should not really come into play // If they get 2 minutes on each run, and the file is 1GB, then that equals 10.2MB/120s = minimum 59KB/s upload speed required $upload_status = $this->jobdata_get('uploading_substatus'); if (is_array($upload_status)) { $upload_status['p'] = $percent/100; $this->jobdata_set('uploading_substatus', $upload_status); } } /** * Method for helping remote storage methods to upload files in chunks without needing to duplicate all the overhead * * @param Object $caller the object to call back to do the actual network API calls; needs to have a chunked_upload() method. * @param String $file the basename of the file * @param String $cloudpath this is passed back to the callback function; within this function, it is used only for logging * @param String $logname the prefix used on log lines. Also passed back to the callback function. * @param Integer $chunk_size the size, in bytes, of each upload chunk * @param Integer $uploaded_size how many bytes have already been uploaded. This is passed back to the callback function; within this method, it is only used for logging. * @param Boolean $singletons when the file, given the chunk size, would only have one chunk, should that be uploaded (true), or instead should 1 be returned (false) ? * @return Boolean / public function chunked_upload($caller, $file, $cloudpath, $logname, $chunk_size, $uploaded_size, $singletons = false) { $fullpath = $this->backups_dir_location().'/'.$file; $orig_file_size = filesize($fullpath); if ($uploaded_size >= $orig_file_size && !method_exists($caller, 'chunked_upload_finish')) return true; $chunks = floor($orig_file_size / $chunk_size); // There will be a remnant unless the file size was exactly on a chunk boundary if ($orig_file_size % $chunk_size > 0) $chunks++; $this->log("$logname upload: $file (chunks: $chunks, of size: $chunk_size) -> $cloudpath ($uploaded_size)"); if (0 == $chunks) { return 1; } elseif ($chunks < 2 && !$singletons) { return 1; } // We have multiple chunks if ($uploaded_size < $orig_file_size) { if (false == ($fp = @fopen($fullpath, 'rb'))) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $this->log("$logname: failed to open file: $fullpath"); $this->log("$file: ".sprintf(__('%s Error: Failed to open local file', 'updraftplus'), $logname), 'error'); return false; } $upload_start = 0; $upload_end = -1; $chunk_index = 1; // The file size minus one equals the byte offset of the final byte $upload_end = min($chunk_size - 1, $orig_file_size - 1); $errors_on_this_chunk = 0; while ($upload_start < $orig_file_size) { // Don't forget the +1; otherwise the last byte is omitted $upload_size = $upload_end - $upload_start + 1; fseek($fp, $upload_start); / * Valid return values for $uploaded are many, as the possibilities have grown over time. * This could be cleaned up; but, it works, and it's not hugely complex. * * WP_Error : an error occured. The only permissible codes are: reduce_chunk_size (only on the first chunk), try_again * (bool)true : What was requested was done * (int)1 : What was requested was done, but do not log anything * (bool)false : There was an error * (Object) : Properties: * (bool)log: (bool) - if absent, defaults to true * (int)new_chunk_size: advisory amount for the chunk size for future chunks * NOT IMPLEMENTED: (int)bytes_uploaded: Actual number of bytes uploaded (needs to be positive - o/w, should return an error instead) * N.B. Consumers should consult $fp and $upload_start to get data; they should not re-calculate from $chunk_index, which is not an indicator of file position. / $uploaded = $caller->chunked_upload($file, $fp, $chunk_index, $upload_size, $upload_start, $upload_end, $orig_file_size); // Try again? (Just once - added in 1.12.6 (can make more sophisticated if there is a need)) if (is_wp_error($uploaded) && 'try_again' == $uploaded->get_error_code()) { // Arbitrary wait sleep(3); $this->log("Re-trying after wait (to allow apparent inconsistency to clear)"); $uploaded = $caller->chunked_upload($file, $fp, $chunk_index, $upload_size, $upload_start, $upload_end, $orig_file_size); } // This is the only other supported case of a WP_Error - otherwise, a boolean must be returned // Note that this is only allowed on the first chunk. The caller is responsible to remember its chunk size if it uses this facility. if (1 == $chunk_index && is_wp_error($uploaded) && 'reduce_chunk_size' == $uploaded->get_error_code() && false != ($new_chunk_size = $uploaded->get_error_data()) && is_numeric($new_chunk_size)) { $this->log("Re-trying with new chunk size: ".$new_chunk_size); return $this->chunked_upload($caller, $file, $cloudpath, $logname, $new_chunk_size, $uploaded_size, $singletons); } $uploaded_amount = $chunk_size; / // Not using this approach for now. Instead, going to allow the consumers to increase the next chunk size if (is_object($uploaded) && isset($uploaded->bytes_uploaded)) { if (!$uploaded->bytes_uploaded) { $uploaded = false; } else { $uploaded_amount = $uploaded->bytes_uploaded; $uploaded = (!isset($uploaded->log) \|\| $uploaded->log) ? true : 1; } } / if (is_object($uploaded) && isset($uploaded->new_chunk_size)) { if ($uploaded->new_chunk_size >= 1048576) $new_chunk_size = $uploaded->new_chunk_size; $uploaded = (!isset($uploaded->log) \|\| $uploaded->log) ? true : 1; } // The joys of WP/PHP: is_wp_error() is not false-y. if ($uploaded && !is_wp_error($uploaded)) { $perc = round(100($upload_end + 1)/max($orig_file_size, 1), 1); // Consumers use a return value of (int)1 (rather than (bool)true) to suppress logging $log_it = (1 === $uploaded) ? false : true; $this->record_uploaded_chunk($perc, $chunk_index, $fullpath, $log_it); // $uploaded_bytes = $upload_end + 1; // If there was an error, then we re-try the same chunk; we don't move on to the next one. Otherwise, we would need more code to handle potential 'intermediate' failed chunks (in case PHP dies before this method eventually returns false, and thus the intermediate chunk failure never gets detected) $chunk_index++; $errors_on_this_chunk = 0; $upload_start = $upload_end + 1; $upload_end += isset($new_chunk_size) ? $uploaded_amount + $new_chunk_size - $chunk_size : $uploaded_amount; $upload_end = min($upload_end, $orig_file_size - 1); } else { $errors_on_this_chunk++; // Either $uploaded is false-y, or is a WP_Error if (is_wp_error($uploaded)) { $this->log("$logname: Chunk upload ($chunk_index) failed (".$uploaded->get_error_code().'): '.$uploaded->get_error_message()); } else { $this->log("$logname: Chunk upload ($chunk_index) failed"); } if ($errors_on_this_chunk >= 3) { @fclose($fp);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. return false; } } } @fclose($fp);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } // All chunks are uploaded - now combine the chunks $ret = true; // The action calls here exist to aid debugging if (method_exists($caller, 'chunked_upload_finish')) { do_action('updraftplus_pre_chunked_upload_finish', $file, $caller); $ret = $caller->chunked_upload_finish($file); if (!$ret) { $this->log("$logname - failed to re-assemble chunks"); $this->log(sprintf(__('%s error - failed to re-assemble chunks', 'updraftplus'), $logname), 'error'); } do_action('updraftplus_post_chunked_upload_finish', $file, $caller, $ret); } if ($ret) { // We allow chunked_upload_finish to return (int)1 to indicate that it took care of any logging. if (true === $ret) $this->log("$logname upload: success"); $ret = true; // UpdraftPlus_RemoteStorage_Addons_Base calls this itself if (!is_a($caller, 'UpdraftPlus_RemoteStorage_Addons_Base_v2')) $this->uploaded_file($file); } return $ret; } /** * Provides a convenience function allowing remote storage methods to download a file in chunks, without duplicated overhead. * * @param String $file - The basename of the file being downloaded * @param Object $method - This remote storage method object needs to have a chunked_download() method to call back * @param Integer $remote_size - The size, in bytes, of the object being downloaded * @param Boolean $manually_break_up - Whether to break the download into multiple network operations (rather than just issuing a GET with a range beginning at the end of the already-downloaded data, and carrying on until it times out) * @param Mixed $passback - A value to pass back to the callback function * @param Integer $chunk_size - Break up the download into chunks of this number of bytes. Should be set if and only if $manually_break_up is true. / public function chunked_download($file, $method, $remote_size, $manually_break_up = false, $passback = null, $chunk_size = 1048576) { try { $fullpath = $this->backups_dir_location().'/'.$file; $start_offset = file_exists($fullpath) ? filesize($fullpath) : 0; if ($start_offset >= $remote_size) { $this->log("File is already completely downloaded ($start_offset/$remote_size)"); return true; } // Some more remains to download - so let's do it // N.B. We use ftell(), which precludes us from using open in append-only ('a') mode - see https://php.net/manual/en/function.fopen.php if (!($fh = fopen($fullpath, 'c+'))) { $this->log("Error opening local file: $fullpath"); $this->log($file.": ".__("Error", 'updraftplus').": ".__('Error opening local file: Failed to download', 'updraftplus'), 'error'); return false; } $last_byte = ($manually_break_up) ? min($remote_size, $start_offset + $chunk_size) : $remote_size; // This only affects logging $expected_bytes_delivered_so_far = true; while ($start_offset < $remote_size) { $headers = array(); // If resuming, then move to the end of the file $requested_bytes = $last_byte-$start_offset; if ($expected_bytes_delivered_so_far) { $this->log("$file: local file is status: $start_offset/$remote_size bytes; requesting next $requested_bytes bytes"); } else { $this->log("$file: local file is status: $start_offset/$remote_size bytes; requesting next chunk ({$start_offset}-)"); } if ($start_offset > 0 \|\| $last_byte<$remote_size) { fseek($fh, $start_offset); // N.B. Don't alter this format without checking what relies upon it $last_byte_start = $last_byte - 1; $headers['Range'] = "bytes=$start_offset-$last_byte_start"; } / * The most common method is for the remote storage module to return a string with the results in it. In that case, the final $fh parameter is unused. However, since not all SDKs have that option conveniently, it is also possible to use the file handle and write directly to that; in that case, the method can either return the number of bytes written, or (boolean)true to infer it from the new file pointer. * The method is free to write/return as much data as it pleases. / $ret = $method->chunked_download($file, $headers, $passback, $fh); if (true === $ret) { clearstatcache(); // Some SDKs (including AWS/S3) close the resource // N.B. We use ftell(), which precludes us from using open in append-only ('a') mode - see https://php.net/manual/en/function.fopen.php if (is_resource($fh)) { $ret = ftell($fh); } else { $ret = filesize($fullpath); // fseek returns - on success if (false == ($fh = fopen($fullpath, 'c+')) \|\| 0 !== fseek($fh, $ret)) { $this->log("Error opening local file: $fullpath"); $this->log($file.": ".__("Error", 'updraftplus').": ".__('Error opening local file: Failed to download', 'updraftplus'), 'error'); return false; } } if (is_integer($ret)) $ret -= $start_offset; } // Note that this covers a false code returned either by chunked_download() or by ftell. if (false === $ret) return false; $returned_bytes = is_integer($ret) ? $ret : strlen($ret); if ($returned_bytes > $requested_bytes \|\| $returned_bytes < $requested_bytes - 1) $expected_bytes_delivered_so_far = false; if (!is_integer($ret) && !fwrite($fh, $ret)) throw new Exception('Write failure (start offset: '.$start_offset.', bytes: '.strlen($ret).'; requested: '.$requested_bytes.')'); clearstatcache(); $start_offset = ftell($fh); $last_byte = ($manually_break_up) ? min($remote_size, $start_offset + $chunk_size) : $remote_size; } } catch (Exception $e) { $this->log('Error ('.get_class($e).') - failed to download the file ('.$e->getCode().', '.$e->getMessage().', line '.$e->getLine().' in '.$e->getFile().')'); $this->log("$file: ".__('Error - failed to download the file', 'updraftplus').' ('.$e->getCode().', '.$e->getMessage().')', 'error'); return false; } // April 1st 2020 - Due to a bug during uploads to Dropbox some backups had string "null" appended to the end which caused warnings, this removes the string "null" from these backups if ('dropbox' == $method->get_id()) { fseek($fh, -4, SEEK_END); $data = fgets($fh, 5); if ("null" == $data) { ftruncate($fh, filesize($fullpath) - 4); } } fclose($fh); return true; } /* * Detect if safe_mode is on. N.B. This is abolished from PHP 7.0 * * @return Integer - 1 or 0 / public function detect_safe_mode() { // @codingStandardsIgnoreLine return (@ini_get('safe_mode') && 'off' != strtolower(@ini_get('safe_mode'))) ? 1 : 0; } /* * Find, if possible, a working mysqldump executable * * @param Boolean $log_it - whether to log the workings or not * @param Boolean $cacheit - whether to cache the results for subsequent queries or not * * @return String\|Boolean - either a path to an executable, or false for failure / public function find_working_sqldump($log_it = true, $cacheit = true) { // The hosting provider may have explicitly disabled the popen or proc_open functions if ($this->detect_safe_mode() \|\| !function_exists('popen') \|\| !function_exists('escapeshellarg')) { if ($cacheit) $this->jobdata_set('binsqldump', false); return false; } $existing = $this->jobdata_get('binsqldump', null); // Theoretically, we could have moved machines, due to a migration if (null !== $existing && (!is_string($existing) \|\| @is_executable($existing))) return $existing;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $updraft_dir = $this->backups_dir_location(); global $wpdb; $table_name = $wpdb->get_blog_prefix().'options'; $pfile = md5(time().rand()).'.tmp'; file_put_contents($updraft_dir.'/'.$pfile, "[mysqldump]\npassword=\"".addslashes(DB_PASSWORD)."\"\n"); $result = false; foreach (explode(',', UPDRAFTPLUS_MYSQLDUMP_EXECUTABLE) as $potsql) { if (!@is_executable($potsql)) continue;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ($log_it) $this->log("Testing potential mysqldump binary: $potsql"); if ('win' == strtolower(substr(PHP_OS, 0, 3))) { $exec = "cd ".escapeshellarg(str_replace('/', '\\', $updraft_dir))." & "; $siteurl = "'siteurl'"; if (false !== strpos($potsql, ' ')) $potsql = '"'.$potsql.'"'; } else { $exec = "cd ".escapeshellarg($updraft_dir)."; "; $siteurl = "\\'siteurl\\'"; if (false !== strpos($potsql, ' ')) $potsql = "'$potsql'"; } // Allow --max_allowed_packet to be configured via constant. Experience has shown some customers with complex CMS or pagebuilder setups can have extrememly large postmeta entries. $msqld_max_allowed_packet = (defined('UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET') && (is_int(UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET) \|\| is_string(UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET))) ? UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET : '1M'; $exec .= "$potsql --defaults-file=$pfile --max_allowed_packet=$msqld_max_allowed_packet --quote-names --add-drop-table"; static $mysql_version = null; if (null === $mysql_version) { $mysql_version = $wpdb->get_var('SELECT VERSION()'); if ('' == $mysql_version) $mysql_version = $wpdb->db_version(); } if ($mysql_version && version_compare($mysql_version, '5.1', '>=')) { $exec .= " --no-tablespaces"; } $exec .= " --skip-comments --skip-set-charset --allow-keywords --dump-date --extended-insert --where=option_name=$siteurl --user=".escapeshellarg(DB_USER)." "; if (preg_match('#^(.):(\d+)$#', DB_HOST, $matches)) { // The escapeshellarg() on $matches[2] is only to avoid tripping static analysis tools $exec .= "--host=".escapeshellarg($matches[1])." --port=".escapeshellarg($matches[2])." "; } elseif (preg_match('#^(.):(.)$#', DB_HOST, $matches) && file_exists($matches[2])) { $exec .= "--host=".escapeshellarg($matches[1])." --socket=".escapeshellarg($matches[2])." "; } else { $exec .= "--host=".escapeshellarg(DB_HOST)." "; } $exec .= DB_NAME." ".escapeshellarg($table_name); $handle = (function_exists('popen') && function_exists('pclose')) ? popen($exec, "r") : false; if ($handle) { $output = ''; // We expect the INSERT statement in the first 100KB while (!feof($handle) && strlen($output) < 102400) { $output .= fgets($handle, 102400); } if ($output && $log_it) { $log_output = (strlen($output) > 512) ? substr($output, 0, 512).' (truncated - '.strlen($output).' bytes total)' : $output; $this->log("Output: ".str_replace("\n", '\\n', trim($log_output))); } $ret = pclose($handle); // The manual page for pclose() claims that only -1 indicates an error, but this is untrue if (0 != $ret) { if ($log_it) { $this->log("Binary mysqldump: error (code: $ret)"); } } else { if (false !== stripos($output, 'insert into')) { if ($log_it) $this->log("Working binary mysqldump found: $potsql"); $result = $potsql; break; } } } else { if ($log_it) $this->log("Error: popen failed"); } } if (file_exists($updraft_dir.'/'.$pfile)) unlink($updraft_dir.'/'.$pfile); if ($cacheit) $this->jobdata_set('binsqldump', $result); return $result; } /** * This function will work out which zip object we want to use and return it's name * * @return string - the name of the zip object we want to use / public function get_zip_object_name() { if (!class_exists('UpdraftPlus_BinZip')) include_once(UPDRAFTPLUS_DIR . '/includes/class-zip.php'); $zip_object = 'UpdraftPlus_ZipArchive'; // In tests, PclZip was found to be 25% slower than ZipArchive if (((defined('UPDRAFTPLUS_PREFERPCLZIP') && UPDRAFTPLUS_PREFERPCLZIP == true) \|\| !class_exists('ZipArchive') \|\| !class_exists('UpdraftPlus_ZipArchive') \|\| (!extension_loaded('zip') && !method_exists('ZipArchive', 'AddFile')))) { $zip_object = 'UpdraftPlus_PclZip'; } return $zip_object; } /* * We require -@ and -u -r to work - which is the usual Linux binzip * * @param Boolean $log_it - whether to record the results with UpdraftPlus::log() * @param Boolean $cacheit - whether to cache the results as job data * @return String\|Boolean - the path to a working zip binary, or false / public function find_working_bin_zip($log_it = true, $cacheit = true) { if ($this->detect_safe_mode()) return false; // The hosting provider may have explicitly disabled the popen or proc_open functions if (!function_exists('popen') \|\| !function_exists('proc_open') \|\| !function_exists('proc_close') \|\| !function_exists('escapeshellarg')) { if ($cacheit) $this->jobdata_set('binzip', false); return false; } $existing = $this->jobdata_get('binzip', null); // Theoretically, we could have moved machines, due to a migration if (null !== $existing && (!is_string($existing) \|\| @is_executable($existing))) return $existing;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $updraft_dir = $this->backups_dir_location(); foreach (explode(',', UPDRAFTPLUS_ZIP_EXECUTABLE) as $potzip) { if (!@is_executable($potzip)) continue;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ($log_it) $this->log("Testing: $potzip"); // Test it, see if it is compatible with Info-ZIP // If you have another kind of zip, then feel free to tell me about it @mkdir($updraft_dir.'/binziptest/subdir1/subdir2', 0777, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!file_exists($updraft_dir.'/binziptest/subdir1/subdir2')) return false; file_put_contents($updraft_dir.'/binziptest/subdir1/subdir2/test.html', '<html><body><a href="https://updraftplus.com">UpdraftPlus is a great backup and restoration plugin for WordPress.</a></body></html>'); if (file_exists($updraft_dir.'/binziptest/test.zip')) unlink($updraft_dir.'/binziptest/test.zip'); if (is_file($updraft_dir.'/binziptest/subdir1/subdir2/test.html')) { $exec = "cd ".escapeshellarg($updraft_dir)."; $potzip"; if (defined('UPDRAFTPLUS_BINZIP_OPTS') && UPDRAFTPLUS_BINZIP_OPTS) $exec .= ' '.UPDRAFTPLUS_BINZIP_OPTS; $exec .= " -v -u -r binziptest/test.zip binziptest/subdir1"; $all_ok=true; $handle = (function_exists('popen') && function_exists('pclose')) ? popen($exec, "r") : false; if ($handle) { while (!feof($handle)) { $w = fgets($handle); if ($w && $log_it) $this->log("Output: ".trim($w)); } $ret = pclose($handle); // The manual page for pclose() claims that only -1 indicates an error, but this is untrue if (0 != $ret) { if ($log_it) $this->log("Binary zip: error (code: $ret)"); $all_ok = false; } } else { if ($log_it) $this->log("Error: popen failed"); $all_ok = false; } // Now test -@ if (true == $all_ok) { file_put_contents($updraft_dir.'/binziptest/subdir1/subdir2/test2.html', '<html><body><a href="https://updraftplus.com">UpdraftPlus is a really great backup and restoration plugin for WordPress.</a></body></html>'); $exec = $potzip; if (defined('UPDRAFTPLUS_BINZIP_OPTS') && UPDRAFTPLUS_BINZIP_OPTS) $exec .= ' '.UPDRAFTPLUS_BINZIP_OPTS; $exec .= " -v -@ binziptest/test.zip"; $all_ok = true; $descriptorspec = array( 0 => array('pipe', 'r'), 1 => array('pipe', 'w'), 2 => array('pipe', 'w') ); $handle = proc_open($exec, $descriptorspec, $pipes, $updraft_dir); if (is_resource($handle)) { if (!fwrite($pipes[0], "binziptest/subdir1/subdir2/test2.html\n")) { @fclose($pipes[0]);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. @fclose($pipes[1]);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. @fclose($pipes[2]);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $all_ok = false; } else { fclose($pipes[0]); while (!feof($pipes[1])) { $w = fgets($pipes[1]); if ($w && $log_it) $this->log("Output: ".trim($w)); } fclose($pipes[1]); while (!feof($pipes[2])) { $last_error = fgets($pipes[2]); if (!empty($last_error) && $log_it) $this->log("Stderr output: ".trim($w)); } fclose($pipes[2]); $ret = function_exists('proc_close') ? proc_close($handle) : -1; if (0 != $ret) { if ($log_it) $this->log("Binary zip: error (code: $ret)"); $all_ok = false; } } } else { if ($log_it) $this->log("Error: proc_open failed"); $all_ok = false; } } // Do we now actually have a working zip? Need to test the created object using PclZip // If it passes, then remove dirs and then return $potzip; $found_first = false; $found_second = false; if ($all_ok && file_exists($updraft_dir.'/binziptest/test.zip')) { if (function_exists('gzopen')) { if (!class_exists('PclZip')) include_once(ABSPATH.'/wp-admin/includes/class-pclzip.php'); $zip = new PclZip($updraft_dir.'/binziptest/test.zip'); if (($list = $zip->listContent()) != 0) { foreach ($list as $obj) { if ($obj['filename'] && !empty($obj['stored_filename']) && 'binziptest/subdir1/subdir2/test.html' == $obj['stored_filename'] && 131 == $obj['size']) $found_first=true; if ($obj['filename'] && !empty($obj['stored_filename']) && 'binziptest/subdir1/subdir2/test2.html' == $obj['stored_filename'] && 138 == $obj['size']) $found_second=true; } } } else { // PclZip will die() if gzopen is not found // Obviously, this is a kludge - we assume it's working. We could, of course, just return false - but since we already know now that PclZip can't work, that only leaves ZipArchive $this->log("gzopen function not found; PclZip cannot be invoked; will assume that binary zip works if we have a non-zero file"); if (filesize($updraft_dir.'/binziptest/test.zip') > 0) { $found_first = true; $found_second = true; } } } $this->remove_binzip_test_files($updraft_dir); if ($found_first && $found_second) { if ($log_it) $this->log("Working binary zip found: $potzip"); if ($cacheit) $this->jobdata_set('binzip', $potzip); return $potzip; } } $this->remove_binzip_test_files($updraft_dir); } if ($cacheit) $this->jobdata_set('binzip', false); return false; } /* * Remove potentially existing test files after binzip testing * * @param String $updraft_dir - directory to find the files in / private function remove_binzip_test_files($updraft_dir) { @unlink($updraft_dir.'/binziptest/subdir1/subdir2/test.html');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. @unlink($updraft_dir.'/binziptest/subdir1/subdir2/test2.html');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. @rmdir($updraft_dir.'/binziptest/subdir1/subdir2');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. @rmdir($updraft_dir.'/binziptest/subdir1');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. @unlink($updraft_dir.'/binziptest/test.zip');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. @rmdir($updraft_dir.'/binziptest');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } public function option_filter_get($which) { global $wpdb; $row = $wpdb->get_row($wpdb->prepare("SELECT option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1", $which)); // Has to be get_row instead of get_var because of funkiness with 0, false, null values return (is_object($row)) ? $row->option_value : false; } /* * Indicate which checksums to take for backup files. Abstracted for extensibilty and future changes. * * @returns array - a list of hashing algorithms, as understood by PHP's hash() function / public function which_checksums() { return apply_filters('updraftplus_which_checksums', array('sha1', 'sha256')); } /* * Pretty printing of the raw backup information * * @param String $description * @param Array $history * @param String $entity * @param Array $checksums * @param Array $jobdata * @param Boolean $smaller * @return String / public function printfile($description, $history, $entity, $checksums, $jobdata, $smaller = false) { if (empty($history[$entity])) return; // PHP 7.2+ throws a warning if you try to count() a string $how_many = is_string($history[$entity]) ? 1 : count($history[$entity]); if ($smaller) { $pfiles = "<strong>".$description." (".sprintf(__('files: %s', 'updraftplus'), $how_many).")</strong><br>\n"; } else { $pfiles = "<h3>".$description." (".sprintf(__('files: %s', 'updraftplus'), $how_many).")</h3>\n\n"; } $is_incremental = (!empty($jobdata) && !empty($jobdata['job_type']) && 'incremental' == $jobdata['job_type'] && 'db' != substr($entity, 0, 2)) ? true : false; if ($is_incremental) { $backup_timestamp = $jobdata['backup_time']; $backup_history = UpdraftPlus_Backup_History::get_history($backup_timestamp); $pfiles .= "<dl>"; foreach ($backup_history['incremental_sets'] as $timestamp => $backup) { if (isset($backup[$entity])) { $pfiles .= "<dt>".get_date_from_gmt(gmdate('Y-m-d H:i:s', (int) $timestamp), 'M d, Y G:i')."\n</dt>\n"; foreach ($backup[$entity] as $ind => $file) { $pfiles .= "<dd>".$this->get_entity_row($file, $history, $entity, $checksums, $jobdata, $ind)."\n</dd>\n"; } } } $pfiles .= "</dl>\n"; } else { $pfiles .= "<ul>"; $files = $history[$entity]; if (is_string($files)) $files = array($files); foreach ($files as $ind => $file) { $pfiles .= "<li>".$this->get_entity_row($file, $history, $entity, $checksums, $jobdata, $ind)."\n</li>\n"; } $pfiles .= "</ul>\n"; } return $pfiles; } /* * This function will use the passed in information to prepare a pretty string describing the backup from the raw backup history * * @param String $file - the backup file * @param Array $history - the backup history * @param String $entity - the backup entity * @param Array $checksums - checksums for the backup file * @param Array $jobdata - the jobdata for this backup * @param Integer $ind - the index of the file * * @return String - returns the entity output string / public function get_entity_row($file, $history, $entity, $checksums, $jobdata, $ind) { $op = htmlspecialchars($file); $skey = $entity.((0 == $ind) ? '' : $ind).'-size'; $op = apply_filters('updraft_report_downloadable_file_link', $op, $entity, $ind, $jobdata); $op .= "\n"; $meta = ''; if ('db' == substr($entity, 0, 2) && 'db' != $entity) { $dind = substr($entity, 2); if (is_array($jobdata) && !empty($jobdata['backup_database']) && is_array($jobdata['backup_database']) && !empty($jobdata['backup_database'][$dind]) && is_array($jobdata['backup_database'][$dind]['dbinfo']) && !empty($jobdata['backup_database'][$dind]['dbinfo']['host'])) { $dbinfo = $jobdata['backup_database'][$dind]['dbinfo']; $meta .= sprintf(__('External database (%s)', 'updraftplus'), $dbinfo['user'].'@'.$dbinfo['host'].'/'.$dbinfo['name'])."<br>"; } } if (isset($history[$skey])) $meta .= sprintf(__('Size: %s MB', 'updraftplus'), round($history[$skey]/1048576, 1)); $ckey = $entity.$ind; foreach ($checksums as $ck) { $ck_plain = false; if (isset($history['checksums'][$ck][$ckey])) { $meta .= (($meta) ? ', ' : '').sprintf(__('%s checksum: %s', 'updraftplus'), strtoupper($ck), $history['checksums'][$ck][$ckey]); $ck_plain = true; } if (isset($history['checksums'][$ck][$ckey.'.crypt'])) { if ($ck_plain) $meta .= ' '.__('(when decrypted)'); $meta .= (($meta) ? ', ' : '').sprintf(__('%s checksum: %s', 'updraftplus'), strtoupper($ck), $history['checksums'][$ck][$ckey.'.crypt']); } } $fileinfo = apply_filters("updraftplus_fileinfo_$entity", array(), $ind); if (is_array($fileinfo) && !empty($fileinfo)) { if (isset($fileinfo['html'])) { $meta .= $fileinfo['html']; } } // if ($meta) $meta = " ($meta)"; if ($meta) $meta = "<br><em>$meta</em>"; return $op.$meta; } /* * This important function returns a list of file entities that can potentially be backed up (subject to users settings), and optionally further meta-data about them * * @param boolean $include_others Whether to include "Others" in the list of entities to backup. * @param boolean $full_info Whether to include additional metadata about each entity. * * @return array An associative array containing information about the backupable file entities. / public function get_backupable_file_entities($include_others = true, $full_info = false) { $wp_upload_dir = $this->wp_upload_dir(); if ($full_info) { $arr = array( 'plugins' => array('path' => untrailingslashit(WP_PLUGIN_DIR), 'description' => __('Plugins', 'updraftplus'), 'singular_description' => __('Plugin', 'updraftplus')), 'themes' => array('path' => WP_CONTENT_DIR.'/themes', 'description' => __('Themes', 'updraftplus'), 'singular_description' => __('Theme', 'updraftplus')), 'uploads' => array('path' => untrailingslashit($wp_upload_dir['basedir']), 'description' => __('Uploads', 'updraftplus')), 'mu-plugins' => array('path' => WPMU_PLUGIN_DIR, 'description' => __('Must-use plugins', 'updraftplus')) ); } else { $arr = array( 'plugins' => untrailingslashit(WP_PLUGIN_DIR), 'themes' => WP_CONTENT_DIR.'/themes', 'uploads' => untrailingslashit($wp_upload_dir['basedir']), 'mu-plugins' => WPMU_PLUGIN_DIR ); } $arr = apply_filters('updraft_backupable_file_entities', $arr, $full_info); // We then add 'others' on to the end if ($include_others) { if ($full_info) { $arr['others'] = array('path' => WP_CONTENT_DIR, 'description' => __('Others', 'updraftplus')); } else { $arr['others'] = WP_CONTENT_DIR; } } // Entries that should be added after 'others' $arr = apply_filters('updraft_backupable_file_entities_final', $arr, $full_info); return $arr; } /* * This function returns a list of specific php error messages and their action block * * @return array An associative array containing information about certain specific php errors and their error messages. / private function php_specific_error_handler_data(){ $handle_specific_messages = array( 'open_basedir restriction./cpanel' => array( 'action' => 'replace', 'action_data' => 'Could not ask cPanel about disk space (open_basedir) - this is not an error', ), 'ftp_nb_fput: php_connect_nonb failed: Operation now in progress' => array( 'action' => 'append', 'action_data' => "\nPHP logs this condition if a firewall blocked your FTP data channel from your webserver to your FTP server (but allowed your FTP control channel). You will need to speak to one or both of the administrators of those two servers to investigate (note that UpdraftPlus support cannot access any more information about the network than this PHP notice gives - talking to the administrators who can access that information is the next step)." ) ); return $handle_specific_messages; } public function php_error_to_logline($errno, $errstr, $errfile, $errline) { switch ($errno) { case 1: $e_type = 'E_ERROR'; break; case 2: $e_type = 'E_WARNING'; break; case 4: $e_type = 'E_PARSE'; break; case 8: $e_type = 'E_NOTICE'; break; case 16: $e_type = 'E_CORE_ERROR'; break; case 32: $e_type = 'E_CORE_WARNING'; break; case 64: $e_type = 'E_COMPILE_ERROR'; break; case 128: $e_type = 'E_COMPILE_WARNING'; break; case 256: $e_type = 'E_USER_ERROR'; break; case 512: $e_type = 'E_USER_WARNING'; break; case 1024: $e_type = 'E_USER_NOTICE'; break; case 2048: $e_type = 'E_STRICT'; break; case 4096: $e_type = 'E_RECOVERABLE_ERROR'; break; case 8192: $e_type = 'E_DEPRECATED'; break; case 16384: $e_type = 'E_USER_DEPRECATED'; break; case 30719: $e_type = 'E_ALL'; break; default: $e_type = "E_UNKNOWN ($errno)"; break; } if (false !== stripos($errstr, 'table which is not valid in this version of Gravity Forms')) return false; if (!is_string($errstr)) $errstr = serialize($errstr); if (0 === strpos($errfile, ABSPATH)) $errfile = substr($errfile, strlen(ABSPATH)); if ('E_DEPRECATED' == $e_type && !empty($this->no_deprecation_warnings)) { return false; } $error_string = "PHP event: code $e_type: $errstr"; foreach ($this->php_specific_error_handler_data() as $pattern => $action_block) { if (preg_match('#'.$pattern.'#i', $error_string)) { if ('replace' == $action_block['action']) { $error_string = 'PHP event: '. $action_block['action_data']; } if ('append' == $action_block['action']) { $error_string = $error_string." ".$action_block['action_data']; } } } $error_string .= " (line $errline, $errfile)"; return $error_string; } public function php_error($errno, $errstr, $errfile, $errline) { if (0 == error_reporting()) return true; $logline = $this->php_error_to_logline($errno, $errstr, $errfile, $errline); if (false !== $logline) $this->log($logline, 'notice', 'php_event'); // Pass it up the chain return $this->error_reporting_stop_when_logged; } /** * Proceed with a backup; before calling this, at least all the initial job data must be set up * * @param Integer $resumption_no - which resumption this is; from 0 upwards * @param String $bnonce - the backup job identifier / public function backup_resume($resumption_no, $bnonce) { // Theoretically (N.B. has been seen in the real world), the WP scheduler might call us more than once within the same context (e.g. an incremental run followed by a main backup resumption), leaving us with incorrect internal state if we don't reset. static $last_bnonce = null; if ($last_bnonce) $this->jobdata_reset(); $last_bnonce = $bnonce; $error_levels = version_compare(PHP_VERSION, '8.4.0', '>=') ? E_ALL : E_ALL & ~E_STRICT; set_error_handler(array($this, 'php_error'), $error_levels); $this->current_resumption = $resumption_no; if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (function_exists('ignore_user_abort')) @ignore_user_abort(true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $runs_started = array(); $time_now = microtime(true); UpdraftPlus_Backup_History::always_get_from_db(); // Restore state $resumption_extralog = ''; $prev_resumption = $resumption_no - 1; $last_successful_resumption = -1; $job_type = 'backup'; if (0 == $resumption_no) { $label = $this->jobdata_get('label'); if ($label) $resumption_extralog = apply_filters('updraftplus_autobackup_extralog', ", label=$label"); } else { $this->nonce = $bnonce; $file_nonce = $this->jobdata_get('file_nonce'); $this->file_nonce = $file_nonce ? $file_nonce : $bnonce; $this->backup_time = $this->jobdata_get('backup_time'); $this->job_time_ms = $this->jobdata_get('job_time_ms'); // Get the warnings before opening the log file, as opening the log file may generate new ones (which then leads to $this->errors having duplicate entries when they are copied over below) $warnings = $this->jobdata_get('warnings'); $this->logfile_open($this->file_nonce); if (!$this->get_backup_job_semaphore_lock($this->nonce, $resumption_no)) { $this->log('Failed to get backup job lock; possible overlapping resumptions - will abort this instance'); die; } // Import existing warnings. The purpose of this is so that when save_backup_to_history() is called, it has a complete set - because job data expires quickly, whilst the warnings of the last backup run need to persist if (is_array($warnings)) { foreach ($warnings as $warning) { $this->errors[] = array('level' => 'warning', 'message' => $warning); } } $runs_started = $this->jobdata_get('runs_started'); if (!is_array($runs_started)) $runs_started =array(); $time_passed = $this->jobdata_get('run_times'); if (!is_array($time_passed)) $time_passed = array(); foreach ($time_passed as $run => $passed) { if (isset($runs_started[$run]) && $runs_started[$run] + $time_passed[$run] + 30 > $time_now) { // We don't want to increase the resumption if WP has started two copies of the same resumption off if ($run && $run == $resumption_no) { $increase_resumption = false; $this->log("It looks like WordPress's scheduler has started multiple instances of this resumption"); } else { $increase_resumption = true; } UpdraftPlus_Job_Scheduler::terminate_due_to_activity('check-in', round($time_now, 1), round($runs_started[$run] + $time_passed[$run], 1), $increase_resumption); } } $useful_checkins = $this->jobdata_get('useful_checkins', array()); if (!empty($useful_checkins)) { $last_successful_resumption = min(max($useful_checkins), $prev_resumption); } if (isset($time_passed[$prev_resumption])) { // N.B. A check-in occurred; we haven't yet tested if it was useful $resumption_extralog = ", previous check-in=".round($time_passed[$prev_resumption], 2)."s"; } // This is just a simple test to catch restorations of old backup sets where the backup includes a resumption of the backup job if ($time_now - $this->backup_time > 172800 && true == apply_filters('updraftplus_check_obsolete_backup', true, $time_now, $this)) { // We have seen cases where the get_site_option() call that self::get_jobdata() relies on returns nothing, even though the data was there in the database. This appears to be sometimes reproducible for the people who get it, but stops being reproducible if they change their backup times - which suggests that they're having failures at times of extreme load. We can attempt to detect this case, and reschedule, instead of aborting. if (empty($this->backup_time) && empty($this->backup_is_already_complete) && !empty($this->logfile_name) && is_readable($this->logfile_name)) { $first_log_bit = file_get_contents($this->logfile_name, false, null, 0, 250); if (preg_match('/$0$ Opened log file at time: (.) on /', $first_log_bit, $matches)) { $first_opened = strtotime($matches[1]); // The value of 1000 seconds here is somewhat arbitrary; but allows for the problem to occur in ~ the first 15 minutes. In practice, the problem is extremely rare; if this does not catch it, we can tweak the algorithm. if (time() - $first_opened < 1000) { $this->log("This backup task (".$this->nonce.") failed to load its job data (possible database server malfunction), but has only recently started: scheduling a fresh resumption in order to try again, and then ending this resumption ($time_now, ".$this->backup_time.") (existing jobdata keys: ".implode(', ', array_keys($this->jobdata)).")"); UpdraftPlus_Job_Scheduler::reschedule(120); die; } } } // If we are doing a local upload then we do not want to abort the backup as it's possible they are uploading a backup that is older than two days if (empty($this->jobdata['local_upload'])) { $this->log("This backup task (" . $this->nonce . ") is either complete or began over 2 days ago: ending ($time_now, " . $this->backup_time . ") (existing jobdata keys: " . implode(', ', array_keys($this->jobdata)) . ")"); die; } } } $this->last_successful_resumption = $last_successful_resumption; $runs_started[$resumption_no] = $time_now; if (!empty($this->backup_time)) $this->jobdata_set('runs_started', $runs_started); // Schedule again, to run in 5 minutes again, in case we again fail // The actual interval can be increased (for future resumptions) by other code, if it detects apparent overlapping $resume_interval = max((int) $this->jobdata_get('resume_interval'), 100); $btime = $this->backup_time; $job_type = $this->jobdata_get('job_type'); do_action('updraftplus_resume_backup_'.$job_type); $updraft_dir = $this->backups_dir_location(); $time_ago = time()-$btime; $this->log("Backup run: resumption=$resumption_no, nonce=$bnonce, file_nonce=".$this->file_nonce." begun at=$btime ({$time_ago}s ago), job type=$job_type".$resumption_extralog); // This works round a bizarre bug seen in one WP install, where delete_transient and wp_clear_scheduled_hook both took no effect, and upon 'resumption' the entire backup would repeat. // Argh. In fact, this has limited effect, as apparently (at least on another install seen), the saving of the updated transient via jobdata_set() also took no effect. Still, it does not hurt. if ($resumption_no >= 1 && 'finished' == $this->jobdata_get('jobstatus')) { $this->log('Terminate: This backup job is already finished (1).'); die; } elseif ('clouduploading' != $this->jobdata_get('jobstatus') && 'backup' == $job_type && !empty($this->backup_is_already_complete)) { $this->jobdata_set('jobstatus', 'finished'); $this->log('Terminate: This backup job is already finished (2).'); die; } if ($resumption_no > 0 && isset($runs_started[$prev_resumption])) { $our_expected_start = $runs_started[$prev_resumption] + $resume_interval; // If the previous run increased the resumption time, then it is timed from the end of the previous run, not the start if (isset($time_passed[$prev_resumption]) && $time_passed[$prev_resumption] > 0) $our_expected_start += $time_passed[$prev_resumption]; $our_expected_start = apply_filters('updraftplus_expected_start', $our_expected_start, $job_type); // More than 12 minutes late? if ($time_now > $our_expected_start + 720) { $this->log('Long time past since expected resumption time: approx expected='.round($our_expected_start, 1).", now=".round($time_now, 1).", diff=".round($time_now-$our_expected_start, 1)); $this->log(__('Your website is visited infrequently and UpdraftPlus is not getting the resources it hoped for; please read this page:', 'updraftplus').' https://updraftplus.com/faqs/why-am-i-getting-warnings-about-my-site-not-having-enough-visitors/', 'warning', 'infrequentvisits'); } } $this->jobdata_set('current_resumption', $resumption_no); $first_run = apply_filters('updraftplus_filerun_firstrun', 0); // April 2022: a similar situation is handled further down, but takes longer to kick in; so extra check has been added (a case where the first runtime under cli was > 4 hours was followed by running under cgi-fci with only 20 minute resumption times; it's better to detect this early) if ($resumption_no == $first_run + 1 && $resume_interval >= 600 && '' != PHP_SAPI) { $last_sapi = $this->jobdata_get('last_sapi'); if ('' != $last_sapi && PHP_SAPI != $last_sapi) { $resume_interval = $this->get_initial_resume_interval(); $this->log(sprintf("Run environment has changed (%s -> %s) - resetting resumption interval to %d", $last_sapi, PHP_SAPI, $resume_interval)); $this->jobdata_set('last_sapi', PHP_SAPI); } // We don't want to be in permanent conflict with the overlap detector } elseif ($resumption_no >= $first_run + 8 && $resumption_no < $first_run + 15 && $resume_interval >= 300) { // $time_passed is set earlier list($max_time, $timings_string, $run_times_known) = UpdraftPlus_Manipulation_Functions::max_time_passed($time_passed, $resumption_no - 1, $first_run); // Do this on resumption 8, or the first time that we have 6 data points. This is only done once to prevent any potential for back-and-forth. if (($first_run + 8 == $resumption_no && $run_times_known >= 6) \|\| (6 == $run_times_known && !empty($time_passed[$prev_resumption]))) { $this->log("Time passed on previous resumptions: $timings_string (known: $run_times_known, max: $max_time)"); // Remember that 30 seconds is used as the 'perhaps something is still running' detection threshold, and that 45 seconds is used as the 'the next resumption is approaching - reschedule!' interval if ($resume_interval > $max_time + 52) { $resume_interval = round($max_time + 52); $this->log("Based on the available data, we are bringing the resumption interval down to: $resume_interval seconds"); $this->jobdata_set('resume_interval', $resume_interval); } } elseif (isset($time_passed[$prev_resumption]) && $time_passed[$prev_resumption] > 50 && $resume_interval > 300 && $time_passed[$prev_resumption] < $resume_interval/2) { // This next condition was added in response to HS#9174, a case where on one resumption, PHP was allowed to run for >3000 seconds - but other than that, up to 500 seconds. As a result, the resumption interval got stuck at a large value, whilst resumptions were only being allowed to run for a much smaller amount. // This detects whether our last run was less than half the resume interval, but was non-trivial (at least 50 seconds - so, indicating it didn't just error out straight away), but with a resume interval of over 300 seconds. In this case, it is reduced. if ('clouduploading' == $this->jobdata_get('jobstatus')) { $resume_interval = round($time_passed[$prev_resumption] + 52); $this->log("Time passed on previous resumptions: $timings_string (known: $run_times_known, max: $max_time). Based on the available data, we are bringing the resumption interval down to: $resume_interval seconds"); $this->jobdata_set('resume_interval', $resume_interval); } elseif ($run_times_known > 4) { // Added in response to the similar HS#66907 - in that case, resumption 0 ran for over an hour; nothing subsequently for more than ~3 minutes; and it didn't reach the uploading stage until resumption 19, so the previous fragment was not helping. The cause was that the backup initially started under WP-CLI, but then resumed through the web - different conditions led to different permitted run-times. (The user could also mitigate this by running WP-Cron in a CLI environment). $examined_values = 0; $matching_values = 0; $looking_at_resumption = $prev_resumption - 1; $largest_recent = false; while ($looking_at_resumption > 0 && $examined_values < 3) { if (isset($time_passed[$looking_at_resumption])) { $examined_values++; if ($time_passed[$looking_at_resumption] > 50 && $time_passed[$looking_at_resumption] < $resume_interval/2) { $matching_values++; $largest_recent = max($largest_recent, $time_passed[$looking_at_resumption]); } } $looking_at_resumption--; } // If the previous three found values were all less than half the resumption interval.... if (3 == $examined_values && 3 == $matching_values) { $resume_interval = round($largest_recent + 52); $this->log("Time passed on previous resumptions: $timings_string (known: $run_times_known, max: $max_time). Based on the available data (most recent 3 resumptions compared to longest), we are bringing the resumption interval down to: $resume_interval seconds"); $this->jobdata_set('resume_interval', $resume_interval); } } } } // A different argument than before is needed otherwise the event is ignored $next_resumption = $resumption_no+1; if ($next_resumption < $first_run + 10) { if (true === $this->jobdata_get('one_shot')) { if (true === $this->jobdata_get('reschedule_before_upload') && 1 == $next_resumption) { $this->log('A resumption will be scheduled for the cloud backup stage'); $schedule_resumption = true; } else { $this->log('We are in "one shot" mode - no resumptions will be scheduled'); } } else { $schedule_resumption = true; } } else { // We're in over-time - we only reschedule if something useful happened last time (used to be that we waited for it to happen this time - but that meant that temporary errors, e.g. Google 400s on uploads, scuppered it all - we'd do better to have another chance // 'useful_checkin' is < 1.16.35 (Nov 2020). It is only supported here for resumptions that span upgrades. Later it can be removed. $useful_checkin = max($this->jobdata_get('useful_checkin', 0), max((array) $this->jobdata_get('useful_checkins', 0))); $last_resumption = $resumption_no - 1; $fail_on_resume = $this->jobdata_get('fail_on_resume'); if (empty($useful_checkin) \|\| $useful_checkin < $last_resumption) { if (empty($fail_on_resume)) { $this->log(sprintf('The current run is resumption number %d, and there was nothing useful done on the last run (last useful run: %s) - will not schedule a further attempt until we see something useful happening this time', $resumption_no, $useful_checkin)); // Internally, we do actually schedule a resumption; but only in order to be able to nicely handle and log the failure, which otherwise may not be logged $this->jobdata_set('fail_on_resume', $next_resumption); $schedule_resumption = 1; } } else { // Something useful happened last time if (!empty($fail_on_resume)) { $this->jobdata_delete('fail_on_resume'); $fail_on_resume = false; } $schedule_resumption = true; } if (!isset($time_passed[$prev_resumption])) { $this->no_checkin_last_time = true; } if (!empty($fail_on_resume) && $fail_on_resume == $this->current_resumption) { $this->log('The backup is being aborted for a repeated failure to progress.', 'updraftplus'); $this->log(__('The backup is being aborted for a repeated failure to progress.', 'updraftplus'), 'error'); $this->backup_finish(true, true); die; } } // Sanity check if (empty($this->backup_time)) { $this->log('The backup_time parameter is empty (usually caused by resuming an already-complete backup).'); return false; } if (!empty($schedule_resumption)) { $schedule_for = time() + $resume_interval; if (1 === $schedule_resumption) { $this->log("Scheduling a resumption ($next_resumption) after $resume_interval seconds ($schedule_for); but the job will then be aborted unless something happens this time"); $this->resumption_scheduled_for_cleanup = true; } else { $this->log("Scheduling a resumption ($next_resumption) after $resume_interval seconds ($schedule_for) in case this run gets aborted"); } wp_schedule_single_event($schedule_for, 'updraft_backup_resume', array($next_resumption, $bnonce)); $this->newresumption_scheduled = $schedule_for; } $backup_files = $this->jobdata_get('backup_files'); global $updraftplus_backup; // Bring in all the backup routines updraft_try_include_file('backup.php', 'include_once'); $updraftplus_backup = new UpdraftPlus_Backup($backup_files, apply_filters('updraftplus_files_altered_since', -1, $job_type)); $undone_files = array(); if ('no' == $backup_files) { $this->log('This backup run is not intended for files - skipping'); $our_files = array(); } else { try { // This should be always called; if there were no files in this run, it returns us an empty array $backup_array = $updraftplus_backup->resumable_backup_of_files($resumption_no); // This save, if there was something, is then immediately picked up again if (is_array($backup_array)) { $this->log('Saving backup status to database (elements: '.count($backup_array).")"); $this->save_backup_to_history($backup_array); } // Switch of variable name is purely vestigial $our_files = $backup_array; if (!is_array($our_files)) $our_files = array(); } catch (Exception $e) { $log_message = 'Exception ('.get_class($e).') occurred during files backup: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); // @codingStandardsIgnoreLine $log_message .= ' Backtrace: '.str_replace(array(ABSPATH, "\n"), array('', ', '), $e->getTraceAsString()); $this->log($log_message); $this->log(sprintf(__('A PHP exception (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); die(); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); // @codingStandardsIgnoreLine $log_message .= ' Backtrace: '.str_replace(array(ABSPATH, "\n"), array('', ', '), $e->getTraceAsString()); $this->log($log_message); $this->log(sprintf(__('A PHP fatal error (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); die(); } } do_action('pre_database_backup_setup'); $backup_databases = $this->jobdata_get('backup_database'); if (!is_array($backup_databases)) $backup_databases = array('wp' => $backup_databases); foreach ($backup_databases as $whichdb => $backup_database) { if (is_array($backup_database)) { $dbinfo = $backup_database['dbinfo']; $backup_database = $backup_database['status']; } else { $dbinfo = array(); } $tindex = ('wp' == $whichdb) ? 'db' : 'db'.$whichdb; if ('begun' == $backup_database \|\| 'finished' == $backup_database \|\| 'encrypted' == $backup_database) { if ('wp' == $whichdb) { $db_descrip = 'WordPress DB'; } else { if (!empty($dbinfo) && is_array($dbinfo) && !empty($dbinfo['host'])) { $db_descrip = "External DB $whichdb - ".$dbinfo['user'].'@'.$dbinfo['host'].'/'.$dbinfo['name']; } else { $db_descrip = "External DB $whichdb - details are missing"; } } if ('begun' == $backup_database) { if ($resumption_no > 0) { $this->log("Resuming creation of database dump ($db_descrip)"); } else { $this->log("Beginning creation of database dump ($db_descrip)"); } } elseif ('encrypted' == $backup_database) { $this->log("Database dump ($db_descrip): Creation and encryption were completed already"); } else { $this->log("Database dump ($db_descrip): Creation was completed already"); } if ('wp' != $whichdb && (empty($dbinfo) \|\| !is_array($dbinfo) \|\| empty($dbinfo['host']))) { unset($backup_databases[$whichdb]); $this->jobdata_set('backup_database', $backup_databases); continue; } // Catch fatal errors through try/catch blocks around the database backup try { $db_backup = $updraftplus_backup->backup_db($backup_database, $whichdb, $dbinfo); } catch (Exception $e) { $log_message = 'Exception ('.get_class($e).') occurred during files backup: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; $this->log($log_message); error_log($log_message); $this->log(sprintf(__('A PHP exception (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); die(); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; $this->log($log_message); error_log($log_message); $this->log(sprintf(__('A PHP fatal error (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()), 'error'); die(); } if (is_array($our_files) && is_string($db_backup)) $our_files[$tindex] = $db_backup; if ('encrypted' != $backup_database) { $backup_databases[$whichdb] = array('status' => 'finished', 'dbinfo' => $dbinfo); $this->jobdata_set('backup_database', $backup_databases); } } elseif ('no' == $backup_database) { $this->log("No database backup ($whichdb) - not part of this run"); } else { $this->log("Unrecognised data when trying to ascertain if the database ($whichdb) was backed up (".serialize($backup_database).")"); } // This is done before cloud despatch, because we want a record of what should be in the backup. Whether it actually makes it there or not is not yet known. $this->save_backup_to_history($our_files); // Potentially encrypt the database if it is not already if ('no' != $backup_database && isset($our_files[$tindex]) && !preg_match("/\.crypt$/", $our_files[$tindex]) && 'incremental' != $job_type) { $our_files[$tindex] = $updraftplus_backup->encrypt_file($our_files[$tindex]); // No need to save backup history now, as it will happen in a few lines time if (preg_match("/\.crypt$/", $our_files[$tindex])) { $backup_databases[$whichdb] = array('status' => 'encrypted', 'dbinfo' => $dbinfo); $this->jobdata_set('backup_database', $backup_databases); } } if ('no' != $backup_database && isset($our_files[$tindex]) && file_exists($updraft_dir.'/'.$our_files[$tindex])) { $our_files[$tindex.'-size'] = filesize($updraft_dir.'/'.$our_files[$tindex]); $this->save_backup_to_history($our_files); } } $backupable_entities = $this->get_backupable_file_entities(true); $checksum_list = $this->which_checksums(); $checksums = array(); foreach ($checksum_list as $checksum) { $checksums[$checksum] = array(); } $total_size = 0; $service = $this->just_one($this->jobdata_get('service')); if (empty($service)) { $message = 'This file has already been successfully processed'; } else { $message = 'This file has already been successfully uploaded'; } // Queue files for upload foreach ($our_files as $key => $files) { // Only continue if the stored info was about a dump if (!isset($backupable_entities[$key]) && ('db' != substr($key, 0, 2) \|\| '-size' == substr($key, -5, 5))) continue; if (is_string($files)) $files = array($files); foreach ($files as $findex => $file) { $size_key = (0 == $findex) ? $key.'-size' : $key.$findex.'-size'; $total_size = (false === $total_size \|\| !isset($our_files[$size_key]) \|\| !is_numeric($our_files[$size_key])) ? false : $total_size + $our_files[$size_key]; foreach ($checksum_list as $checksum) { $cksum = $this->jobdata_get($checksum.'-'.$key.$findex); if ($cksum) $checksums[$checksum][$key.$findex] = $cksum; $cksum = $this->jobdata_get($checksum.'-'.$key.$findex.'.crypt'); if ($cksum) $checksums[$checksum][$key.$findex.".crypt"] = $cksum; } if ($this->is_uploaded($file)) { $this->log("$file: $key: $message"); } elseif (is_file($updraft_dir.'/'.$file)) { if (!in_array($file, $undone_files)) { $this->log("$file: $key: This file has not yet been successfully uploaded: will queue"); $undone_files[$key.$findex] = $file; } else { $this->log("$file: $key: This file was already queued for upload (this condition should never be seen)"); } } elseif (!$this->is_ours_to_upload($file, $key)) { $this->log("$file: $key: This file is not ours to upload and has been/will be handled by another job."); } else { $this->log("$file: $key: Note: This file was not marked as successfully uploaded, but does not exist on the local filesystem; now marking as uploaded ($updraft_dir/$file)"); $this->uploaded_file($file, true); } } } $our_files['checksums'] = $checksums; // Save again (now that we have checksums) $size_description = (false === $total_size) ? 'Unknown' : UpdraftPlus_Manipulation_Functions::convert_numeric_size_to_text($total_size); $this->log("Saving backup history. Total backup size: $size_description"); $this->save_backup_to_history($our_files); do_action('updraft_final_backup_history', $our_files); // We finished; so, low memory was not a problem $this->log_remove_warning('lowram'); if (0 == count($undone_files)) { $this->log("Resume backup ($bnonce, $resumption_no): finish run"); if (is_array($our_files)) $this->save_last_backup($our_files); $this->log("There were no more files that needed uploading"); // No email, as the user probably already got one if something else completed the run $allow_email = false; if ('begun' == $this->jobdata_get('prune')) { // Begun, but not finished $this->log('Restarting backup prune operation'); $updraftplus_backup->do_prune_standalone(); $allow_email = true; } elseif ('finished' != $this->jobdata_get('prune')) { // If prune has not begun or finished but we have undone files then start it $updraftplus_backup->do_prune_standalone(); $allow_email = true; } $this->check_upload_completed(); $this->backup_finish(true, $allow_email); restore_error_handler(); return; } $this->error_count_before_cloud_backup = $this->error_count(); // This is intended for one-shot backups, where we do want a resumption if it's only for uploading if (empty($this->newresumption_scheduled) && 0 == $resumption_no && 0 == $this->error_count_before_cloud_backup && true === $this->jobdata_get('reschedule_before_upload')) { $this->log("Cloud backup stage reached on one-shot backup: scheduling resumption for the cloud upload"); UpdraftPlus_Job_Scheduler::reschedule(60); UpdraftPlus_Job_Scheduler::record_still_alive(); } $this->log("Requesting upload of the files that have not yet been successfully uploaded (".count($undone_files).")"); // Catch fatal errors through try/catch blocks around the upload to remote storage $updraftplus_backup->cloud_backup($undone_files); $this->log("Resume backup ($bnonce, $resumption_no): finish run"); if (is_array($our_files)) $this->save_last_backup($our_files); $this->backup_finish(true, true); restore_error_handler(); } /** * Get all the job data in a single array * * @param String $job_id - the job identifier (nonce) for the job whose data is to be retrieved * * @return Array / public function jobdata_getarray($job_id) { return get_site_option('updraft_jobdata_'.$job_id, array()); } public function jobdata_set_from_array($array) { $this->jobdata = $array; if (!empty($this->nonce)) update_site_option("updraft_jobdata_".$this->nonce, $this->jobdata); } /* * This works with any amount of settings, but we provide also a jobdata_set for efficiency as normally there's only one setting * You can list the keys/values (keys must be strings) as consecutive/alternating parameters, or send them all in as an array (with no other parameters) * * @return null / public function jobdata_set_multi() { if (!is_array($this->jobdata)) $this->jobdata = array(); $args = func_num_args(); // func_get_arg() could not be used in parameter lists prior to PHP 5.3, so, we get it as a variable if (1 == $args && null !== ($first_arg = func_get_arg(0)) && is_array($first_arg)) { foreach ($first_arg as $key => $value) { $this->jobdata[$key] = $value; } } else { for ($i=1; $i<=$args/2; $i++) { $key = func_get_arg($i2-2); $value = func_get_arg($i2-1); $this->jobdata[$key] = $value; } } if (!empty($this->nonce)) update_site_option('updraft_jobdata_'.$this->nonce, $this->jobdata); } /* * Set a job-data key/value pair for the current job * * @param String $key - the key * @param Mixed $value - needs to be serializable * * @uses update_site_option() / public function jobdata_set($key, $value) { if (empty($this->jobdata)) { $this->jobdata = empty($this->nonce) ? array() : get_site_option('updraft_jobdata_'.$this->nonce); if (!is_array($this->jobdata)) $this->jobdata = array(); } $this->jobdata[$key] = $value; if ($this->nonce) update_site_option('updraft_jobdata_'.$this->nonce, $this->jobdata); } /* * Delete a jobdata item, by key * * @param String $key / public function jobdata_delete($key) { if (!is_array($this->jobdata)) { $this->jobdata = empty($this->nonce) ? array() : get_site_option("updraft_jobdata_".$this->nonce); if (!is_array($this->jobdata)) $this->jobdata = array(); } unset($this->jobdata[$key]); if ($this->nonce) update_site_option("updraft_jobdata_".$this->nonce, $this->jobdata); } public function get_job_option($opt) { // These are meant to be read-only if (empty($this->jobdata['option_cache']) \|\| !is_array($this->jobdata['option_cache'])) { if (!is_array($this->jobdata) && $this->nonce) $this->jobdata = get_site_option("updraft_jobdata_".$this->nonce, array()); $this->jobdata['option_cache'] = array(); } return isset($this->jobdata['option_cache'][$opt]) ? $this->jobdata['option_cache'][$opt] : UpdraftPlus_Options::get_updraft_option($opt); } /* * Get a job data item, or the specified default if it is not yet set * * @param String $key * @param Mixed $default * * @return Mixed / public function jobdata_get($key, $default = null) { if (empty($this->jobdata)) { $this->jobdata = empty($this->nonce) ? array() : get_site_option('updraft_jobdata_'.$this->nonce, array()); if (!is_array($this->jobdata)) return $default; } return isset($this->jobdata[$key]) ? $this->jobdata[$key] : $default; } /* * Reset the job data for the currently active job (forcing a re-fetch from the database, if there is any) / public function jobdata_reset() { $this->jobdata = null; } /* * Gets an instance of the "UpdraftPlus_Clone" class which will be * used to login the user to UpdraftPlus.com * * @return object / public function get_updraftplus_clone() { if (!class_exists('UpdraftPlus_Clone')) updraft_try_include_file('includes/updraftplus-clone.php', 'include_once'); return new UpdraftPlus_Clone(); } /* * This function will add data to the backup options that is needed for the clone backup job * * @param array $options - the backup options array * @param array $request - the extra data we want to add to the backup options * * @return array - the backup options array with the extra data added / public function updraftplus_clone_backup_options($options, $request) { if (!is_array($options)) return $options; if (!empty($request['clone_id']) && !empty($request['secret_token'])) { $options['clone_id'] = $request['clone_id']; $options['secret_token'] = $request['secret_token']; } if (isset($request['clone_url'])) $options['clone_url'] = $request['clone_url']; if (isset($request['key'])) $options['key'] = $request['key']; if (isset($request['clone_region'])) $options['clone_region'] = $request['clone_region']; if (isset($request['backup_nonce']) && isset($request['backup_timestamp'])) { if ('current' != $request['backup_nonce'] && 'current' != $request['backup_timestamp']) { $options['use_nonce'] = $request['backup_nonce']; $options['use_timestamp'] = $request['backup_timestamp']; } else { $options['clone_backup'] = 'current'; } } return $options; } /* * This function will set up the backup job data for when we are starting a clone backup job. It changes the initial jobdata so that UpdraftPlus knows it's a clone job and adds the needed information for to lookup the clone and if we have it the URL and migration key for the clone. * * @param array $jobdata - the initial job data that we want to change * @param array $options - options sent from the front end includes the clone id, secret token and maybe clone url and migration key * @param Integer $split_every - the size we should split the zips at * * @return array - the modified jobdata / public function updraftplus_clone_backup_jobdata($jobdata, $options, $split_every) { if (!is_array($jobdata)) return $jobdata; if (!isset($options['clone_id']) && !isset($options['secret_token']) && !isset($options['clone_url']) && !isset($options['key'])) return $jobdata; $option_cache_key = array_search('option_cache', $jobdata) + 1; $option_cache = $jobdata[$option_cache_key]; $option_cache['updraft_encryptionphrase'] = ''; $jobdata[$option_cache_key] = $option_cache; // Reduce to 100MB if it was above. Since the user isn't expected to directly manipulate these zip files, the potentially higher number of zip files doesn't matter. $split_every_key = array_search('split_every', $jobdata) + 1; if ($split_every > 100) $jobdata[$split_every_key] = 100; $service_key = array_search('service', $jobdata) + 1; $jobdata[$service_key] = array('remotesend'); $backup_database_key = array_search('backup_database', $jobdata) + 1; $db_backups = $jobdata[$backup_database_key]; foreach (array_keys($db_backups) as $key) { if ('wp' != $key) unset($db_backups[$key]); } $jobdata[] = 'clone_job'; $jobdata[] = true; $jobdata[] = 'clone_id'; $jobdata[] = $options['clone_id']; $jobdata[] = 'secret_token'; $jobdata[] = $options['secret_token']; $jobdata[] = 'clone_url'; $jobdata[] = $options['clone_url']; $jobdata[] = 'clone_key'; $jobdata[] = $options['key']; $jobdata[] = 'clone_region'; $jobdata[] = $options['clone_region']; $jobdata[] = 'remotesend_info'; $jobdata[] = array('url' => $options['clone_url']); $jobdata[$backup_database_key] = $db_backups; // if clone_backup is set and is 'current' then theres nothing more that needs to be done, otherwise we need to tweak some more jobdata to skip to the upload stage and use the specified clone backup if (isset($options['clone_backup']) && 'current' == $options['clone_backup']) return $jobdata; global $updraftplus_admin; add_filter('updraftplus_get_backup_file_basename_from_time', array($updraftplus_admin, 'upload_local_backup_name'), 10, 3); $backup_history = UpdraftPlus_Backup_History::get_history(); $backup = $backup_history[$options['use_timestamp']]; $jobstatus_key = array_search('jobstatus', $jobdata) + 1; $backup_time_key = array_search('backup_time', $jobdata) + 1; $backup_files_key = array_search('backup_files', $jobdata) + 1; $db_backups = $jobdata[$backup_database_key]; $db_backup_info = $this->update_database_jobdata($db_backups, $backup); $skip_entities = array('more', 'wpcore'); $file_backups = $this->update_files_jobdata($backup, $skip_entities); $jobdata[$jobstatus_key] = 'clouduploading'; $jobdata[$backup_time_key] = $options['use_timestamp']; $jobdata[$backup_files_key] = 'finished'; $jobdata[] = 'backup_files_array'; $jobdata[] = $file_backups; $jobdata[] = 'blog_name'; $jobdata[] = $db_backup_info['blog_name']; $jobdata[$backup_database_key] = $db_backup_info['db_backups']; $jobdata[] = 'local_upload'; $jobdata[] = true; return $jobdata; } /* * This function will update the database backup jobdata and set each entity to finished or encrypted to prevent that entity from being backed up again. This will also return the blog name that the database backup belongs to, just in case it's from another site. * * @param array $db_backups - the database backup jobdata * @param array $backup - the backup history for this backup * * @return array - an array that contains the updated database backup jobdata and the blog name / public function update_database_jobdata($db_backups, $backup) { $backup_database_info = array( 'blog_name' => '', 'db_backups' => $db_backups ); if (!is_array($db_backups)) return $backup_database_info; / We need to tweak the database array here by setting each database entity to finished or encrypted if it's an encrypted archive. I also grab the backups blog name here ready to be used later, just in case this backup set is from another site. / foreach ($db_backups as $key => $db_info) { $status = 'finished'; $db_index = ('wp' == $key) ? '' : $key; if (isset($backup['db'.$db_index])) { $db_backup_name = $backup['db'.$db_index]; if (preg_match('/^backup_([\-0-9]{15})_(.)_([0-9a-f]{12})-[\-a-z]+([0-9]+)?+(\.(zip\|gz\|gz\.crypt))?$/i', $db_backup_name, $matches)) { $backup_database_info['blog_name'] = $matches[2]; } if (UpdraftPlus_Encryption::is_file_encrypted($db_backup_name)) $status = 'encrypted'; if (is_array($db_info) && isset($db_info['status'])) { $db_backups[$key]['status'] = $status; } else { $db_backups[$key] = $status; } } else { unset($db_backups[$key]); } } $backup_database_info['db_backups'] = $db_backups; return $backup_database_info; } /** * This function will update the files backup jobdata by constructing the backup entities and their sizes from the backup * * @param array $backup - the backup array * @param array $skip_entities - an array of entities to skip * * @return array - the files backup array / public function update_files_jobdata($backup, $skip_entities = array()) { $file_backups = array(); $backupable_entities = $this->get_backupable_file_entities(true); // We need to construct the expected files array here, this gets added to the jobdata much later in the backup process but we need this before we start foreach ($backupable_entities as $entity => $path) { if (in_array($entity, $skip_entities)) continue; if (isset($backup[$entity])) $file_backups[$entity] = $backup[$entity]; if (isset($backup[$entity . '-size'])) $file_backups[$entity . '-size'] = $backup[$entity . '-size']; } return $file_backups; } /* * Start a files backup (used by WP cron) / public function backup_files() { // Note that the "false" for database gets over-ridden automatically if they turn out to have the same schedules $this->boot_backup(true, false); } /* * Start a database backup (used by WP cron) / public function backup_database() { // Note that nothing will happen if the file backup had the same schedule $this->boot_backup(false, true); } /* * Start a files + database backup (used by users manually in WP cron, and 'Backup Now') * * @param array $options * @return Boolean\|Void - as for UpdraftPlus::boot_backup() / public function backup_all($options = array()) { if (!is_array($options)) $options = array(); $skip_cloud = empty($options['nocloud']) ? false : true; return $this->boot_backup(1, 1, false, false, $skip_cloud ? 'none' : false, $options); } /* * Start a files backup * * @param array $options * @return Boolean\|Void - as for UpdraftPlus::boot_backup() / public function backupnow_files($options = array()) { $skip_cloud = empty($options['nocloud']) ? false : true; return $this->boot_backup(1, 0, false, false, $skip_cloud ? 'none' : false, $options); } /* * Start a files backup * * @param array $options * @return Boolean\|Void - as for UpdraftPlus::boot_backup() / public function backupnow_database($options = array()) { $skip_cloud = empty($options['nocloud']) ? false : true; return $this->boot_backup(0, 1, false, false, ($skip_cloud) ? 'none' : false, $options); } /* * This function will try and get a lock for the backup, it will return false if it fails to get a lock. * * @param Boolean $backup_files - boolean to indicate if we want a lock for files * @param Boolean $backup_database - boolean to indicate if we want a lock for the database * * @return boolean - boolean to indicate if we got a lock or not / public function get_semaphore_lock($backup_files, $backup_database) { $semaphore = ($backup_files ? 'f' : '') . ($backup_database ? 'd' : ''); if (!class_exists('UpdraftPlus_Semaphore')) updraft_try_include_file('includes/class-semaphore.php', 'include_once'); UpdraftPlus_Semaphore::ensure_semaphore_exists($semaphore); // Are we doing an action called by the WP scheduler? If so, we want to check when that last happened; the point being that the dodgy WP scheduler, when overloaded, can call the event multiple times - and sometimes, it evades the semaphore because it calls a second run after the first has finished, or > 3 minutes (our semaphore lock time) later // doing_action() was added in WP 3.9 // wp_cron() can be called from the 'init' action if (function_exists('doing_action') && (doing_action('init') \|\| (defined('DOING_CRON') && DOING_CRON)) && (doing_action('updraft_backup_database') \|\| doing_action('updraft_backup'))) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $last_scheduled_action_called_at = get_option("updraft_last_scheduled_$semaphore"); // 11 minutes - so, we're assuming that they haven't custom-modified their schedules to run scheduled backups more often than that. If they have, they need also to use the filter to over-ride this check. $seconds_ago = time() - $last_scheduled_action_called_at; if ($last_scheduled_action_called_at && $seconds_ago < 660 && apply_filters('updraft_check_repeated_scheduled_backups', true)) { $this->log(sprintf('Scheduled backup aborted - another backup of this type was apparently invoked by the WordPress scheduler only %d seconds ago - the WordPress scheduler invoking events multiple times usually indicates a very overloaded server (or other plugins that mis-use the scheduler)', $seconds_ago)); return false; } } update_option("updraft_last_scheduled_$semaphore", time()); $this->semaphore = UpdraftPlus_Semaphore::factory(); $this->semaphore->lock_name = $semaphore; $semaphore_log_message = 'Requesting semaphore lock ('.$semaphore.')'; if (!empty($last_scheduled_action_called_at)) { $semaphore_log_message .= " (apparently via scheduler: last_scheduled_action_called_at=$last_scheduled_action_called_at, seconds_ago=$seconds_ago)"; } else { $semaphore_log_message .= " (apparently not via scheduler)"; } $this->log($semaphore_log_message); if (!$this->semaphore->lock()) { $this->log('Failed to gain semaphore lock ('.$semaphore.') - another backup of this type is apparently already active - aborting (if this is wrong - i.e. if the other backup crashed without removing the lock, then another can be started after 3 minutes)'); return false; } return true; } /* * This function will try and get a lock for the backup job, it will return false if it fails to get a lock. * * @param String $job_nonce - the backup job nonce * @param Integer $resumption_no - the current resumption * * @return boolean - boolean to indicate if we got a lock or not / public function get_backup_job_semaphore_lock($job_nonce, $resumption_no) { $semaphore = 'udp_backupjob_'.$job_nonce; if (!class_exists('Updraft_Semaphore_3_0')) updraft_try_include_file('includes/class-updraft-semaphore.php', 'include_once'); if (empty($this->backup_semaphore)) { $this->backup_semaphore = new Updraft_Semaphore_3_0($semaphore, 30, array($this)); } if (1 <= $resumption_no) { $this->log('Requesting backup semaphore lock ('.$semaphore.')'); if (!$this->backup_semaphore->lock()) { $this->log('Failed to gain semaphore lock ('.$semaphore.') - another resumption for this job is apparently already active'); return false; } } return true; } /* * This function will check to see if any of the known backups are still running and return true otherwise returns false. * * @return boolean\|string - returns false if no backup is running or a error code if there is a backup running / public function is_backup_running() { $backup_history = UpdraftPlus_Backup_History::get_history(); foreach ($backup_history as $backup) { $nonce = $backup['nonce']; // Check the job is not still running. $jobdata = $this->jobdata_getarray($nonce); if (!empty($jobdata) && 'finished' != $jobdata['jobstatus']) { // Check that there is not a resumption scheduled if (wp_next_scheduled('updraft_backup_resume')) return "job_resumption_scheduled"; $time_passed = $jobdata['run_times']; // No runtime found so return if (!is_array($time_passed)) return "job_scheduled_{$nonce}_no_run_times"; // Runtime has been found so make sure last activity is over an hour $time_passed = end($time_passed); if (strtotime($time_passed) <= time() - (3600)) continue; return "job_scheduled_{$nonce}_run_time_activity"; } } return false; } /* * This function is a filter function which will return the nonce for the incremental backup set we want to add to * * @param String $nonce - the backup nonce we want to filter * * @return string - the backup nonce / public function incremental_backup_file_nonce($nonce) { if (apply_filters('updraftplus_incremental_addon_installed', false) && !empty($this->file_nonce)) return $this->file_nonce; return $nonce; } /* * Get the initial resumption interval, in seconds * * @return Integer / private function get_initial_resume_interval() { // Allow the resume interval to be more than 300 if last time we know we went beyond that - but never more than 600 if (defined('UPDRAFTPLUS_INITIAL_RESUME_INTERVAL') && is_numeric(UPDRAFTPLUS_INITIAL_RESUME_INTERVAL)) { $resume_interval = UPDRAFTPLUS_INITIAL_RESUME_INTERVAL; } else { $resume_interval = (int) min(max(300, get_site_transient('updraft_initial_resume_interval')), 600); } // We delete it because we only want to know about behaviour found during the very last backup run (so, if you move servers then old data is not retained) delete_site_transient('updraft_initial_resume_interval'); return $resume_interval; } /* * This procedure initiates a backup run * $backup_files/$backup_database: true/false = yes/no (over-write allowed); 1/0 = yes/no (force) * * @param Boolean\|Integer $backup_files * @param Boolean\|Integer $backup_database * @param Boolean\|Array $restrict_files_to_override * @param Boolean $one_shot * @param Boolean\|Array\|String $service * @param Array $options * * @return Boolean\|Void - false indicates definite failure; true indicates a job was started and ran through as far as possible on this resumption. Note that you should not expect this method to return at all, depending on how long the backup takes, and available PHP run time, etc. In case of failure, currently there may or may not be information logged, and it may or may not be logged at the 'error' level. If more precise feedback is needed, then this can be improved. Void is currently used if no backup was started because none was needed. / public function boot_backup($backup_files, $backup_database, $restrict_files_to_override = false, $one_shot = false, $service = false, $options = array()) { if (function_exists('ignore_user_abort')) @ignore_user_abort(true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $is_scheduled_backup = is_bool($backup_files) \|\| is_bool($backup_database); $hosting_company = $this->get_hosting_info(); if (!empty($options['incremental']) && in_array('only_one_incremental_per_day', $this->is_hosting_backup_limit_reached())) { $this->log(__("You have reached the daily limit for the number of incremental backups you can create at this time.", 'updraftplus').' '.__(' Your hosting provider only allows you to take one incremental backup per day.', 'updraftplus').' '.sprintf(__('Please contact your hosting company (%s) if you require further support.', 'updraftplus'), $hosting_company['name'])); return false; } elseif (empty($options['incremental']) && in_array('only_one_backup_per_month', $this->is_hosting_backup_limit_reached())) { $this->log(__('You have reached the monthly limit for the number of backups you can create at this time.', 'updraftplus').' '.__('Your hosting provider only allows you to take one backup per month.', 'updraftplus').' '.sprintf(__('Please contact your hosting company (%s) if you require further support.', 'updraftplus'), $hosting_company['name'])); return false; } if (false === $restrict_files_to_override && isset($options['restrict_files_to_override'])) $restrict_files_to_override = $options['restrict_files_to_override']; // Generate backup information $use_nonce = empty($options['use_nonce']) ? false : $options['use_nonce']; $use_timestamp = empty($options['use_timestamp']) ? false : $options['use_timestamp']; $this->backup_time_nonce($use_nonce, $use_timestamp); // The current_resumption is consulted within logfile_open() $this->current_resumption = 0; $this->logfile_open($this->file_nonce); if (!is_file($this->logfile_name)) { $this->log('Failed to open log file ('.$this->logfile_name.') - you need to check your UpdraftPlus settings (your chosen directory for creating files in is not writable, or you ran out of disk space). Backup aborted.'); $this->log(__('Could not create files in the backup directory.', 'updraftplus').' '.__('Backup aborted - check your UpdraftPlus settings.', 'updraftplus'), 'error'); if (!defined('UPDRAFTPLUS_SEND_UNWRITABLE_BACKUP_DIRECTORY_EMAIL') \|\| UPDRAFTPLUS_SEND_UNWRITABLE_BACKUP_DIRECTORY_EMAIL) { $final_message = __('UpdraftPlus is unable to perform backups as your backup directory is not writable or the disk space is full.', 'updraftplus').' '.__('Please check the backup directory and ensure it is writable so that backups may continue.', 'updraftplus'); $this->send_results_email($final_message, $this->jobdata); } return false; } // Some house-cleaning UpdraftPlus_Filesystem_Functions::clean_temporary_files(); // Log some information that may be helpful $this->log("Tasks: Backup files: $backup_files (schedule: ".UpdraftPlus_Options::get_updraft_option('updraft_interval', 'unset').") Backup DB: $backup_database (schedule: ".UpdraftPlus_Options::get_updraft_option('updraft_interval_database', 'unset').")"); // The is_bool() check here is confirming that we're allowed to adjust the parameters if (false === $one_shot && is_bool($backup_database)) { // If the files and database schedules are the same, and if this the file one, then we rope in database too. // On the other hand, if the schedules were the same and this was the database run, then there is nothing to do. $files_schedule = UpdraftPlus_Options::get_updraft_option('updraft_interval'); $db_schedule = UpdraftPlus_Options::get_updraft_option('updraft_interval_database'); $sched_log_extra = ''; if ('manual' != $files_schedule && false !== $files_schedule) { if ($files_schedule == $db_schedule \|\| UpdraftPlus_Options::get_updraft_option('updraft_interval_database', 'xyz') == 'xyz') { $sched_log_extra = 'Combining jobs from identical schedules. '; $backup_database = (true == $backup_files) ? true : false; } elseif ($files_schedule && $db_schedule && $files_schedule != $db_schedule) { // This stored value is the earliest of the two apparently-close jobs $combine_around = empty($this->combine_jobs_around) ? false : $this->combine_jobs_around; if (preg_match('/^(cancel:)?(\d+)$/', $combine_around, $matches)) { $combine_around = $matches[2]; // Re-save the option, since otherwise it will have been reset and not be accessible to the 'other' run UpdraftPlus_Options::update_updraft_option('updraft_combine_jobs_around', 'cancel:'.$this->combine_jobs_around); $margin = (defined('UPDRAFTPLUS_COMBINE_MARGIN') && is_numeric(UPDRAFTPLUS_COMBINE_MARGIN)) ? UPDRAFTPLUS_COMBINE_MARGIN : 600; $time_now = time(); // The margin is doubled, to cope with the lack of predictability in WP's cron system if ($time_now >= $combine_around && $time_now <= $combine_around + 2$margin) { $sched_log_extra = 'Combining jobs from co-inciding events. '; if ('cancel:' == $matches[1]) { $backup_database = false; $backup_files = false; } else { // We want them both to happen on whichever run is first (since, afterwards, the updraft_combine_jobs_around option will have been removed when the event is rescheduled). $backup_database = true; $backup_files = true; } } } } } $this->log("Processed schedules. {$sched_log_extra}Tasks now: Backup files: $backup_files Backup DB: $backup_database"); } if (false == apply_filters('updraftplus_boot_backup', true, $backup_files, $backup_database, $one_shot)) { $this->log("Backup aborted (via filter)"); return false; } $enabled_storage_objects_and_ids = array(); // All scheduled backups will go through this condition (and some others may too) // This section sets up default options, filters services/instances, and populates $options['remote_storage_instances'] if (!is_string($service) && !is_array($service)) { $all_services = !empty($options['remote_storage_instances']) ? array_keys($options['remote_storage_instances']) : UpdraftPlus_Options::get_updraft_option('updraft_service'); if (is_string($all_services)) $all_services = (array) $all_services; $enabled_storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_enabled_storage_objects_and_ids($all_services); $legacy_storage_instances = array(); if (!isset($options['remote_storage_instances'])) { $remote_storage_instances = array(); foreach ($enabled_storage_objects_and_ids as $method_id => $method_info) { if ($method_info['object']->supports_feature('multi_options')) { foreach ($method_info['instance_settings'] as $instance_id => $instance_settings) { // We already know the instance is enabled, as we only selected those. We just want to give add-ons an opportunity to filter it. if (!apply_filters('updraft_boot_backup_remote_storage_instance_include', true, $instance_settings, $method_id, $instance_id, $is_scheduled_backup)) continue; if (!isset($remote_storage_instances[$method_id])) $remote_storage_instances[$method_id] = array(); $remote_storage_instances[$method_id][] = $instance_id; } } else { $legacy_storage_instances[] = $method_id; } } $options['remote_storage_instances'] = $remote_storage_instances; } $service = array_merge(array_keys($options['remote_storage_instances']), $legacy_storage_instances); } $service = $this->just_one($service); $service = $this->get_canonical_service_list($service); if (!empty($options['extradata']) && !empty($options['extradata']['services']) && preg_match('#remotesend/(\d+)#', $options['extradata']['services'])) { $service[] = 'remotesend'; } $canonised_storage_objects_and_ids = array_merge(array_flip($service), $enabled_storage_objects_and_ids); $option_cache = array(); foreach ($canonised_storage_objects_and_ids as $method_id => $method_info) { // Explained at updraftplus/-/merge_requests/1302#note_206636 if (!is_array($method_info)) $canonised_storage_objects_and_ids[$method_id] = $method_info = array(); if (!isset($method_info['object']) \|\| !is_object($method_info['object'])) { updraft_try_include_file('methods/'.$method_id.'.php', 'include_once'); $cclass = 'UpdraftPlus_BackupModule_'.$method_id; if (class_exists($cclass)) { $method_info['object'] = $canonised_storage_objects_and_ids[$method_id]['object'] = new $cclass; } else { error_log("UpdraftPlus: backup class does not exist: $cclass"); } } if (isset($method_info['object']) && is_object($method_info['object']) && is_callable(array($method_info['object'], 'get_credentials'))) { $opts = $method_info['object']->get_credentials(); if (is_array($opts)) { foreach ($opts as $opt) $option_cache[$opt] = UpdraftPlus_Options::get_updraft_option($opt); } } } $option_cache = apply_filters('updraftplus_job_option_cache', $option_cache); // If nothing to be done, then just finish if (!$backup_files && !$backup_database) { $ret = $this->backup_finish(false, false); // Don't keep useless log files if (!UpdraftPlus_Options::get_updraft_option('updraft_debug_mode') && !empty($this->logfile_name) && file_exists($this->logfile_name)) { unlink($this->logfile_name); } // Currently backup_finish() appears to have a void return. We don't want to return false, as that indicates failure. But neither was it really a success. Void seems fine for now, given that nothing is currently using it. return $ret; } if (!$this->get_semaphore_lock($backup_files, $backup_database)) { // get_semaphore_lock() already does some of its own logging (though not currently (Nov 2019) at 'error' level) return false; } $resume_interval = $this->get_initial_resume_interval(); $job_file_entities = array(); if ($backup_files) { $possible_backups = $this->get_backupable_file_entities(true); foreach ($possible_backups as $youwhat => $whichdir) { if ((false === $restrict_files_to_override && UpdraftPlus_Options::get_updraft_option("updraft_include_$youwhat", apply_filters("updraftplus_defaultoption_include_$youwhat", true))) \|\| (is_array($restrict_files_to_override) && in_array($youwhat, $restrict_files_to_override))) { // The 0 indicates the zip file index $job_file_entities[$youwhat] = array( 'index' => 0 ); } } } $followups_allowed = (((!$one_shot && defined('DOING_CRON') && DOING_CRON)) \|\| (defined('UPDRAFTPLUS_FOLLOWUPS_ALLOWED') && UPDRAFTPLUS_FOLLOWUPS_ALLOWED)); $split_every = max((int) UpdraftPlus_Options::get_updraft_option('updraft_split_every', 400), UPDRAFTPLUS_SPLIT_MIN); $initial_jobdata = array( 'resume_interval', $resume_interval, 'job_type', 'backup', 'jobstatus', 'begun', 'backup_time', $this->backup_time, 'job_time_ms', $this->job_time_ms, 'service', $service, 'split_every', $split_every, 'maxzipbatch', 26214400, // 25MB 'job_file_entities', $job_file_entities, 'option_cache', $option_cache, 'uploaded_lastreset', 9, 'one_shot', $one_shot, 'followsups_allowed', $followups_allowed, 'last_sapi', PHP_SAPI, ); if ($one_shot) update_site_option('updraft_oneshotnonce', $this->nonce); if ($this->file_nonce && $this->file_nonce != $this->nonce) array_push($initial_jobdata, 'file_nonce', $this->file_nonce); if ($is_scheduled_backup) array_push($initial_jobdata, 'is_scheduled_backup', true); // 'autobackup' == $options['extradata'] might be set from another plugin so keeping here to keep support if (!empty($options['extradata']) && (!empty($options['extradata']['autobackup']) \|\| 'autobackup' === $options['extradata'])) array_push($initial_jobdata, 'is_autobackup', true); // Save what should be done, to make it resumable from this point on if ($backup_database) { $dbs = apply_filters('updraft_backup_databases', array('wp' => 'begun')); if (is_array($dbs)) { foreach ($dbs as $key => $db) { if ('wp' != $key && (!is_array($db) \|\| empty($db['dbinfo']) \|\| !is_array($db['dbinfo']) \|\| empty($db['dbinfo']['host']))) unset($dbs[$key]); } } } else { $dbs = 'no'; } array_push($initial_jobdata, 'backup_database', $dbs); array_push($initial_jobdata, 'backup_files', (($backup_files) ? 'begun' : 'no')); if (is_array($options) && !empty($options['label'])) array_push($initial_jobdata, 'label', $options['label']); if (!empty($options['always_keep'])) array_push($initial_jobdata, 'always_keep', true); if (!empty($options['remote_storage_instances'])) array_push($initial_jobdata, 'remote_storage_instances', $options['remote_storage_instances']); try { // Use of jobdata_set_multi saves around 200ms call_user_func_array(array($this, 'jobdata_set_multi'), apply_filters('updraftplus_initial_jobdata', $initial_jobdata, $options, $split_every)); } catch (Exception $e) { $this->log("Exception when calling jobdata_set_multi: ".$e->getMessage().' ('.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'); return false; } // Everything is set up; now go $this->backup_resume(0, $this->nonce); if ($one_shot) delete_site_option('updraft_oneshotnonce'); return true; } /** * The purpose of this function is to abstract away historical discrepancies in service lists, by returning in a single, logical form (in particular, no 'none' or '' entries, and always an array) * * @param Array\|String\|Boolean\|Null $services - a list of services to canonicalize, or a string indicating a single service. If null is parsed, then the saved settings will be read. * * @return Array - an array of service names. All service names will be non-empty strings, and 'none' will not feature. If there are no services, then the array will be empty. / public function get_canonical_service_list($services = null) { if (null === $services) $services = UpdraftPlus_Options::get_updraft_option('updraft_service'); $services = (array) $services; foreach ($services as $key => $service) { if ('' === $service \|\| 'none' === $service \|\| false === $service) unset($services[$key]); } return $services; } /* * Perform the tasks necessary when a backup has run through all the available steps. N.B. This does not imply that the were all successful or that the backup is finished. * * @param Boolean $do_cleanup - if (and only if) this is set will resumptions be unscheduled * @param Boolean $allow_email - if this is false, then no email will be sent * @param Boolean $force_abort - set to indicate that the user is manually aborting the backup / public function backup_finish($do_cleanup, $allow_email, $force_abort = false) { if (!empty($this->semaphore)) $this->semaphore->unlock(); if (!empty($this->backup_semaphore)) $this->backup_semaphore->delete(); $this->restore_composer_autoloaders(); $delete_jobdata = false; $clone_job = $this->jobdata_get('clone_job'); if (!empty($clone_job)) { $clone_id = $this->jobdata_get('clone_id'); $secret_token = $this->jobdata_get('secret_token'); } // The valid use of $do_cleanup is to indicate if in fact anything exists to clean up (if no job really started, then there may be nothing) // In fact, leaving the hook to run (if debug is set) is harmless, as the resume job should only do tasks that were left unfinished, which at this stage is none. if (0 == $this->error_count() \|\| $force_abort) { if ($do_cleanup) { $cancel_event = $this->current_resumption + 1; $this->log("There were no errors in the uploads, so the 'resume' event ($cancel_event) is being unscheduled"); // This apparently-worthless setting of metadata before deleting it is for the benefit of a WP install seen where wp_clear_scheduled_hook() and delete_transient() apparently did nothing (probably a faulty cache) $this->jobdata_set('jobstatus', 'finished'); wp_clear_scheduled_hook('updraft_backup_resume', array($cancel_event, $this->nonce)); // This should be unnecessary - even if it does resume, all should be detected as finished; but I saw one very strange case where it restarted, and repeated everything; so, this will help wp_clear_scheduled_hook('updraft_backup_resume', array($cancel_event+1, $this->nonce)); wp_clear_scheduled_hook('updraft_backup_resume', array($cancel_event+2, $this->nonce)); wp_clear_scheduled_hook('updraft_backup_resume', array($cancel_event+3, $this->nonce)); wp_clear_scheduled_hook('updraft_backup_resume', array($cancel_event+4, $this->nonce)); $delete_jobdata = true; } } else { if ($this->newresumption_scheduled) { if ($this->current_resumption + 1 != $this->jobdata_get('fail_on_resume')) { $this->log("There were errors in the uploads, so the 'resume' event is remaining scheduled"); $this->jobdata_set('jobstatus', 'resumingforerrors'); } } // If there were no errors before moving to the upload stage, on the first run, then bring the resumption back very close. Since this is only attempted on the first run, it is really only an efficiency thing for a quicker finish if there was an unexpected networking event. We don't want to do it straight away every time, as it may be that the cloud service is down - and might be up in 5 minutes time. This was added after seeing a case where resumption 0 got to run for 10 hours... and the resumption 7 that should have picked up the uploading of 1 archive that failed never occurred. if (isset($this->error_count_before_cloud_backup) && 0 === $this->error_count_before_cloud_backup) { if (0 == $this->current_resumption) { UpdraftPlus_Job_Scheduler::reschedule(60); } else { // Added 27/Feb/2016 - though the cloud service seems to be down, we still don't want to wait too long $resume_interval = $this->jobdata_get('resume_interval'); // 15 minutes + 2 for each resumption (a modest back-off) $max_interval = 900 + $this->current_resumption 120; if ($resume_interval > $max_interval) { UpdraftPlus_Job_Scheduler::reschedule($max_interval); } } } } // Send the results email if appropriate, which means: // - The caller allowed it (which is not the case in an 'empty' run) // - And: An email address was set (which must be so in email mode) // And one of: // - Debug mode // - There were no errors (which means we completed and so this is the final run - time for the final report) // - It was the tenth resumption; everything failed $send_an_email = false; // Save the jobdata's state for the reporting - because it might get changed (e.g. incremental backup is scheduled) $jobdata_as_was = $this->jobdata; // Make sure that the final status is shown if ($force_abort) { $send_an_email = true; $final_message = __('The backup was aborted by the user', 'updraftplus'); if (!empty($clone_job)) $this->get_updraftplus_clone()->clone_failed_delete(array('clone_id' => $clone_id, 'secret_token' => $secret_token, 'reason' => 'The backup was aborted by the user')); } elseif (0 == $this->error_count()) { $send_an_email = true; $service = $this->jobdata_get('service'); $remote_sent = (!empty($service) && ((is_array($service) && in_array('remotesend', $service)) \|\| 'remotesend' === $service)) ? true : false; if (0 == $this->error_count('warning')) { $final_message = __('The backup succeeded and is now complete', 'updraftplus'); // Ensure it is logged in English. Not hugely important; but helps with a tiny number of really broken setups in which the options cacheing is broken if ('The backup succeeded and is now complete' != $final_message) { $this->log('The backup succeeded and is now complete'); } } else { $final_message = __('The backup succeeded (with warnings) and is now complete', 'updraftplus'); if ('The backup succeeded (with warnings) and is now complete' != $final_message) { $this->log('The backup succeeded (with warnings) and is now complete'); } } if ($remote_sent && !$force_abort) { $final_message .= empty($clone_job) ? '. '.__('To complete your migration/clone, you should now log in to the remote site and restore the backup set.', 'updraftplus') : '. '.__('Your clone will now deploy this data to re-create your site.', 'updraftplus'); } if ($do_cleanup) $delete_jobdata = apply_filters('updraftplus_backup_complete', $delete_jobdata); } elseif (false == $this->newresumption_scheduled \|\| $this->current_resumption + 1 == $this->jobdata_get('fail_on_resume')) { if ($this->current_resumption + 1 == $this->jobdata_get('fail_on_resume')) { $this->log("The resumption is being cancelled, as it was only scheduled to enable error reporting, which can be performed now"); wp_clear_scheduled_hook('updraft_backup_resume', array($this->current_resumption + 1, $this->nonce)); } $send_an_email = true; $final_message = __('The backup attempt has finished, apparently unsuccessfully', 'updraftplus'); if (!empty($clone_job)) $this->get_updraftplus_clone()->clone_failed_delete(array('clone_id' => $clone_id, 'secret_token' => $secret_token, 'reason' => 'The backup attempt has finished, apparently unsuccessfully')); } else { // There are errors, but a resumption will be attempted $final_message = __('The backup has not finished; a resumption is scheduled', 'updraftplus'); } if (0 == $this->error_count()) { // delete manifest files $updraft_dir = $this->backups_dir_location(); $backup_files_array = $this->jobdata_get('backup_files_array', array()); if (!empty($backup_files_array)) { foreach ($backup_files_array as $entity => $files) { if ('-size' === substr($entity, -5, 5) \|\| !is_array($files)) continue; foreach ($files as $file) { $fullpath = $updraft_dir.'/'.$file; if (file_exists($fullpath.'.list.tmp')) { $this->log("Deleting zip manifest ({$file}.list.tmp)"); unlink($fullpath.'.list.tmp'); } } } } } // Now over-ride the decision to send an email, if needed if (UpdraftPlus_Options::get_updraft_option('updraft_debug_mode')) { $send_an_email = true; $this->log("An email has been scheduled for this job, because we are in debug mode"); } $email = UpdraftPlus_Options::get_updraft_option('updraft_email'); // If there's no email address, or the set was empty, that is the final over-ride: don't send if (!$allow_email) { $send_an_email = false; $this->log("No email will be sent - this backup set was empty."); } elseif (empty($email)) { $send_an_email = false; $this->log("No email will/can be sent - the user has not configured an email address."); } if ($force_abort) $jobdata_as_was['aborted'] = true; if ($send_an_email) $this->send_results_email($final_message, $jobdata_as_was); // Make sure this is the final message logged (so it remains on the dashboard) $this->log($final_message); @fclose($this->logfile_handle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $this->logfile_handle = null; // This is left until last for the benefit of the front-end UI, which then gets maximum chance to display the 'finished' status if ($delete_jobdata) delete_site_option('updraft_jobdata_'.$this->nonce); } /** * The jobdata is passed in instead of fetched, because the live jobdata may now differ from that which should be reported on (e.g. an incremental run was subsequently scheduled) * * @param String $final_message The final message to be sent * @param Array $jobdata Full job data / private function send_results_email($final_message, $jobdata) { $debug_mode = UpdraftPlus_Options::get_updraft_option('updraft_debug_mode'); $sendmail_to = $this->just_one_email(UpdraftPlus_Options::get_updraft_option('updraft_email')); if (is_string($sendmail_to)) $sendmail_to = array($sendmail_to); $backup_files = $jobdata['backup_files']; $backup_db = $jobdata['backup_database']; if (is_array($backup_db)) $backup_db = $backup_db['wp']; if (is_array($backup_db)) $backup_db = $backup_db['status']; $backup_type = ('backup' == $jobdata['job_type']) ? __('Full backup', 'updraftplus') : __('Incremental', 'updraftplus'); $backup_status = __('Successful', 'updraftplus'); $was_aborted = !empty($jobdata['aborted']); if ($was_aborted) { $backup_contains = __('The backup was aborted by the user', 'updraftplus'); $backup_status = __('Aborted', 'updraftplus'); } elseif ('finished' == $backup_files && ('finished' == $backup_db \|\| 'encrypted' == $backup_db) && 'incremental' !== $jobdata['job_type']) { $backup_contains = __('Files and database', 'updraftplus')." ($backup_type)"; } elseif ('finished' == $backup_files) { $backup_contains = ('begun' == $backup_db) ? __("Files (database backup has not completed)", 'updraftplus') : __('Files only (database was not part of this particular schedule)', 'updraftplus'); $backup_contains .= " ($backup_type)"; } elseif ('finished' == $backup_db \|\| 'encrypted' == $backup_db) { $backup_contains = ('begun' == $backup_files) ? __("Database (files backup has not completed)", 'updraftplus') : __('Database only (files were not part of this particular schedule)', 'updraftplus'); } elseif ('begun' == $backup_db \|\| 'begun' == $backup_files) { $backup_contains = __('Incomplete', 'updraftplus'); $backup_status = __('Incomplete', 'updraftplus'); } else { $this->log('Unknown/unexpected status: '.serialize($backup_files).'/'.serialize($backup_db)); $backup_contains = __("Unknown/unexpected error - please raise a support request", 'updraftplus'); $backup_status = __('Unsuccessful', 'updraftplus'); } $append_log = ''; $attachments = array(); $error_count = 0; if ($this->error_count() > 0) { $append_log .= __('Errors encountered:', 'updraftplus')."\r\n"; $attachments[0] = $this->logfile_name; foreach ($this->errors as $err) { if (is_wp_error($err)) { foreach ($err->get_error_messages() as $msg) { $append_log .= " ".rtrim($msg)."\r\n"; } } elseif (is_array($err) && 'error' == $err['level']) { $append_log .= "* ".rtrim($err['message'])."\r\n"; } elseif (is_string($err)) { $append_log .= "* ".rtrim($err)."\r\n"; } $error_count++; } $append_log .="\r\n"; $backup_status = __('Unsuccessful due to number of errors', 'updraftplus'); } $warnings = (isset($jobdata['warnings'])) ? $jobdata['warnings'] : array(); if (is_array($warnings) && count($warnings) >0) { if ('finished' == $jobdata['jobstatus'] && 0 == $this->error_count()) { $append_log .= __('Warnings encountered (note: this is for information; the backup has completed successfully)', 'updraftplus')."\r\n"; } else { $append_log .= __('Warnings encountered:', 'updraftplus')."\r\n"; } $attachments[0] = $this->logfile_name; foreach ($warnings as $err) { $append_log .= "* ".rtrim($err)."\r\n"; } $append_log .="\r\n"; if (0 == $this->error_count()) $backup_status = __('Successful with warnings', 'updraftplus'); } if ($debug_mode && '' != $this->logfile_name && !in_array($this->logfile_name, $attachments)) { $append_log .= "\r\n".__('The log file has been attached to this email.', 'updraftplus'); $attachments[0] = $this->logfile_name; } // We have to use the action in order to set the MIME type on the attachment - by default, WordPress just puts application/octet-stream $subject = apply_filters('updraft_report_subject', sprintf(__('Backed up: %s', 'updraftplus'), wp_specialchars_decode(get_option('blogname'), ENT_QUOTES)).' (UpdraftPlus '.$this->version.') '.get_date_from_gmt(gmdate('Y-m-d H:i:s', time()), 'Y-m-d H:i').' - '.esc_html($backup_status), $error_count, count($warnings)); // The class_exists() check here is a micro-optimization to prevent a possible HTTP call whose results may be disregarded by the filter $feed = ''; if (!class_exists('UpdraftPlus_Addon_Reporting') && !defined('UPDRAFTPLUS_NOADS_B') && !defined('UPDRAFTPLUS_NONEWSFEED')) { $this->log('Fetching RSS news feed'); $rss = $this->get_updraftplus_rssfeed(); $this->log('Fetched RSS news feed; result is a: '.get_class($rss)); if (is_a($rss, 'SimplePie')) { $feed .= __('Email reports created by UpdraftPlus (free edition) bring you the latest TeamUpdraft.com news', 'updraftplus')." - "; /* translators: %s: The TeamUpdraft news URL / $feed .= sprintf(__('read more at %s', 'updraftplus'), 'https://teamupdraft.com/blog/')."\r\n\r\n"; $i = 0; foreach ($rss->get_items(0, 20) as $item) { $item_title = $item->get_title(); $item_date = $item->get_date('j F Y'); if ($i >= 6) break; if (empty($item_title)) continue; $feed .= ' '; $feed .= $item_title; if (!empty($item_date)) $feed .= " (".$item_date.")"; // $feed .= ' - '.$item->get_permalink(); $feed .= "\r\n"; $i++; } } $feed .= "\r\n\r\n"; } $extra_messages = apply_filters('updraftplus_report_extramessages', array()); $extra_msg = ''; if (is_array($extra_messages)) { foreach ($extra_messages as $msg) { $extra_msg .= '<strong>'.$msg['key'].'</strong>: '.$msg['val']."\r\n"; } } foreach ($this->remotestorage_extrainfo as $service => $message) { if (!empty($this->backup_methods[$service])) $extra_msg .= $this->backup_methods[$service].': '.$message['plain']."\r\n"; } // Make it available to the filter $jobdata['remotestorage_extrainfo'] = $this->remotestorage_extrainfo; if (!class_exists('UpdraftPlus_Notices')) updraft_try_include_file('includes/updraftplus-notices.php', 'include_once'); global $updraftplus_notices; $ws_notice = $updraftplus_notices->do_notice(false, 'report-plain', true); $body = apply_filters('updraft_report_body', __('Backup of:', 'updraftplus').' '.site_url()."\r\n". "UpdraftPlus ".__('WordPress backup is complete', 'updraftplus').".\r\n". __('Backup contains:', 'updraftplus')." $backup_contains\r\n". __('Latest status:', 'updraftplus').' '.$final_message."\r\n". $extra_msg. "\r\n". $feed. $ws_notice."\r\n". $append_log, $final_message, $backup_contains, $this->errors, $warnings, $jobdata); $this->attachments = apply_filters('updraft_report_attachments', $attachments); $attach_size = 0; $unlink_files = array(); foreach ($this->attachments as $ind => $attach) { if ($attach == $this->logfile_name && filesize($attach) > 61048576) { $this->log("Log file is large (".round(filesize($attach)/1024, 1)." KB): will compress before e-mailing"); if (!$handle = fopen($attach, "r")) { $this->log("Error: Failed to open log file for reading: ".$attach); } else { if (!$whandle = gzopen($attach.'.gz', 'w')) { $this->log("Error: Failed to open log file for reading: ".$attach.".gz"); } else { while (false !== ($line = @stream_get_line($handle, 131072, "\n"))) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. @gzwrite($whandle, $line."\n");// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } fclose($handle); gzclose($whandle); $this->attachments[$ind] = $attach.'.gz'; $unlink_files[] = $attach.'.gz'; } } } $attach_size += filesize($this->attachments[$ind]); } foreach ($sendmail_to as $ind => $mailto) { if (false === apply_filters('updraft_report_sendto', true, $mailto, $error_count, count($warnings), $ind)) continue; foreach (explode(',', $mailto) as $sendmail_addr) { // if the address is a URL then instead of emailing it, POST it to slack if (preg_match('/^https?:\/\//i', $sendmail_addr)) { $this->log("Sending to (URL) ('$backup_contains') report (attachments: ".count($attachments).", size: ".round($attach_size/1024, 1)." KB) to: ".substr($sendmail_addr, 0, 5)."..."); $this->post_results_slack($subject, $body, trim($sendmail_addr), $this->file_nonce); } else { $this->log("Sending email ('$backup_contains') report (attachments: ".count($attachments).", size: ".round($attach_size/1024, 1)." KB) to: ".substr($sendmail_addr, 0, 5)."..."); $headers = array(); try { $headers[] = "X-UpdraftPlus-Backup-ID: ".$this->nonce; $from_email = apply_filters('updraftplus_email_from_header', $this->get_email_from_header()); $from_name = apply_filters('updraftplus_email_from_name_header', $this->get_email_from_name_header()); $use_wp_from_name_filter = '' === $from_email; // Notice that we don't use the 'wp_mail_from' filter, but only the 'From:' header to set sender name and sender email address, the reason behind it is that some SMTP plugins override the "wp_mail()" function and they do anything they want inside their own "wp_mail()" function, including not to call the php_mailer filter nor the wp_mail_from and wp_mail_from_name filters, but since the function signature remain the same as the WP one, so they may evaluate and do something with the header parameter if (!$use_wp_from_name_filter) { $headers[] = sprintf('From: %s <%s>', $from_name, $from_email); } else { add_filter('wp_mail_from_name', array($this, 'get_email_from_name_header'), 9); } add_action('wp_mail_failed', array($this, 'log_email_delivery_failure')); wp_mail(trim($sendmail_addr), $subject, $body, $headers, is_array($this->attachments) ? $this->attachments : array()); remove_action('wp_mail_failed', array($this, 'log_email_delivery_failure')); if ($use_wp_from_name_filter) remove_filter('wp_mail_from_name', array($this, 'get_email_from_name_header'), 9); } catch (Exception $e) { $this->log("Exception occurred when sending mail (".get_class($e)."): ".$e->getMessage()); } } } } foreach ($unlink_files as $file) @unlink($file);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. do_action('updraft_report_finished'); } /* * Log the email delivery failure to the log file when a PHPMailer exception is caught * * @param WP_Error $error A WP_Error object with the PHPMailer\PHPMailer\Exception message, and an array containing the mail recipient, subject, message, headers, and attachments. / public function log_email_delivery_failure($error) { $this->log("An error occurred when sending a backup report email and/or backup file(s) via email (".$error->get_error_code()."): ".$error->get_error_message()); } /* * Check whether the provided admin_email is under the same domain with the site, and use it as a sender email to increase the chance of an email being sent successfully (if appropriate) * * @return String The admin email address if it's found to be in same domain, an empty string otherwise / public function get_email_from_header() { $sitename = $this->get_site_name(); $admin_email = get_bloginfo('admin_email'); $admin_email_domain = preg_replace('/^[^@]+@(.+)$/', "$1", $admin_email); if (trim(strtolower($sitename)) === trim(strtolower($admin_email_domain))) { // assuming (non validating) that the email account of the admin email does exist, and the admin email is under the same domain as with the web domain and the domain exists and live as well return $admin_email; } return ''; } /* * Build sender name and use something authentic that represents the identity of the plugin and web domain * * @return String The sender name / public function get_email_from_name_header() { return sprintf(__('UpdraftPlus on %s', 'updraftplus'), $this->get_site_name()); } /* * Post backup report to slack instead of emailing if the address is a URL * * @param string $header report title * @param string $report_body report content * @param string $webhook_url url to post report * @param string $nval backup log file nonce * @return Void / public function post_results_slack($header, $report_body, $webhook_url, $nval) { $findcontent = __('The log file has been attached to this email.', 'updraftplus'); $report_body = str_replace($findcontent, '', $report_body); $url = admin_url(UpdraftPlus_Options::admin_page()."?page=updraftplus&action=downloadlog&updraftplus_backup_nonce=$nval"); $response = wp_remote_post($webhook_url, array( 'method' => 'POST', 'headers' => array(), 'body' => json_encode(array( 'blocks' => array( array( 'type' => 'header', 'text' => array( 'type' => 'plain_text', 'text' => $header, 'emoji' => true ), ), array( 'type' => 'section', 'text' => array( 'type' => 'mrkdwn', 'text' => $report_body ), ), array( 'type' => 'section', 'text' => array( 'type' => 'mrkdwn', 'text' => __('You can view the log by pressing the \'View log\' button.', 'updraftplus') ), 'accessory' => array( 'type' => 'button', 'text' => array( 'type' => 'plain_text', 'text' => __('View log', 'updraftplus'), 'emoji' => true ), 'value' => 'view_log_123', 'url' => $url, 'action_id' => 'button-action' ) ), ) )) )); if (!is_wp_error($response)) { $response_code = wp_remote_retrieve_response_code($response); if ($response_code < 200 \|\| $response_code >= 300) { $this->log('HTTP POST error : '.$response_code.' - '.wp_remote_retrieve_response_message($response)); } } else { $this->log('HTTP POST error : '.$response->get_error_code().' - '.$response->get_error_message()); } } /* * This function returns 'true' if mod_rewrite could be detected as unavailable; a 'false' result may mean it just couldn't find out the answer * * @param boolean $check_if_in_use_first * @return boolean / public function mod_rewrite_unavailable($check_if_in_use_first = true) { if (function_exists('apache_get_modules')) { global $wp_rewrite; $mods = apache_get_modules(); if ((!$check_if_in_use_first \|\| $wp_rewrite->using_mod_rewrite_permalinks()) && ((in_array('core', $mods) \|\| in_array('http_core', $mods)) && !in_array('mod_rewrite', $mods))) { return true; } } return false; } /* * Count the number of alerts that have occurred at the specified level * * @param String $level - the level to count at * * @return Integer / public function error_count($level = 'error') { $count = 0; foreach ($this->errors as $err) { if (('error' == $level && (is_string($err) \|\| is_wp_error($err))) \|\| (is_array($err) && $level == $err['level'])) { $count++; } } return $count; } public function list_errors() { echo '<ul style="list-style: disc inside;">'; foreach ($this->errors as $err) { if (is_wp_error($err)) { foreach ($err->get_error_messages() as $msg) { echo '<li>'.esc_html($msg).'<li>'; } } elseif (is_array($err) && ('error' == $err['level'] \|\| 'warning' == $err['level'])) { echo "<li>".esc_html($err['message'])."</li>"; } elseif (is_string($err)) { echo "<li>".esc_html($err)."</li>"; } else { print "<li>".esc_html(print_r($err, true))."</li>"; } } echo '</ul>'; } /* * Save last successful backup information * * @param Array $backup_array An array of backup information / private function save_last_backup($backup_array) { $success = (0 == $this->error_count()) ? 1 : 0; $last_backup = UpdraftPlus_Options::get_updraft_option('updraft_last_backup', array()); if (empty($last_backup)) $last_backup = array(); if ('incremental' === $this->jobdata_get('job_type')) { $last_backup['incremental_backup_time'] = $this->backup_time; // the incremental_backup_time index is used only for storing time of the incremental job type } else { $last_backup['nonincremental_backup_time'] = $this->backup_time; // otherwise the nonincremental_backup_time index is for the backup job type } $last_backup = wp_parse_args(array( 'backup_time' => $this->backup_time, // the backup_time index is used for storing either time of backup or incremental job type 'backup_array' => $backup_array, 'success' => $success, 'errors' => $this->errors, 'backup_nonce' => $this->nonce ), $last_backup); $last_backup = apply_filters('updraftplus_save_last_backup', $last_backup); UpdraftPlus_Options::update_updraft_option('updraft_last_backup', $last_backup, false); } /* * $handle must be either false or a WPDB class (or extension thereof). Other options are not yet fully supported. * * @param Resource\|Boolean\|Object $handle * @param Boolean $log_it - whether to log information about the check * @param Boolean $reschedule - whether to schedule a resumption if checking fails * @param Boolean $allow_bail - whether to allow the connection to fail or throw an error * @return Boolean\|Integer - whether the check succeeded, or -1 for an unknown result / public function check_db_connection($handle = false, $log_it = false, $reschedule = false, $allow_bail = false) { $type = false; if (false === $handle \|\| is_a($handle, 'wpdb')) { $type = 'wpdb'; } elseif (is_resource($handle)) { // Expected: string(10) "mysql link" $type = get_resource_type($handle); } elseif (is_object($handle) && is_a($handle, 'mysqli')) { $type = 'mysqli'; } if (false === $type) return -1; $db_connected = -1; if ('mysql link' == $type \|\| 'mysqli' == $type) { if ('mysql link' == $type && @mysql_ping($handle)) return true;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged, PHPCompatibility.Extensions.RemovedExtensions.mysql_DeprecatedRemoved -- Needed to add this as the old ignores no longer work if ('mysqli' == $type && @mysqli_ping($handle)) return true;// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. for ($tries = 1; $tries <= 5; $tries++) { // to do, if ever needed // if ($this->db_connect(false )) return true; // sleep(1); } } elseif ('wpdb' == $type) { if (false === $handle \|\| (is_object($handle) && 'wpdb' == get_class($handle))) { global $wpdb; $handle = $wpdb; } if (method_exists($handle, 'check_connection') && (!defined('UPDRAFTPLUS_SUPPRESS_CONNECTION_CHECKS') \|\| !UPDRAFTPLUS_SUPPRESS_CONNECTION_CHECKS)) { if (!$handle->check_connection($allow_bail)) { if ($log_it) $this->log("The database went away, and could not be reconnected to"); // Almost certainly a no-op if ($reschedule) UpdraftPlus_Job_Scheduler::reschedule(60); $db_connected = false; } else { $db_connected = true; } } } return $db_connected; } /* * This should be called whenever a file is successfully uploaded * * @param String $file - full filepath * @param Boolean $force - mark as successfully uploaded even if not on the last service * @return Void / public function uploaded_file($file, $force = false) { global $updraftplus_backup; $db_connected = $this->check_db_connection(false, true, true); $service = empty($updraftplus_backup->current_service) ? '' : $updraftplus_backup->current_service; $instance_id = empty($updraftplus_backup->current_instance) ? '' : $updraftplus_backup->current_instance; $shash = $service.(('' == $service) ? '' : '-').$instance_id.(('' == $instance_id) ? '' : '-').md5($file); if ($force \|\| !empty($updraftplus_backup->last_storage_instance)) { $this->log("Recording as successfully uploaded: $file"); $new_jobdata = $this->get_uploaded_jobdata_items($file, $service, $instance_id); } else { $new_jobdata = array('uploaded_'.$shash => 'yes'); $this->log("Recording as successfully uploaded: $file (".$updraftplus_backup->current_service.", more services to follow)"); } $upload_status = $this->jobdata_get('uploading_substatus'); if (is_array($upload_status) && isset($upload_status['i'])) { $upload_status['i']++; $upload_status['p'] = 0; $new_jobdata['uploading_substatus'] = $upload_status; } $this->jobdata_set_multi($new_jobdata); // Really, we could do this immediately when we realise the DB has gone away. This is just for the probably-impossible case that a DB write really can still succeed. But, we must abort before calling delete_local(), as the removal of the local file can cause it to be recreated if the DB is out of sync with the fact that it really is already uploaded if (false === $db_connected) { UpdraftPlus_Job_Scheduler::record_still_alive(); die; } // Delete local files immediately if the option is set // Where we are only backing up locally, only the "prune" function should do deleting $service = $this->jobdata_get('service'); if (!empty($updraftplus_backup->last_storage_instance) && ('' !== $service && ((is_array($service) && count($service)>0 && (count($service) > 1 \|\| (array('') !== $service && array('none') !== $service))) \|\| (is_string($service) && 'none' !== $service)))) { $this->delete_local($file); } } /* * Gets the jobdata items to be added to mark a file as uploaded * * @param String $file - the file (basename) * @param String $service - service identifier * @param String $instance_id - instance identifier * * @return Array - jobdata items / public function get_uploaded_jobdata_items($file, $service = '', $instance_id = '') { $hash = md5($file); $shash = $service.(('' == $service) ? '' : '-').$instance_id.(('' == $instance_id) ? '' : '-').md5($file); return array( 'uploaded_lastreset' => $this->current_resumption, 'uploaded_'.$hash => 'yes', 'uploaded_'.$shash =>'yes' ); } /* * Return whether a particular file has been uploaded to a particular remote service * * @param String $file - the filename (basename) * @param String $service - the service identifier; or none, to indicate all services * @param String $instance_id - the instance identifier * * @return Boolean - the result / public function is_uploaded($file, $service = '', $instance_id = '') { $hash = $service.(('' == $service) ? '' : '-').$instance_id.(('' == $instance_id) ? '' : '-').md5($file); return ('yes' === $this->jobdata_get("uploaded_$hash")) ? true : false; } /* * This function will mark the passed in service and instance id upload as complete * * @param String $service - the service identifier * @param String $instance_id - the instance identifier * * @return void / public function mark_upload_complete($service, $instance_id = '') { $upload_completed = $this->jobdata_get('upload_completed', array()); if (empty($instance_id)) { $upload_completed[$service] = 1; } else { if (!is_array($upload_completed[$service])) $upload_completed[$service] = array(); $upload_completed[$service][$instance_id] = 1; } $this->jobdata_set('upload_completed', $upload_completed); } /* * This function will check all the remote storage options for this job and ensure that each has completed the upload, if they have mark them as done if they have not completed then call upload_completed() for that service if it exists, otherwise mark as complete. * * @return boolean / private function check_upload_completed() { $job_services = $this->jobdata_get('service'); $services = $this->get_canonical_service_list($job_services); $sent_to_cloud = empty($services) ? false : true; if (!$sent_to_cloud) return; $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_storage_objects_and_ids($services); foreach ($services as $service) { if ('email' == $service \|\| 'none' == $service \|\| !$service) continue; $remote_obj = $storage_objects_and_ids[$service]['object']; $upload_completed = $this->jobdata_get('upload_completed', array()); if (isset($upload_completed[$service]) && !is_array($upload_completed[$service])) continue; if (!empty($remote_obj) && !$remote_obj->supports_feature('multi_options')) { if (is_callable(array($remote_obj, 'upload_completed'))) { $result = $remote_obj->upload_completed(); if ($result) $this->mark_upload_complete($service); } else { $this->mark_upload_complete($service); } } elseif (!empty($storage_objects_and_ids[$service]['instance_settings'])) { foreach ($storage_objects_and_ids[$service]['instance_settings'] as $instance_id => $options) { if (isset($upload_completed[$service][$instance_id])) continue; $remote_obj->set_options($options, true, $instance_id); if (is_callable(array($remote_obj, 'upload_completed'))) { $remote_obj->upload_completed(); } else { $this->mark_upload_complete($service, $instance_id); } } } } } /* * This function will check if the passed-in file is this job's responsibility to upload. Potentially files can belong to a different job, when running an incremental backup run * * @param String $file - the name of the file * @param String $type - the file entity type (db, plugins, themes etc) * * @return boolean - whether this is a file this job should upload (at some point) / private function is_ours_to_upload($file, $type) { if ('db' == $type) return false; $previous_backup_files_array = $this->jobdata_get('previous_backup_files_array', array()); if (isset($previous_backup_files_array[$type]) && in_array($file, $previous_backup_files_array[$type])) return false; return true; } private function delete_local($file) { $log = "Deleting local file: $file: "; if (UpdraftPlus_Options::get_updraft_option('updraft_delete_local', 1)) { $fullpath = $this->backups_dir_location().'/'.$file; // check to make sure it exists before removing if (realpath($fullpath)) { $deleted = unlink($fullpath); $this->log($log.(($deleted) ? 'OK' : 'failed')); return $deleted; } } else { $this->log($log."skipped: user has unchecked updraft_delete_local option"); } return true; } /* * For detecting another run, and aborting if one was found * * @param String $file - full file path of the file to check / public function check_recent_modification($file) { if (file_exists($file)) { $time_mod = (int) @filemtime($file);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $time_now = time(); if ($time_mod > 100 && ($time_now - $time_mod) < 30) { UpdraftPlus_Job_Scheduler::terminate_due_to_activity($file, $time_now, $time_mod); } } } public function get_exclude($whichone) { if ('uploads' == $whichone) { $exclude = explode(',', UpdraftPlus_Options::get_updraft_option('updraft_include_uploads_exclude', UPDRAFT_DEFAULT_UPLOADS_EXCLUDE)); } elseif ('others' == $whichone) { $exclude = explode(',', UpdraftPlus_Options::get_updraft_option('updraft_include_others_exclude', UPDRAFT_DEFAULT_OTHERS_EXCLUDE)); } else { $exclude = apply_filters('updraftplus_include_'.$whichone.'_exclude', array()); } return (empty($exclude) \|\| !is_array($exclude)) ? array() : $exclude; } public function wp_upload_dir() { if (is_multisite()) { global $current_site; switch_to_blog($current_site->blog_id); } $wp_upload_dir = wp_upload_dir(); if (is_multisite()) restore_current_blog(); return $wp_upload_dir; } public function backup_uploads_dirlist($log_it = false) { // Create an array of directories to be skipped // Make the values into the keys $exclude = UpdraftPlus_Options::get_updraft_option('updraft_include_uploads_exclude', UPDRAFT_DEFAULT_UPLOADS_EXCLUDE); if ($log_it) $this->log("Exclusion option setting (uploads): ".$exclude); $skip = array_flip(preg_split("/,/", $exclude)); $wp_upload_dir = $this->wp_upload_dir(); $uploads_dir = $wp_upload_dir['basedir']; return $this->compile_folder_list_for_backup($uploads_dir, array(), $skip); } public function backup_others_dirlist($log_it = false) { // Create an array of directories to be skipped // Make the values into the keys $exclude = UpdraftPlus_Options::get_updraft_option('updraft_include_others_exclude', UPDRAFT_DEFAULT_OTHERS_EXCLUDE); if ($log_it) $this->log("Exclusion option setting (others): ".$exclude); $skip = array_flip(preg_split("/,/", $exclude)); $file_entities = $this->get_backupable_file_entities(false); // Keys = directory names to avoid; values = the label for that directory (used only in log files) // $avoid_these_dirs = array_flip($file_entities); $avoid_these_dirs = array(); foreach ($file_entities as $type => $dirs) { if (is_string($dirs)) { $avoid_these_dirs[$dirs] = $type; } elseif (is_array($dirs)) { foreach ($dirs as $dir) { $avoid_these_dirs[$dir] = $type; } } } return $this->compile_folder_list_for_backup(WP_CONTENT_DIR, $avoid_these_dirs, $skip); } /* * avoid_these_dirs and skip_these_dirs ultimately do the same thing; but avoid_these_dirs takes full paths whereas skip_these_dirs takes basenames; and they are logged differently (dirs in avoid_these_dirs are potentially dangerous to include; skip is just a user-level preference). They are allowed to overlap. * * @param String $backup_from_inside_dir * @param Array $avoid_these_dirs * @param Array $skip_these_dirs * * @return Array / public function compile_folder_list_for_backup($backup_from_inside_dir, $avoid_these_dirs, $skip_these_dirs) { // Entries in $skip_these_dirs are allowed to end in , which means "and anything else as a suffix". It's not a full shell glob, but it covers what is needed to-date. $dirlist = array(); $added = 0; $log_skipped = 0; $log_skipped_last = ''; $this->log('Looking for candidates to backup in: '.$backup_from_inside_dir); $updraft_dir = $this->backups_dir_location(); if (is_file($backup_from_inside_dir)) { array_push($dirlist, $backup_from_inside_dir); $added++; $this->log("finding files: $backup_from_inside_dir: adding to list ($added)"); } elseif ($handle = opendir($backup_from_inside_dir)) { while (false !== ($entry = readdir($handle))) { if ('.' == $entry \|\| '..' == $entry) continue; // $candidate: full path; $entry = one-level $candidate = $backup_from_inside_dir.'/'.$entry; if (isset($avoid_these_dirs[$candidate])) { $this->log("finding files: $entry: skipping: this is the ".$avoid_these_dirs[$candidate]." directory"); } elseif ($candidate == $updraft_dir) { $this->log("finding files: $entry: skipping: this is the updraft directory"); } elseif (isset($skip_these_dirs[$entry])) { $this->log("finding files: $entry: skipping: excluded by options"); } else { $add_to_list = true; // Now deal with entries in $skip_these_dirs ending in * or starting with * foreach ($skip_these_dirs as $skip => $sind) { if ('' == substr($skip, -1, 1) && '' == substr($skip, 0, 1) && strlen($skip) > 2) { if (strpos($entry, substr($skip, 1, strlen($skip)-2)) !== false) { $this->log("finding files: $entry: skipping: excluded by options (glob)"); $add_to_list = false; } } elseif ('' == substr($skip, -1, 1) && strlen($skip) > 1) { if (substr($entry, 0, strlen($skip)-1) == substr($skip, 0, strlen($skip)-1)) { $this->log("finding files: $entry: skipping: excluded by options (glob)"); $add_to_list = false; } } elseif ('' == substr($skip, 0, 1) && strlen($skip) > 1) { if (strlen($entry) >= strlen($skip)-1 && substr($entry, (strlen($skip)-1)-1) == substr($skip, 1)) { $this->log("finding files: $entry: skipping: excluded by options (glob)"); $add_to_list = false; } } } if ($add_to_list) { array_push($dirlist, $candidate); $added++; if ($added > 500) { if ($log_skipped >= 500) { $this->log("finding files: $entry: adding to list ($added, $log_skipped log lines skipped)"); $log_skipped = 0; $log_skipped_last = ''; } else { $log_skipped++; $log_skipped_last = $entry; } } else { $skip_dblog = (($added > 50 && 0 != $added % 100) \|\| ($added > 2000 && 0 != $added % 500)); $this->log("finding files: $entry: adding to list ($added)", 'notice', false, $skip_dblog); } } } } @closedir($handle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if ($log_skipped > 0) { $this->log("finding files: $log_skipped_last: adding to list ($added, last; $log_skipped log lines skipped)"); } } else { $this->log('ERROR: Could not read the directory: '.$backup_from_inside_dir); $this->log(__('Could not read the directory', 'updraftplus').': '.$backup_from_inside_dir, 'error'); } return $dirlist; } /* * Save the backup information to the backup history during a running backup (adding information to the currently-running job) * * @param Array $backup_array - the backup history / private function save_backup_to_history($backup_array) { if (!is_array($backup_array)) { $this->log('Could not save backup history because we have no backup array. Backup probably failed.'); $this->log(__('Could not save backup history because we have no backup array.', 'updraftplus').' '.__('Backup probably failed.', 'updraftplus'), 'error'); return; } $job_type = $this->jobdata_get('job_type'); $backup_array['nonce'] = $this->file_nonce; $backup_array['service'] = $this->jobdata_get('service'); $backup_array['service_instance_ids'] = array(); if ('incremental' != $job_type) $backup_array['always_keep'] = $this->jobdata_get('always_keep', false); $backup_array['files_enumerated_at'] = $this->jobdata_get('files_enumerated_at'); $remote_storage_instances = $this->jobdata_get('remote_storage_instances', array()); // N.B. Though the saved 'service' option can have various forms (especially if upgrading from (very) old versions), in the jobdata, it is always an array. $storage_objects_and_ids = UpdraftPlus_Storage_Methods_Interface::get_enabled_storage_objects_and_ids($backup_array['service'], $remote_storage_instances); // N.B. On PHP 5.5+, we'd use array_column() foreach ($storage_objects_and_ids as $method => $method_information) { if ('none' == $method \|\| !$method \|\| !$method_information['object']->supports_feature('multi_options')) continue; $backup_array['service_instance_ids'][$method] = array_keys($method_information['instance_settings']); } if ('incremental' != $job_type && '' != ($label = $this->jobdata_get('label', ''))) $backup_array['label'] = $label; if (!isset($backup_array['created_by_version'])) $backup_array['created_by_version'] = $this->version; $backup_array['last_saved_by_version'] = $this->version; $backup_array['is_multisite'] = is_multisite() ? true : false; $remotesend_info = $this->jobdata_get('remotesend_info'); if (is_array($remotesend_info) && !empty($remotesend_info['url'])) $backup_array['remotesend_url'] = $remotesend_info['url']; if (false != $this->jobdata_get('is_autobackup', false)) $backup_array['autobackup'] = true; if (false != ($morefiles_linked_indexes = $this->jobdata_get('morefiles_linked_indexes', false))) $backup_array['morefiles_linked_indexes'] = $morefiles_linked_indexes; if (false != ($morefiles_more_locations = $this->jobdata_get('morefiles_more_locations', false))) $backup_array['morefiles_more_locations'] = $morefiles_more_locations; UpdraftPlus_Backup_History::save_backup(apply_filters('updraftplus_save_backup_history_timestamp', $this->backup_time), $backup_array); } /* * If files + db are on different schedules but are scheduled for the same time, * then combine them $event = (object) array('hook' => $hook, 'timestamp' => $timestamp, 'schedule' => $recurrence, 'args' => $args, 'interval' => $schedules[$recurrence]['interval']); * See wp_schedule_single_event() and wp_schedule_event() in wp-includes/cron.php * * @param Object\|Boolean $event - the event being scheduled * @return Object\|Boolean - the filtered value / public function schedule_event($event) { static $scheduled = array(); if (is_object($event) && ('updraft_backup' == $event->hook \|\| 'updraft_backup_database' == $event->hook)) { // Reset the option - but make sure it is saved first so that we can used it (since this hook may be called just before our actual cron task) $this->combine_jobs_around = UpdraftPlus_Options::get_updraft_option('updraft_combine_jobs_around'); UpdraftPlus_Options::delete_updraft_option('updraft_combine_jobs_around'); $scheduled[$event->hook] = true; // This next fragment is wrong: there's only a 'second call' when saving all settings; otherwise, the WP scheduler might just be updating one event. So, there's some inefficieny as the option is wiped and set uselessly at least once when saving settings. // We only want to take action on the second call (otherwise, our information is out-of-date already) // If there is no second call, then that's fine - nothing to do // if (count($scheduled) < 2) { // return $event; // } $backup_scheduled_for = ('updraft_backup' == $event->hook) ? $event->timestamp : wp_next_scheduled('updraft_backup'); $db_scheduled_for = ('updraft_backup_database' == $event->hook) ? $event->timestamp : wp_next_scheduled('updraft_backup_database'); $diff = absint($backup_scheduled_for - $db_scheduled_for); $margin = (defined('UPDRAFTPLUS_COMBINE_MARGIN') && is_numeric(UPDRAFTPLUS_COMBINE_MARGIN)) ? UPDRAFTPLUS_COMBINE_MARGIN : 600; if ($backup_scheduled_for && $db_scheduled_for && $diff < $margin) { // We could change the event parameters; however, this would complicate other code paths (because the WP cron system uses a hash of the parameters as a key, and you must supply the exact parameters to look up events). So, we just set a marker that boot_backup() can pick up on. UpdraftPlus_Options::update_updraft_option('updraft_combine_jobs_around', min($backup_scheduled_for, $db_scheduled_for)); } } return $event; } /* * This function is both the backup scheduler and a filter callback for saving the option. It is called in the register_setting for the updraft_interval, which means when the admin settings are saved it is called. * * @param String $interval * @return String - filtered value / public function schedule_backup($interval) { $previous_time = wp_next_scheduled('updraft_backup'); // Clear schedule so that we don't stack up scheduled backups wp_clear_scheduled_hook('updraft_backup'); if ('manual' == $interval) { // Clear increments schedule as the file schedule is manual wp_clear_scheduled_hook('updraft_backup_increments'); return 'manual'; } $previous_interval = UpdraftPlus_Options::get_updraft_option('updraft_interval'); $valid_schedules = wp_get_schedules(); if (empty($valid_schedules[$interval])) $interval = 'daily'; // Try to avoid changing the time is one was already scheduled. This is fairly conservative - we could do more, e.g. check if a backup already happened today. $default_time = ($interval == $previous_interval && $previous_time>0) ? $previous_time : $this->random_schedule_time(); $first_time = apply_filters('updraftplus_schedule_firsttime_files', $default_time); wp_schedule_event($first_time, $interval, 'updraft_backup'); return $interval; } /* * This function is both the database backup scheduler and a filter callback for saving the option. It is called in the register_setting for the updraft_interval_database, which means when the admin settings are saved it is called. * * @param String $interval * @return String - filtered value / public function schedule_backup_database($interval) { $previous_time = wp_next_scheduled('updraft_backup_database'); // Clear schedule so that we don't stack up scheduled backups wp_clear_scheduled_hook('updraft_backup_database'); if ('manual' == $interval) return 'manual'; $previous_interval = UpdraftPlus_Options::get_updraft_option('updraft_interval_database'); $valid_schedules = wp_get_schedules(); if (empty($valid_schedules[$interval])) $interval = 'daily'; // Try to avoid changing the time is one was already scheduled. This is fairly conservative - we could do more, e.g. check if a backup already happened today. $default_time = ($interval == $previous_interval && $previous_time>0) ? $previous_time : $this->random_schedule_time(); $first_time = apply_filters('updraftplus_schedule_firsttime_db', $default_time); wp_schedule_event($first_time, $interval, 'updraft_backup_database'); return $interval; } /* * This function is both the increments backup scheduler and a filter callback for saving the option. It is called in the register_setting for the updraft_interval_increments, which means when the admin settings are saved it is called. * * @param String $interval * @return String - filtered value / public function schedule_backup_increments($interval) { $previous_time = wp_next_scheduled('updraft_backup_increments'); // Clear schedule so that we don't stack up scheduled backups wp_clear_scheduled_hook('updraft_backup_increments'); if ('none' == $interval \|\| empty($interval)) return 'none'; $previous_interval = UpdraftPlus_Options::get_updraft_option('updraft_interval_increments'); $valid_schedules = wp_get_schedules(); if (empty($valid_schedules[$interval])) $interval = 'daily'; // Try to avoid changing the time is one was already scheduled. This is fairly conservative - we could do more, e.g. check if a backup already happened today. $default_time = ($interval == $previous_interval && $previous_time>0) ? $previous_time : time()+120; $first_time = apply_filters('updraftplus_schedule_firsttime_increments', $default_time); wp_schedule_event($first_time, $interval, 'updraft_backup_increments'); return $interval; } /* * This function will generate a random backup schedule timestamp between the hours of 9PM and 7AM and return it * * @return string - the random timestamp / private function random_schedule_time() { static $scheduled_timestamp = false; if ($scheduled_timestamp) return $scheduled_timestamp; $valid_hours = array(21, 22, 23, 0, 1, 2, 3, 4, 5, 6, 7); $current_hour = current_time('G'); $current_timestamp = current_time('timestamp'); if (in_array($current_hour, $valid_hours)) { $scheduled_timestamp = $current_timestamp; } else { $scheduled_timestamp = $current_timestamp + 43200; } return $scheduled_timestamp; } /* * Acts as a WordPress options filter * * @param Array $options - An array of options * @param String $option_name - The option name * * @return Array - the returned array can either be the set of updated options or a WordPress error array / public function storage_options_filter($options, $option_name) { if ('updraft_' !== substr($option_name, 0, 8)) return $options; $method = substr($option_name, 8); $storage = UpdraftPlus_Storage_Methods_Interface::get_storage_object($method); if (!is_a($storage, 'UpdraftPlus_BackupModule') \|\| !is_callable(array($storage, 'options_filter'))) return $options; return call_user_func(array($storage, 'options_filter'), $options); } /* * Get the location of UD's internal directory * * @param Boolean $allow_cache * @return String - the directory path. Returns without any trailing slash. / public function backups_dir_location($allow_cache = true) { if ($allow_cache && !empty($this->backup_dir)) return $this->backup_dir; $updraft_dir = UpdraftPlus_Options::get_updraft_option('updraft_dir'); if (!is_string($updraft_dir)) $updraft_dir = ''; $updraft_dir = untrailingslashit($updraft_dir); // When newly installing, if someone had (e.g.) wp-content/updraft in their database from a previous, deleted pre-1.7.18 install but had removed the updraft directory before re-installing, without this fix they'd end up with wp-content/wp-content/updraft. if (preg_match('/^wp-content\/(.)$/', $updraft_dir, $matches) && ABSPATH.'wp-content' === WP_CONTENT_DIR) { UpdraftPlus_Options::update_updraft_option('updraft_dir', $matches[1]); $updraft_dir = WP_CONTENT_DIR.'/'.$matches[1]; } // Default if (!$updraft_dir) $updraft_dir = WP_CONTENT_DIR.'/updraft'; // Do a test for a relative path if ('/' != substr($updraft_dir, 0, 1) && "\\" != substr($updraft_dir, 0, 1) && !preg_match('/^[a-zA-Z]:/', $updraft_dir)) { // Legacy - file paths stored related to ABSPATH if (is_dir(ABSPATH.$updraft_dir) && is_file(ABSPATH.$updraft_dir.'/index.html') && is_file(ABSPATH.$updraft_dir.'/.htaccess') && !is_file(ABSPATH.$updraft_dir.'/index.php') && false !== strpos(file_get_contents(ABSPATH.$updraft_dir.'/.htaccess', false, null, 0, 20), 'deny from all')) { $updraft_dir = ABSPATH.$updraft_dir; } else { // File paths stored relative to WP_CONTENT_DIR $updraft_dir = trailingslashit(WP_CONTENT_DIR).$updraft_dir; } } // Check for the existence of the dir and prevent enumeration // index.php is for a sanity check - make sure that we're not somewhere unexpected if ((!is_dir($updraft_dir) \|\| !is_file($updraft_dir.'/index.html') \|\| !is_file($updraft_dir.'/.htaccess')) && !is_file($updraft_dir.'/index.php') \|\| !is_file($updraft_dir.'/web.config')) { @mkdir($updraft_dir, 0775, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. @file_put_contents($updraft_dir.'/index.html', "<html><body><a href=\"https://updraftplus.com\" target=\"_blank\">WordPress backups by UpdraftPlus</a></body></html>");// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!is_file($updraft_dir.'/.htaccess')) @file_put_contents($updraft_dir.'/.htaccess', 'deny from all');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!is_file($updraft_dir.'/web.config')) @file_put_contents($updraft_dir.'/web.config', "<configuration>\n<system.webServer>\n<authorization>\n<deny users=\"\" />\n</authorization>\n</system.webServer>\n</configuration>\n");// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } $this->backup_dir = $updraft_dir; return $updraft_dir; } /* * This function will work out the total size of the passed in backup and return it. * * @param array $backup - an array of information about this backup set * * @return integer - the total size of the backup in bytes / public function get_total_backup_size($backup) { $backupable_entities = $this->get_backupable_file_entities(true, true); // Add the database to the entities array ready to loop over $backupable_entities['db'] = ''; $total_size = 0; foreach ($backup as $ekey => $files) { if (!isset($backupable_entities[$ekey])) continue; if (is_string($files)) $files = array($files); foreach ($files as $findex => $file) { $size_key = (0 == $findex) ? $ekey.'-size' : $ekey.$findex.'-size'; $total_size = (false === $total_size \|\| !isset($backup[$size_key]) \|\| !is_numeric($backup[$size_key])) ? false : $total_size + $backup[$size_key]; } } return $total_size; } public function spool_file($fullpath, $encryption = '') { if (function_exists('set_time_limit')) @set_time_limit(900);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. if (!file_exists($fullpath) \|\| filesize($fullpath) < 1) { esc_html_e('File not found', 'updraftplus'); return; } // Prevent any debug output // Don't enable this line - it causes 500 HTTP errors in some cases/hosts on some large files, for unknown reason // @ini_set('display_errors', '0'); if (UpdraftPlus_Encryption::is_file_encrypted($fullpath)) { if (ob_get_level()) { $flush_max = min(5, (int) ob_get_level()); for ($i=1; $i<=$flush_max; $i++) { @ob_end_clean();// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } } header("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1 header("Expires: Sat, 26 Jul 1997 05:00:00 GMT"); // Date in the past UpdraftPlus_Encryption::spool_crypted_file($fullpath, (string) $encryption); return; } $content_type = UpdraftPlus_Manipulation_Functions::get_mime_type_from_filename($fullpath, false); updraft_try_include_file('includes/class-partialfileservlet.php', 'include_once'); // Prevent the file being read into memory if (ob_get_level()) { $flush_max = min(5, (int) ob_get_level()); for ($i=1; $i<=$flush_max; $i++) { @ob_end_clean();// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } } if (ob_get_level()) @ob_end_clean(); // phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged --Twice - see HS#6673 - someone at least needed it if (isset($_SERVER['HTTP_RANGE'])) { $range_header = trim($_SERVER['HTTP_RANGE']); } elseif (function_exists('apache_request_headers')) { foreach (apache_request_headers() as $name => $value) { if (strtoupper($name) === 'RANGE') { $range_header = trim($value); } } } if (empty($range_header)) { header("Content-Length: ".filesize($fullpath)); header("Content-type: $content_type"); header("Content-Disposition: attachment; filename=\"".basename($fullpath)."\";"); readfile($fullpath); return; } try { $range_header = UpdraftPlus_RangeHeader::createFromHeaderString($range_header); $servlet = new UpdraftPlus_PartialFileServlet($range_header); $servlet->sendFile($fullpath, $content_type); } catch (UpdraftPlus_InvalidRangeHeaderException $e) { header("HTTP/1.1 400 Bad Request"); error_log("UpdraftPlus: UpdraftPlus_InvalidRangeHeaderException: ".$e->getMessage()); } catch (UpdraftPlus_UnsatisfiableRangeException $e) { header("HTTP/1.1 416 Range Not Satisfiable"); } catch (UpdraftPlus_NonExistentFileException $e) { header("HTTP/1.1 404 Not Found"); } catch (UpdraftPlus_UnreadableFileException $e) { header("HTTP/1.1 500 Internal Server Error"); } } public function just_one_email($input, $required = false) { $x = $this->just_one($input, 'saveemails', (empty($input) && false === $required) ? '' : get_bloginfo('admin_email')); if (is_array($x)) { foreach ($x as $ind => $val) { if (empty($val)) unset($x[$ind]); } if (empty($x)) $x = ''; } return $x; } /* * Filter the values down to just one (subject to being filtered) * * @param Array\|String $input - input * @param String $filter - filter suffix to use * @param Boolean\|String $rinput - a 'preferred' value (unless false) if no filtering is done * * @return Array\|String\|Null - output, after filtering / public function just_one($input, $filter = 'savestorage', $rinput = false) { $oinput = $input; if (false === $rinput) $rinput = is_array($input) ? array_pop($input) : $input; if (is_string($rinput) && false !== strpos($rinput, ',')) $rinput = substr($rinput, 0, strpos($rinput, ',')); return apply_filters('updraftplus_'.$filter, $rinput, $oinput); } /* * Enqueue the JavaScript and CSS for the select2 library / public function enqueue_select2() { // De-register to defeat any plugins that may have registered incompatible versions (e.g. WooCommerce 2.5 beta1 still has the Select 2 3.5 series) wp_deregister_script('select2'); wp_deregister_style('select2'); $select2_version = $this->use_unminified_scripts() ? '4.1.0-rc.0'.'.'.time() : '4.1.0-rc.0'; $min_or_not = $this->use_unminified_scripts() ? '' : '.min'; wp_enqueue_script('select2', UPDRAFTPLUS_URL."/includes/select2/select2".$min_or_not.".js", array('jquery'), $select2_version); wp_enqueue_style('select2', UPDRAFTPLUS_URL."/includes/select2/select2".$min_or_not.".css", array(), $select2_version); } public function memory_check_current($memory_limit = false) { // Returns in megabytes if (false == $memory_limit) $memory_limit = ini_get('memory_limit'); $memory_limit = rtrim($memory_limit); $memory_unit = $memory_limit[strlen($memory_limit)-1]; if (0 == (int) $memory_unit && '0' !== $memory_unit) { $memory_limit = substr($memory_limit, 0, strlen($memory_limit)-1); } else { $memory_unit = ''; } switch ($memory_unit) { case '': $memory_limit = floor($memory_limit/1048576); break; case 'K': case 'k': $memory_limit = floor($memory_limit/1024); break; case 'G': $memory_limit = $memory_limit1024; break; case 'M': // assumed size, no change needed break; } return $memory_limit; } public function memory_check($memory, $check_using = false) { $memory_limit = $this->memory_check_current($check_using); return ($memory_limit >= $memory) ? true : false; } /** * Get the UpdraftPlus RSS feed * * @uses fetch_feed() * * @return WP_Error\|SimplePie WP_Error object on failure or SimplePie object on success / public function get_updraftplus_rssfeed() { if (!function_exists('fetch_feed')) include(ABSPATH.WPINC.'/feed.php'); return fetch_feed('http://feeds.feedburner.com/updraftplus/'); } /* * Sets up the nonce, basic job data, opens a log file for a new restore job, and makes sure that the Updraft_Restorer class is available * * @param Boolean\|string $nonce - the job nonce we want to use or false for a new one * * @return void / public function initiate_restore_job($nonce = false) { $this->backup_time_nonce($nonce); // we reset here so that we ensure the correct jobdata gets loaded while we resume $this->jobdata_reset(); $this->jobdata_set('job_type', 'restore'); $this->jobdata_set('job_time_ms', $this->job_time_ms); $this->logfile_open($this->nonce); if (!class_exists('Updraft_Restorer')) updraft_try_include_file('restorer.php', 'include_once'); } /* * Analyse a database file and return information about it * * @param Integer $timestamp - the database time in the backup history * @param Array $res - accompanying data. The key 'updraft_encryptionphrase' will be used for decryption if relevant. * @param Boolean\|String $db_file - the path to the file to analyse; if not specified (false), then it will be obtained from the backup history * @param Boolean $header_only - whether or not to stop analysis once the header ends * * @return Array - containing arrays for the resulting messages, warnings, errors and meta information / public function analyse_db_file($timestamp, $res, $db_file = false, $header_only = false) { $mess = array(); $warn = array(); $err = array(); $info = array(); $wp_version = $this->get_wordpress_version(); global $wpdb; if (!class_exists('UpdraftPlus_Database_Utility')) updraft_try_include_file('includes/class-database-utility.php', 'include_once'); $updraft_dir = $this->backups_dir_location(); if (false === $db_file) { // This attempts to raise the maximum packet size. This can't be done within the session, only globally. Therefore, it has to be done before the session starts; in our case, during the pre-analysis. $this->max_packet_size(); $backup = UpdraftPlus_Backup_History::get_history($timestamp); if (!isset($backup['nonce']) \|\| !isset($backup['db'])) return array($mess, $warn, $err, $info); $db_file = is_string($backup['db']) ? $updraft_dir.'/'.$backup['db'] : $updraft_dir.'/'.$backup['db'][0]; } if (!is_readable($db_file)) return array($mess, $warn, $err, $info); // Encrypted - decrypt it if (UpdraftPlus_Encryption::is_file_encrypted($db_file)) { $encryption = empty($res['updraft_encryptionphrase']) ? UpdraftPlus_Options::get_updraft_option('updraft_encryptionphrase') : $res['updraft_encryptionphrase']; if (!$encryption) { if (class_exists('UpdraftPlus_Addon_MoreDatabase')) { $err[] = sprintf(__('Error: %s', 'updraftplus'), __('Decryption failed.', 'updraftplus').' '.__('The database file is encrypted, but you have no encryption key entered.', 'updraftplus')); } else { $err[] = sprintf(__('Error: %s', 'updraftplus'), __('Decryption failed.', 'updraftplus').' '.__('The database file is encrypted.', 'updraftplus')); } return array($mess, $warn, $err, $info); } $decrypted_file = UpdraftPlus_Encryption::decrypt($db_file, $encryption); if (is_array($decrypted_file)) { $db_file = $decrypted_file['fullpath']; } else { $err[] = __('Decryption failed.', 'updraftplus').' '.__('The most likely cause is that you used the wrong key.', 'updraftplus'); return array($mess, $warn, $err, $info); } } // Even the empty schema when gzipped comes to 1565 bytes; a blank WP 3.6 install at 5158. But we go low, in case someone wants to share single tables. if (filesize($db_file) < 1000) { $err[] = sprintf(__('The database is too small to be a valid WordPress database (size: %s Kb).', 'updraftplus'), round(filesize($db_file)/1024, 1)); return array($mess, $warn, $err, $info); } // If the backup is not from UpdraftPlus and it's not a simple SQL file then we don't want to scan if (!empty($backup['meta_foreign']) && 'genericsql' != $backup['meta_foreign']) { $info['skipped_db_scan'] = 1; return array($mess, $warn, $err, $info); } $is_plain = ('.gz' == substr($db_file, -3, 3)) ? false : true; $dbhandle = $is_plain ? fopen($db_file, 'r') : UpdraftPlus_Filesystem_Functions::gzopen_for_read($db_file, $warn, $err); if (!is_resource($dbhandle)) { $err[] = __('Failed to open database file.', 'updraftplus'); return array($mess, $warn, $err, $info); } $info['timestamp'] = $timestamp; // Analyse the file, print the results. $line = 0; $old_siteurl = ''; $old_home = ''; $old_table_prefix = null; $old_siteinfo = array(); $gathering_siteinfo = true; $old_wp_version = ''; $old_php_version = ''; $tables_found = array(); $db_charsets_found = array(); $db_scan_timed_out = false; $php_max_input_vars_exceeded = false; // TODO: If the backup is the right size/checksum, then we could restore the $line <= 100 in the 'while' condition and not bother scanning the whole thing? Or better: sort the core tables to be first so that this usually terminates early $wanted_tables = array('terms', 'term_taxonomy', 'term_relationships', 'commentmeta', 'comments', 'links', 'options', 'postmeta', 'posts', 'users', 'usermeta'); $migration_warning = false; $processing_create = false; $processing_routine = false; $db_version = $wpdb->db_version(); // Don't set too high - we want a timely response returned to the browser // Until April 2015, this was always 90. But we've seen a few people with ~1GB databases (uncompressed), and 90s is not enough. Note that we don't bother checking here if it's compressed - having a too-large timeout when unexpected is harmless, as it won't be hit. On very large dbs, they're expecting it to take a while. // "120 or 240" is a first attempt at something more useful than just fixed at 90 - but should be sufficient (as 90 was for everyone without ~1GB databases) $default_dbscan_timeout = (filesize($db_file) < 31457280) ? 120 : 240; $dbscan_timeout = (defined('UPDRAFTPLUS_DBSCAN_TIMEOUT') && is_numeric(UPDRAFTPLUS_DBSCAN_TIMEOUT)) ? UPDRAFTPLUS_DBSCAN_TIMEOUT : $default_dbscan_timeout; if (function_exists('set_time_limit')) @set_time_limit($dbscan_timeout);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // We limit the time that we spend scanning the file for character sets $db_charset_collate_scan_timeout = (defined('UPDRAFTPLUS_DB_CHARSET_COLLATE_SCAN_TIMEOUT') && is_numeric(UPDRAFTPLUS_DB_CHARSET_COLLATE_SCAN_TIMEOUT)) ? UPDRAFTPLUS_DB_CHARSET_COLLATE_SCAN_TIMEOUT : 10; $charset_scan_start_time = microtime(true); $db_supported_character_sets = (array) $GLOBALS['wpdb']->get_results('SHOW CHARACTER SET', OBJECT_K); $db_supported_collations = (array) $GLOBALS['wpdb']->get_results('SHOW COLLATION', OBJECT_K); $db_charsets_found = array(); $db_collates_found = array(); $db_supported_charset_related_to_unsupported_collation = false; $db_supported_charsets_related_to_unsupported_collations = array(); while ((($is_plain && !feof($dbhandle)) \|\| (!$is_plain && !gzeof($dbhandle))) && ($line<100 \|\| (!$header_only && count($wanted_tables)>0) \|\| ((microtime(true) - $charset_scan_start_time) < $db_charset_collate_scan_timeout && !empty($db_supported_character_sets)))) { $line++; // Up to 1MB $buffer = $is_plain ? rtrim(fgets($dbhandle, 1048576)) : rtrim(gzgets($dbhandle, 1048576)); // Comments are what we are interested in if (substr($buffer, 0, 1) == '#') { $processing_create = false; $processing_routine = false; if ('' == $old_siteurl && preg_match('/^\# Backup of: (http(.))$/', $buffer, $matches)) { $old_siteurl = untrailingslashit($matches[1]); $mess[] = __('Backup of:', 'updraftplus').' '.htmlspecialchars($old_siteurl).((!empty($old_wp_version)) ? ' '.sprintf(__('(version: %s)', 'updraftplus'), $old_wp_version) : ''); // Check for should-be migration if (untrailingslashit(site_url()) != $old_siteurl) { if (!$migration_warning) { $migration_warning = true; $info['migration'] = true; // && !class_exists('UpdraftPlus_Addons_Migrator') if (UpdraftPlus_Manipulation_Functions::normalise_url($old_siteurl) == UpdraftPlus_Manipulation_Functions::normalise_url(site_url())) { // Same site migration with only http/https difference $info['same_url'] = false; $info['url_scheme_change'] = true; $old_siteurl_parsed = parse_url($old_siteurl); $actual_siteurl_parsed = parse_url(site_url()); if ((stripos($old_siteurl_parsed['host'], 'www.') === 0 && stripos($actual_siteurl_parsed['host'], 'www.') !== 0) \|\| (stripos($old_siteurl_parsed['host'], 'www.') !== 0 && stripos($actual_siteurl_parsed['host'], 'www.') === 0)) { $powarn = sprintf(__('The website address in the backup set (%s) is slightly different from that of the site now (%s).', 'updraftplus'), $old_siteurl, site_url()).' '.__('This is not expected to be a problem for restoring the site, as long as visits to the former address still reach the site.', 'updraftplus').' '; } else { $powarn = ''; } if (('https' == $old_siteurl_parsed['scheme'] && 'http' == $actual_siteurl_parsed['scheme']) \|\| ('http' == $old_siteurl_parsed['scheme'] && 'https' == $actual_siteurl_parsed['scheme'])) { $powarn .= sprintf(__('This backup set is of this site, but at the time of the backup you were using %s, whereas the site now uses %s.', 'updraftplus'), $old_siteurl_parsed['scheme'], $actual_siteurl_parsed['scheme']); if ('https' == $old_siteurl_parsed['scheme']) { $powarn .= ' '.apply_filters('updraftplus_https_to_http_additional_warning', ''); } else { $powarn .= ' '.apply_filters('updraftplus_http_to_https_additional_warning', ''); } } else { $powarn .= apply_filters('updraftplus_dbscan_urlchange_www_append_warning', ''); } $warn[] = $powarn; } else { // For completely different site migration $info['same_url'] = false; $info['url_scheme_change'] = false; $warn[] = apply_filters('updraftplus_dbscan_urlchange', '<a href="https://updraftplus.com/shop/migrator/" target="_blank">'.sprintf(__('This backup set is from a different site (%s) - this is not a restoration, but a migration.', 'updraftplus'), htmlspecialchars($old_siteurl.' / '.untrailingslashit(site_url()))).' '.__('You need the Migrator add-on in order to make this work.', 'updraftplus').'</a>', $old_siteurl, $res); } } if ($this->mod_rewrite_unavailable(false)) { $warn[] = sprintf(__('You are using the %s webserver, but do not seem to have the %s module loaded.', 'updraftplus'), 'Apache', 'mod_rewrite').' '.sprintf(__('You should enable %s to make any pretty permalinks (e.g. %s) work', 'updraftplus'), 'mod_rewrite', 'http://example.com/my-page/'); } } else { // For exactly same URL site restoration $info['same_url'] = true; $info['url_scheme_change'] = false; } } elseif ('' == $old_home && preg_match('/^\# Home URL: (http(.))$/', $buffer, $matches)) { $old_home = untrailingslashit($matches[1]); // Check for should-be migration if (!$migration_warning && UpdraftPlus_Manipulation_Functions::normalise_url(home_url()) != UpdraftPlus_Manipulation_Functions::normalise_url($old_home)) { $migration_warning = true; $powarn = apply_filters('updraftplus_dbscan_urlchange', '<a href="https://updraftplus.com/shop/migrator/" target="_blank">'.sprintf(__('This backup set is from a different site (%s) - this is not a restoration, but a migration.', 'updraftplus'), htmlspecialchars($old_home.' / '.home_url())).' '.__('You need the Migrator add-on in order to make this work.', 'updraftplus').'</a>', $old_home, $res); if (!empty($powarn)) $warn[] = $powarn; } } elseif (!isset($info['created_by_version']) && preg_match('/^\# Created by UpdraftPlus version ([\d\.]+)/', $buffer, $matches)) { $info['created_by_version'] = trim($matches[1]); } elseif ('' == $old_wp_version && preg_match('/^\# WordPress Version: ([0-9]+(\.[0-9]+)+)(-[-a-z0-9]+,)?(.)$/', $buffer, $matches)) { $old_wp_version = $matches[1]; if (!empty($matches[3])) $old_wp_version .= substr($matches[3], 0, strlen($matches[3])-1); if (version_compare($old_wp_version, $wp_version, '>')) { // $mess[] = sprintf(__('%s version: %s', 'updraftplus'), 'WordPress', $old_wp_version); $warn[] = sprintf(__('You are importing from a newer version of WordPress (%s) into an older one (%s).', 'updraftplus'), $old_wp_version, $wp_version).' '.__('There are no guarantees that WordPress can handle this.', 'updraftplus'); } if (preg_match('/running on PHP ([0-9]+\.[0-9]+)(\s\|\.)/', $matches[4], $nmatches) && preg_match('/^([0-9]+\.[0-9]+)(\s\|\.)/', PHP_VERSION, $cmatches)) { $old_php_version = $nmatches[1]; $current_php_version = $cmatches[1]; if (version_compare($old_php_version, $current_php_version, '>')) { $warn[] = sprintf(__('The site in this backup was running on a webserver with version %s of %s.', 'updraftplus'), $old_php_version, 'PHP').' '.sprintf(__('This is significantly newer than the server which you are now restoring onto (version %s).', 'updraftplus'), PHP_VERSION).' '.sprintf(__('You should only proceed if you cannot update the current server and are confident (or willing to risk) that your plugins/themes/etc are compatible with the older %s version.', 'updraftplus'), 'PHP').' '.sprintf(__('Any support requests to do with %s should be raised with your web hosting company.', 'updraftplus'), 'PHP'); } elseif (version_compare($old_php_version, $current_php_version, '<')) { $warn[] = sprintf(__('The site in this backup was running on a webserver with version %s of %s.', 'updraftplus'), $old_php_version, 'PHP').' '.sprintf(__('This is older than the server which you are now restoring onto (version %s).', 'updraftplus'), PHP_VERSION).' '.sprintf(__('You should only proceed if you have checked and are confident (or willing to risk) that your plugins/themes/etc are compatible with the new %s version.', 'updraftplus'), 'PHP').' '.sprintf(__('Any support requests to do with %s should be raised with your web hosting company.', 'updraftplus'), 'PHP'); } } } elseif (null === $old_table_prefix && (preg_match('/^\# Table prefix: ?(\S)$/', $buffer, $matches) \|\| preg_match('/^-- Table prefix: ?(\S)$/i', $buffer, $matches))) { $old_table_prefix = $matches[1]; // echo '<strong>'.__('Old table prefix:', 'updraftplus').'</strong> '.htmlspecialchars($old_table_prefix).'<br>'; } elseif (empty($info['label']) && preg_match('/^\# Label: (.)$/', $buffer, $matches)) { $info['label'] = $matches[1]; $mess[] = __('Backup label:', 'updraftplus').' '.htmlspecialchars($info['label']); } elseif ($gathering_siteinfo && preg_match('/^\# Site info: (\S+)$/', $buffer, $matches)) { if ('end' == $matches[1]) { $gathering_siteinfo = false; // Sanity checks if (isset($old_siteinfo['multisite']) && !$old_siteinfo['multisite'] && is_multisite()) { // Just need to check that you're crazy // if (!defined('UPDRAFTPLUS_EXPERIMENTAL_IMPORTINTOMULTISITE') \|\| !UPDRAFTPLUS_EXPERIMENTAL_IMPORTINTOMULTISITE) { // $err[] = sprintf(__('Error: %s', 'updraftplus'), __('You are running on WordPress multisite - but your backup is not of a multisite site.', 'updraftplus')); // return array($mess, $warn, $err, $info); // } else { $warn[] = __('You are running on WordPress multisite - but your backup is not of a multisite site.', 'updraftplus').' '.__('It will be imported as a new site.', 'updraftplus').' <a href="https://updraftplus.com/information-on-importing-a-single-site-wordpress-backup-into-a-wordpress-network-i-e-multisite/" target="_blank">'.__('Please read this link for important information on this process.', 'updraftplus').'</a>'; // } // Got the needed code? if (!class_exists('UpdraftPlusAddOn_MultiSite') \|\| !class_exists('UpdraftPlus_Addons_Migrator')) { $err[] = sprintf(__('Error: %s', 'updraftplus'), sprintf(__('To import an ordinary WordPress site into a multisite installation requires %s.', 'updraftplus'), 'UpdraftPlus Premium')); return array($mess, $warn, $err, $info); } } elseif (isset($old_siteinfo['multisite']) && $old_siteinfo['multisite'] && !is_multisite()) { $warn[] = __('Warning:', 'updraftplus').' '.__('Your backup is of a WordPress multisite install; but this site is not.', 'updraftplus').' '.__('Only the first site of the network will be accessible.', 'updraftplus').' <a href="https://codex.wordpress.org/Create_A_Network" target="_blank">'.__('If you want to restore a multisite backup, you should first set up your WordPress installation as a multisite.', 'updraftplus').'</a>'; } } elseif (preg_match('/^([^=]+)=(.)$/', $matches[1], $kvmatches)) { $key = $kvmatches[1]; $val = $kvmatches[2]; if ('multisite' == $key) { $info['multisite'] = $val ? true : false; if ($val) $mess[] = '<strong>'.__('Site information:', 'updraftplus').'</strong> '.'backup is of a WordPress Network'; } $old_siteinfo[$key] = $val; } } elseif (preg_match('/^\# Skipped tables: (.)$/', $buffer, $matches)) { $skipped_tables = array_map('trim', explode(',', $matches[1])); } } elseif (preg_match('#^\s/\\!40\d+ SET NAMES (.)\\/#i', $buffer, $smatches)) { $db_charsets_found[] = rtrim($smatches[1]); } elseif (!$processing_routine && !$processing_create && preg_match("/^[^'\"]create[^'\"](?:definer\s=\s(?:`.{1,17}`@`[^\s]+`\|'.{1,17}'@'[^\s]+'))?.+?(?:function(?:\s\sif\s\snot\s\sexists)?\|procedure)\s`([^\r\n]+)`/is", $buffer, $matches)) { // ^\screate\s\s(?:or\s\sreplace\s\s)?.?(?:aggregate\s\sfunction\|function\|procedure)\s\s`(.+)`(?:\s\sif\s\snot\s\sexists\s\|\s)?\( if (!preg_match('/END\s(?:\\/)?;;\s$/is', $buffer) && !preg_match('/\;\s;;\s$/is', $buffer) && !preg_match('/\s(?:\\/)?;;\s$/is', $buffer)) $processing_routine = true; } elseif (!$processing_routine && preg_match('/^\screate table \`?([^\`\(])\`?\s\(/i', $buffer, $matches)) { $table = $matches[1]; $tables_found[] = $table; if (null !== $old_table_prefix) { // Remove prefix $table = $old_table_prefix ? UpdraftPlus_Manipulation_Functions::str_replace_once($old_table_prefix, '', $table) : $table; if (in_array($table, $wanted_tables)) { $wanted_tables = array_diff($wanted_tables, array($table)); } } if (empty($old_siteurl) && !empty($backup['meta_foreign'])) { $info['migration'] = true; } if (';' != substr($buffer, -1, 1)) { $processing_create = true; $db_supported_charset_related_to_unsupported_collation = true; } } elseif ($processing_create) { if (!empty($db_supported_collations)) { if (preg_match('/ COLLATE=([^\s;]+)/i', $buffer, $collate_match)) { $db_collates_found[] = $collate_match[1]; if (!isset($db_supported_collations[$collate_match[1]])) { $db_supported_charset_related_to_unsupported_collation = true; } } if (preg_match('/ COLLATE ([a-zA-Z0-9._-]+),/i', $buffer, $collate_match)) { $db_collates_found[] = $collate_match[1]; if (!isset($db_supported_collations[$collate_match[1]])) { $db_supported_charset_related_to_unsupported_collation = true; } } if (preg_match('/ COLLATE ([a-zA-Z0-9._-]+) /i', $buffer, $collate_match)) { $db_collates_found[] = $collate_match[1]; if (!isset($db_supported_collations[$collate_match[1]])) { $db_supported_charset_related_to_unsupported_collation = true; } } } if (!empty($db_supported_character_sets)) { if (preg_match('/ CHARSET=([^\s;]+)/i', $buffer, $charset_match)) { $db_charsets_found[] = $charset_match[1]; if ($db_supported_charset_related_to_unsupported_collation && !in_array($charset_match[1], $db_supported_charsets_related_to_unsupported_collations)) { $db_supported_charsets_related_to_unsupported_collations[] = $charset_match[1]; } } } if (';' == substr($buffer, -1, 1)) { $processing_create = false; $db_supported_charset_related_to_unsupported_collation = false; } static $mysql_version_warned = false; if (!$mysql_version_warned && version_compare($db_version, '5.2.0', '<') && preg_match('/(CHARSET\|COLLATE)[= ]utf8mb4/', $buffer)) { $mysql_version_warned = true; $err[] = sprintf(__('Error: %s', 'updraftplus'), sprintf(__('The database backup uses MySQL features not available in the old MySQL version (%s) that this site is running on.', 'updraftplus'), $db_version).' '.__('You must upgrade MySQL to be able to use this database.', 'updraftplus')); } } elseif ($processing_routine) { if ((preg_match('/END\s(?:\\/)?;;\s$/is', $buffer) \|\| preg_match('/\;\s;;\s$/is', $buffer) \|\| preg_match('/\s(?:\\/)?;;\s$/is', $buffer)) && !preg_match('/(?:--\|#).+?;;\s$/i', $buffer)) $processing_routine = false; } } if ($is_plain) { if (!feof($dbhandle)) $db_scan_timed_out = true; @fclose($dbhandle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } else { if (!gzeof($dbhandle)) $db_scan_timed_out = true; @gzclose($dbhandle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } if (!empty($db_supported_character_sets)) { $db_charsets_found_unique = array_unique($db_charsets_found); $db_unsupported_charset = array(); $db_charset_forbidden = false; foreach ($db_charsets_found_unique as $db_charset) { if (!isset($db_supported_character_sets[$db_charset])) { $db_unsupported_charset[] = $db_charset; $db_charset_forbidden = true; } } if ($db_charset_forbidden) { $db_unsupported_charset_unique = array_unique($db_unsupported_charset); $warn[] = sprintf(_n("The database server that this WordPress site is running on doesn't support the character set (%s) which you are trying to import.", "The database server that this WordPress site is running on doesn't support the character sets (%s) which you are trying to import.", count($db_unsupported_charset_unique), 'updraftplus'), implode(', ', $db_unsupported_charset_unique)).' '.__('You can choose another suitable character set instead and continue with the restoration at your own risk.', 'updraftplus').' <a target="_blank" href="https://updraftplus.com/faqs/implications-changing-tables-character-set/" target="_blank">'.__('Go here for more information.', 'updraftplus').'</a>'.' <a target="_blank" href="https://updraftplus.com/faqs/implications-changing-tables-character-set/" target="_blank">'.__('Go here for more information.', 'updraftplus').'</a>'; $db_supported_character_sets = array_keys($db_supported_character_sets); $similar_type_charset = UpdraftPlus_Manipulation_Functions::get_matching_str_from_array_elems($db_unsupported_charset_unique, $db_supported_character_sets, true); if (empty($similar_type_charset)) { $row = $GLOBALS['wpdb']->get_row('show variables like "character_set_database"'); $similar_type_charset = (null !== $row) ? $row->Value : ''; } if (empty($similar_type_charset) && !empty($db_supported_character_sets[0])) { $similar_type_charset = $db_supported_character_sets[0]; } $charset_select_html = '<label>'.__('Your chosen character set to use instead:', 'updraftplus').'</label> '; $charset_select_html .= '<select name="updraft_restorer_charset" id="updraft_restorer_charset">'; if (is_array($db_supported_character_sets)) { foreach ($db_supported_character_sets as $character_set) { if ($character_set == $similar_type_charset) $info['supported_charset'] = $character_set; $charset_select_html .= '<option value="'.esc_attr($character_set).'" '.selected($character_set, $similar_type_charset, false).'>'.esc_html($character_set).'</option>'; } } $charset_select_html .= '</select>'; if (empty($info['addui'])) $info['addui'] = ''; $info['addui'] .= $charset_select_html; } } if (!empty($db_supported_collations)) { $db_collates_found_unique = array_unique($db_collates_found); $db_unsupported_collate = array(); $db_collate_forbidden = false; foreach ($db_collates_found_unique as $db_collate) { if (!isset($db_supported_collations[$db_collate])) { $db_unsupported_collate[] = $db_collate; $db_collate_forbidden = true; } } if ($db_collate_forbidden) { $db_unsupported_collate_unique = array_unique($db_unsupported_collate); $warn[] = sprintf(_n("The database server that this WordPress site is running on doesn't support the collation (%s) used in the database which you are trying to import.", "The database server that this WordPress site is running on doesn't support multiple collations (%s) used in the database which you are trying to import.", count($db_unsupported_collate_unique), 'updraftplus'), implode(', ', $db_unsupported_collate_unique)).' '.__('You can choose another suitable collation instead and continue with the restoration (at your own risk).', 'updraftplus'); $similar_type_collate = ''; if ($db_charset_forbidden && !empty($similar_type_charset)) { $similar_type_collate = $this->get_similar_collate_related_to_charset($db_supported_collations, $db_unsupported_collate_unique, $similar_type_charset); } if (empty($similar_type_collate) && !empty($db_supported_charsets_related_to_unsupported_collations)) { $db_supported_collations_related_to_charset = array(); foreach ($db_supported_collations as $db_supported_collation => $db_supported_collations_info_obj) { if (isset($db_supported_collations_info_obj->Charset) && in_array($db_supported_collations_info_obj->Charset, $db_supported_charsets_related_to_unsupported_collations)) { $db_supported_collations_related_to_charset[] = $db_supported_collation; } } if (!empty($db_supported_collations_related_to_charset)) { $similar_type_collate = UpdraftPlus_Manipulation_Functions::get_matching_str_from_array_elems($db_unsupported_collate_unique, $db_supported_collations_related_to_charset, false); } } if (empty($similar_type_collate)) { $similar_type_collate = $this->get_similar_collate_based_on_ocuurence_count($db_collates_found, $db_supported_collations, $db_supported_charsets_related_to_unsupported_collations); } if (empty($similar_type_collate)) { $similar_type_collate = UpdraftPlus_Manipulation_Functions::get_matching_str_from_array_elems($db_unsupported_collate_unique, array_keys($db_supported_collations), false); } $collate_select_html = '<div class="udp-notice below-h2 updraft-restore-option"><label>'.__('Your chosen replacement collation', 'updraftplus').':</label>'; $collate_select_html .= '<select name="updraft_restorer_collate" id="updraft_restorer_collate">'; $db_charsets_found_unique = array_unique($db_charsets_found); foreach ($db_supported_collations as $collate => $collate_info_obj) { $option_other_attr = array(); if ($db_charset_forbidden && isset($collate_info_obj->Charset)) { $option_other_attr[] = 'data-charset='.esc_attr($collate_info_obj->Charset); if ($similar_type_charset != $collate_info_obj->Charset) { $option_other_attr[] = 'style="display:none;"'; } } else { if (1 == count($db_charsets_found_unique)) { if (!in_array($collate_info_obj->Charset, $db_charsets_found_unique)) { $option_other_attr[] = 'style="display:none;"'; } } else { $option_other_attr[] = 'style="display:none;"'; } } $collate_select_html .= '<option value="'.esc_attr($collate).'" '.selected($collate, $similar_type_collate, false).' '.implode(' ', $option_other_attr).'>'.esc_html($collate).'</option>'; } if (count($db_charsets_found_unique) > 1 && !$db_charset_forbidden) { $collate_select_html .= '<option value="choose_a_default_for_each_table" selected="selected">'.__('Choose a default for each table', 'updraftplus').'</option>'; } $collate_select_html .= '</select>'; $collate_select_html .= '</div>'; $info['addui'] = empty($info['addui']) ? $collate_select_html : $info['addui'].'<br>'.$collate_select_html; if ($db_charset_forbidden) { $collate_change_on_charset_selection_data = array( 'db_supported_collations' => $db_supported_collations, 'db_unsupported_collate_unique' => $db_unsupported_collate_unique, 'db_collates_found' => $db_collates_found, ); $info['addui'] .= '<input type="hidden" name="collate_change_on_charset_selection_data" id="collate_change_on_charset_selection_data" value="'.esc_attr(json_encode($collate_change_on_charset_selection_data)).'">'; } } } / $blog_tables = "CREATE TABLE $wpdb->terms ( CREATE TABLE $wpdb->term_taxonomy ( CREATE TABLE $wpdb->term_relationships ( CREATE TABLE $wpdb->commentmeta ( CREATE TABLE $wpdb->comments ( CREATE TABLE $wpdb->links ( CREATE TABLE $wpdb->options ( CREATE TABLE $wpdb->postmeta ( CREATE TABLE $wpdb->posts ( $users_single_table = "CREATE TABLE $wpdb->users ( $users_multi_table = "CREATE TABLE $wpdb->users ( $usermeta_table = "CREATE TABLE $wpdb->usermeta ( $ms_global_tables = "CREATE TABLE $wpdb->blogs ( CREATE TABLE $wpdb->blog_versions ( CREATE TABLE $wpdb->registration_log ( CREATE TABLE $wpdb->site ( CREATE TABLE $wpdb->sitemeta ( CREATE TABLE $wpdb->signups ( / if (!isset($skipped_tables)) $skipped_tables = array(); $missing_tables = array(); if (null !== $old_table_prefix) { if ('' === $old_table_prefix) $warn[] = __('This backup is of a site with an empty table prefix, which WordPress does not officially support; the results may be unreliable.', 'updraftplus'); if (!$header_only) { foreach ($wanted_tables as $table) { if (!in_array($old_table_prefix.$table, $tables_found)) { $missing_tables[] = $table; } } foreach ($missing_tables as $key => $value) { if (in_array($old_table_prefix.$value, $skipped_tables)) { $key_to_unset_skipped_tables = array_search($old_table_prefix.$value, $skipped_tables); unset($skipped_tables[$key_to_unset_skipped_tables]); } } if (count($missing_tables)>0) { $warn[] = sprintf(__('This database backup is missing core WordPress tables: %s', 'updraftplus'), implode(', ', $missing_tables)); } if (count($skipped_tables)>0) { $warn[] = sprintf(__('This database backup has the following non-core WordPress database tables excluded: %s', 'updraftplus'), implode(', ', $skipped_tables)); } } } else { if (empty($backup['meta_foreign'])) { $warn[] = __('UpdraftPlus was unable to find the table prefix when scanning the database backup.', 'updraftplus'); } } $php_max_input_vars = ini_get("max_input_vars"); // phpcs:ignore PHPCompatibility.IniDirectives.NewIniDirectives.max_input_varsFound -- does not exist in PHP 5.2 if (false == $php_max_input_vars) { $php_max_input_vars_exceeded = true; } elseif (count($tables_found) >= 0.90 $php_max_input_vars) { $php_max_input_vars_exceeded = true; // If the amount of tables exceed 90% of the php max input vars then truncate the list to 50% of the php max input vars value $tables_found = array_splice($tables_found, 0, intval($php_max_input_vars / 2)); } $php_max_input_vars_value = false == $php_max_input_vars ? 0 : $php_max_input_vars; $info['php_max_input_vars'] = $php_max_input_vars_value; // On UD 1.16.30 - 1.16.34 there was a serious bug that did not backup all content in composite key tables, if this is not a migration and the backup was created on one of these versions do not restore this table. $skip_composite_tables = (!empty($info['created_by_version']) && version_compare("1" . substr($info['created_by_version'], 1), '1.16.30', '>=') && version_compare("1" . substr($info['created_by_version'], 1), '1.16.34', '<=')) ? true : false; if ($skip_composite_tables) { if (!empty($info['migration'])) { $skip_composite_tables = false; $warn[] = sprintf(__('This backup was created on a previous UpdraftPlus version (%s) which did not correctly backup tables with composite primary keys (such as the term_relationships table, which records tags and product attributes).', 'updraftplus').' '.__('Therefore it is advised that you take a fresh backup on the source site, using a later version.', 'updraftplus'), $info['created_by_version']); } else { $warn[] = sprintf(__('This backup was created on a previous UpdraftPlus version (%s) which did not correctly backup tables with composite primary keys (such as the term_relationships table, which records tags and product attributes).', 'updraftplus').' '.__('Therefore, affected tables on the current site which already exist will not be replaced by default, to avoid corrupting them (you can review this in the list of tables below).', 'updraftplus'), $info['created_by_version']); } } if (empty($tables_found)) { $warn[] = __('UpdraftPlus was unable to find any tables when scanning the database backup; it maybe corrupt.', 'updraftplus'); } else { $select_restore_tables = '<div class="udp-notice below-h2 updraft-restore-option">'; $select_restore_tables .= '<p>'.__('If you do not want to restore all your database tables, then choose some to exclude here.', 'updraftplus').'(<a href="#" id="updraftplus_restore_tables_showmoreoptions">...</a>)</p>'; $select_restore_tables .= '<div class="updraftplus_restore_tables_options_container" style="display:none;">'; $select_table_button = '<p><a href="#" class="updraft-select-all-tables">'.__('Select All', 'updraftplus').'</a> \| <a href="#" class="updraft-deselect-all-tables">'.__('Deselect All', 'updraftplus').'</a></p>'; $select_restore_tables .= $select_table_button; if ($db_scan_timed_out \|\| $php_max_input_vars_exceeded) { if ($db_scan_timed_out) $all_other_table_title = __('The database scan was taking too long and consequently the list of all tables in the database could not be completed.', 'updraftplus').' '.__('This option will ensure all tables not found will be backed up.', 'updraftplus'); if ($php_max_input_vars_exceeded) $all_other_table_title = __('The amount of database tables scanned is near or over the php_max_input_vars value so some tables maybe truncated.', 'updraftplus').' '.__('This option will ensure all tables not found will be backed up.', 'updraftplus'); $select_restore_tables .= '<div style="margin-bottom:0.7rem;margin-top:0.7rem;"><input class="updraft_restore_tables_options" id="updraft_restore_table_udp_all_other_tables" checked="checked" type="checkbox" name="updraft_restore_tables_options[]" value="udp_all_other_tables"> '; $select_restore_tables .= '<label for="updraft_restore_table_udp_all_other_tables" title="'.$all_other_table_title.'">'.__('Include all tables not listed below', 'updraftplus').'</label></div>'; } foreach ($tables_found as $table) { $checked = $skip_composite_tables && UpdraftPlus_Database_Utility::table_has_composite_private_key($table) ? '' : 'checked="checked"'; $select_restore_tables .= '<input class="updraft_restore_tables_options" id="updraft_restore_table_'.$table.'" '. $checked .' type="checkbox" name="updraft_restore_tables_options[]" value="'.$table.'"> '; $select_restore_tables .= '<label for="updraft_restore_table_'.$table.'">'.$table.'</label><br>'; } $select_restore_tables .= $select_table_button; $select_restore_tables .= '</div></div>'; $info['addui'] = empty($info['addui']) ? $select_restore_tables : $info['addui'].'<br>'.$select_restore_tables; } // //need to make sure that we reset the file back to .crypt before clean temp files // $db_file = $decrypted_file['fullpath'].'.crypt'; // unlink($decrypted_file['fullpath']); return array($mess, $warn, $err, $info); } /** * Get the current outgoing IP address. Use this wisely; of course, it's not guaranteed to always be the same. * * @param Boolean $use_ipv6_service True to check the IP address using the IPv6 service with IPv4 fallback, false to use the IPv4 service only * @return String\|Boolean - returns false upon failure / public function get_outgoing_ip_address($use_ipv6_service = false) { $urls = array('https://ipvigilante.com/json'); if ($use_ipv6_service) array_unshift($urls, 'http://ip6.me/api'); $urls = apply_filters('updraftplus_get_outgoing_ip_address', $urls); foreach ($urls as $url) { $ip_lookup = wp_remote_get($url, array('timeout' => 6)); if (200 === wp_remote_retrieve_response_code($ip_lookup)) { $body = wp_remote_retrieve_body($ip_lookup); $info = json_decode($body, true); if (is_array($info)) { if (!empty($info['status']) && !empty($info['data']) && 'success' === $info['status']); if (!empty($info['data']['ipv4'])) return $info['data']['ipv4']; if (!empty($info['data']['ipv6'])) return $info['data']['ipv6']; } elseif (preg_match_all('/([^"\',]+\|"(?:[^"]\|")?"\|\'(?:[^\']\|\')?\')?(?:,\|$)/is', $body, $matches)) { // https://regex101.com/r/Q8XjT4/1/ $matches[1][0] = strtolower(trim($matches[1][0], ',\'" ')); if (('ipv4' === $matches[1][0] \|\| 'ipv6' === $matches[1][0]) && !empty($matches[1][1])) return trim($matches[1][1], ',\'" '); } } } return false; } /* * Get default substitute similar collate related to charset * * @param array $db_supported_collations Supported collations. It should contain result of 'SHOW COLLATION' query * @param array $db_unsupported_collate_unique Unsupported unique collates collection * @param String $similar_type_charset Charset for which need to get default collate substitution * @return string $similar_type_collate default substitute collate which is best suitable or blank string / public function get_similar_collate_related_to_charset($db_supported_collations, $db_unsupported_collate_unique, $similar_type_charset) { $similar_type_collate = ''; $db_supported_collations_related_to_charset = array(); foreach ($db_supported_collations as $db_supported_collation => $db_supported_collations_info_obj) { if (isset($db_supported_collations_info_obj->Charset) && $db_supported_collations_info_obj->Charset == $similar_type_charset) { $db_supported_collations_related_to_charset[] = $db_supported_collation; } } if (!empty($db_supported_collations_related_to_charset)) { $similar_type_collate = UpdraftPlus_Manipulation_Functions::get_matching_str_from_array_elems($db_unsupported_collate_unique, $db_supported_collations_related_to_charset, false); } return $similar_type_collate; } /* * Get default substitute similar collate based on existing supported collates count in database backup file * * @param array $db_collates_found All collates which have found in database backup file regardless whether they are supported or unsupported * @param array $db_supported_collations Supported collations. It should contain result of 'SHOW COLLATION' query * @param array $db_supported_charsets_related_to_unsupported_collations All charset which are related to unsupported collation * * @return string $similar_type_collate default substitute collate which is best suitable or blank string / public function get_similar_collate_based_on_ocuurence_count($db_collates_found, $db_supported_collations, $db_supported_charsets_related_to_unsupported_collations) { $similar_type_collate = ''; $db_supported_collates_found_with_occurrence = array(); foreach ($db_collates_found as $db_collate_found) { if (isset($db_supported_collations[$db_collate_found])) { if (isset($db_supported_collates_found_with_occurrence[$db_collate_found])) { $db_supported_collates_found_with_occurrence[$db_collate_found] = (int) $db_supported_collates_found_with_occurrence[$db_collate_found] + 1; } else { $db_supported_collates_found_with_occurrence[$db_collate_found] = 1; } } } if (!empty($db_supported_collates_found_with_occurrence)) { arsort($db_supported_collates_found_with_occurrence); if (!empty($db_supported_charsets_related_to_unsupported_collations)) { foreach ($db_supported_collates_found_with_occurrence as $db_supported_collate_with_occurrence => $occurrence_count) { if (isset($db_supported_collations[$db_supported_collate_with_occurrence]) && isset($db_supported_collations[$db_supported_collate_with_occurrence]->Charset) && in_array($db_supported_collations[$db_supported_collate_with_occurrence]->Charset, $db_supported_charsets_related_to_unsupported_collations)) { $similar_type_collate = $db_supported_collate_with_occurrence; break; } } } else { $similar_type_collate = array_search(max($db_supported_collates_found_with_occurrence), $db_supported_collates_found_with_occurrence); } } return $similar_type_collate; } /* * Retrieves current clean url for anchor link where href attribute value is not url (for ex. #div) or empty. Output is not escaped - caller should escape. * * @return String - current clean url / public static function get_current_clean_url() { // Within an UpdraftCentral context, there should be no prefix on the anchor link if (defined('UPDRAFTCENTRAL_COMMAND') && UPDRAFTCENTRAL_COMMAND \|\| defined('WP_CLI') && WP_CLI) return ''; if (defined('DOING_AJAX') && DOING_AJAX && !empty($_SERVER['HTTP_REFERER'])) { $current_url = $_SERVER['HTTP_REFERER']; } else { $url_prefix = is_ssl() ? 'https' : 'http'; $host = empty($_SERVER['HTTP_HOST']) ? parse_url(network_site_url(), PHP_URL_HOST) : $_SERVER['HTTP_HOST']; $current_url = $url_prefix."://".$host.$_SERVER['REQUEST_URI']; } $remove_query_args = array('state', 'action', 'oauth_verifier', 'nonce', 'updraftplus_instance', 'access_token', 'user_id', 'updraftplus_googledriveauth'); return UpdraftPlus_Manipulation_Functions::wp_unslash(remove_query_arg($remove_query_args, $current_url)); } /* * TODO: Remove legacy storage setting keys from here * These are used in 4 places (Feb 2016 - of course, you should re-scan the code to check if relying on this): showing current settings on the debug modal, wiping all current settings, getting a settings bundle to restore when migrating, and for relevant keys in POST-ed data when saving settings over AJAX * * @return Array - the list of keys / public function get_settings_keys() { // N.B. updraft_backup_history is not included here, as we don't want that wiped return array( 'updraft_autobackup_default', 'updraft_dropbox', 'updraft_pcloud', 'updraft_googledrive', 'updraftplus_tmp_googledrive_access_token', 'updraftplus_dismissedautobackup', 'dismissed_general_notices_until', 'dismissed_review_notice', 'dismissed_clone_php_notices_until', 'dismissed_clone_wc_notices_until', 'dismissed_season_notices_until', 'updraftplus_dismissedexpiry', 'updraftplus_dismisseddashnotice', 'updraft_interval', 'updraft_interval_increments', 'updraft_interval_database', 'updraft_retain', 'updraft_retain_db', 'updraft_encryptionphrase', 'updraft_service', 'updraft_googledrive_clientid', 'updraft_googledrive_secret', 'updraft_googledrive_remotepath', 'updraft_ftp', 'updraft_backblaze', 'updraft_server_address', 'updraft_dir', 'updraft_email', 'updraft_delete_local', 'updraft_debug_mode', 'updraft_include_plugins', 'updraft_include_themes', 'updraft_include_uploads', 'updraft_include_others', 'updraft_include_wpcore', 'updraft_include_wpcore_exclude', 'updraft_include_more', 'updraft_include_blogs', 'updraft_include_mu-plugins', 'updraft_auto_updates', // since WordPress 5.5, updraft_auto_updates option is no longer used and has been removed from the code, but the HTML IDs which use the same name that represent the automatic update setting are still zealously preserved so this one cannot be removed 'updraft_include_others_exclude', 'updraft_include_uploads_exclude', 'updraft_lastmessage', 'updraft_googledrive_token', 'updraft_dropboxtk_request_token', 'updraft_dropboxtk_access_token', 'updraft_adminlocking', 'updraft_updraftvault', 'updraft_remotesites', 'updraft_migrator_localkeys', 'updraft_central_localkeys', 'updraft_retain_extrarules', 'updraft_googlecloud', 'updraft_include_more_path', 'updraft_split_every', 'updraft_ssl_nossl', 'updraft_backupdb_nonwp', 'updraft_extradbs', 'updraft_combine_jobs_around', 'updraft_last_backup', 'updraft_starttime_files', 'updraft_starttime_db', 'updraft_startday_db', 'updraft_startday_files', 'updraft_sftp', 'updraft_s3', 'updraft_s3generic', 'updraft_dreamhost', 'updraft_s3generic_login', 'updraft_s3generic_pass', 'updraft_s3generic_remote_path', 'updraft_s3generic_endpoint', 'updraft_webdav', 'updraft_openstack', 'updraft_onedrive', 'updraft_azure', 'updraft_cloudfiles', 'updraft_cloudfiles_user', 'updraft_cloudfiles_apikey', 'updraft_cloudfiles_path', 'updraft_cloudfiles_authurl', 'updraft_ssl_useservercerts', 'updraft_ssl_disableverify', 'updraft_s3_login', 'updraft_s3_pass', 'updraft_s3_remote_path', 'updraft_dreamobjects_login', 'updraft_dreamobjects_pass', 'updraft_dreamobjects_remote_path', 'updraft_dreamobjects', 'updraft_report_warningsonly', 'updraft_report_wholebackup', 'updraft_report_dbbackup', 'updraft_log_syslog', 'updraft_extradatabases', 'updraftplus_tour_cancelled_on', 'updraftplus_version', 'updraft_dismiss_admin_warning_litespeed', 'updraft_dismiss_admin_warning_pclzip', 'updraft_dismiss_phpseclib_notice', ); } /* * A function that works through the array passed to it and gets a list of all the tables from that database and puts the information in an array ready to be parsed and output to html. * * @param Array $dbsinfo an array that contains information about each database, the default 'wp' array is just an empty array, but other entries can be added so that this method can get tables from other databases the array structure for this would be array('wp' => array(), 'TestDB' => array('host' => '', 'user' => '', 'pass' => '', 'name' => '', 'prefix' => '')) * note that the extra tables array key must match the database name in the array note that the extra tables array key must match the database name in the array * @return Array - databases and their table names / public function get_database_tables($dbsinfo = array('wp' => array())) { global $wpdb; if (!class_exists('UpdraftPlus_Database_Utility')) updraft_try_include_file('includes/class-database-utility.php', 'include_once'); $dbhandle = ''; $db_tables_array = array(); foreach ($dbsinfo as $key => $value) { if ('wp' == $key) { // The unfiltered table prefix - i.e. the real prefix that things are relative to $table_prefix_raw = $this->get_table_prefix(false); $dbhandle = $wpdb; } else { $dbhandle = new UpdraftPlus_WPDB_OtherDB_Utility($dbsinfo[$key]['user'], $dbsinfo[$key]['pass'], $dbsinfo[$key]['name'], $dbsinfo[$key]['host']); if (!empty($dbhandle->error)) { return $this->log_wp_error($dbhandle->error); } $table_prefix_raw = $dbsinfo[$key]['prefix']; } // SHOW FULL - so that we get to know whether it's a BASE TABLE or a VIEW $all_tables = $dbhandle->get_results("SHOW FULL TABLES", ARRAY_N); if (empty($all_tables) && !empty($dbhandle->last_error)) { $all_tables = $dbhandle->get_results("SHOW TABLES", ARRAY_N); $all_tables = array_map(array($this, 'cb_get_name_base_type'), $all_tables); } else { $all_tables = array_map(array($this, 'cb_get_name_type'), $all_tables); } // If this is not the WP database, then we do not consider it a fatal error if there are no tables if ('wp' == $key && 0 == count($all_tables)) { return $this->log_wp_error("No tables found in wp database."); die; } // Put the options table first UpdraftPlus_Database_Utility::init($key, $table_prefix_raw, $dbhandle); usort($all_tables, array('UpdraftPlus_Database_Utility', 'backup_db_sorttables')); $all_table_names = array_map(array($this, 'cb_get_name'), $all_tables); $db_tables_array[$key] = $all_table_names; } return $db_tables_array; } /* * Returns the member of the array with key (int)0, as a new array. This function is used as a callback for array_map(). * * @param Array $a - the array * * @return Array - with keys 'name' and 'type' / private function cb_get_name_base_type($a) { return array('name' => $a[0], 'type' => 'BASE TABLE'); } /* * Returns the members of the array with keys (int)0 and (int)1, as part of a new array. * * @param Array $a - the array * * @return Array - keys are 'name' and 'type' / private function cb_get_name_type($a) { return array('name' => $a[0], 'type' => $a[1]); } /* * Returns the member of the array with key (string)'name'. This function is used as a callback for array_map(). * * @param Array $a - the array * * @return Mixed - the value with key (string)'name' / private function cb_get_name($a) { return $a['name']; } /* * Retrieves the appropriate URL for the given target page * * @internal * @param String $which_page The target page * @return String - The requested URL for a given page / public function get_url($which_page = false) { switch ($which_page) { case 'my-account': return apply_filters('updraftplus_com_myaccount', 'https://updraftplus.com/my-account/'); break; case 'shop': return apply_filters('updraftplus_com_shop', 'https://updraftplus.com/shop/'); break; case 'premium': return apply_filters('updraftplus_com_premium', 'https://teamupdraft.com/updraftplus/pricing?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=updraftplus-premium&utm_creative_format=text'); break; case 'buy-tokens': return apply_filters('updraftplus_com_updraftclone_tokens', 'https://updraftplus.com/shop/updraftclone-tokens/'); break; case 'lost-password': return apply_filters('updraftplus_com_myaccount_lostpassword', 'https://teamupdraft.com/my-account/lost-password/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=forgotten-details&utm_creative_format=text'); break; case 'mothership': return apply_filters('updraftplus_com_mothership', 'https://updraftplus.com/plugin-info'); break; case 'shop_premium': return apply_filters('updraftplus_com_shop_premium', 'https://teamupdraft.com/updraftplus/pricing/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=get-it-here&utm_creative_format=text#pricing-block'); break; case 'upgrade_premium': return apply_filters('updraftplus_com_shop_premium', 'https://teamupdraft.com/updraftplus/pricing/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=upgrade-now&utm_creative_format=text'); break; case 'shop_vault_5': return apply_filters('updraftplus_com_shop_vault_5', 'https://teamupdraft.com/cart/?add-to-cart=1431&variation_id=1441?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=updraftplus-vault-storage-$1-trial&utm_creative_format=button'); break; case 'shop_vault_15': return apply_filters('updraftplus_com_shop_vault_15', 'https://teamupdraft.com/cart/?add-to-cart=1434&variation_id=1441?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=updraftplus-vault-storage-15-gb&utm_creative_format=button'); break; case 'shop_vault_50': return apply_filters('updraftplus_com_shop_vault_50', 'https://teamupdraft.com/cart/?add-to-cart=1440&variation_id=1441?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=updraftplus-vault-storage-50-gb&utm_creative_format=button'); break; case 'shop_vault_250': return apply_filters('updraftplus_com_shop_vault_250', 'https://teamupdraft.com/cart/?add-to-cart=1437&variation_id=1441?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=updraftplus-vault-storage-250-gb&utm_creative_format=button'); break; case 'anon_backups': return apply_filters('updraftplus_com_anon_backups', 'https://teamupdraft.com/blog/upcoming-updraftplus-feature-anonymise-data-before-cloning-your-site/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=unknown&utm_creative_format=unknown'); break; case 'clone_packages': return apply_filters('updraftplus_com_clone_packages', 'https://updraftplus.com/faqs/what-is-the-largest-site-that-i-can-clone-with-updraftclone/'); break; case 'premium_more_than_one_storage': return apply_filters('updraftplus_premium_more_than_one_storage', 'https://teamupdraft.com/updraftplus/pricing?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=more-than-one&utm_creative_format=text'); break; case 'premium_rackspace': return apply_filters('updraftplus_premium_rackspace', 'https://teamupdraft.com/updraftplus/features/rackspace-cloudfiles?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=rackspace-container&utm_creative_format=text'); break; case 'premium_onedrive': return apply_filters('updraftplus_premium_onedrive', 'https://teamupdraft.com/updraftplus/wordpress-cloud-storage-options?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=back-up-to-onedrive&utm_creative_format=text'); break; case 'premium_azure': return apply_filters('updraftplus_premium_azure', 'https://teamupdraft.com/updraftplus/wordpress-cloud-storage-options?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=backup-to-microsoft-azure&utm_creative_format=text'); break; case 'premium_sftp': return apply_filters('updraftplus_premium_sftp', 'https://teamupdraft.com/updraftplus/wordpress-cloud-storage-options?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=backup-via-sftp-and-scp&utm_creative_format=text'); break; case 'premium_googlecloud': return apply_filters('updraftplus_premium_googlecloud', 'https://teamupdraft.com/updraftplus/wordpress-cloud-storage-options?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=backup-to-google-cloud&utm_creative_format=text'); break; case 'premium_backblaze': return apply_filters('updraftplus_premium_backblaze', 'https://teamupdraft.com/updraftplus/wordpress-cloud-storage-options?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=backup-to-backblaze&utm_creative_format=text'); break; case 'premium_webdav': return apply_filters('updraftplus_premium_webdav', 'https://teamupdraft.com/updraftplus/wordpress-cloud-storage-options?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=backup-to-webdav&utm_creative_format=text'); break; case 'premium_pcloud': return apply_filters('updraftplus_premium_pcloud', 'https://teamupdraft.com/updraftplus/wordpress-cloud-storage-options?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=backup-to-pcloud&utm_creative_format=text'); break; case 'premium_email': return apply_filters('updraftplus_premium_email', 'https://teamupdraft.com/updraftplus/features/advanced-wordpress-backup-reports?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=for-more-email-options&utm_creative_format=notice'); break; case 'buy_clone_tokens': return apply_filters('updraftplus_buy_clone_tokens', 'https://teamupdraft.com/updraftplus/updraftclone/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=to-clone-your-site&utm_creative_format=text#pricing-block'); break; default: return 'URL not found ('.$which_page.')'; } } /* * Get log message for permission failure * * @param String $path full path of file or folder * @param String $log_message_prefix action which is performed to path * @param String $directory_prefix_in_log_message Directory Prefix. It should be either "Parent" or "Destination" * @return string\|boolean log message (HTML). If posix function doesn't exist, It returns false / public function log_permission_failure_message($path, $log_message_prefix, $directory_prefix_in_log_message = 'Parent') { if ($this->do_posix_functions_exist()) { $stat_data = stat($path); $log_message = $log_message_prefix.': Failed. '; $log_message .= $directory_prefix_in_log_message.' Directory UID='.$stat_data['uid'].', GID='.$stat_data['gid'].'. '; $log_message .= $this->get_log_message_for_current_uid_and_gid(); return $log_message; } else { return false; } } /* * Get log message for current uid and gid * * @return String log message of current process (HTML) / private function get_log_message_for_current_uid_and_gid() { $log_message = 'Effective/real user IDs of the current process: '.posix_geteuid().'/'.posix_getuid().'. '; $log_message .= 'Effective/real group IDs of the current process: '.posix_getegid().'/'.posix_getgid().'. '; return $log_message; } /* * Restore any previously-removed autoloaders / public function restore_composer_autoloaders() { foreach ($this->removed_autoloaders as $callable) { if (is_callable($callable, false, $callable_name)) { $this->log("Clean-up: re-registering composer autoloader: $callable_name"); spl_autoload_register($callable, false); } } $this->removed_autoloaders = array(); } /* * Remove any potentially clashing composer PSR4 autoloaders. Only to be used inside a backup when no other plugins' libraries should be needed * * @param Array $prefixes / public function potentially_remove_composer_autoloaders($prefixes) { if (!defined('UPDRAFTPLUS_REMOVE_COMPOSER_AUTOLOADERS') \|\| !UPDRAFTPLUS_REMOVE_COMPOSER_AUTOLOADERS) return; $functions = spl_autoload_functions(); foreach ($functions as $callable) { if (!is_array($callable) \|\| !isset($callable[0]) \|\| !is_object($callable[0])) continue; if (!is_a($callable[0], 'Composer\Autoload\ClassLoader') \|\| !is_callable(array($callable[0], 'getPrefixesPsr4'))) continue; $prefixes_psr4 = $callable[0]->getPrefixesPsr4(); if (!is_array($prefixes_psr4)) continue; foreach ($prefixes as $prefix) { if (!isset($prefixes_psr4[$prefix])) continue; $is_ud = false; if (is_array($prefixes_psr4[$prefix])) { foreach ($prefixes_psr4[$prefix] as $path) { if (false !== strpos(UpdraftPlus_Manipulation_Functions::wp_normalize_path($path), '/'.basename(UpdraftPlus_Manipulation_Functions::wp_normalize_path(UPDRAFTPLUS_DIR)).'/vendor/')) { $is_ud = true; } } } if ($is_ud) continue; if (is_callable($callable, false, $callable_name)) { $this->log("Conflict prevention: de-registering composer autoloader: $callable_name"); } $this->removed_autoloaders[] = $callable; spl_autoload_unregister($callable); break; } } } /* * Try to deal with other plugins with incompatible versions and bugs / public function mitigate_guzzle_autoloader_conflicts() { // Work round bug in the JetPack autoloader which loads a file in a different namespace $potentially_include_in = array('guzzlehttp/guzzle', 'guzzlehttp/promises', 'guzzlehttp/psr7'); foreach ($potentially_include_in as $package) { $file = UPDRAFTPLUS_DIR.'/vendor/'.$package.'/src/functions_include.php'; // Avoid conflicting with Google Ads and Listings which has already loaded this function if ('guzzlehttp/guzzle' == $package && function_exists('\GuzzleHttp\choose_handler')) continue; if (file_exists($file)) include_once($file); } } /* * Checks whether POSIX functions exists or not * * @return boolean true if POSIX functions exists or not / private function do_posix_functions_exist() { return function_exists('posix_geteuid') && function_exists('posix_getuid') && function_exists('posix_getegid') && function_exists('posix_getgid'); } /* * Wipe state-related data (e.g. on wiping settings, or on a restore). Note that there is some internal knowledge within the method below of how it is being used (if not including locks, then check for an active job) * * @param Boolean $include_locks Whether to also wipe out data other than just updraft_jobdata (e.g. updraft semaphore, lock, schedule, etc.) * @param String $table What table the data is in. It recognises only two tables ('options', 'sitemeta'), the default is 'options' / public function wipe_state_data($include_locks = false, $table = 'options') { // These aren't in get_settings_keys() because they are always in the options table, regardless of context global $wpdb; switch ($table) { case 'sitemeta': $table = $wpdb->sitemeta; $field = 'meta_key'; break; default: $table = $wpdb->options; $field = 'option_name'; // if multisite do we need site_id column in the where clause? break; } if (!class_exists('UpdraftPlus_Database_Utility')) updraft_try_include_file('includes/class-database-utility.php', 'include_once'); if ($include_locks) { $wpdb->query($wpdb->prepare("DELETE FROM $table WHERE ($field LIKE %s OR $field LIKE %s OR $field LIKE %s OR $field LIKE %s OR $field LIKE %s OR $field LIKE %s)", UpdraftPlus_Database_Utility::esc_like('updraftplus_unlocked_').'%', UpdraftPlus_Database_Utility::esc_like('updraftplus_locked_').'%', UpdraftPlus_Database_Utility::esc_like('updraftplus_last_lock_time_').'%', UpdraftPlus_Database_Utility::esc_like('updraftplus_semaphore_').'%', UpdraftPlus_Database_Utility::esc_like('updraft_jobdata_').'%', UpdraftPlus_Database_Utility::esc_like('updraft_last_scheduled_').'%')); } else { $sql = ''; if (!empty($this->nonce)) { $sql = $wpdb->prepare("DELETE FROM $table WHERE $field LIKE %s AND $field != %s", UpdraftPlus_Database_Utility::esc_like('updraft_jobdata_').'%', "updraft_jobdata_{$this->nonce}"); } else { $sql = $wpdb->prepare("DELETE FROM $table WHERE $field LIKE %s", UpdraftPlus_Database_Utility::esc_like('updraft_jobdata_').'%'); } $wpdb->query($sql); } } /* * Checks whether debug mode is on or not. If it is on then unminified script will be used. * * @return boolean true indicate use the unminified script / public function use_unminified_scripts() { return UpdraftPlus_Options::get_updraft_option('updraft_debug_mode') \|\| (defined('SCRIPT_DEBUG') && SCRIPT_DEBUG); } /* * This function has checks in place to see if a restore is still in progress * Currently used in this->block_updates_during_restore_progress and admin->print_restore_in_progress_box_if_needed * * @uses $_REQUEST['action'] * @param Int $job_time_greater_than Specify the time in seconds. Default is 120 seconds but function like block_updates_during_restore_progress has a 1 second time set as we want to check as soon as a restore is kicked off * @return void\|array There is a possibility if there is no restore in progress this can return a void. However, in every other case, it will return an array. / public function check_restore_progress($job_time_greater_than = 120) { $restore_progress = array(); $restore_progress['status'] = false; $restore_in_progress = get_site_option('updraft_restore_in_progress'); if (empty($restore_in_progress)) return; $restore_jobdata = $this->jobdata_getarray($restore_in_progress); if (is_array($restore_jobdata) && !empty($restore_jobdata)) { // Only print if within the last 24 hours; and only after 2 minutes if (isset($restore_jobdata['job_type']) && 'restore' == $restore_jobdata['job_type'] && isset($restore_jobdata['second_loop_entities']) && !empty($restore_jobdata['second_loop_entities']) && isset($restore_jobdata['job_time_ms']) && (time() - $restore_jobdata['job_time_ms'] > $job_time_greater_than \|\| (defined('UPDRAFTPLUS_RESTORE_PROGRESS_ALWAYS_SHOW') && UPDRAFTPLUS_RESTORE_PROGRESS_ALWAYS_SHOW)) && time() - $restore_jobdata['job_time_ms'] < 86400 && (empty($_REQUEST['action']) \|\| ('updraft_restore' != $_REQUEST['action'] && 'updraft_restore_continue' != $_REQUEST['action']))) { $restore_progress['status'] = true; $restore_progress['restore_jobdata'] = $restore_jobdata; $restore_progress['restore_in_progress'] = $restore_in_progress; return $restore_progress; } } } /* * Checking to see if a restore is in progress before * Turning off WP updates while restoration is in progress / public function block_updates_during_restore_progress() { $check_restore_progress = $this->check_restore_progress(1); // Check to see if the restore is still in progress if (is_array($check_restore_progress) && true == $check_restore_progress['status']) { add_filter('pre_site_transient_update_core', '__return_false'); // Disable WordPress core updates add_filter('pre_site_transient_update_plugins', '__return_false'); // Disable WordPress plugin updates add_filter('pre_site_transient_update_themes', '__return_false'); // Disable WordPress themes updates } } /* * Retrieve the list of server (Apache, Nginx, PHP, etc..) configuration file names / public function server_configuration_file_list() { $server_config_filenames = array( '.user.ini', '.htaccess', ); // the default value for user_ini.filename setting in PHP.ini file is '.user.ini' but this could be set to use different file name $server_config_filenames[] = ini_get('user_ini.filename'); // phpcs:ignore PHPCompatibility.IniDirectives.NewIniDirectives.user_ini_filenameFound -- Ignore ini_get function compatibility. $server_config_filenames = array_unique($server_config_filenames); return $server_config_filenames; } /* * Check what hosting company that this plugin is installed onto and if there appear to be any restriction being applied to it * * @return Array An array of information regarding the hosting company or empty array if this method fails to recognise the hosting company / public function get_hosting_info() { $hosting_company = array( 'name' => '', 'website' => '', 'restriction' => array(), ); if (array_key_exists('KINSTA_CACHE_ZONE', $_SERVER)) { $hosting_company = array( 'name' => 'Kinsta', 'website' => 'kinsta.com', 'restriction' => array( 'only_one_backup_per_month', 'only_one_incremental_per_day', ) ); } return apply_filters('updraftplus_get_hosting_info', $hosting_company); } /* * Check whether the hosting provider has some restriction * * @param String\|Array $restriction An array or string of restriction * @return Boolean True if the hosting provider has the given restriction, false otherwise / public function is_restricted_hosting($restriction) { $restriction = (array) $restriction; $hosting_company = $this->get_hosting_info(); if (empty($hosting_company)) return false; foreach ($restriction as $rstc) { if (in_array($rstc, $hosting_company['restriction'])) return true; } return false; } /* * Check whether the hosting has a number of backups restrictions that can be created at a particular time and whether that number has reached the limit or the time elapsed has passed the limit / public function is_hosting_backup_limit_reached() { $res = array(); $last_backup = UpdraftPlus_Options::get_updraft_option('updraft_last_backup', array()); if (empty($last_backup)) $last_backup = array(); $current_time = time(); if (!empty($last_backup['incremental_backup_time'])) { // $next_day_from_last_backup = strtotime(gmdate('Y-m-d', (int) $last_backup['backup_time'])) + 86400; $next_24hours_from_last_backup = strtotime(gmdate('Y-m-d H:i:s', (int) $last_backup['incremental_backup_time'])) + 86400; // one incremental per day and the time has gone 24 hours past the last incremental backup time if ($this->is_restricted_hosting('only_one_incremental_per_day') && $current_time < $next_24hours_from_last_backup) $res[] = 'only_one_incremental_per_day'; } if (!empty($last_backup['nonincremental_backup_time'])) { // $first_day_of_next_month_from_last_backup = strtotime(gmdate('Y-m-t', (int) $last_backup['backup_time']))+86400; $next_thirty_days_from_last_backup = strtotime(gmdate('Y-m-d H:i:s', (int) $last_backup['nonincremental_backup_time'])) + (86400 30); // Check whether the hosting provider permits only one backup per month and whether the time has gone 30 days past the last backup time if ($this->is_restricted_hosting('only_one_backup_per_month') && $current_time < $next_thirty_days_from_last_backup) $res[] = 'only_one_backup_per_month'; } return $res; } /** * Maintain compatibility on all versions between WordPress and UpdraftPlus, specifically since WordPress 5.5 / public function wordpress_55_updates_potential_migration() { // Due to the new WP's auto-updates interface in WordPress version 5.5, we need to maintain the auto update compatibility on all versions of WordPress and UpdraftPlus $udp_saved_version = UpdraftPlus_Options::get_updraft_option('updraftplus_version'); $updraft_auto_updates = UpdraftPlus_Options::get_updraft_option('updraft_auto_updates'); if (!$udp_saved_version \|\| version_compare($udp_saved_version, '1.16.34', '<=') \|\| (version_compare($udp_saved_version, '2.0.0', '>=') && version_compare($udp_saved_version, '2.16.34', '<=')) \|\| null !== $updraft_auto_updates) { $this->replace_auto_updates_option(); } } /* * Remove the use of updraft_auto_updates option/meta (single & multisite) and replace it with auto_update_plugins site option that is used in WordPress's core since version 5.5 * This needs to be done in order to maintain auto-updates compatibility between WordPress and Updraftplus and to synchronise the auto-updates setting for both / private function replace_auto_updates_option() { $old_setting_value = UpdraftPlus_Options::get_updraft_option('updraft_auto_updates'); UpdraftPlus_Options::delete_updraft_option('updraft_auto_updates'); $new_setting_value = (array) get_site_option('auto_update_plugins', array()); if (!empty($old_setting_value)) $new_setting_value[] = basename(UPDRAFTPLUS_DIR).'/updraftplus.php'; $new_setting_value = array_unique($new_setting_value); update_site_option('auto_update_plugins', $new_setting_value); } /* * Set the plugin's automatic updates setting to either on or off by removing/adding plugin basename from/into the auto_update_plugins option * * @param Mixed $value The new value which auto_update_plugins option value is replaced with / public function set_automatic_updates($value) { $auto_update_plugins = (array) get_site_option('auto_update_plugins', array()); if (!empty($value)) { $auto_update_plugins[] = basename(UPDRAFTPLUS_DIR).'/updraftplus.php'; $auto_update_plugins = array_unique($auto_update_plugins); } else { $auto_update_plugins = array_diff($auto_update_plugins, array(basename(UPDRAFTPLUS_DIR).'/updraftplus.php')); } update_site_option('auto_update_plugins', $auto_update_plugins); } /* * Check whether the automatic-updates is set for UpdraftPlus * * @return Boolean True if set, false otherwise / public function is_automatic_updating_enabled() { $auto_update_plugins = (array) get_site_option('auto_update_plugins', array()); return in_array(basename(UPDRAFTPLUS_DIR).'/updraftplus.php', $auto_update_plugins, true); } /* * Perform conditional checking of two values with the specified operator * * @param Mixed $value1 the first value to compare * @param String $operator the operator that is used for comparison of the two values * @param Mixed $value2 the second value to compare * * @return Boolean true if the first value matches against the second value, false otherwise / public function if_cond($value1, $operator, $value2) { switch (strtolower($operator)) { case 'is': case '==': return $value1 == $value2; break; case 'is_not': case '!=': return $value1 != $value2; break; default: // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Error messages should be escaped when caught and printed. throw new Exception(__METHOD__.": Unsupported (".$operator.") operator", 1); break; } } /* * Return a listing of days of the week * * @param Boolean $respect_start_of_week whether to use the WordPress's start_of_week setting * @return Array the days of the week / public function list_days_of_the_week($respect_start_of_week = true) { global $wp_locale; $days_of_the_week = array(); $i = $j = $respect_start_of_week ? (int) get_option('start_of_week', 1) : 1; while ($i < $j + 7) { // 7 days $days_of_the_week[] = array( 'index' => $i % 7, 'value' => $wp_locale->get_weekday($i % 7), ); $i++; } return $days_of_the_week; } /* * Identify whether the minimum system requirements for PHPSecLib are met * * @return Boolean True if the minimum system requirements are met, false otherwise / public function phpseclib_requirements_met() { if (version_compare(PHP_VERSION, '5.3', '>=')) return true; $active_phpseclib_related_features = array_intersect($this->list_active_features_requiring_phpseclib(), array('dropbox', 'sftp', 'dbencryption', 'updraftcentral')); if (!empty($active_phpseclib_related_features)) return false; return true; } /* * Log warnings regarding phpseclib requirements that are not met / public function maybe_log_phpseclib_warnings() { global $updraftplus; static $logged = false; $job_type = $updraftplus->jobdata_get('job_type'); if (('backup' === $job_type \|\| 'restore' === $job_type) && !$logged) { $updraftplus->log($this->get_phpseclib_warning_msg(), 'warning'); $logged = true; // prevent multiple warnings being logged } } /* * Retrieve phpseclib warning message that will be shown at the front-end and/or included in the backup/restoration logs * * @return String The warning message (filterable) / public function get_phpseclib_warning_msg() { $phpseclib_related_features = array( 'dropbox' => 'Dropbox', 'sftp' => 'SFTP/SCP', 'dbencryption' => 'Database Encryption', 'updraftcentral' => 'UpdraftCentral', ); $active_phpseclib_related_features = array_intersect_key($phpseclib_related_features, array_flip($this->list_active_features_requiring_phpseclib())); return sprintf(__('Your site is running on PHP version %s and has feature(s) currently enabled (%s) which are deprecated upon this PHP version.', 'updraftplus'), PHP_VERSION, implode(', ', $active_phpseclib_related_features)).' '.sprintf(__('Future releases of UpdraftPlus will require a more recent PHP version to use these features; we recommend that you speak to your web hosting company about updating to version %s or higher.', 'updraftplus'), '5.3'); } /* * Get plugin features requiring phpseclib which are active * * @return Array an array of active features / protected function list_active_features_requiring_phpseclib() { $active_features = array(); $encryptionphrase = UpdraftPlus_Options::get_updraft_option('updraft_encryptionphrase', ''); $updraft_services = $this->get_canonical_service_list(); $updraft_central_localkeys = UpdraftPlus_Options::get_updraft_option('updraft_central_localkeys', ''); if (in_array('dropbox', $updraft_services)) $active_features[] = 'dropbox'; if ((class_exists('UpdraftPlus_Addons_RemoteStorage_sftp') && in_array('sftp', $updraft_services))) $active_features[] = 'sftp'; if (class_exists('UpdraftPlus_Addon_MoreDatabase') && '' !== $encryptionphrase) $active_features[] = 'dbencryption'; if (!empty($updraft_central_localkeys)) $active_features[] = 'updraftcentral'; return $active_features; } /* * Retrieve site name by outputing the hostname of the URL parsed * * @return String Site name / private function get_site_name() { return preg_replace('/^www\./i', '', strtolower(parse_url(network_site_url(), PHP_URL_HOST))); } /* * Function to load Updraft_Checkout_Embed * * @return void / public static function load_checkout_embed() { global $updraftplus_checkout_embed; if (!class_exists('Updraft_Checkout_Embed')) updraft_try_include_file('includes/checkout-embed/class-udp-checkout-embed.php', 'include_once'); // Create an empty list (useful for testing, thanks to the filter below) $checkout_embed_products = array(); // get products from JSON file. $checkout_embed_product_file = UPDRAFTPLUS_DIR.'/includes/checkout-embed/products.json'; if (file_exists($checkout_embed_product_file)) { $checkout_embed_products = json_decode(file_get_contents($checkout_embed_product_file)); } else { throw new Exception(sprintf("The %s file is missing.", $checkout_embed_product_file)); // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Error messages should be escaped when caught and printed. } $checkout_embed_products = apply_filters('updraftplus_checkout_embed_products', $checkout_embed_products); if (!empty($checkout_embed_products)) { $updraftplus_checkout_embed = new Updraft_Checkout_Embed( 'updraftplus', // plugin name UpdraftPlus_Options::admin_page_url().'?page=updraftplus', // return url $checkout_embed_products, // products list UPDRAFTPLUS_URL.'/includes' // base_url ); } } /* * Function to replace avatar with default image in UpdraftClone environment * * @param String $url * * @return String $url / public function get_avatar_url($url) { if (preg_match('/gravatar.com/i', $url)) return UPDRAFTPLUS_URL.'/images/default-avatar.jpg'; return $url; } /* * Modifies the parent file value. * * This modification is necessary to prevent the active menu selection from pointing to the * old "Settings" menu and to ensure correct menu highlighting. * * @param string $parent_file The current parent file value. * * @return string The modified parent file value. / public static function parent_file($parent_file) { // Set the global variable 'self' and update the parent file to UpdraftPlus_Options::PARENT_FILE $GLOBALS['self'] = $parent_file = UpdraftPlus_Options::PARENT_FILE; return $parent_file; } /* * Unserialize data while maintaining compatibility across PHP versions due to different number of arguments required by PHP's "unserialize" function * * @param string $serialized_data Data to be unserialized, should be one that is already serialized * @param boolean\|array $allowed_classes Either an array of class names which should be accepted, false to accept no classes, or true to accept all classes * @param integer $max_depth The maximum depth of structures permitted during unserialization, and is intended to prevent stack overflows * @return mixed Unserialized data can be any of types (integer, float, boolean, string, array or object) */ public static function unserialize($serialized_data, $allowed_classes = false, $max_depth = 0) { static $polyfill_unserialize_loaded = false; if (version_compare(PHP_VERSION, '5.2', '<=')) { $result = unserialize($serialized_data); // For PHP 5.2 users, the search-replace feature has been removed, meaning that any input provided in this context will not undergo search-replace processing } else { if (!$polyfill_unserialize_loaded) { if (!class_exists('Brumann\Polyfill\DisallowedClassesSubstitutor')) updraft_try_include_file('vendor/brumann/polyfill-unserialize/src/DisallowedClassesSubstitutor.php', 'require_once'); if (!class_exists('Brumann\Polyfill\Unserialize')) updraft_try_include_file('vendor/brumann/polyfill-unserialize/src/Unserialize.php', 'require_once'); $polyfill_unserialize_loaded = true; } $result = call_user_func(array('Brumann\Polyfill\Unserialize', 'unserialize'), $serialized_data, array('allowed_classes' => $allowed_classes, 'max_depth' => $max_depth)); } return $result; } }	303.64 KB	2025-10-09 08:53
📁 css	-	2025-10-09 08:53
📄 example-decrypt.php <?php // @codingStandardsIgnoreStart /* To dump the decrypted file using the given key on stdout, call: rijndael_decrypt_file('../path/to/file.crypt' , 'mykey'); Thus, here are the easy instructions: 1) Add a line like the above into this PHP file (not inside these comments, but outside) e.g. rijndael_decrypt_file('/home/myself/myfile.crypt' , 'MYKEY'); 2) Run this file (and make sure that includes/Rijndael.php is available, if you are moving this file around) e.g. php /home/myself/example-decrypt.php >output.sql.gz 3) You may then want to gunzip the resulting file to have a standard SQL file. e.g. gunzip output.sql.gz / // @codingStandardsIgnoreEnd /* * An example of how to decrypt a file * * @param String $file Full path to file to decrypt * @param String $key Key or salting to be used */ function rijndael_decrypt_file($file, $key) { include_once(dirname(__FILE__).'/vendor/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.php'); $rijndael = new Crypt_Rijndael(); $rijndael->setKey($key); $ciphertext = file_get_contents($file); print $rijndael->decrypt($ciphertext);// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- intentional binary output }	1.17 KB	2025-10-09 08:53
📁 images	-	2025-10-09 08:53
📁 includes	-	2025-10-09 08:53
📄 index.html <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-type" content="text/html;charset=UTF-8"> <title>UpdraftPlus backup/restore/clone/migrate for WordPress</title> </head> <body> <h1>UpdraftPlus Backup / Restore / Clone / Migrate plugin for WordPress</h1> <div class="block-content"><p><a href="https://updraftplus.com" rel="nofollow">UpdraftPlus, a backup/restore/clone/migration plugin for WordPress</a> simplifies backups (and restoration). Backup into the cloud (Amazon S3, Dropbox, Google Drive, Rackspace Cloud, DreamObjects, FTP, SFTP, WebDAV and email) and restore with a single click. Backups of files and database can have separate schedules.</p> <ul> <li>Thousands of users: widely tested and reliable (over 140,000 downloads). Ranks in the top 1% on rankwp.com (228 out of 25,000 plugins).</li> <li>Top-quality: ranks 45th out of 25,000 plugins for quality on rankwp.com (top 0.25% - last checked 23rd May 2013).</li> <li>Supports backups to Amazon S3, Dropbox, Rackspace Cloud Files, Google Drive, DreamHost DreamObjects, FTP and email. Also (via premium) FTP over SSL, SFTP and WebDAV. (Note: Microsoft forbid SkyDrive to be used by backup software). </li> <li>Quick restore (both file and database backups)</li> <li>Backup automatically on a repeating schedule</li> <li>Site duplicator/migrator: can copy sites, and (with add-on) move them to new locations</li> <li>Files and databases can have separate schedules</li> <li>Failed uploads are automatically resumed/retried</li> <li>Select which files to backup (plugins, themes, content, other)</li> <li>Select which components of a backup to restore</li> <li>Download backup archives direct from your WordPress dashboard</li> <li>Database backups can be encrypted for security</li> <li>Debug mode that gives full logging of the backup</li> <li>Internationalised (translations very welcome - see below)</li> <li>Premium version and support available - <a href="https://updraftplus.com" rel="nofollow">https://updraftplus.com</a></li> <li>Tested and supported on all current PHP versions</li> </ul> <h4>Don't Risk Anything Less</h4> <p>Your backups are worth the same as your entire investment in your website. The day may come when you get hacked, or your hosting company does, or they go bust - without good backups, you lose everything. Do you really want to entrust all your work to plugins with only a few thousand downloads, or that has no professional backup or support? Believe us - writing a reliable backup plugin that works consistently across the huge range of WordPress deployments is hard.</p> <h4>UpdraftPlus Premium</h4> <p>UpdraftPlus is not crippled in any way - it is fully functional, with no annoying omissions. What we do have is various extra features, and guaranteed support, available <a href="https://updraftplus.com/" rel="nofollow">from our website, updraftplus.com</a>.</p> <p>If you need WordPress multisite compatibility (you'll know if you do), <a href="https://updraftplus.com/shop/" rel="nofollow">then you need UpdraftPlus Premium</a>.</p> <h4>Professional / Enterprise support agreements available</h4> <p>UpdraftPlus is written by professional WordPress developers. If your site needs guaranteed support, then we are available. Just <a href="https://updraftplus.com/shop/" rel="nofollow">go to our shop.</a></p> <h4>Are you multi-lingual? Can you translate?</h4> <p>Are you able to translate UpdraftPlus into another language? Are you ready to help speakers of your language? UpdraftPlus itself is ready and waiting - the only work needed is the translating. The translation process is easy, and web-based - go here for instructions: <a href="https://updraftplus.com/translate/" rel="nofollow">https://updraftplus.com/translate/</a>.</p> <h4>Other support</h4> <p>We hang out in the support forum for this plugin - <a href="http://wordpress.org/support/plugin/updraftplus" rel="nofollow">http://wordpress.org/support/plugin/updraftplus</a> - however, to save our time so that we can spend it on development, please read the plugin's Frequently Asked Questions - <a href="https://updraftplus.com/support/frequently-asked-questions/" rel="nofollow">https://updraftplus.com/support/frequently-asked-questions/</a> - before going there, and ensure that you have updated to the latest released version of UpdraftPlus.</p> </div> </body> </html>	4.34 KB	2025-10-09 08:53
📁 js	-	2025-10-09 08:53
📁 languages	-	2025-10-09 08:53
📁 methods	-	2025-10-09 08:53
📄 options.php <?php /** * Options handling / if (!defined('ABSPATH')) die('No direct access allowed'); class UpdraftPlus_Options { /* * The url for UprdraftPlus page / const PARENT_FILE = 'options-general.php?page=updraftplus'; /* * Whether or not the current user has permission to manage UpdraftPlus * * @return Boolean / public static function user_can_manage() { $user_can_manage = current_user_can(apply_filters('option_page_capability_updraft-options-group', 'manage_options')); // false: allows the filter to know that the request is not coming from the multisite add-on return apply_filters('updraft_user_can_manage', $user_can_manage, false); } public static function options_table() { return 'options'; } /* * Get the URL to the dashboard admin page * * @return String / public static function admin_page_url() { return admin_url('options-general.php'); } /* * Get the base-name for the dashboard admin page * * @return String / public static function admin_page() { return 'options-general.php'; } /* * Extracts the last logged message from updraftplus last process * * @return Mixed - Value set for the option or the default message / public static function get_updraft_lastmessage() { return UpdraftPlus_Options::get_updraft_option('updraft_lastmessage', __('(Nothing has been logged yet)', 'updraftplus')); } /* * Get the value for a specified option * * @param String $option option name * @param Mixed $default default value of option * * @return Mixed / public static function get_updraft_option($option, $default = null) { $ret = get_option($option, $default); return apply_filters('updraftplus_get_option', $ret, $option, $default); } /* * The apparently unused parameter is used in the alternative class in the Multisite add-on * * @param String $option specify option name * @param String $value specify option value * @param Boolean $use_cache whether or not to use the WP options cache * @param String $autoload whether to autoload (only takes effect on a change of value) * * @return Boolean - as from update_option() / public static function update_updraft_option($option, $value, $use_cache = true, $autoload = 'yes') { return update_option($option, apply_filters('updraftplus_update_option', $value, $option, $use_cache), $autoload); } /* * Delete an option * * @param String $option - the option name / public static function delete_updraft_option($option) { delete_option($option); } /* * Register the UpdraftPlus admin menu entry / public static function add_admin_pages() { $capability = apply_filters('option_page_capability_updraft-options-group', 'manage_options'); if (!defined('UPDRAFTPLUS_DISABLE_TOP_LEVEL_MENU_ENTRY') \|\| !UPDRAFTPLUS_DISABLE_TOP_LEVEL_MENU_ENTRY) { // Check user capability to manage options before proceeding if (!current_user_can($capability)) return; global $submenu, $title, $plugin_page; if ('updraftplus' == $plugin_page) $title = 'UpdraftPlus'; // Add "UpdraftPlus" as the main menu item add_menu_page( 'UpdraftPlus', 'UpdraftPlus', $capability, 'options-general.php?page=updraftplus', '', // Set the callback to empty string because it's unused trailingslashit(UPDRAFTPLUS_URL).'images/dashicon-white.png' ); UpdraftPlus_Options::add_submenu(); foreach ($submenu['options-general.php'] as $key => $item) { if ('updraftplus' != $item[2]) continue; unset($submenu['options-general.php'][$key]); } } else { UpdraftPlus_Options::add_submenu(); } } /* * Adds a submenu page under the "Settings" menu in the WordPress admin. * * The capability required to access this submenu is filtered through the * 'option_page_capability_updraft-options-group' filter, with a default value of 'manage_options'. / public static function add_submenu() { global $updraftplus_admin; $capability = apply_filters('option_page_capability_updraft-options-group', 'manage_options'); add_submenu_page( 'options-general.php', 'UpdraftPlus', __('UpdraftPlus Backups', 'updraftplus'), $capability, 'updraftplus', array($updraftplus_admin, 'settings_output') ); } public static function options_form_begin($settings_fields = 'updraft-options-group', $allow_autocomplete = true, $get_params = array(), $classes = '') { global $pagenow; echo '<form method="post"'; if ('' != $classes) echo ' class="'.esc_attr($classes).'"'; $page = ''; if ('options-general.php' == $pagenow) $page = "options.php"; if (!empty($get_params)) { $page .= '?'; $first_one = true; foreach ($get_params as $k => $v) { if ($first_one) { $first_one = false; } else { $page .= '&'; } $page .= urlencode($k).'='.urlencode($v); } } if ($page) echo ' action="'.esc_url($page).'"'; if (!$allow_autocomplete) echo ' autocomplete="off"'; echo '>'; if ($settings_fields) { // This is settings_fields('updraft-options-group'), but with the referer pruned echo "<input type='hidden' name='option_page' value='" . esc_attr('updraft-options-group') . "' />"; echo '<input type="hidden" name="action" value="update" />'; wp_nonce_field("updraft-options-group-options", '_wpnonce', false); $remove_query_args = array('state', 'action', 'oauth_verifier'); $referer = UpdraftPlus_Manipulation_Functions::wp_unslash(remove_query_arg($remove_query_args, $_SERVER['REQUEST_URI'])); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput -- To be executed on server only, hence this superglobal not to be empty, sanitization and unslashing is done by custom function. // Add back the page parameter if it looks like we were on the settings page via an OAuth callback that has now had all parameters removed. This is likely unnecessarily conservative, but there's nothing requiring more than this at the current time. if (substr($referer, -19, 19) == 'options-general.php' && false !== strpos($_SERVER['REQUEST_URI'], '?')) $referer .= '?page=updraftplus'; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput -- To be executed on server only, hence this superglobal will not to be empty, sanitization and unslashing are not required as this superglobal is used directly. echo '<input type="hidden" name="_wp_http_referer" value="'. esc_attr($referer) . '" />'; } } /* * Runs upon the WordPress action admin_init / public static function admin_init() { static $already_inited = false; if ($already_inited) return; $already_inited = true; // If being called outside of the admin context, this may not be loaded yet if (!function_exists('register_setting')) include_once(ABSPATH.'wp-admin/includes/plugin.php'); global $updraftplus, $updraftplus_admin; register_setting('updraft-options-group', 'updraft_interval', array($updraftplus, 'schedule_backup')); register_setting('updraft-options-group', 'updraft_interval_database', array($updraftplus, 'schedule_backup_database')); register_setting('updraft-options-group', 'updraft_interval_increments', array($updraftplus, 'schedule_backup_increments')); register_setting('updraft-options-group', 'updraft_retain', array('UpdraftPlus_Manipulation_Functions', 'retain_range')); register_setting('updraft-options-group', 'updraft_retain_db', array('UpdraftPlus_Manipulation_Functions', 'retain_range')); register_setting('updraft-options-group', 'updraft_retain_extrarules', array($updraftplus_admin, 'return_array')); register_setting('updraft-options-group', 'updraft_encryptionphrase', 'strval'); register_setting('updraft-options-group', 'updraft_service', array($updraftplus, 'just_one')); $services_to_register = array_keys($updraftplus->backup_methods); foreach ($services_to_register as $service) { register_setting('updraft-options-group', 'updraft_'.$service); // phpcs:ignore PluginCheck.CodeAnalysis.SettingSanitization.register_settingMissing -- Sanitize callback added below to avail two params. // We have to add the filter manually in order to get the second parameter passed through (register_setting() only registers with one parameter) add_filter('sanitize_option_updraft_'.$service, array($updraftplus, 'storage_options_filter'), 10, 2); } register_setting('updraft-options-group', 'updraft_auto_updates', 'absint'); register_setting('updraft-options-group', 'updraft_ssl_nossl', 'absint'); register_setting('updraft-options-group', 'updraft_log_syslog', 'absint'); register_setting('updraft-options-group', 'updraft_ssl_useservercerts', 'absint'); register_setting('updraft-options-group', 'updraft_ssl_disableverify', 'absint'); register_setting('updraft-options-group', 'updraft_split_every', array($updraftplus_admin, 'optionfilter_split_every')); register_setting('updraft-options-group', 'updraft_dir', array('UpdraftPlus_Manipulation_Functions', 'prune_updraft_dir_prefix')); register_setting('updraft-options-group', 'updraft_report_warningsonly', array($updraftplus_admin, 'return_array')); register_setting('updraft-options-group', 'updraft_report_wholebackup', array($updraftplus_admin, 'return_array')); register_setting('updraft-options-group', 'updraft_report_dbbackup', array($updraftplus_admin, 'return_array')); register_setting('updraft-options-group', 'updraft_autobackup_default', 'absint'); register_setting('updraft-options-group', 'updraft_delete_local', 'absint'); register_setting('updraft-options-group', 'updraft_debug_mode', 'absint'); register_setting('updraft-options-group', 'updraft_extradbs', array($updraftplus_admin, 'return_array')); register_setting('updraft-options-group', 'updraft_backupdb_nonwp', 'absint'); register_setting('updraft-options-group', 'updraft_include_plugins', 'absint'); register_setting('updraft-options-group', 'updraft_include_themes', 'absint'); register_setting('updraft-options-group', 'updraft_include_uploads', 'absint'); register_setting('updraft-options-group', 'updraft_include_others', 'absint'); register_setting('updraft-options-group', 'updraft_include_wpcore', 'absint'); register_setting('updraft-options-group', 'updraft_include_wpcore_exclude', array('UpdraftPlus_Manipulation_Functions', 'strip_dirslash')); register_setting('updraft-options-group', 'updraft_include_more', 'absint'); register_setting('updraft-options-group', 'updraft_include_more_path', array('UpdraftPlus_Manipulation_Functions', 'remove_empties')); register_setting('updraft-options-group', 'updraft_include_uploads_exclude', array('UpdraftPlus_Manipulation_Functions', 'strip_dirslash')); register_setting('updraft-options-group', 'updraft_include_others_exclude', array('UpdraftPlus_Manipulation_Functions', 'strip_dirslash')); register_setting('updraft-options-group', 'updraft_starttime_files', array('UpdraftPlus_Options', 'hourminute')); register_setting('updraft-options-group', 'updraft_starttime_db', array('UpdraftPlus_Options', 'hourminute')); register_setting('updraft-options-group', 'updraft_startday_files', array('UpdraftPlus_Options', 'week_or_month_day')); register_setting('updraft-options-group', 'updraft_startday_db', array('UpdraftPlus_Options', 'week_or_month_day')); global $pagenow; if ('options-general.php' == $pagenow && isset($_REQUEST['page']) && 'updraftplus' == substr($_REQUEST['page'], 0, 11)) { if (!defined('UPDRAFTPLUS_DISABLE_TOP_LEVEL_MENU_ENTRY') \|\| !UPDRAFTPLUS_DISABLE_TOP_LEVEL_MENU_ENTRY) add_filter('parent_file', array('UpdraftPlus', 'parent_file'), 99); if (is_multisite()) add_action('all_admin_notices', array('UpdraftPlus_Options', 'show_admin_warning_multisite')); } } public static function hourminute($pot) { if (preg_match("/^([0-2]?[0-9]):([0-5][0-9])$/", $pot, $matches)) return sprintf("%02d:%s", $matches[1], $matches[2]); if ('' == $pot) return date('H:i', time()+300); return '00:00'; } public static function week_or_month_day($pot) { $pot = absint($pot); return ($pot>28) ? 1 : $pot; } /* * Output information about the multisite add-on when relevant */ public static function show_admin_warning_multisite() { global $updraftplus_admin; $updraftplus_admin->show_admin_warning('<strong>'.__('UpdraftPlus warning:', 'updraftplus').'</strong> '.__('This is a WordPress multi-site (a.k.a. network) installation.', 'updraftplus').' <a href="https://updraftplus.com/shop/" target="_blank">'.__('WordPress Multisite is supported, with extra features, by UpdraftPlus Premium.', 'updraftplus').'</a> '.__('Without upgrading, UpdraftPlus allows <strong>every</strong> blog admin who can modify plugin settings to backup (and hence access the data, including passwords, from) and restore (including with customized modifications, e.g. changed passwords) <strong>the entire network</strong>.', 'updraftplus').' '.__('(This applies to all WordPress backup plugins unless they have been explicitly coded for multisite compatibility).', 'updraftplus'), 'error'); } } add_action('admin_init', array('UpdraftPlus_Options', 'admin_init')); add_action('admin_menu', array('UpdraftPlus_Options', 'add_admin_pages'));	12.92 KB	2025-10-09 08:53
📄 readme.txt === UpdraftPlus: WP Backup & Migration Plugin === Contributors: Backup with UpdraftPlus, DavidAnderson, pmbaldha, DNutbourne, aporter, bcrodua Tags: backup, database backup, wordpress backup, cloud backup, migration Requires at least: 3.2 Tested up to: 6.8 Stable tag: 1.25.8 Author URI: https://updraftplus.com Donate link: https://david.dw-perspective.org.uk/donate License: GPLv3 or later Backup, restore or migrate your WordPress website to another host or domain. Schedule backups or run manually. Migrate in minutes. Reliable and easy to use. == Description == <a href="https://updraftplus.com">The UpdraftPlus Backup & Migration Plugin</a> is trusted by the WordPress community to backup, restore and migrate their WordPress websites. UpdraftPlus is actively installed on more than 3 million websites around the world. = Backup with UpdraftPlus = UpdraftPlus is the world’s highest ranking and most popular scheduled backup and migration plugin. Backup to your preferred storage location and restore in just three clicks. Backup to Dropbox, Google Drive, Amazon S3 (or compatible), Rackspace Cloud, FTP, DreamObjects, Openstack Swift or email. The paid version also allows you to backup to Microsoft OneDrive, Microsoft Azure, Google Cloud, Backblaze B2, SFTP, SCP, pCloud, WebDAV or UpdraftVault, our integrated storage option for UpdraftPlus. Backup manually or schedule to run every 2, 4, 8 or 12 hours, daily, weekly, monthly or fortnightly. = Restore with UpdraftPlus = Your WordPress website is vulnerable. Your site may get hacked. Something could go wrong with an update or your server could crash. You might need to reverse a change made or a mistake caused by human error. Whatever the reason, you can restore your WordPress website in just a few clicks with UpdraftPlus. Choose which components to restore (e.g. plugins, themes, database etc.), click again to restore, then click again to return to the main screen. = Migrate with UpdraftPlus = It’s easy to migrate your WordPress website to another web host, server or domain with this free version of UpdraftPlus. To migrate, simply download your database, plugins, themes etc. from the source site, then upload them into your destination site. When migrating, a built-in search-and-replace engine identifies old strings and replaces these to reflect the new location. UpdraftPlus saves you time and reduces the risk of broken links or missing files associated with manual migrations. = Why UpdraftPlus? = Writing a reliable backup and migration plugin that ‘just works’ consistently across millions of different WordPress deployments is hard. UpdraftPlus is relied upon to do exactly that. We’re trusted and actively deployed on more websites around the world than any other WordPress backup and migration plugin. UpdraftPlus: * Backs up, migrates and restores * Offers a huge number of remote storage locations * Allows you to schedule backups, so you can ‘set and forget’ * Is comprehensive and easy to use * Is proven to work on over 3 million sites. [vimeo https://vimeo.com/154870690] = UpdraftPlus Premium = The free version of UpdraftPlus will back up and migrate your website perfectly well. However if you need more features and options you can purchase our Premium version. Backup and Migrate with UpdraftPlus Premium, and: * Get automatic backups before updates. Restore the very latest version if a WordPress or plugin update breaks your site. * Backup Incrementally. Changes are added to the master, saving server resources vs repeatedly backing up in full. * Get more remote storage options including Microsoft OneDrive, SFTP, Microsoft Azure, WebDAV, Google Cloud, SCP, Backblaze and pCloud. * Get 1GB of integrated storage with UpdraftVault for 99.999% reliability, redundancy and scalability. * Get more control over how many backups are stored in a specified interval. Restore from other backup plugins including BackWPup, BackupWordPress, Simple Backups and more. * Run backups at set times e.g. during periods of low traffic. * Backup to more than one location for added protection. * Get detailed reports. Includes cryptographic checksums so you can verify the integrity of the backup files and more. * Get Premium migration. Migrating to the destination site is more direct and can be done from the source site. * Get Multisite / multi-network compatibility. * Backup non-WP files and databases e.g. tables belonging to your e-commerce store or customisations to WordPress core. * Get database encryption. * Manage your backups and migrations from the WP-CLI. * Get Premium Support. Find out more <a href="https://updraftplus.com/comparison-updraftplus-free-updraftplus-premium/">on our comparison page</a>. UpdraftPlus Premium is available for purchase <a href="https://updraftplus.com/shop/">here</a>. = Managing multiple websites? = UpdraftCentral is a powerful remote control dashboard for WordPress that allows you to manage your backups, as well as updates, users, pages, posts, plugins and themes from one central location. Choose between: * <a href="https://wordpress.org/plugins/updraftcentral/#description/">UpdraftCentral</a> (free, self-hosted) * <a href="https://updraftplus.com/shop/updraftcentral-premium/">UpdraftCentral Premium</a> (paid-for, self-hosted) * <a href="https://updraftplus.com/shop/updraftcentral-dashboard/">UpdraftCentral Cloud</a> (paid-for, fully-hosted) Optimize your sites centrally by combining the power of WP-Optimize and UpdraftCentral or manage your backups centrally by combining the power of UpdraftPlus with UpdraftCentral. = Need to create a temporary clone of your site? = UpdraftClone makes it quick and easy to create a temporary sandbox for changes you want to try out. Simply select the versions of WordPress and PHP that you want, and we’ll do the rest. <a href="https://updraftplus.com/shop/updraftclone-tokens/">More about UpdraftClone</a> = The full suite of plugins from Team Updraft and friends = * <a href="https://updraftplus.com">UpdraftPlus</a>. <b>Backup, migrate and restore.</b> Rated 5* on the plugin directory and trusted by more than 3 million WordPress website owner * <a href="https://getwpo.com">WP-Optimize</a>. <b>Clean the database, compress images and caching.</b> Optimize your WordPress website. 5* user rating. 1 million + active installs. * <a href="https://aiosplugin.com">All-In-One Security (AIOS)</a>. <b>Secure your WordPress website.</b> Comprehensive, feature rich and easy to use. 5* user rating and 1 million + active installs. * <a href="https://wpovernight.com">WP Overnight</a>. <b>Quality Extensions for your WooCommerce store.</b> 5* rated invoicing, order and product management, customer management solutions and more. * <a href="https://easyupdatesmanager.com">Easy Updates Manager</a>. <b>Take control of updates.</b> Lots of features for free, and a Premium version with even more - over 300,000 users. * <a href="https://www.internallinkjuicer.com">Internal Link Juicer</a>.<b>Boost your SEO.</b> Automate internal links within your WordPress website. Save time and rank higher in the search engines. For other useful, free plugins see <a href="https://profiles.wordpress.org/davidanderson/#content-plugins">our lead developer's profile, here</a>. = Are you multilingual? Can you translate? = Do you want to help people that speak your language to backup, migrate and restore their WordPress websites? The UpdraftPlus backup, migration and restoration plugin is ready and waiting. The translation process is easy, and web-based – please go here for instructions: https://updraftplus.com/translate/. Or, if you’re already an expert WordPress translator, just pick out the .pot file from the wp-content/plugins/updraftplus/languages/ directory – if you scan for translatable strings manually, then you need to get these functions: _x(), __(), _e(), _ex(), log_e(). Many thanks to our existing translators. == Frequently Asked Questions == = How do I install the UpdraftPlus backup & migration plugin? = Here are the installation guidelines from our <a href="https://www.youtube.com/watch?v=7ReY7Z19h2I">YouTube channel</a> or from <a href="https://updraftplus.com/download/">our website</a>. = What if I have a problem / need support ? = If you’re struggling to backup, migrate or restore there’s help available. Search existing topics on the WordPress support forum or post a new one. Our support and development teams check and respond to queries everyday. UpdraftPlus Premium customers can log a ticket directly with our support and development teams via the <a href="https://updraftplus.com/support/">UpdraftPlus support hub</a>. Before you get in touch, please ensure that you have read through our <a href=https://updraftplus.com/frequently-asked-questions/">FAQs</a> and that you’ve updated to the latest release of our plugin. It helps greatly if you can include the backup log and as much other information as possible in your report, for example the PHP version, your website, the error description, how you got to the page that caused it, any other relevant plugins you have installed, plus any other information that might be of use. To find the backup log: there are links to download the logs on the UpdraftPlus settings page in the plugin - or you may be emailed it. Failing that, FTP into the directory wp-content/updraft and look for it there. If you know how, please send your PHP error logs - just the few lines that appear when you run a backup, often the file called error_log, possibly in your wp-admin directory which you can check via FTP. If you’re a programmer that can debug and send a patch, that’s even better. = When it comes to migration, what does the premium plugin do that the free plugin can't? = Migrating in the free plugin involves downloading the backups from the source site then uploading these to the destination site. To find the backup log: there are links to download the logs on the UpdraftPlus settings page- or you may be emailed it. Failing that, FTP into the directory wp-content/updraft and look for it there. Both free and Premium plugins include a built-in search-and-replace engine to replace old strings with the new location. If migration is all you require, and for simple single site migrations the free plugin will likely be enough to meet your needs. If you have additional needs around backups e.g. the ability to backup before updates, if you require more remote storage locations or if you have a WordPress multisite then we recommend UpdraftPlus Premium for the additional benefits that it brings. = UpdraftPlus runs out of time when it’s trying to backup, after I have left it for some time to give it a good chance. What can I do? = This problem is probably caused by your account being starved of resources by your (cheap) web host provider. This is far from ideal; although UpdraftPlus supports resuming backup runs right from the beginning to avoid everything having to be done at once, it has its limits. The best thing is to choose a more reputable web host. Failing this, try going into the “Expert settings” and reducing the size at which zip files are split. UpdraftPlus is known to successfully backup websites that run into the multiple-gigabytes on web servers that are not resource-starved. == Changelog == The <a href="https://updraftplus.com/news/">UpdraftPlus backup blog</a> is the best place to learn in more detail about any important changes. N.B. Paid versions of UpdraftPlus Backup / Restore have a version number which is 1 higher in the first digit, and has an extra component on the end, but the changelog below still applies. i.e. changes listed for 1.16.32.x of the free version correspond to changes made in 2.16.32.x of the paid version. = 1.25.8 - 07/Oct/2025 = * FIX: A fatal error in UpdraftCentral when trying to manage posts when no posts exist. * FIX: During a failure in the file copy process while restoring, a directory was created with the same name as the file, and the restoration process persisted when it ought to have been stopped * FIX: PHP fatal error in WP CLI commands for listing or scanning existing backups on PHP 8.0+ after a rescan * TWEAK: Add UpdraftCentral support to import_settings function with return values * TWEAK: Add support for new Amazon AWS S3 regions * TWEAK: Added Burst Statistics to the family plugin list * TWEAK: Adjust the backup logic to recognize invisible columns, and when that occurs, use a query that explicitly specifies the required columns instead of relying on "SELECT ". TWEAK: Ensure the restore process terminates with an error when file copying/moving fails * TWEAK: Improve the backup email report to better reflect the backup types and status. * TWEAK: New endpoint for getting locked settings data for UpdraftCentral * TWEAK: Perform a search and replace on __PHP_Incomplete_Class to make it work with unserialize() when object deserialization is not allowed. * TWEAK: Refactoring site info section to deduplicate and read from single source * TWEAK: Resolved a PHP warning triggered when uploading the plugin via the WP Plugins page — caused by translation functions (e.g. __()) being called too early. * TWEAK: Some text was left out of the translation POT file, which meant that certain translator plugins and libraries could not find the text, making it impossible to translate. * TWEAK: Update the db_size function to allow returning either data or html, depending on the argument that is passed in. = 1.25.7 - 07/Aug/2025 = * FIX: A regression for verifying the presence of old folders in the backup directory; old folders created during the restoration of the "Others" entity were not detected correctly. * FIX: The per-backup lock entries were not removed, resulting in an accumulation of these entries in the database over time. (Includes clean-up of old entries). * TWEAK: Add IDrive e2 and MEGA to the S3-Compatible storage list * TWEAK: Internal function call to prevent a PHP 8.1 deprecation notice on fresh WP installs * TWEAK: Add wp-staging to the default uploads exclusion list * TWEAK: Add UpdraftCentral handler for site icon upload request. * TWEAK: Added support for the database view dashicon in WordPress versions prior to 5.5. * TWEAK: Include site icon information in the 'get_site_icon' response of the UpdraftCentral core module. * TWEAK: Resolve the empty list issue on the backup email reports created by the UpdraftPlus free version * TWEAK: The "Get every feature of UpdraftPlus Premium" box shouldn't be displayed after purchases got claimed/activated * TWEAK: Remove seasonal (new year, summer, spring and plugin collection) sale notices * TWEAK: Handle unsupported character set defined for table fields during database pre-restoration. * TWEAK: Updated links in the Premium Extensions tab of the plugin’s admin menu page. = 1.25.6 - 27/May/2025 = * FIX: A regression that prevented the remote storage label from being updated * FIX: A regression that could cause unintended behaviour when restoring special files * FIX: A fatal error when executing a standalone php backup script with "do_action('updraft_backup_all')". * FIX: Regression that caused certain features (e.g. PHP Info) to break due to a missing HTML attribute on the triggering element * FIX: An issue that caused migration failure for sites using the Performance Lab plugin or other plugins implementing an object cache drop-in * TWEAK: handle non fatal file rename failure during restore * TWEAK: The automatic backup feature is now disabled by default on new installs * TWEAK: return post status and formatted date from UDC post API * TWEAK: Replace a call to unserialize() in the Dropbox storage library * TWEAK: Validate the DreamObjects endpoint to ensure only expected DreamObjects enpoint formats can pass through. * TWEAK: Position the "includes all tables not listed below" option at the beginning of the first known table in the DB restoration widget. * TWEAK: Add a new default endpoint in DreamObjects along with UI to allow users to add custom endpoint in the format "s3.<region>.dream.io". * TWEAK: The Azure Storage Service add-on now requires PHP 5.6 or higher to support the mandatory use of TLS 1.2, which will be enforced starting August 31, 2025. = 1.25.5 - 17/Apr/2025 = * FIX: A bug that prevented the Rackspace "Create new API user and container" dialog from opening. * TWEAK: An HTTP header intended to terminate the browser's connection was incorrectly assigned a value that the header does not support. * TWEAK: Ability to automatically choose the proper checkout page when the user is about to buy TeamUpdraft products from within the plugin * TWEAK: Clear Divi theme CSS cache at the end of the restoration process * TWEAK: Resolve PHP warning in pCloud addon when upgrading from free to premium version. * TWEAK: Update error messages when the user fails to connect to their TeamUpdraft account on the 'Premium/Extensions' tab. = 1.25.4 - 24/Mar/2025 = * FIX: Regression in 1.25.3 - missing database encryption input field due to the use of the "wp_kses_post" function that doesn't allow "<input>" tag to be rendered * TWEAK: Add new fields to UpdraftCentral handler = 1.25.3 - 21/Mar/2025 = * FIX: An issue that prevented an UpdraftClone backup from sending when attempting to boot an UpdraftClone from WP_CLI * FIX: An issue that prevented changing the default UpdraftClone region when attempting to boot an UpdraftClone from WP_CLI * TWEAK: The "x-amz-content-sha256" request header is now signed and included in the S3 signature version 4. Some S3-based providers mandate the signing of this header for accurate signature calculation. * TWEAK: Introduce a new constant named "UPDRAFTPLUS_S3_EXCLUDE_SIGV4_CONTENT_SHA256_HEADER". This constant allows for the exclusion of the "x-amz-content-sha256" headers from being signed if desired; it accepts a boolean value, defaulting to false. * TWEAK: Add 'noopener, noreferrer' window features to the Javascript's window.open() call to prevent the target page from changing content of the original page * TWEAK: Favicon fetching feature for UpdraftCentral * TWEAK: Minor tweak to "updates" module to include icons to plugin and screenshot url to theme update items * TWEAK: New UpdraftCentral module for background fetching * TWEAK: Revise the wording found in the expert settings regarding the deletion of local backup files * TWEAK: Update seasonal notices * TWEAK: Enhance the notifications to signify the introduction of other plugins that belong to the same plugin family * TWEAK: To avoid CORS issues and ensure the UpdraftPlus plugin is functional and accessible via the UpdraftCentral dashboard, the hostname and/or domain origin is changed from updraftplus.com to teamupdraft.com. * COMPATIBILITY: Resolved PHP deprecation warnings in lockadmin.php by eliminating the use of dynamic properties = 1.25.2 - 26/Feb/2025 = * FEATURE: Added a "Cron events" tab in the Advanced Tools section to check for the presence of the UpdraftPlus cron job. * FIX: Resolve the issue of uploads to pCloud failing after a folder name change by resetting the "folderid" whenever the folder name is updated. * TWEAK: Add site information for WooCommerce and HPOS support to the database backup header. * TWEAK: Create a log entry when a bot verification page appears during the file upload in the migration procedure. * TWEAK: Improve error message clarity for failed connection tests in migration. * TWEAK: Include details in the backup log file about the status and availability of the proxy configured in the system. * TWEAK: Update the Google library to support the WP_PROXY_HOST and WP_PROXY_PORT constants. * TWEAK: Update the link for Onedrive and Azure app creation * COMPATIBILITY: Got rid of PHP 8.4 deprecation messages caused by the E_STRICT constant usage = 1.25.1 - 11/Jan/2025 = * SECURITY: Fix a non-persistent reflected XSS vulnerability due to a missing nonce combined with missing sanitisation. This could allow an attacker, who persuaded you to click a personally-crafted link to your site's dashboard whilst you were logged in, to once run JavaScript code in your dashboard. Thanks to Asaf Mozes for finding and responsibly disclosing this issue. * FIX: Prevent the restoration from failing when there is a 'sync-xhr=()' permission policy on the response header. * FIX: Improve the approach of acquiring a suggested region for Amazon AWS S3 if a failure arises during the getBucketLocation() call, particularly when the XML response fails to provide a field for the suggested region - this resolves issues with regions (e.g. us-east-2) which recently changed their response behaviour * TWEAK: Broaden the support to incorporate the "ap-southeast-4" region of Amazon AWS S3 and additional recently updated regions * TWEAK: A regression in the paid version update checker to version 4.13.2, resulting in non-appearance of notices concerning subscription status or WP version compatibility. = 1.24.12 - 23/Dec/2024 = * FIX: The pre-restoration stage failed to properly address the tables that were to be excluded, which caused a logical error that misread the checked "include all tables not listed" option as an instruction to restore every table * FIX: Update PHPSecLib library to version 2.0.48 which has the fixes for the "gmp_pow(): base and exponent overflow" on certain PHP versions and could cause backups to fail on the SFTP remote storage * TWEAK: Complete the review and removal of calls to the unserialize() PHP function allowing class instantiation begun in 1.24.7. (The final removal involved a theoretical security defect, if your development site allowed an attacker to post content to it which you migrated to another site, and which contained customised code that could perform destructive actions which the attacker knew about, prior to you then cloning the site. The result of this removal is that some search-replaces, highly unlikely to be encountered in practice, will be skipped). * TWEAK: Drop search and replace feature for PHP 5.2 users (to fulfil the preceding item) * TWEAK: Tweak UpdraftCentral media module to add "has_image_editor" property to each media item * TWEAK: On the restoration screen in a multisite configuration, the dropdown labeled "which site to restore" was covering other HTML elements, which caused some buttons to be positioned at the bottom instead of at the top * TWEAK: Avoid deregistering jQuery-UI CSS if already printed by other plugins to prevent compatibility issues * TWEAK: In the context of database restoration, the execution of LOCK and/or ALTER SQL statements must be avoided for any tables that are part of the "skipped tables" list * TWEAK: openssl_free_key() is only needed on PHP < 8 * TWEAK: Various coding style changes to comply with "Plugin Check" rules = 1.24.11 - 15/Nov/2024 = * TWEAK: Do not request drive.readonly scope on Google Drive connections, due to Google's app permissions review (unannounced and requires us to create a Youtube video for their review process) - this means that (until the review completes) new connections to Google Drive can only access backups created by UpdraftPlus directly, and not backups which you manually upload to Google Drive. This restores the ability to make new connections to Google Drive. * TWEAK: Adjustment of the UpdraftPlus_S3_Compat class to preserve compatibility with the external UpdraftPlus AWS SDK plugin (https://github.com/DavidAnderson684/updraftplus-aws-sdk). = 1.24.9 - 14/Nov/2024 = * FIX: A regression in 1.24.8 when handling restoration of wp-config.php * TWEAK: The changes in handling of loading text domains in 1.24.8 did not cover most cases * TWEAK: Introduce the "updraftplus_use_builtin_wpcore_restoration" filter which can be used to restore WP-Core entity using a different WP-Core restoration mechanism especially in a case that the admin-ajax.php file couldn't be deleted during the restoration = 1.24.8 - 13/Nov/2024 = * TWEAK: Add descriptions for the 'Clone Package' dropdown when creating a clone. * TWEAK: Move the "load_plugin_textdomain" call from being called through "plugins_loaded" action to being called via "init" action * TWEAK: Update the log message to specify that backup files are marked as "processed" when no remote storage is selected, and as "uploaded" when remote storage is selected. * TWEAK: Some code tidying in the restore class = 1.24.7 - 04/Nov/2024 = * TWEAK: Include the .part file extension into the cleanup list, guaranteeing that files associated with this extension are regularly deleted from the backup directory * TWEAK: The update functionalities in the WordPress plugin information box (6.5 and later) have been adjusted to stop updates from taking place in the same window, ensuring that the "auto-backup before update" dialog appears as intended * TWEAK: Add customized "unserialized" method into the UpdraftPlus class which can handle the use of the "options" argument or its absence when running across different PHP versions * TWEAK: Add the UPDRAFTPLUS_SEND_UNWRITABLE_BACKUP_DIRECTORY_EMAIL constant to disable the sending of unwritable backup directory emails to users. * TWEAK: Clearer notifications to users regarding unconfigured remote storage settings and/or the selection of remote storage that are not part of their UpdraftPlus version * TWEAK: During the resumption of OneDrive’s chunk uploads, the authorisation header and bearer token should not be included as it may lead to an unauthenticated error due to a different upload URL. * TWEAK: Implement code to enable automatic activation of the UpdraftPlus plugin during the migration process from a multisite setup to a standalone site * TWEAK: In a multisite environment, ensure that users can access the UpdraftPlus plugin page even in the absence of the WP_ALLOW_MULTISITE constant * TWEAK: UpdraftClone now supports PHP 8.4 * TWEAK: Prevent a potential PHP deprecation notice when zip creation fails = 1.24.6 - 25/Sep/2024 = * TWEAK: In 1.24.5, the browser title wrongly displayed as "UpdraftPlus" when accessing an unrelated plugin page using the main menu. = 1.24.5 - 24/Sep/2024 = * FIX: Incorrect regular expression for DigitalOcean Spaces endpoint * FIX: CSS conflicts with the LearnDash LMS Instructor Role Add-on plugin which caused some UI elements to disappear * TWEAK: Reorganize UpdraftPlus in left-hand menu and rename it to "UpdraftPlus"; to disable it, follow this guide: https://updraftplus.com/new-location-of-updraftplus-in-the-wordpress-dashboard/ * TWEAK: Add span wrapper to UpdraftCentral connection failed message * TWEAK: Add the "Go here to complete your settings" link into the appropriate admin notice that when clicked will jump to the UpdraftVault configuration if no settings are specified. * TWEAK: Adjust regex patterns that didn't match some temporary files, causing them to not be automatically removed * TWEAK: After a restoration, clicking "Delete old folders" will also remove the wp-config-pre-ud-restore-backup.php file * TWEAK: On the settings page/tab; prevent the floating "Save changes" button from getting clicked multiple times and/or sending multiple AJAX requests * TWEAK: Remove pCloud from the add-ons list on the "Premium / Extensions" tab (there is no change in its availability) * TWEAK: Renamed wp-config-backup.php to wp-config-pre-ud-restore-backup.php to clarify its purpose as a backup file created before restoring WordPress core entities, and it will only be generated if the user does not select the "Over-write wp-config.php" option during restoration, as the previous name was too generic and could cause confusion * TWEAK: The popup modal for automatic plugin updates fails to retain the backup checkbox selection when the "remember" option is enabled in a Multisite environment. * TWEAK: Updated autobackup selector to resolve issues caused by the missing "update-link" class in WPForms Pro plugin = 1.24.4 - 2/Jul/2024 = * FIX: Case-sensitive issue of bit field type names in a table. * FIX: Resolved issue where backup files could not be deleted from remote storage when either the root directory was active or no directory was specified in the OneDrive configuration form. * FIX: When users attempt to update a plugin using the "View Version x.x.x Details" link instead of choosing "Update Now," the plugin is successfully updated; however, the UI incorrectly displays an "Update Failed" message * FIX: Conflict with the Gravity Forms plugin when there was an older version of jQuery UI presented on the "Installed Plugins" page. * TWEAK: Ensure compliance with Google Granular Consent and check for required permissions during storage access authorisation of Google Drive and Google Cloud * TWEAK: Prevent PHP warning and deprecation messages after completing access authorisation to Google Drive storage. * TWEAK: Prevent PHP warning when Dropbox remote storage has been authenticated and the page is refreshed. * TWEAK: Added filter updraftplus_working_dir_localpath to allow temporary unzip path to be modified by developers * TWEAK: Modify the displayed title of the plugin from "WordPress Backup & Migration Plugin" to "WP Backup & Migration Plugin" as required by the plugin directory team * TWEAK: Parse certain php events and log proper error messages = 1.24.3 - 30/Apr/2024 = * FIX: Regression in 1.23.16 for improving logs which then caused incorrect_offset error reported by Dropbox wasn't properly handled. * TWEAK: The UpdraftVault remote storage can handle Wasabi as well as Amazon S3 storage in the background. * TWEAK: Fix WP_Theme_JSON_Resolver::theme_has_support deprecation warning for UpdraftCentral * TWEAK: Prevent "PHP Warning: Undefined property: UpdraftPlus_BackupModule_pcloud::$description" during rescan remote storage. * TWEAK: Prevent PHP deprecation warnings during database backups when encountering null values in bit field types. * TWEAK: Show a warning message when the WP_ACCESSIBLE_HOSTS constant is defined and updraftplus.com is not permitted by its value * TWEAK: Update notices * TWEAK: Split multiple sentences into separate translation function calls. * TWEAK: Trim spaces from S3-Compatible (Generic) endpoint. = 1.24.2 - 26/Mar/2024 = * FIX: The "Continue restoration" and "Dismiss" buttons on the unfinished restoration dialog were not responsive to being pressed due to a recent regression * FIX: Conflict with other plugins due to different version of third party library (Guzzle) and the composer autoload.php was called too early * FIX: Undefined "NET_SCP_LOCAL_FILE" constant when SCP was in use for the SFTP/SCP remote storage * TWEAK: Add compatibility fields when returning plugins and themes to UpdraftCentral * TWEAK: Due to issues in some cURL versions 7.x in handling HTTP/2 connections, all HTTP connections to the OneDrive API are now forced to use HTTP/1.1 version, on cURL versions after 7.61 and before 8.0. Also, a constant named UPDRAFTPLUS_ONEDRIVE_CURL_HTTP_VERSION can be set in the wp-config.php file to change the default HTTP version to another preferred version * TWEAK: Adjust margin to fix broken UI for the 'View logs' button on backups. * TWEAK: Ensure all "SET SQL_MODE" statements in the database backup file are internally handled and are subjected only to a restoration outside UpdraftPlus plugin * TWEAK: Prevent PHP 8.2 coding style deprecation notices in the autobackup addon * TWEAK: In the context of OneDrive's chunk upload, authorisation header and bearer token should not be included during upload session as it may lead to 401 HTTP status due to different upload URL * TWEAK: Remove default value for updraftplus_https_to_http_additional_warning and updraftplus_http_to_https_additional_warning filters. * TWEAK: Set the SQL_MODE to 'NO_AUTO_VALUE_ON_ZERO' in the database backup file. * TWEAK: Seasonal notice content update for 2024 * TWEAK: During the operations that require phpseclib, include the composer autoload.php only when the phpseclib is really needed = 1.24.1 - 21/Feb/2024 = * FEATURE: Implement Backblaze Object Lock support (Premium version) * FIX: The email backup and basic report setting didn't work causing notification email confirming backup status couldn't be delivered to admin's email address (free version) * FIX: Fix WP-Optimize premium discovery for UpdraftCentral * FIX: Regression in 1.23.16 for correcting calls to translation functions which then caused some HTML attributes to be empty * FIX: Restoring backup sets via Migrate/Clone tab had caused all associated backup entities being downloaded immediately ignoring user preferences about the entities they wanted to restore * FIX: Third-party library conflict (phpseclib) with WP All Import Pro and AIO WP Migration plugins that caused failure in testing SFTP credentials and backing up to the SFTP remote storage * FIX: Restore compatibility with WordPress multisite running on versions < 4.9 caused by use of function not present before then * TWEAK: Add new translation entries for UpdraftCentral * TWEAK: Got rid of PHP 8.2 deprecation messages caused by a null value being passed to the htmlspecialchars() function and creation of dynamic property * TWEAK: Got rid of PHP 8.3 deprecation messages caused by calling get_class() without arguments. * TWEAK: Refactor methods in UpdraftPlus_Database_Utility class * TWEAK: Send an email if the backup directory is not writable. * TWEAK: Add and set the `filename_only` parameter to reduce search times when looking for specific backup files in Dropbox. * TWEAK: Autoload PHP secure communication library (phpseclib) in a better way that would prevent already-loaded phpseclib classes (by other plugin) from being used in certain operations * TWEAK: Add updraftplus_backup_db_header_append filter to allow site owners to include arbitrary content in their database backup header = 1.23.16 - 23/Dec/2023 = * TWEAK: Added demo link for the family plugin in advertisement * TWEAK: Removed https / http prefix from s3generic endpoints * TWEAK: Resolve PHP 8.0 compatibility with ob_implicit_flush function * TWEAK: Dropbox error logs improvement * TWEAK: As required by the wordpress.org plugin team, all UpdraftPlus news is forbidden to be displayed in the "WordPress News" section of the dashboard for users of the free plugin even if consent is first given. * TWEAK: Fix some incorrect calls to translation functions = 1.23.14 - 30/Nov/2023 = * FIX: Resolved Google Cloud remote storage authentication flow * TWEAK: Changed updraftvault links functionality to open in different tab * TWEAK: Clarify significance of warnings in report emails * TWEAK: Make the news-consent's layer fit with the confirmation text thus removing empty space that can reveal some of the UpdraftPlus news * TWEAK: Declare a shim "php_uname" function when it's found to be undefined to prevent a fatal error in the phpseclib library (which calls it) = 1.23.13 - 22/Nov/2023 = * FIX: An issue that prevented incremental backups from running via WP-CLI or Cron when the option to backup mu-plugins was enabled but no mu-plugins existed * FIX: OneDrive remote storage authentication was giving the error "Invalid input." * FIX: The option to back up additional, user-chosen files (i.e. the morefiles entity) was no longer present in the UI * TWEAK: Remove unused "migrator-lite.php" string during search and replace operations * TWEAK: Replace remaining hardcoded text domain with UPDRAFTCENTRAL_TEXT_DOMAIN placeholder within the central folder * TWEAK: LiteSpeed admin dashboard warning is now displayed upon completion of migration on the destination site, even after dismissing the message on the source site. * TWEAK: Do not show UpdraftPlus news in the WordPress events and news widget section without first gaining user consent * TWEAK: Change order of checks when seeing if cPanel is present/accessible for asking about disk quota in order to prevent unwanted an PHP notice when safe_mode is active * TWEAK: Prevent potential fatal error if something has modified an updates check's 'translation' property to be invalid before passing on to UpdraftPlus * TWEAK: Update bundled cacert.pem file = 1.23.12 - 08/Nov/2023 = * FIX: Issue that prevented some database restores from completing due to a change in wpdb in WordPress 6.4 * TWEAK: Replace Javascript onchange event with oninput event to detect changes made for HTML <input> tags on the settings page, also to add <textarea> to the event handler so that unsaved changes can be detected = 1.23.11 - 03/Nov/2023 = * SECURITY: Fix a vulnerability which could, if you had Google Drive storage enabled, and if an attacker targetted a logged-in administrator on your site and persuaded them to access a specific URL that the attacker creates, add the attacker's own Google Drive account to the saved storage methods. Thanks to Nicolas Decayeux of Patrowl for finding and disclosing this issue. * FEATURE: Add JSTree for Google Drive to select existing folder * FEATURE: The "Must-use plugins" backup entity can be backed up and restored separately in a normal WordPress site * FIX: OneDrive folder case sensitivity issue (successfully uploaded backup files to the remote storage but failed in pruning old backup files due to different letter capitalisation; also happened in manual deletions) * FIX: When two instances of WebDav remote storage were sequentially added in the Premium version, filling some fields of the latest instance would break the WebDav URL of the previous instance * TWEAK: Update phpseclib library from version 1 to 2. As previously advised, this also means that these features (Database Encryption, Dropbox & SFTP/SCP remote storage, and UpdraftCentral key creations) will no longer be available and can cause a fatal error when running on PHP 5.2 * TWEAK: Add a link to Trustpilot in the review prompt * TWEAK: Added a warning message when the WP_HTTP_BLOCK_EXTERNAL is defined and set to true * TWEAK: Added the "Copy to clipboard" button under the self-hosted central option * TWEAK: File size is shown when pressing on the backup entity * TWEAK: Fix the restore dialog to not display "plugins" checkbox when only there's "mu-plugins" entity * TWEAK: Fixed PHP 8.2 deprecation messages caused by a null value being passed to the rtrim() function * TWEAK: Resolve PHP deprecations for the dynamic property access by declaring the variables in the class * TWEAK: Includes the plugin.php file path if "get_mu_plugins" function does not exist. * TWEAK: Provide default options for function UpdraftPlus::backup_all() * TWEAK: Add and call the `litespeed_finish_request()` function to ensure the HTTP connection made from the browser gets closed immediately without having to wait the process to complete thus leaving it run in the background * TWEAK: Ensure no PHP "Class not found" is showing up during credentials testing * TWEAK: Add type checking in UpdraftPlus::handle_url_actions() to prevent plugin conflicts causing PHP errors on PHP 8+ = 1.23.10 - 05/Sep/2023 = * TWEAK: New S3 signature version setting is added to the S3-Compatible (Generic) configuration form, giving an opportunity for the user to choose which signature version to use (SigV2 or SigV4) * TWEAK: Enable PHP 8.3 (see: https://stitcher.io/blog/new-in-php-83) support in UpdraftClone * TWEAK: Adjust fread() sizes for better performance when uploading an archive via the widget = 1.23.9 - 14/Aug/2023 = * FIX: Fatal error of Uncaught ArgumentCountError when the UpdraftPlus settings page is browsed from an IP-adressed site (i.e. no hostname) on PHP 7.1+ * FIX: Incorrect caching mechanism such that when multiple Google Drive storage back-ends were in use (Premium feature), uploading to a storage would fail due to unmatched folder ID taken from a different storage instance * TWEAK: Define class properties in UpdraftPlus_Addons_Migrator class for PHP 8.2 compatibility = 1.23.8 - 08/Aug/2023 = * FEATURE: Given the basic migration feature in the free plugin * FIX: Content-MD5 and any V2-related headers were always included in the S3's V4 SignedHeaders even though the headers were not presented in a HTTP request * FIX: Generating URL-encoded queries for a canonical request should have used a method/mechanism which encoded query values according to RFC 3986 (for consistency and for not breaking the code) * FIX: Search / replace database not working on Admin dashboard > Settings > UpdraftPlus Backups > Advanced Tools > Search / replace database on PHP 8.2 due to stricter type checking * FIX: A newly added subsite that was restored from a normal site to the multisite was not listed in the site list in the multisite * FIX: Manual deletion of backup sets appeared to skip some files when multiple instance and/or remote storage were in use * FIX: The SFTP remote storage stopped working in the UpdraftPlus 2.23.6 release. Reverted the change "TWEAK: Validate SFTP key field on credential test and before save" * TWEAK: Add a warning in the log file if AWS connection fails and a TLSv1.2 connection test fails * TWEAK: Add warning for user if only PclZip available * TWEAK: Fix unable to switch tab when a plugin (wrongly) loads certain CSS onto UD's settings page * TWEAK: Remove the word 'apparently' in the backup success message * TWEAK: Update to latest phpseclib 1.0.X version (prevents deprecation notice on PHP 8.1+) * TWEAK: Change "s3" property to "public" in UpdraftPlus_AWSRequest class for PHP 8.2 deprecation compatibility * TWEAK: Fixed Missing/ broken links for the pCloud image in addons tab * TWEAK: Buying UpdraftClone tokens through inline checkout * TWEAK: Fixed Spelling errors in updraftplus repo * TWEAK: Added save button at the top of setting tab content * TWEAK: UpdraftCentral module now, by default, overwrites the same existing theme installed on the remote sites (if any), regardless of what version is currently installed or what version being uploaded and installed * TWEAK: Define class properties in Updraft_Checkout_Embed class for PHP 8.2 deprecation compatibility * TWEAK: Update the composer package yahnis-elsts/plugin-update-checker for PHP 8.2 compatibility * TWEAK: Added username and email details for authenticated dropbox account in updraftplus settings * TRANSLATIONS: Split sentences to make one sentence in any translation functions = 1.23.7 - 04/Jul/2023 = * FIX: When Dropbox returns an error, this error was not always correctly passed up to the logging layer * FIX: Search / replace database not working on Admin dashboard > Settings > UpdraftPlus Backups > Advanced Tools > Search / replace database on PHP 8.2 due to stricter type checking * FIX: The SFTP remote storage stopped working in the UpdraftPlus 2.23.6 release. Reverted the change "TWEAK: Validate SFTP key field on credential test and before save" * TWEAK: Fixed Missing/ broken links for the pCloud image in addons tab * TWEAK: Buying UpdraftClone tokens through inline checkout * TWEAK: Prevent PHP warning during some migrations when no table list provided = 1.23.6 - 19/Jun/2023 = * FIX: Search / replace database not working on Admin dashboard > Settings > UpdraftPlus Backups > Advanced Tools > Search / replace database on PHP 8.2 due to stricter type checking * TWEAK: Remove the incremental dropdown on incremental backup restore when the user selects only the database to restore * TWEAK: Validate SFTP key field on credential test and before save * TWEAK: Remove the unused UpdraftPlus_S3::getHttpUploadPostParams() method * TWEAK: Attempt to workaround some web hosts' opcode cache producing incorrect error upon upgrade * COMPATIBILITY: Fix pCloud deprecated warning in PHP 8.2 * COMPATIBILITY: Fix Google Cloud deprecated warning in PHP 8.2 * COMPATIBILITY: Fix Google Drive deprecated warning in PHP 8.2 * TWEAK: Fixed issue with cron jobs not clearing after wiping settings * TWEAK: Added link to WP-Optimize in the database size tab in the advanced tools = 1.23.4 - 16/May/2023 = * SECURITY: Fixed a missing nonce combined with a URL sanitisation failure, which could lead to a targeted XSS opportunity (if an attacker persuades a logged-in administrator to both re-authorise their connection to a remote storage (e.g. Dropbox) and then to follow a link personally crafted for their site before re-authorising whilst logged in, he can then store a fixed JavaScript payload in the WP admin area (they would need a further route to use that ability to cause any damage). Because of the need for the administrator to co-operate in multiple steps, this attack is very unlikely (but you should of course still update). * FIX: DigitalOcean S3-compatible storage does not work with disabled SSL entirely where possible settings. * FIX: If there was an error or network connectivity issue on first attempt of uploading a plugin/theme file, then the second attempt of uploading the same file would make the file become corrupted thus resulting in installation failure. * COMPATIBILITY: Suppress htmlspecialchars deprecation warnings on PHP 8.1 * COMPATIBILITY: Suppress some PHP 8.2 deprecation notices from use of ${} style variables, and others from use of dynamic properties * TWEAK: Handle web hosting company setup that disabled pclose() but not popen() * TWEAK: All HTTP requests to the Google Drive API now, by default, forces to use HTTP/1.1 version. Also, a constant named UPDRAFTPLUS_GDRIVE_CURL_HTTP_VERSION can be set in the wp-config.php file to change the default HTTP version to another preferred version * TWEAK: Improve 'move' and 'copy' filesystem functions in restoring directories containing files to a different mount point/partition than where they reside * TWEAK: Improve files pruning mechanism, by not repeating already-done ones when resuming deletions * TWEAK: Improve the Handlebars templates of the Google Drive, Dropbox and UpdraftVault remote storage modules by taking PHP code out of them * TWEAK: Improve widget layout when decrypting a backup * TWEAK: Remove Bootstrap CSS in Restore Wizard and replace with Flexbox CSS * TWEAK: Add multisite subsites header information to the database backup file that will be used for converting a network subsite to a standalone normal WordPress site * TWEAK: Add the UpdraftPlus plugin slug header to the database backup file * TWEAK: Include next-level-up directory path along with deleted folder's name when deleting a folder * TWEAK: Update seasonal notices * TWEAK: Make common logic for getting backup history from the database * TWEAK: Remove usage of the file_get_contents() function from WebDAV remote storage without chunking upload * TWEAK: Pass through some previously unhandled Dropbox error codes * TWEAK: Added the "non-core" word to the WordPress database tables excluded warning. * TWEAK: Remove WordPress core tables from the non-core WordPress database tables excluded list in restoration step 2 * TWEAK: When migrating the www site, the search replace will be performed in database tables on the non-www domain too, and vice versa = 1.23.3 - 16/Mar/2023 = * SECURITY: This release fixes an important security defect - please update. Full details: https://updraftplus.com/updraftplus-1-23-3-2-23-3-important-security-release/. Sites are affected if there are WordPress users (i.e. people who can login) who can reach the back-end (i.e. wp-admin) dashboard (but we recommend everyone updates in any case). = 1.23.2 - 15/Mar/2023 = * FIX: Automatic backups before updating a plugin, theme, or WP core were not working (regression in 1.23.1) * FIX: A database backup couldn't be taken from WP-Optimize and All-In-One Security (AIOS) (regression) * TWEAK: Add a user capabilities check when downloading a backup (this is not believed to have any security implications, as the download operation already requires knowledge of a further nonce that there is no mechanism for a non-administrator to obtain). * TWEAK: Improve the Handlebars template of the UpdraftVault remote storage by taking PHP code out of it * TWEAK: Prevent making a nonce available to logged-in users who could not manage UpdraftPlus (this did not give access to any unauthorised actions) * TWEAK: Improve the Handlebars template of the UpdraftVault remote storage by taking PHP code out of it * TWEAK: Improve the Handlebars template of the pCloud remote storage by taking PHP code out of it = 1.23.1 - 08/Mar/2023 = * FEATURE: Support Cloudflare R2 as a generic S3 storage provider (always use v4 signature) * FEATURE: Added the ability to get an accurate row count for all tables in the advanced tools * FEATURE: Expose an option in the UI to disable chunked uploading when using WebDAV remote storage (previously required a constant) * FEATURE: Add the ability to anonymize WooCommerce order data when cloning a site * FIX: An over-ride enforcing use of V4 signatures on Aliyuncs S3 storage was no longer working * FIX: pCloud error handling in chunked uploading did not pass the error message up to the logging layer * FIX: Backups started under WP-CLI could not backup the database only without any files * FIX: Couldn't add any file/directory inclusion for "Other" entity due to access to one directory up from the current (ABSPATH) isn't permitted * FIX: Atomic restore is not renaming a few tables when not restoring specific tables by using the filter `updraftplus_restore_this_table`. * FIX: Sometimes the "delete old directories" notice displayed even though the actual `-old` directory didn't exist * FIX: The restore point date time was incorrect in the restore screen when restoring the incremental backup, and the WordPress site has a non-GMT timezone set. * TWEAK: Improve manual rescanning and deletion of backup sets by setting up a time limit to a value defined in UPDRAFTPLUS_SET_TIME_LIMIT constant to minimise chances of getting fatal error (maximum execution time exceeded) * TWEAK: Add a filter updraftplus_mysqldump_arguments to allow changing of arguments passed to the mysqldump binary when that is being used * TWEAK: Include PHP version in default S3 user agent to aid debugging * TWEAK: Disable Gravatar on UpdraftClone * TWEAK: Cleanup .list.tmp files when a cloud backup completes * TWEAK: Use the function that lists our own cron schedules to simplify the way backup intervals are prepared and to avoid schedules mismatch * TWEAK: Improve manual deletion of backup sets by setting up a time limit to a value defined in UPDRAFTPLUS_SET_TIME_LIMIT constant to minimise chances of getting fatal error (maximum execution time exceeded) * TWEAK: Improve the Handlebars template of the S3-Compatible (Generic) remote storage by taking PHP code out of it * TWEAK: Increase max_recursion value to 20 in class-search-replace.php * TWEAK: Add a new function that lists our own cron schedules so that it can later be used as schedules sorting purpose also as a main source from which our schedules list is originated * TWEAK: Display Google drive email address along with account holder name * TWEAK: Fixed WebDAV PHP 8.1+ deprecated warnings * TWEAK: Updated text message displayed on Web Server - Localhost UC Dashboard Key Creation. * TWEAK: Use nonce in every part of a restoration process to prevent direct access that has allows an unwanted log file to be begun. On sites running on end-of-lifed PHP versions (<8.0) it was possible to read the beginning of the log file, causing an unintended information disclosure about the server environment, e.g. Apache version, PHP version and available memory (but current PHP versions are not vulnerable). * TWEAK: Use nonce when starting a new restoration and strengthen the continuation process to prevent direct access that has the potential of being file and/or log abuse * TWEAK: Improve the WebDAV storage module API in regard to the way it handles uploading and writing files * TWEAK: Replace the word "Directory" with "Folder" in UI notices * TWEAK: UpdraftVault: select storage class intelligently = 1.22.25 - 16/Dec/2022 = * FIX: Resolves a fatal error that occurred if a user had one specific add-on and not another (i.e. paid versions only) = 1.22.24 - 14/Dec/2022 = * FEATURE: Support PHP 8.2 in UpdraftClone * FEATURE: pCloud protocol support (Premium) * FIX: Add missing support for custom Dropbox app refresh tokens * FIX: After sending email report, other emails that follow would contain leftover data from the previous email report * FIX: Javascript hook that is used to show "Automatic backup before update" dialog box when pressing "Install Update Now" button on the WP Plugins page had made the same button on WP Updates page not respond to a press * FIX: Potentially not storing the size of new files in the backup history * FIX: Pressing "Rescan remote storage" using WebDAV can show an error message * FIX: Prevent a fatal error when logging PHP events using the exported "central" folder on the remote site * FIX: Prevent an error that occurs on WordPress 6.1 when managing and creating post/page from UpdraftCentral * FIX: Prevent fatal error when rescanning if internal directory was unusable * TWEAK: Ability to permanently dismiss Litespeed warning * TWEAK: Add admin notice to inform the user to upgrade their PHP to version 5.3 or higher due to changes in phpseclib requirements in future releases * TWEAK: Add "#[\ReturnTypeWillChange]" attribute to Google Drive API for suppressing PHP 8.1 deprecation notices * TWEAK: Add the ability to anonymize personal data in the database backup when using migrator * TWEAK: Advise users if files in the plugin are missing * TWEAK: Discourage page caches from caching UpdraftClone intermediate pages * TWEAK: "Dismiss from main dashboard" button sometimes doesn't work * TWEAK: Fix missing FTP admin notices when clicking on other remote storage method * TWEAK: Hive off the AWS S3 SDK into a separate plugin (UpdraftPlus now always uses its own, more lightweight, SDK) - https://github.com/DavidAnderson684/updraftplus-aws-sdk * TWEAK: Improve the Handlebars template of the Amazon S3 remote storage by taking PHP code out of it * TWEAK: Improve the Handlebars template of the DreamObjects remote storage by taking PHP code out of it * TWEAK: Improve wording in plugin by removing ambiguous wordings * TWEAK: Increase the Google Cloud (Premium) downloading minimum chunk size for faster downloads * TWEAK: In Premium / Extensions tab add notices for AIOS and Easy Updates Manager * TWEAK: Log the list of blocks that failed to re-assemble in Microsoft Azure. * TWEAK: Make the Google Drive downloading algorithms adapt to available memory - cut the total download time by 2/3 in testing * TWEAK: Prevent a PHP notice upon UpdraftClone startup * TWEAK: Prevent deprecation notice on PHP 8+ if opening a zero-size zip file * TWEAK: Replace the use of $_SERVER['SERVER_NAME'] variable with network_site_url() function because the array key is not defined in WP-CLI and might not be defined on some server-side cron tasks, resulting in a PHP log message * TWEAK: Set a global context for $wp_file_descriptions context so that it gets assigned to correctly, preventing a subtle visual change in the theme editor * TWEAK: Use built-in logging for WebDAV * TWEAK: WP Rocket - disable CDN upon migration completion for multisite since key will be invalid = 1.22.23 - 29/Sep/2022 = * FIX: Fix "More Files" tracking on resumption * FIX: Parse error when loading plugins and themes in UpdraftCentral. Error occurs when UpdraftPlus is installed in a system with PHP 5.6 or older. * FIX: BinZip did not handle out-of-tree directory symlinks. These are now backed up as expected. * FIX: When expired tokens occur during Vault uploads, reschedule and resume, to avoid incomplete pruning of backup history * FIX: Inconsistent WebDAV host field behaviour where there are multiple WebDAV storage locations * FIX: The Exclusion rule link text was broken when "uploads" and "wp-content" exclusion settings were initially in an unchecked state * TWEAK: Create IAM call methods in UpdraftPlus_S3 * TWEAK: Add a select all / deselect all selector to the table list when restoring * TWEAK: Do not write `SET @@GLOBAL.GTID_PURGED` statements * TWEAK: Improve the upload after create status reporting in the progress widget * TWEAK: If a symlink pointed to an inaccessible location, this was silently skipped when using ZipArchive; it now generates a warning. * TWEAK: Cast the service list to an array in upload_button() to avoid a potential PHP error with PHP 8 * TWEAK: Quadruple size of buffer when reading from files for S3 chunks = 1.22.22 - 16/Sep/2022 = * FIX: Restrict the CSS scope for our jQuery to prevent conflicts * FIX: UI bug when unable to download a database for restoration and then retrying before refreshing the page * TWEAK: Add basic design to confirmation window when adding a site to UpdraftCentral * TWEAK: Prevent a PHP coding deprecation warning on PHP 8.1 * TWEAK: Feedburner URLs now are case-sensitive * TWEAK: Improve the Handlebars template of the Rackspace Cloud Files remote storage by taking PHP code out of it * TWEAK: WP Rocket - disable CDN upon migration completion since key will be invalid. * TWEAK: Improve the UpdraftClone user-visible feedback and logging on delay or failure conditions * TWEAK: WebDAV refactor part 2: Eliminate the stream-wrapper layer = 1.22.21 - 09/Sep/2022 = * FIX: Infinite recursions/loops appeared to happen in restoration during the search-replace operation especially when some tables had a circular reference in their serialised data * FIX: Prevent PclZip from restoring empty/corrupt archives * FIX: Zip file sizes had ceased to be recorded in the backup history * FIX: Fix fatal error when loading the "Advanced Tools" section for UpdraftCentral * TWEAK: Log intermediate unzip errors before proceeding with different method = 1.22.20 - 05/Sep/2022 = * FEATURE: Restore the "upload immediately after creation" feature that was turned off whilst misbehaviour was investigated; fixes have been applied. * FIX: Prevent premature removal of zip manifest files * TWEAK: Improve the Handlebars template of the OpenStack (Swift) remote storage by taking PHP code out of it * TWEAK: Do not run out-of-place "SET @@GLOBAL.GTID_PURGED" statements upon restore = 1.22.19 - 29/Aug/2022 = * TWEAK: The "upload immediately after creation" feature has been disabled whilst reports of incorrect behaviour are investigated * TWEAK: Replace require_once to include_once and use the UpdraftCentral path constant when loading the UpdraftCentral host class. * TWEAK: Modify the "overdue crons" message for greater clarity = 1.22.18 - 26/Aug/2022 = * TWEAK: Suppress pre-loading of phpseclib libraries, which has exposed fatal-error inducing bugs in a handful of unmaintained third-party plugins and themes * TWEAK: Increase the number of conditions for which attempts to access an S3 bucket will result in more logging = 1.22.17 - 23/Aug/2022 = * FIX: Ensure jobdata is saved before attempting a partial cloud upload, preventing potential omission of an archive * FEATURE: Restore the "upload immediately after creation" feature that was turned off in 1.22.16 whilst misbehaviour was investigated * TWEAK: Add log information as to why DB stored routines couldn't be included in the backup if that should be so * TWEAK: Declare some implicitly-declared class variables to avoid warnings in PHP 8.2 = 1.22.15 - 22/Aug/2022 = * FEATURE: Each archive created will now be uploaded immediately directly after creation, to save disk space (prior behaviour was to first create all archives) * FIX: Improve parsing of HTTP response code header with generic S3 providers to avoid incorrectly interpreting status code * FIX: When an S3 service returns a RequestTimeTooSkewed error, make sure this is passed up to the user and not lost * FIX: Do not prematurely trigger upload_complete message when performing immediate file upload during clone operation * FIX: Database views don't get restored or are not restored correctly when in atomic mode * FIX: After sending email reports, other emails that follow used the same From address/name taken from the previous email * FIX: Database views don't get included in the backup * TWEAK: Improve the Handlebars template of the Microsoft Azure remote storage by taking PHP code out of it (Premium) * TWEAK: Update WebDAV library used for WebDAV remote storage (Premium) - N.B. This now requires PHP 5.5+. * TWEAK: Improve the Handlebars template of the Google Cloud remote storage by taking PHP code out of it (Premium) * TWEAK: Improve the Handlebars template of the Microsoft OneDrive remote storage by taking PHP code out of it (Premium) * TWEAK: Detect and break absurdly-future locks * TWEAK: Restrict the CSS scope for our jQuery to prevent conflicts * TWEAK: Work around consequences of a backup history save failure * TWEAK: Add a twice-daily cron to clear temporary files so that they are cleared even in the absence of new backups beginning and prior backup completion failure * TWEAK: Tweak UpdraftCentral abstraction classes * TWEAK: Separate custom font rules when retrieving styles from remote sites * TWEAK: Prevent PHP deprecation notice when using Google libraries on PHP 8.1+ * TWEAK: Simplify Dropbox SDK by removing unused "response format" code = 1.22.14 - 07/Jul/2022 = * FIX: Selective table restore * FIX: Fix restore button JS issue when importing single site to multisite * TWEAK: Allow charset to be set during a WP_CLI restore * TWEAK: Use similar charset if one is not set and not supported during a WL_CLI restore * TWEAK: Add bulk process handler for UpdraftCentral's plugin and theme modules * TWEAK: Return previous plugin and theme states before installation or activation * TWEAK: Improve the Handlebars template of the Backblaze remote storage by taking PHP code out of it (Premium) * TWEAK: Improve the Handlebars template of the WebDAV remote storage by taking PHP code out of it (Premium) * TWEAK: Improve the Handlebars template of the SFTP/SCP remote storage by taking PHP code out of it (Premium) * TWEAK: Avoid using 'phpmailer_init' action when setting up sender name and sender email address, as some SMTP plugins override the 'wp_mail()' function and they don't bother to call the 'phpmailer_init' action * TWEAK: Prevent increments being added to backups from other sites = 1.22.13 - 25/May/2022 = * FEATURE: Added the ability to create a clone from WP-CLI (Premium) * TWEAK: Free version – Improve the Handlebars template of Azzure, OneDrive, WebDAV, SFTP/SCP, Blackblaze, and Google Cloud remote storage by taking PHP code out of them * TWEAK: Update notice class * TWEAK: Escape URL used in remote storage connection modal * TWEAK: A Label being incorrectly displayed when creating a clone * TWEAK: Update class-udrpc * TWEAK: Don't show database selective restore UI if no tables are found in the database scan * TWEAK: Allow drag-dropping of backup anywhere, not just on target area * TWEAK: Add "echo" to display the premium link properly in some templates * TWEAK: Update the posts class to support theme.json config file for theme styles and block settings * TWEAK: Extract from plugin's data rather than relying on its key when retrieving the plugin slug * TWEAK: Increase likelihood of using experimental upload-sooner feature from 1% to 5% = 1.22.12 - 29/Apr/2022 = * FEATURE: Added the ability to select which themes and plugins to Restore * FEATURE: Allow existing local backups to be sent to a remote site when migrating * TWEAK: Tweak to allow the Amazon S3 setup wizard to run if the internal S3 library is active * TWEAK: The WordPress sidebar menu overlaps the popover tour box * TWEAK: Attempt to upload a zip file after it's been created to save on storage space * TWEAK: Add MySQL maximum packet size to Advanced Tools -> Site Information * TWEAK: Only output the expected table rows when starting to process the table * TWEAK: Fix get_users parameter that has been deprecated on WP 5.9 in UpdraftCentral posts controller. * TWEAK: Do not call escapeshellarg() for SCP if we know it is unnecessary (prevents problems on hosts lacking the function for trivial use cases) * TWEAK: Detect change of run-time environment on first resumption and re-set previously detected resumption interval if likely to be helpful * TWEAK: Improve the FTP Handlebars template by taking PHP code out of it * TWEAK: Convert HTTP error codes to their meanings * TWEAK: Some plugins are loading their own incomplete mcrypt_* functions try and detect this and recover * TWEAK: Ensure the local backup file is cleaned up if an earlier failed remote storage upload later succeeds * TWEAK: Include plugin version when getting details from UpdraftPlus Vault to allow features that depend upon a sufficiently up-to-date version = 1.22.11 - 15/Mar/2022 = * FIX: Internal S3 library did not correctly construct canonical query string with v4 signatures if there were multiple parameters, leading to wrong signatures and failed authorisation * FIX: Fix a recent regression that caused DNS hostnames to not be preferred when using Amazon S3 * TWEAK: Prevent deprecation notice on PHP 8.1 if opening a zero-size zip file * TWEAK: Introduce filter updraftplus_dropbox_fetch_curl_options for easier debugging/experimentation = 1.22.10 - 11/Mar/2022 = * FIX: Fix a regression in the 1.22.9 adjustment to the internal S3 library's evaluation of when to use a Host: header * FIX: Fix a long-standing issue whereby if S3-related credentials were being tested via the front-end UI, and multiple back-end instances were present, then the wrong settings could be used in making decisions on Host: headers = 1.22.9 - 10/Mar/2022 = * SECURITY: Fixed a failure to sanitise printed URLs properly, leading to a targeted XSS opportunity (if an attacker persuades a logged-in admin to follow a link personally crafted for their site, he may be able to run JavaScript inside the browser - but on our testing, this ability is limited due to the sanitisation that was there - we have not been able to confirm that a payload causing damage is possible). Reported by Taurus Omar - https://taurusomar.com. * TWEAK: Adjust internal S3 library's evaluation of when to use a Host: header (improves compatibility with buckets with minimal access rules) * TWEAK: Adjust algorithm concerning likelihood of switching S3 libraries to accelerate deployment * TWEAK: Prevent PHP notice when using S3 with particular bucket naming and SSL = 1.22.8 - 03/Mar/2022 = * FIX: Do not attempt to use S3 DNS-style bucket naming in alternative library if SSL validation will fail due to AWS certificate wildcard policies or other bucket naming-related reasons * TWEAK: Add version number to alternative S3 library requests = 1.22.7 - 01/Mar/2022 = * FIX: Internal S3 library was missing a method for using session tokens together with Vault * FIX: Various UI issues with the S3 IAM Wizard * TWEAK: Use AWS SDK/Guzzle for S3 operations if Curl is not available * TWEAK: Prevent coding deprecation notice during S3 upload on PHP 8.1 = 1.22.6 - 26/Feb/2022 = * FIX: Internal S3 library had regressed in its ability to detect bucket location on AWS when using v4 signatures * TWEAK: When using S3 APIs, log the class used for easier debugging * TWEAK: Change S3 SDK selection algorithm = 1.22.5 - 24/Feb/2022 = * FIX: An issue that prevented being able to browse the contents of an already downloaded backup zip file * FIX: Add previously unbundled AWS SDK file for IAM service description which prevented S3 wizard in the Premium version working correctly * FIX: Prevent a fatal error when handling some S3 errors, caused by a format change * TWEAK: When loading AWS SDK at upload time, apply some work-arounds for plugins with buggy or old versions of related libraries * TWEAK: Update to latest AWS SDK toolkit, fixing an error with error-reporting in some situations in the previous version * TWEAK: Remove vendor/aws/aws-crt-php/run_tests.bat from build (apparently one user's hosting does not allow .bat files), plus other unnecessary files from that package * TWEAK: Enable PHP 8.1 in UpdraftClone (N.B. not yet officially supported by WordPress, so, made available for testing/development purposes) * TWEAK: Prevent error emitted on the browser console when 'Images' filter is selected on UpdraftCentral's media module = 1.22.4 - 17/Feb/2022 = * TWEAK: Prevent a couple of possible fatal errors when printing autobackup options on PHP 8 * TWEAK: Work around a bug in the JetPack autoloader that was triggered when projects using that also used Guzzle in a different namespace = 1.22.3 - 15/Feb/2022 = * SECURITY: Thanks to Marc-Alexandre Montpas of Automattic for this report (CVE: CVE-2022-23303). All versions of UpdraftPlus from March 2019 onwards have contained a vulnerability caused by a missing permissions-level check, allowing untrusted users access to backups. If your site does not have non-admin users, or if your non-admin users are all trusted (and your site does not allow users to sign up themselves), then you are not vulnerable (but we always recommend updating to the latest version in any case). Please see https://updraftplus.com/updraftplus-security-release-1-22-3-2-22-3/ for more details. * FIX: Unexpected 'Backup History' array structure during the rescanning of the new backup sets that changed the type of the database associative keys from string to array format * FIX: Failure in excluding and wiping out jobdata during backup and restore causing the same backup to repeat under certain circumstances * REFACTOR: Upgrade AWS SDK from version 2.8 to 3 * TWEAK: Improve how log file and backup file attachments are handled through mail-related functions, so they don't get omitted by some 3rd party SMTP plugins * TWEAK: Overcome PHP 8 'Only the first byte will be assigned to the string offset' warning when rescanning local folder and/or remote storage for new backup sets * TWEAK: On Windows, when mysqldump.exe binary is in use for backing up database, it failed to exclude updraft_jobdata_* entries due to 'escapeshellarg' function that replaces % char to white space * TWEAK: Switch to official jstree release now that our patch is included * TWEAK: Update updater library in paid version to current release * TWEAK: In the multisite add-on, store the last log message separately to perform better with binary logging together with large backups * TWEAK: Add Google branding to the Google Drive authentication link * TWEAK: Change complex formatting string to avoid translator errors resulting in PHP errors = 1.22.1 - 14/Jan/2022 = * TWEAK: New versioning scheme; the second part of the version number was previously not used very meaningfully/systematically; together with the third, it now indicates the year of release and number within that year * TWEAK: Adjust run-time performance check, removing one test that was no longer appropriate * TWEAK: Adjust next resumption display message if there isn't one * TWEAK: Cache the UpdraftVault quota to reduce the amount of network calls made during long backups = 1.16.69 - 27/Dec/2021 = * FIX: A bug that prevented a final resumption from attempting to split the zip to make progress * FIX: Handle LOCK TABLES statements produced by some mysqldump versions properly in case of atomic restores * SECURITY: Fix a non-persistent XSS error allowing an attacker to once run JavaScript in your web browser if you clicked on a link crafted personally for you whilst logged into your site (very similar to that fixed in 1.16.65/6). A packaging error meant that this was not properly fixed in the 1.16.67-68 releases. * TWEAK: Search and replace ABSPATH if it's changed, non-trivial and stored in the DB by a bad plugin/theme * TWEAK: Make whole label for "UpdraftPlus temporary clone user login settings" clickable * TWEAK: Change wording for an advanced tool for clarity * TWEAK: Include UD in user agent for S3 calls when using the AWS SDKs * TWEAK: Make sure WP_Error is passed up during specific plugin update failure case = 1.16.66 - 29/Nov/2021 = * SECURITY: The fix made in 1.16.65 was faulty; this release corrects it. = 1.16.65 - 25/Nov/2021 = * SECURITY: Fix a non-persistent XSS error allowing an attacker to once run JavaScript in your web browser if you clicked on a link crafted personally for your site whilst logged into it. Discovered by Krzysztof Zając. * TWEAK: Premium - add review link at bottom of admin = 1.16.64 - 24/Nov/2021 = * FIX: Do not create a zip manifest file if the zip is still potentially incomplete * TWEAK: Improve Dropbox downloading performance by reducing round-trips, by eliminating unnecessary chunking * TWEAK: Update certificate store to current list * TWEAK: Increase precision of previous check-in record in log = 1.16.63 - 25/Oct/2021 = * FIX: Use correct zip file name when creating manifest * TWEAK: Tweak the response data of UpdraftCentral's plugin and theme handlers to add additional error information * TWEAK: Moved the raw backup history command so it can be accessed via UpdraftCentral * TWEAK: Optimise away unnecessary file open/read/close cycle on null gzip files when writing the final database dump (should help on enormous sites with thousands of tables) * TWEAK: Cleanup .list.tmp files when a local backup completes * TWEAK: Refactor WebDAV addon code for future improvements = 1.16.62 - 30/Sep/2021 = * FIX: Fix UpdraftCentral error when installing plugin or theme on a slow connection * TWEAK: Support wildcard (asterisk char) exclusions not just for the first/top-level directory but also for the 2nd level directories and below * TWEAK: Fix deprecation warning on UpdraftCentral's comment settings * TWEAK: Algorithm improvement with small tables with individually large rows not triggering the existing over-sized rows algorithm, to reduce fetch size quicker * TWEAK: Implement the newly abstracted host plugin usage/process within the UpdraftCentral client code * TWEAK: Improve backtrace logging * TWEAK: Add admin and log warning messages regarding the planned shutdown of Microsoft Azure and OneDrive Germany * TWEAK: Output UpdraftVault quota recount link if needed * TWEAK: Introduce constant: UPDRAFTPLUS_LOG_BACKUP_SELECTS: Defining this to true will cause the SQL SELECT commands used when fetching data for a database table backup to be logged in the UpdraftPlus backup log * TWEAK: Don't change SQL modes if a null value is returned * TWEAK: Existing backups paging logic to avoid a confusing rescan user experience * TWEAK: Refactor the search and replace engine = 1.16.61 - 28/Aug/2021 = * FIX: If MySQL performance was very fast on large tables, and if fallback fetch mode was being used (which should not occur on any WordPress core table, but can be triggered on recent Oracle MySQL 8.0 versions), then when increasing rows fetched on large tables, some rows could be unintentionally skipped. * TWEAK: Oracle MySQL 8.0 from somewhere after 8.0.17 has removed the display width from the response to SHOW CREATE TABLE, resulting in failure (prior to this tweak) to detect a primary key type that can be used with faster fetching * TWEAK: Use 'wp_mail_failed' action hook to improve logging of email delivery failures caused by a PHPMailer exception * TWEAK: Add additional log information to themes and plugins modules = 1.16.60 - 23/Aug/2021 = * FIX: An issue that prevented the more files restore UI appearing if it was part of an incremental backup * FIX: Add an extra check to prevent incremental backups from being run after a migration, if incremental backups are not enabled. * TWEAK: Add method to check whether an image editor is available for UpdraftCentral's image media editing feature. * TWEAK: In the reporting add-on accept URLs, if the address is a URL then instead of emailing it, POST it to that URL using the format used by Slack * TWEAK: Add a link to the create clone UI to explain the various clone package sizes * TWEAK: Record ABSPATH in the summary * TWEAK: Prevent a couple of unwanted logging notices on PHP 8 * TWEAK: Catch and deal with various WebDAV exceptions * TWEAK: Create a zip file manifest and read from it if available = 1.16.59 - 16/Jul/2021 = * FEATURE: (Paid versions) New WP-CLI command (connect) to connect plugin with the user's associated account/licence on updraftplus.com * FIX: Each time the 'Upload Backup' dialog is opened, '(already uploaded)' text is appended one more time for the same remote storage resulting in it being nearly impossible to have the two buttons shown at the bottom * TWEAK: Enhanced over-sized row-detection to include any table with a primary key and a LONGTEXT * TWEAK: Log file now includes max packet size * TWEAK: Properly handle port numbers included in DB_HOST when using mysqldump * TWEAK: Handle UNIX socket paths included in DB_HOST when using mysqldump * TWEAK: Increase default mysqldump maximum packet size * TWEAK: Change WebDAV request library to HTTP_Request2 * TWEAK: Add custom category sorting on post module using uasort due to deprecation warning emitted on UpdraftCentral * TWEAK: Added an icon within the top-right of the log widget allowing user to toggle that part between its current size and full-screen of the restoration log section * TWEAK: Prevent an error in the phpinfo advanced tool when handling non-string constants * TWEAK: Escape remote storage IDs in output templates * TWEAK: Suppress unwanted error logging related to Gravity Forms * TWEAK: Clear Elementor cache at the end of restoration process (if possible) giving an opportunity for Elementor to regenerate CSS files on the next page load request * TWEAK: Clear Avada/Fusion-related CSS cache at the end of restoration process (if relevant) * TWEAK: Catch and recover from errors and exceptions when clearing third-party caches * TWEAK: Prevent a PHP logging notice when an SCP server is scanned for files * TWEAK: Remove unused CloudFront methods from S3 library * TWEAK: Added missing anonymisation.png graphic and detail of Anonymisation addon in the addons list table * TWEAK: Added Update URI header field to avoid accidentally being overwritten with an update of a plugin of a similar name from the WordPress.org Plugin Directory. * TWEAK: Improvements in finding a working mysqldump binary during a backup operation * TWEAK: Start on larger chunk sizes when fetching meta table contents, and scale up chunk sizes on all tables dynamically (less SQL queries; but testing shows it makes little difference to overall speed) TWEAK: Adjust Google Drive to retry once after a UDP_Google_IO_Exception, as was done in Google Cloud - intended to help with intermittently buggy Curl versions * TWEAK: Show a notice when attempting to download a backup from email remote storage explaining nothing can be downloaded * TWEAK: Update shop links and upgrade prompts = 1.16.58 - 27/May/2021 = * FIX: UpdraftVault storage settings saving issue on multisite * FIX: Translation undefined index issue while running updates on UpdraftCentral * FIX: Do not retain SFTP/SCP connection object between upload and prune stages, fixing a multi-instance bug that could cause deleting of obsolete archives to be skipped when backing up the same backup to multiple SCP servers * TWEAK: When a link points to an unreadable file, include information in the log about the original reference * TWEAK: Do not compress and recompress intermediate table files when stitching together the final database dump (increases speed and reduces resource usage) = 1.16.57 - 08/May/2021 = * FIX: Backblaze infinite loop when listing on buckets with huge numbers of objects * TWEAK: Minor improvements to the organisation of the S3-provider classes (abstract per-backend logic more cleanly) * TWEAK: Add --no-tablespaces switch to mysqldump invocation (required on MySQL 8.0+) = 1.16.56 - 29/Apr/2021 = * FIX: Revert changing of Amazon S3 authentication error handling in 1.16.55, which broke support of S3-compatible providers * TWEAK: Remove some unnecessary methods from the UpdraftPlus_S3 class = 1.16.55 - 28/Apr/2021 = * FIX: Wrong prefix being used on non WP tables during an atomic restore * FIX: Issue that prevented generic (non-UpdraftPlus) SQL databases being restored * TWEAK: JSTree file selector: list folders first, and list entities in alphabetical order * TWEAK: Increase efficiency when listing Backblaze files during multi-delete operation * TWEAK: Integrate UpdraftVault storage with the scheduled destination backups feature * TWEAK: Added bucket access style field to S3-Compatible (Generic) to allow user to choose preferred access style (Path or Virtual-host) * TWEAK: Improve handling of Amazon S3 authentication error messages to avoid misunderstanding concerning "wrong bucket region" that occurs after trying further methods * TWEAK: Make modal dialogs resizable * TWEAK: During the Database scan if the amount of tables found exceeds the PHP max input vars limit then truncate the list, to prevent restore options being lost * TWEAK: Update seasonal notices * TWEAK: Track the amount of restore options being sent and warn the user if this exceeds the PHP max_input_vars limit = 1.16.54 - 05/Apr/2021 = * FIX: Undetected build system error on free version omitted jstree library * TWEAK: Reduce plugin size by removing 9 languages that are now fully available from the wordpress.org on-demand system = 1.16.53 - 03/Apr/2021 = * FIX: Incorrect final table name being used during an atomic restore when restoring using a different table prefix * FIX: Fix variable re-use issue in Backblaze multi-delete code which halted deletion * TWEAK: Prevent unnecessary logging when testing data for serialization on PHP 8.0 during migration * TWEAK: Update jsTree library to version 3.3.12-rc0 to work around deprecated jQuery functions * TWEAK: Add an extra check for whether it looks reasonable to reduce the resumption time, increasing efficiency * TWEAK: On the posts table, detect over-sized rows in advance, and fetch them one at a time. = 1.16.51 - 01/Apr/2021 = * FIX: Backup before updating dialog was not working on the inline informational pop-up on the Plugins page * TWEAK: Refactor how translatable texts are being handled and displayed within the UpdraftCentral client code * TWEAK: Fix parameter passing for UpdraftCentral multiplexed request * TWEAK: Exclude/skip very large files from the backup operation if the first and second attempt at backing them up didn't succeed * TWEAK: Backblaze multi-deletion code did not properly handle files that were already deleted (could abort deletion of others) * TWEAK: Replace the table prefix in the constraint name if it is found * TWEAK: Don't perform an atomic restore on tables with constraints * TWEAK: Add atomic restore support for non-WordPress tables = 1.16.50 - 16/Mar/2021 = * FIX: An issue with refreshing Dropbox access tokens * TWEAK: Reduce and log memory usage in Google upload methods * TWEAK: Catch Dropbox HTTP 401 errors and refresh the access token = 1.16.49 - 10/Mar/2021 = * FIX: Don't perform an atomic restore for non-WP-prefix tables backed up (Premium feature) - fixes a bug that resulted in the final table being dropped * TWEAK: Dates/times shown in the "next scheduled backup(s)" are now translated into the user's locale = 1.16.48 - 09/Mar/2021 = * FEATURE: If needed database permissions are available then perform an atomic restore to improve chances of successfully restoring the database * FEATURE: Added the ability to manually complete authentication with Google Drive (Avoids issues where security modules/plugins break the authentication flow) * FEATURE: Added the ability to manually complete authentication with OneDrive (Avoids issues where security modules/plugins break the authentication flow) * FEATURE: Google Drive and Google Cloud now allow boosting chunk size for faster transfers * FIX: Files/Directories Exclusion not saving correctly when adding numeric directory/file names into the exclusion list * FIX: Different PHP versions generate different suffixes length in the temporary ZIP filename resulting in a chance of overlapping runs * FIX: an issue with mysqldump password character escaping * TWEAK: Avoid unnecessary database writes caused by redundant jobdata updating during backup of files * TWEAK: Add "anywhere in their names" syntax option to the exclusion UI * TWEAK: Bump the requirement for the S3 enhanced module, and for using the official AWS SDK, up to PHP 5.5 (in preparation for updating the SDK version later) * TWEAK: Fix a bug of report emails for incremental backups displaying incorrectly in many email apps * TWEAK: Update Select2 library to version 4.1.0-rc.0 to work around deprecated jQuery isFunction * TWEAK: Update jQuery-serializeJSON library to version 3.2.0 to work around deprecated jQuery isArray * TWEAK: Handle hosts that have disabled some of the PHP functions thus causing a fatal error on PHP 8 * TWEAK: Correct under-calculation of used memory in verify_free_memory() * TWEAK: Fix (inconsequential to this point) double-use of identifier for SQL statement type * TWEAK: Remove some compatibility code in Dropbox downloading pertaining to a folder selection bug eliminated ~8 years ago. * TWEAK: Remove unneeded sub-site tables when performing a restoration/migration (Multisite) * TWEAK: Improve the exclusion UI by adding new "wildcards" option thus allowing the user to add a set of patterns for excluding files/directories * TWEAK: Integration of the new files that were previously added for abstracting UpdraftCentral's client code * TWEAK: Excluded items (Files or Folders) that are not readable should not trigger a warning about being unreadable * TWEAK: Fix some RTL CSS issues * TWEAK: OneDrive 4xx error reporting * TWEAK: Update the Dropbox SDK to use refresh tokens (long lived token support ends September 2021) * TWEAK: implement a multi-delete capability when deleting from Backblaze * TWEAK: On UpdraftClone display the image ID in the advanced tools tab for easier debugging * TWEAK: Make it more clear in the restore log that we are starting an AJAX restore * TWEAK: The download backup HTML so that there is only one download button per archive type = 1.16.47 - 25/Jan/2021 = * FEATURE: added the ability to anonymise personal data in database backups from the "Backup Now" dialog (Premium / add-on) * FEATURE: Add page management module for UpdraftCentral * FIX: 1.16.42 Introduced a regression (truncation) when listing files from Dropbox when there were multiple pages of results * TWEAK: Force host-style bucket access when backing up via S3 generic to Alibabacloud * TWEAK: Remove unneeded Google SDK files from our fork of the SDK taking the size from 6MB to 800KB * TWEAK: Incorrect jQuery UI dialog extended filename * TWEAK: Change some class names to improve compatibility with other plugins using the Google SDK and auto-loading their version unconditionally * TWEAK: Update the delete file Dropbox API call to version 2 * TWEAK: Change the S3 test settings form names to match the saved setting names * TWEAK: Check the Content-Type on the response from an S3-compatible provider slightly less strictly, improving compatibility with at least one otherwise-working implementation * TWEAK: Update the Dropbox SDK to use scopes * TWEAK: Handle hosts that have removed disk_free_space() (now that on PHP 8 disabling functions removes them) = 1.16.46 - 05/Jan/2021 = * FIX: Prevent some deprecation-related errors when backing up to some remote storage locations in PHP 8 * FIX: Adding new remote storage instance (Premium) doesn't bring up the UI * TWEAK: Fix some modal dialog alignment/resizing issues = 1.16.45 - 04/Jan/2021 = * FIX: Prevent some fatal errors due to language behaviour changes when running under PHP 8 * TWEAK: Replace deprecated calls to jQuery fn.focus(), fn.ready(), fn.submit(), fn.click() and fn.blur() methods in internal libraries * TWEAK: Replace deprecated calls to jQuery (:first) and (:eq) pseudo-classes in internal libraries * TWEAK: Prevent several PHP deprecation log notices on PHP 8 * TWEAK: Rename some further classes in our fork of the Google SDK to prevent conflicts * TWEAK: When running under cron, do not combine schedules when there are no schedules * TWEAK: Revert a jQuery change in 1.16.44 which made notices on the 'updates' page appear multiple times. = 1.16.43 - 17/Dec/2020 = * TWEAK: Replace deprecated calls to jQuery.trim(), jQuery.fn.change(), jQuery.fn.bind(), jQuery.fn.unbind(), jQuery.fn.keyup(), jQuery.fn.removeAttr() and `jQuery.fn.removeProp() in internal libraries * TWEAK: Reduce excessive vertical margin above the header within Autobackup dialog box * TWEAK: Improve user experience in the case of some rare UpdraftVault conditions * TWEAK: Fix the exclude fields, which were unable to switch their mode from read-only to edit mode * TWEAK: Added new files needed for abstracting UpdraftCentral's client code * TWEAK: Update the review notice * TWEAK: When attempting to delete a Backblaze file and discovering it does not exist, do not log that as an error (presumably already deleted) * TWEAK: Fetch history log data in the popup using AJAX, instead of using embedded data attributes. * TWEAK: Be less quick to switch to PclZip when BinZip has not completed the job = 1.16.42 - 10/Dec/2020 = * FEATURE: Added the ability to manually complete authentication with Dropbox (Avoids issues where security modules/plugins break the authentication flow) * TWEAK: Replace BlockUI's deprecated jQuery functions and/or shorthand events with the appropriate method accordingly * TWEAK: Replace /2/files/search Dropbox API calls with /2/files/search_v2 * TWEAK: Replace Labelauty's deprecated jQuery functions and/or shorthand events with the appropriate method accordingly * TWEAK: Fix broken multiple range selection's highlighters due to the absence of jquery-migrate in the WordPress core on version 5.5 * TWEAK: Add the latest jQuery UI CSS framework for compatibility with WordPress 5.6 and all ongoing versions of WordPress * TWEAK: Add support for PHP 8.0 in UpdraftClone * TWEAK: Prevent a couple of PHP coding notices on PHP 8.0 * TWEAK: Tweak in the backing up of tables to reduce PHP memory use when working with very long row contents * TWEAK: Prevent a PHP warning when starting a backup * TWEAK: Fix a UI issue in the "send backup to remote site" options = 1.16.41 - 27/Nov/2020 = * TWEAK: Don't repeat sending the 'upload_complete' command to a remotesend destination after it succeeded the first time * TWEAK: Update the udrpc library * TWEAK: In UpdraftClone, delay the temporary_clone_ready_for_restore signal until the browser connection is closed (preventing a loss of response) = 1.16.40 - 25/Nov/2020 = * TWEAK: Cycle Dropbox API client ID (old one has been cycled and no longer works) = 1.16.37 - 23/Nov/2020 = * FIX: Scheduled backups to remote storage not being correctly sent in 1.16.35/36 in the absence of the "More Storage" add-on * TWEAK: Wording tweak to clarify the effect of the conditional logic settings * TWEAK: Add a warning to the restore page to inform the user if JavaScript is broken and as a result the restore won't start * TWEAK: Replace intval() with casting to (int) * TWEAK: If the first fetch from a table failed, then the algorithm to fetch fewer rows failed to reduce the fetch size more than once = 1.16.36 - 20/Nov/2020 = * TWEAK: During a restore or migration, detect if the backup was affected by the key issue fixed in 1.16.35, and automatically unselect by default such tables from the list of those to be restored. On a migration advise the user to take a fresh backup on the source site with a current version. = 1.16.35 - 19/Nov/2020 = * FEATURE: Backup destinations with conditional logic rules for scheduled backups (Premium) * FIX: A regression in 1.16.30 meant that the term_relationships table could have rows missing in the backup if mysqldump was not present/used; this meant that items with multiple terms were only having one relationship backed up (e.g. multiple tags being assigned to one post) * TWEAK: Adding remote block assets support when editing post from UpdraftCentral * TWEAK: Rename UpdraftCentral's main and listener classes * TWEAK: Improve error message when encrypted key given by user for SFTP/SCP remote storage method * TWEAK: Enhance the algorithm when dumping large tables via PHP, by also consulting the size of the current uncompressed data and passed time and resumption state * TWEAK: When there are no backups in existence, display some help text explaining how to upload one for restoration * TWEAK: Prevent composer 2 run-time platform checks * TWEAK: Update bundled cacert.pem file * TWEAK: When fetching less rows due to previous failures, make this persist across resumptions when on the same table * TWEAK: Raise the default for UPDRAFTPLUS_MAXBATCHFILES * TWEAK: Improve handling of the situation when the source database has no table prefix (which is officially unsupported by WordPress, but people have them) * TWEAK: When fetching the site name from the database, process it via wp_specialchars_decode() to remove HTML encodings that WP applied before storage * TWEAK: Replace uses of php_uname() function with PHP_OS constant when the server where PHP is running on disables the function for security reasons * TWEAK: When the definition of a VIEW cannot be fetched, report this nicely, do not let it be flagged as a fatal error, and log it in the backup file and log * TWEAK: Integrate UpdraftPlus and WordPress 5.5 core's automatic update settings * TWEAK: When a backup resumed, the last successful resumption was incorrectly set as the last successful resumption when an 'alive' event was recorded, rather than a 'useful' one; this deferred some mitigations when there was insufficient progress * TWEAK: Add another tweak to paid versions' update checking time algorithm * TWEAK: Add "Select all" and "Deselect all" link texts for bulk selecting/deselecting tables from the database table list on the manual backup dialog * TWEAK: Ensure all code paths use internal ud_parse_json function for decoding JSON in JavaScript * TWEAK: When using UpdraftVault, only cache results of a vault_getconfig call conditionally (retry on potentially transient errors) * TWEAK: Prevent a PHP coding notice if running an UpdraftVault backup on the CLI * TWEAK: Reduce the on-disk logging of entity base directories containing vast numbers of entries * TWEAK: When we first save the backup schedule set the scheduled time randomly between 9PM and 7AM * TWEAK: During a remote storage rescan correctly update the backup file sizes to prevent incorrect 'may have changed' warnings = 1.16.34 - 30/Oct/2020 = * TWEAK: On sites with enormous numbers of tables (e.g. very large multisites), counting the already-backed-up tables when resuming took unnecessarily long since 1.16.30 * TWEAK: Update jQuery document ready style to the one not deprecated in jQuery 3.0 * TWEAK: While using the file tree browser return an error if we are unable to open a directory = 1.16.33 - 20/Oct/2020 = * FIX: Fatal error when doing a backup with no storage in the short-lived 1.16.32 (free version) * TWEAK: Cookie policy changes in the Chrome family of browsers broke the embedded checkout; hence, this is now disabled (goes directly to updraftplus.com instead). * TWEAK: Exclude All In One WP Migration-related archive files when backing up plugins and/or others from the UpdraftPlus backup process * TWEAK: Add downloadable backup links in the Backup Report email (Reporting Addon) * TWEAK: Rename some classes in our fork of the Google SDK to prevent conflicts * TWEAK: Improve automatic backups output when 'UPDRAFTPLUS_NOAUTOBACKUPS' constant is defined. * TWEAK: Remove the now-redundant concept of inner loops from the database table backup routine = 1.16.31 - 20/Oct/2020 = * FIX: A regression in 1.16.30 meant that tables with integer primary keys which used signed integers omitted the first row of the table from the backups. This is not common (e.g. it does not affect any core WP tables; most plugins adding tables follow WP core in using unsigned integers for primary keys). = 1.16.30 - 15/Oct/2020 = * PERFORMANCE: Where a table has a numerical primary key, extract its data using that index. This results in a substantial performance increase when fetching large tables using PHP. (The filter updraftplus_can_use_primary_key_default can be used to de-activate this behaviour). * FIX: Remove incorrect decodeURIComponent() parsing when importing settings, which could prevent import of settings containing some special characters * FIX: An issue where database tables that were not selected to be backed up in a "Backup Now" backup would get added to the backup during a resumption (i.e. if it did not finish in a single run) * TWEAK: Catch errors from Google Cloud when the bucket is not found * TWEAK: Fix undefined variables instead of expected values in message prior to settings import * TWEAK: Strip the redundant WHERE for the --where parameter to mysqldump (which modern versions strip out, but a version was found that didn't) * TWEAK: Handle hosts that have disabled the session_id() function * TWEAK: Provide SQL mode information in the 'Site Information' section under the 'Advanced Tools' tab and in the database backup's header * TWEAK: Show a notification of UpdraftPlus plugin updates even if the associated user account is not connected to the UpdraftPlus website * TWEAK: Add mechanism to detect what hosting provider is being used and use it to make UpdraftPlus comply with Kinsta's backup limit policies (thus removing it from the list of disallowed plugins) * TWEAK: When booting a clone if it's claimed from the clone queue then update the token being used * TWEAK: Tweaked downwards the minimum time in the future for rescheduling a resumption = 1.16.29 - 08/Sep/2020 = * FIX: Added Africa (Cape Town), Asia Pacific (Hong Kong) & Asia Pacific (Osaka-Local) to AWS * FIX: Fix bug where incorrect function call prevented backup file downloads from the WP dashboard * TWEAK: Removed LinkedIn and Google+ links * TWEAK: Choosing email remote storage method in the free version will automatically tick the "Email" field setting, making the UI meaning clearer * TWEAK: Work around the invalid file paths if found in some key-value pairs in the PHP user.ini file or Apache .htaccess file when restoring = 1.16.28 - 02/Sep/2020 = * FEATURE: Support backing up and restoring MySQL/MariaDB routines (stored procedures and functions) * FEATURE: Added the ability to search and replace the database via WP-CLI * FIX: Bit fields in a table don't necessarily get backed up correctly due to the difference in the output of mysql_query() and mysqli_query() for the bit-field type * FIX: Allow single multisite sub-sites to be restored when there is a http/https mismatch between the site and database backup * TWEAK: Update plugin updates checker dependency (in paid versions) to the 4.10 series, improving compatibility with WP 5.5+'s updates management * TWEAK: Suppress message about how to upgrade an already-installed plugin when on WP 5.5+ (where it is no longer relevant) * TWEAK: Internal refactoring to allow more flexibility when creating database backups * TWEAK: Force the turning off of ANSI_QUOTES in the active SQL mode when creating a backup, for better compatibility * TWEAK: Add the ability to configure the 'max_allowed_packet' option in the binary mysqldump command via the 'UPDRAFTPLUS_MYSQLDUMP_MAX_ALLOWED_PACKET' constant * TWEAK: The Google Drive options exist condition to prevent a false positive saved settings error * TWEAK: Improve the UpdraftPlus get_outgoing_ip_address method in finding user webserver's IPv6 address * TWEAK: Removed MetaSlider notice in the notices collection = 1.16.27 - 23/Jun/2020 = * FIX: In the free version configured remote storage locations were not selected by default in the backup now modal * FIX: On newer versions of Curl uploads to Dropbox can fail with a bad request, we now retry with a better request * FEATURE: Improve support for enormous tables when outputting via PHP via batching of the dump * TWEAK: Add site_url to load_plugins and load_themes requests * TWEAK: Catch PHP fatal errors when executing UpdraftCentral commands * TWEAK: Tweak the version that gets added to CSS and JS filenames to work with addons * TWEAK: Prevent an internal UpdraftVault message displaying in the UI when Vault is not in use * TWEAK: Stop displaying the 'licence expires soon' warning if an active subscription is detected on the account * TWEAK: Catch Google_IO_Exception during upload to Google Cloud to prevent further unwanted errors * TWEAK: Date/time indicator in the UI now gets updated via the WP heartbeat API * TWEAK: On large databases the database file scan can time-out; an option has been added to allow the restore operation to include tables that are missing from the list * TWEAK: Use the administration email address (if possible) as the email sender address when sending a backup report email * TWEAK: Catch new OneDrive access token has expired message during a backup * TWEAK: Cleanup failed OneDrive uploads to prevent repeated failures that will never succeed * TWEAK: Add a warning alert when the remote scan button is pressed to explain this feature to prevent support requests * TWEAK: On large databases the amount of database tables can exceed the php_max_input_vars value; an option has been added to allow the restore operation to include tables that are missing from the list * NOTE: The free version 1.16.27 was released as 1.16.26; i.e. if confused about 1.16.26 went, then the answer is that they are the same thing. = 1.16.25 - 23/May/2020 = * FIX: Dropbox since 1.16.24 was only deleting one backup files archive out of the set. i.e. Excess archives remained on Dropbox. These have to be deleted manually. * TWEAK: Add version to CSS and JS within filenames to prevent old versions being served after update on sites which have customisations to remove the query string * FEATURE: Added the ability to create UpdraftCentral keys from WP-CLI = 1.16.24 - 15/May/2020 = * FEATURE: Support migration between different "generate columns" syntaxes of MySQL and MariaDB * FEATURE: Added the ability to choose the remote storage locations you want to send your backup to in the "Backup Now" modal * FIX: If non-WordPress tables are selected in the advanced 'Backup Now' options, then back them up (even if the saved setting to back them up is off). i.e. "Backup Now" over-ride options should have been taking priority. * FIX: Failure to restore database 'view' in some rare circumstances due to the nonexistent DEFINER account and lack of privileges * TWEAK: Handle binary data during backup * TWEAK: Add strack_st to the lists of large logging tables and tables not requiring search/replace * TWEAK: Make search and replace case insensitive when operating on URLs * TWEAK: The incremental backup notice logic * TWEAK: Update bundled updater class (YahnisElsts/plugin-update-checker) (paid versions) to version 4.9 * TWEAK: Add another tweak to paid versions' update checking time algorithm * TWEAK: Add the options_exist() method to backup modules that did not have it * TWEAK: During manual backup uploads, check if the last 4 bytes are string "null" (caused by an error in uploading to Dropbox) and if so remove them. Prevents an unnecessary message about unexpected data. * TWEAK: Show the backup label (if specified) in the UI backup progress indicator * TWEAK: Added the facility to clear the list of existing migration sites * TWEAK: Create default instance labels * TWEAK: Bring list of debugging plugins up to date * TWEAK: Add support for the AWS Milan and Cape Town endpoints (and correct a couple of existing endpoints that had wrong references) = 1.16.23 - 01/Apr/2020 = * FEATURE: Post module handler for UpdraftCentral * FEATURE: Added the ability to select which database tables you want to restore * FIX: An apparent change in Dropbox API behaviour at a recent date was causing uploads to Dropbox to be corrupted in some circumstances in versions 1.16.21-22. * TWEAK: The "Backup now" options were all unselected after trying to take a manual incremental backup with no possible entities for increments * TWEAK: When importing a single site into a multisite remove UpdraftPlus options and cron to prevent unwanted backups * TWEAK: Auto select clone package based on size of the selected backup * TWEAK: Prevent PHP notice when logging a Google Drive account full condition * TWEAK: Prevent a PHP notice when Azure is deleting files on PHP 7.4 * TWEAK: Prevent potential PHP notice if returned OneDrive quota is zero * TWEAK: When restoring a single site that is part of a multisite only put that single site in maintenance mode not the entire network * TWEAK: Remove filesize warning from the log if we successfully added the file to the zip to prevent user concern * TWEAK: Add page_visit_history table to list of those with low-priority data and search/replace unnecessary * TWEAK: Add a warning message when restoring/migrating from an older PHP version to a newer version * TWEAK: Set 'NO_AUTO_VALUE_ON_ZERO' sql mode on restorations, for better compatibility with MySQL 8 * TWEAK: Add WordFence logging tables to list of optional tables * TWEAK: If the Google Cloud revoke call fails try again once * TWEAK: Catch file closed errors during uploads to Dropbox to prevent unwanted errors in the backup log and prevent user concern * TWEAK: Get list of supported UpdraftClone regions from updraftplus.com * TWEAK: Logging in backup modules will now correctly pass on arguments to main log function * TWEAK: Change OneDrive 'account full, expected to fail' error message to a recoverable warning * TWEAK: Detect non-homepage 404s and provide FAQ link after a restore * TWEAK: Add paging to the existing backups table to prevent long loading times for sites with a large amount of backups * TWEAK: Remove unwanted padding on some buttons = 1.16.22 - 17/Feb/2020 = * FIX: Fix a regression with some S3-compatible providers caused by a previous switch to virtual-hosted style bucket referencing * TWEAK: Integrate input credentials from UpdraftCentral's zip install feature * TWEAK: Add information to the log file about what type of addresses (sub-domain/sub-folder) the multisite is configured to use * TWEAK: Fix potential race condition affecting settings page notifications on very fast or very slow sites * TWEAK: Some PHP notices that could be output during a restore * TWEAK: Automatically resume a timed-out restore operation during the uploads stage * TWEAK: If the database connection dies during a restore operation, try to reopen it * TWEAK: Adjust the UpdraftClone dashboard notice text * TWEAK: If the Google Drive revoke call fails try again once * TWEAK: The incremental backups label showed the incorrect time for different timezones * TWEAK: Update the WP-Optimize notice * TWEAK: Extend the auto resume restore to themes, others and more file backups = 1.16.21 - 10/Dec/2019 = * FIX: Correctly search and replace database views when importing on a site with a different table prefix * FIX: A bug that prevented the restore modal opening on the migrate/clone tab * FIX: Dropbox cURL issues on connection are resolved for PHP 7.4 * TWEAK: Change the way the "Disabled Cron" warning appears on the administrative settings page * TWEAK: Improvements to error messages return for UpdraftCentral's plugin and theme installation process * TWEAK: Updates to credentials validation for UpdraftCentral's plugin and theme modules * TWEAK: Add media request handler for UpdraftCentral media module * TWEAK: On paid versions, again possibly adjust the daily update check time to further favour overnight hours * TWEAK: Mask classified information in WebDav URL settings * TWEAK: Add multiple range selection on certain backup using ctrl and shift buttons * TWEAK: Hide incremental backup link if the backup directory is not writable * TWEAK: Make Updraft_Restorer_Skin compatible with WP 5.3 * TWEAK: Added Linode object storage link to list of supported S3 providers and updated existing links * TWEAK: Ensure some variables are defined to prevent unwanted warnings = 1.16.20 - 04/Nov/2019 = * FEATURE: Add support for PHP 7.4 in UpdraftClone * FEATURE: Added the ability to restore "more files" backups * FEATURE: Add OneDrive Germany compatibility * FIX: Failure to send existing translation version with update checks (on paid versions) resulted in redundant translation updates * FIX: Deal with a BackBlaze "first chunk too small" error correctly when doing chunked uploading * TWEAK: Block any updates from occurring during a restore * TWEAK: Force the predecessor Amazon S3 SDK to use virtual-hosted style bucket identification instead of path style * TWEAK: Refactor the remote storage logging code in Addon base v2 * TWEAK: Removed the Keyy notice (Keyy now has a new owner) * TWEAK: Add WP 5.3 support in UpdraftClone * TWEAK: On paid versions, possibly adjust the daily update check time to favour overnight hours * TWEAK: Get UpdraftClone supported WordPress versions during authentication * TWEAK: Added the ability to use backups stored in remote storage for UpdraftClone * TWEAK: Small PHP 7.4 deprecation tweaks in the Google and legacy AWS SDKs * FIX: Prevent trying to download files that have no remote storage and don't exist locally = 1.16.19 - 04/Oct/2019 = * FIX: GoogleDrive and WebDAV remote storage methods now correctly report if remote files failed to be deleted * FIX: Issue in cloudfiles-enhanced addon that breaks translations when the user language is different from the site language * FIX: Regression: add missing restore options * TWEAK: Improve restoration modal on mobile devices * TWEAK: Support the new Amazon S3 Middle East (Bahrain) region when removing a backup set * TWEAK: Improvements to the dashboard to allow for better screen-reader access * TWEAK: Ensure phpseclib Crypt_Blowfish is loaded over PEAR's version * TWEAK: Add time zone and expiries in to the UpdraftClone scheduled removal time * TWEAK: Add a multi-delete capability for OneDrive to prevent PHP timeouts during deletes = 1.16.18 - 20/Sep/2019 = * FIX: Select2 instance visiblility in restoration modal when selecting blog on multisite * FIX: Remove unsupported WordPress versions (3.6 and older) from the UpdraftClone selection list * FEATURE: Ability to resume interrupted database restores * TWEAK: Add filesystem error data when FTP input validation fails in UpdraftCentral * TWEAK: Enable appropriate SQL mode to ensure the database restoration compatibility * TWEAK: Add a link to the Backblaze configuration guide = 1.16.17 - 12/Sep/2019 = * FEATURE: Added the ability to use UpdraftClone with sub-folder based multisites * FEATURE: Catch duplicate entries in a corrupt DB upon restoration and handle/fix them automatically * FIX: Some more complicated triggers (see in CiviCRM) that were not previously handled correctly are; and SQL backup format for triggers is now mutually compatible with mysqldump/mysql binaries * FIX: Reset internal state upon beginning backup_resume(), in case WP cron called us multiple times in the same process * FIX: Provide compatibility functions on WP < 3.7 for mbstring_binary_safe_encoding() and reset_mbstring_encoding() * FIX: Correct the Azure China storage endpoint in options * TWEAK: Re-designed restore process * TWEAK: Prevent cosmetic error if WP_Filesystem call fails when deleting old folders * TWEAK: Fix escaping that caused a problem in some translations with a dismissal notice * TWEAK: Update bundled cacert.pem file * TWEAK: Include a DROP command for any triggers about to be created in the backup * TWEAK: The BackBlaze module (Premium feature) can now cope with BackBlaze losing uploaded chunks * TWEAK: Cast file IDs in Backblaze to strings to prevent possible API error * TWEAK: Do not attempt to perform search/replaces in tables of ARCHIVE type * TWEAK: Introduce the constant UPDRAFTPLUS_SQLEXEC_MAXIMUM_ERRORS to aid debugging * TWEAK: log message when checking which files need uploading on a incremental backup job * TWEAK: Don't send external DB backups to UpdraftClone * TWEAK: Reset the UpdraftClone UI if the clone is not created before it expires * TWEAK: Automatically detect a stalled restore and offer a resumption on the restore page * TWEAK: Remove some unused restore code * TWEAK: Prevent a PHP deprecation log notice with WebDAV on PHP 7.3 * TWEAK: Catch exceptions and errors during recursive search/replace and recover from them * TWEAK: CSS tweak to prevent other plugins from breaking the style of pop-up close buttons * TWEAK: Ensure the error is logged on the final remote send complete call if it fails * TWEAK: BackBlaze terminology updated to match their changes * TWEAK: Update seasonal notices for next year = 1.16.16 - 23/Jul/2019 = * TWEAK: Adding support for installing plugin and theme through zip files in UpdraftCentral * FEATURE: Added the ability to launch a blank WordPress clone * FEATURE: Add --collate= parameter to WP-CLI (Premium) to allow substitution of locally unknown collations when restoring * FIX: Switched to wp_insert_site() from insert_blog() and install_blog() method when importing single-site into a multisite network on WP 5.1+. Fixes 'Already Installed' error when importing on newer WP versions * FIX: Issue where (rare) foreign key constraints aren't updated upon restore when table prefix changes * FIX: Improve parsing of backed-up triggers when restoring preventing possible unnecessary errors * FIX: If an upload to Google Drive starts to fail due to an OAuth token refresh error, the backup will re-bootstrap the Drive client and try again * FIX: JSON-reparser to prevent unwanted RINFO data being output to screen * FIX: Triggers were still included in a backup for tables that were excluded because of lack of WP prefix * FIX: Resuming restores could resume at an unnecessarily early stage * FIX: Issue with Dropbox account information call that could make it fail * TWEAK: In cases where there were duplicate Google Drive folders (which is possible if there are multiple network communications failures when looking up the folder), these are now detected and merged automatically * TWEAK: Add option to start 250GB Vault subscription as in-app purchase * TWEAK: Regression: backup checksums were not being recorded in the backup log file * TWEAK: Remove UpdraftClone when the backup is cancelled by the user * TWEAK: Send the backup log during the creation of UpdraftClone for easier support when a clone fails to receive the backup * TWEAK: Detect OneDrive Graph token expiries and initiate swift resumption * TWEAK: Reduce the permissions requested for the UpdraftPlus Google Drive app (this now means that backups manually uploaded to Google Drive can not be deleted through the UpdraftPlus UI) = 1.16.15 - 31/May/2019 = * FEATURE: Added the ability to use already existing local backups with UpdraftClone * FIX: Prevent PHP fatal error (regression) when WP_Filesystem credentials were needed and wrong ones were supplied * FIX: Issue where you could not delete old directories from the restore progress page * FIX: Issue where restore would not run over AJAX if wrong credentials were entered when WordPress requested filesystem credentials * FIX: Fix incorrect refusal to accept valid email addresses in the UpdraftCentral wizard * TRANSLATION: The Italian translation is now complete and supplied from wordpress.org, so can be removed from the free plugin zip (saves 424KB disk space - if your mother tongue is not English and you want to improve UpdraftPlus, take a look at: https://translate.wordpress.org/projects/wp-plugins/updraftplus). * TWEAK: Update UpdraftCentral theme module handler to support themes without a name header * TWEAK: Prevent PHP log notice when fetching available theme updates via UpdraftCentral * TWEAK: Add more scheduling options to the built-in list (you can still further add whatever other arbitrary options you like: https://updraftplus.com/faqs/how-can-i-add-any-new-scheduling-interval-to-updraftplus/) * TWEAK: Abstract the code for handling maintenance mode to allow future improvements * TWEAK: Fix a potential wrong file path in an error message * TWEAK: If there is more than one Google Drive folder of the same name, now the selection is deterministic: the oldest one is always used * TWEAK: Infer phpseclib class path from the class name, instead of hard-coding it * TWEAK: Some lines that were meant to include HTML bold in the browser output had lost that effect * TWEAK: Add what entity caused the automatic backup to the logfile * TWEAK: Upon restoration, a couple of known plugin cache directories will be emptied to prevent serving up an intermediate page * TWEAK: Fix a bug in the "fail on resume" error-trapping logic which could cause it to resume too many times * TWEAK: Prevent a bogus error message being logged at the end of a successful direct site-to-site transfer * TWEAK: Add backup size information when hovering at the backup data buttons (excluding database button) * TWEAK: Allow the plugin to connect to account and activate Premium licence if no more UpdraftCentral Cloud licences remain and the user enables the 'Add this website to UpdraftCentral' option in the Premium/Extensions tab * TWEAK: During a restore send structured data to the front end. This is preparing the way for future UX improvements. = 1.16.14 - 30/Apr/2019 = * TWEAK: Make UpdraftVault trial more discoverable * TWEAK: Fix stray JavaScript in the short-lived version 1.16.13 * TWEAK: Add support to translation updates * TWEAK: Add WP 5.2 support in UpdraftClone * TWEAK: Prevent PHP notice in remotesend method * TWEAK: Restorations are now started over AJAX instead of in-page. This is preparing the way for future UX improvements. * TWEAK: Upgraded the 'site-to-site' remote sending code to use the more recent UDRPC message format * TWEAK: Make the UpdraftClone suggestion sentences dismissible * TWEAK: Improve JSON-reparser to cope with even more exotic junk from some setups with problems elsewhere in their stack = 1.16.12 - 16/Apr/2019 = * FIX: Regression which caused PclZip unzips to be very slow * TWEAK: Add stream_meta to the list of log tables and tables not requiring search/replace = 1.16.11 - 08/Apr/2019 = * FIX: Issue which prevented the downloader UI being removed during a manual entity download (regression) * FIX: Regression in 1.16.10 whereby restore resumptions did not correctly resume because the jobdata had not been loaded * TWEAK: Update UpdraftCentral description and internationalize strings * TWEAK: Handle HTTP/2 responses from Dropbox on some operations * TWEAK: Add a timeout on Dropbox quota look-up operations during backup, in response to cases of faulty outgoing HTTP proxies * TWEAK: The backup_finish() method should not have been private; could cause a harmless PHP abort when manually stopping a backup * TWEAK: Wrong variable context could cause failure of SFTP progress recording = 1.16.10 - 23/Mar/2019 = * FEATURE: Added support for backing up and restoring SQL triggers * FIX: Prevent the downloader UI being removed before it's complete in the case of multi-archive sets (regression) * TWEAK: Refactor the restore code and use jobdata to save information about the restore rather than using $_POST data * TWEAK: Automatically show the UpdraftClone admin UI for UpdraftClone developers for easier debugging * TWEAK: Prevent a PHP notice with certain exclusion settings * TWEAK: Add a mention of UpdraftClone in WP's PHP version notice and WooCommerce's "untested extensions" notice * TWEAK: Add 5.1 to the built-in list of available UpdraftClone WP versions = 1.16.8 - 13/Mar/2019 = * FIX: If requesting clone credentials that were not ready, the loop could rapidly repeat instead of waiting the intended time * TWEAK: Some background updates checks (paid versions) that were intended to be suppressed, weren't being. = 1.16.7 - 11/Mar/2019 = * FEATURE: Add support for bucket-specific application keys in Backblaze * FEATURE: Added the ability to take incremental backups via UpdraftCentral * FIX: Dropbox authorisation setting getting lost after saving UpdraftPlus settings in the free version * FIX: Issue where an error wasn't thrown if you tried to restore a backup with no valid components * TRANSLATION: Norwegian (Bokmål) and Polish translations are now complete and supplied from wordpress.org, so can be removed from the free plugin zip (saves 900KB disk space - if your mother tongue is not English and you want to improve UpdraftPlus, take a look at: https://translate.wordpress.org/projects/wp-plugins/updraftplus). * TWEAK: Ride a polling status check on the regular heartbeat check, thereby reducing the need for stand-alone polls * TWEAK: If FTP settings were removed and an attempt was made to download a backup, then a zero-sized file would be created and then an unclear error shown, instead of just showing a clear error. * TWEAK: For premium users: Added the option to connect to UpdraftCentral Cloud at point of connecting a license to a site * TWEAK: If on PHP 5.3 or later, then register our Google SPL auto-loader with the 'prepend' flag, so that we can avoid loading incompatible Google SDKs registered (but not yet used) by other components * TWEAK: Clear settings visuals after wipe settings * TWEAK: Improve UpdraftPlus news layout on dashboard * TWEAK: Handle a case seen where the updates checker failed to load * TWEAK: Prevent a possible PHP notice when requesting a rating * TWEAK: Update to the current series (4.5) of yahnis-elsts/plugin-update-checker (paid versions) * TWEAK: The "follow this link to refresh your (licensing) connection)" (paid versions) link was not functioning * TWEAK: Alert the user in the UI if they have activated a storage destination without any settings * TWEAK: Refactor the remote storage logging code in the S3, Email, Remote send, Backblaze, WebDAV, UpdraftVault, FTP, Google Cloud and Azure modules * FEATURE: Ability to purchase UpdraftVault subscriptions, including a new 5GB 1 month trial, directly from the UpdraftVault settings * TWEAK: If a directory is not found during a restore but the parent directory is then, where relevant, UpdraftPlus will automatically try to create the missing directory * TWEAK: Use the correct nonce name when requesting filesystem credentials if needing the WP_Filesystem API to delete old directories * TWEAK: Regression in 1.16.6 - certain types of final errors stopped being shown in the final report and had to be read from the log file * TWEAK: Refactor the remote storage logging code in all remote storage modules * TWEAK: Prevent the download entities UI becoming uglified from multiple button presses = 1.16.6 - 14/Feb/2019 = * FEATURE: Added new S3 intelligent tiering class * FEATURE: Ability for user to buy Premium without leaving the plugin's settings pages * FEATURE: UpdraftPlus can now catch backups that don't complete because of errors that kill PHP and make sure a report is still sent about them * FIX: If a very large UpdraftVault upload took more than an hour, then the token could expire without being refreshed (fix in version 1.16.0 was incomplete) * PERFORMANCE: Modify a condition in the zip-batching algorithm so that greater acceleration in the zip-batching algorithm is allowed on setups allowing very long PHP run times on the initial (zero-eth) resumption * PERFORMANCE: UpdraftClone now sends larger chunks over the network, leading to faster sending of data * PERFORMANCE: Force UpdraftClone to use a 100MB split size for better performance (previously intended, but not always working) * TWEAK: Upon restoration, WP's cache directory will be emptied (by default it is not included in backups, so in theory this is a no-op, but the occasional case has been seen where it got populated during the restore process) * TWEAK: Add support for the new Europe (Stockholm) (eu-north-1) AWS region in Amazon S3 * TWEAK: Advise the user if they changed the plugin's slug (and so won't be able to get updates) (paid versions) * TWEAK: Make use of wp_get_themes rather than relying solely to get_themes which is already deprecated * TWEAK: Regression: When a user aborted a fatal error occurred before all clean-up actions were complete = 1.16.5 - 28/Jan/2019 = * FEATURE: If a restoration is interrupted (e.g. PHP timeout), then the "Continue" feature can now resume not just at the most recent zip file, but within the zip file at the point it had reached (https://updraftplus.com/auto-resuming-interrupted-restores-part-2/) * FEATURE: Added command in WP-CLI which gives a list of incremental backups restore points. * FIX: Regression: When a Dropbox upload failed to complete, UpdraftPlus would log this but fail to retry * FIX: Again update phpseclib to the latest version which should now fix the 'SSH2 Server Host Key Algorithm Mismatch' on all installs * TWEAK: Correct a wrong variable reference in an error message * TWEAK: Only add the JavaScript for the incremental schedule selection on the UD settings page * TWEAK: Replace incidental use of ipinfo.io now that it requires a paid API key * TWEAK: The print_delete_old_dirs_form method should have been public to allow painting if the user clicked through the previous message = 1.16.4 - 17/Jan/2019 = * FIX: Regression: Properly mark backups picked up via "Rescan remote storage" as non-native (preventing unwelcome side-effects such as being pruned by another site) * FIX: Correctly update the OneDrive refresh token to prevent expiry * FIX: Again work around an issue with 'SSH2 Server Host Key Algorithm Mismatch' occurring with the current phpseclib release by temporarily reverting to an earlier one as it still does not work on all installs * FIX: When restoring an incremental backup set via WP-CLI, the selected restore point was ignored * FIX: If the remote storage settings were for multiple instances of a single backend-type (e.g. two Dropbox accounts), and if the entire backup and send operation completed in a single PHP process, then the local copy of the files would not be deleted * TWEAK: Show the error message if mbstring.func_overload is turned on in php.ini while creating migration key * TWEAK: Added Azure China endpoint * TWEAK: Resolve "dashicons" CSS conflict * TWEAK: Add 'blogmeta' to the list of core tables (in readiness for WP 5.1) * TWEAK: Remove unnecessary deprecated (in PHP 7.3) parameter to define() in WebDAV HTTP library * TWEAK: Prevent a potential PHP notice in UpdraftPlus Premium when installed without network access * TWEAK: Enhance the updraftplus_exclude_file and updraftplus_exclude_directory filters to also pass the stored names * TWEAK: Add a new constant UPDRAFTPLUS_ZIP_BATCH_CEILING that can tweak internals of the zip backup engine = 1.16.3 - 10/Jan/2019 = * FIX: Prevent extraction regression (in 1.16.1) when using PclZip (N.B. php-zip is always preferred if installed) on zero-sized files * FIX: Prevent the incremental backup cron from being incorrectly scheduled = 1.16.2 - 07/Jan/2019 = * FIX: wp_doing_cron() was used when unzipping, but requires WP 4.8+ (regression in 1.16.1, which was never released on wordpress.org) * TWEAK: Updated phpseclib to the latest version after the previous work around to fix the 'SSH2 Server Host Key Algorithm Mismatch' issue * TWEAK: Check-in with the clone during the backup process to make sure it is not prematurely purged = 1.16.1 - 01/Jan/2019 = * FIX: If a very large UpdraftVault upload took more than an hour, then the token could expire without being refreshed * FIX: Version 2.16.0 could write invalid or incomplete JSON when creating the manifest file on an incremental backup under certain circumstances * FIX: When restoring an incremental backup set via WP-CLI, the restore order could be wrong * TWEAK: Accept and parse the invalid JSON when restoring an incremental archive created on 2.16.0 * TWEAK: When running an incremental backup, the backup report would report the time taken to run the backup wrongly * TWEAK: Make the logging on the state of zip extraction more fine-grained (at least every 100MB, 1000 files or 15 seconds) * TWEAK: Re-factoring of zip extraction code to allow for future improvements * TWEAK: Re-factoring of the restore routines to share more code between different entry points, and allow future improvements * TWEAK: Differentiate between failures to JSON-decode an incremental backup manifest file and other types of failures = 1.16.0 - 19/Dec/2018 = * FEATURE: Added the ability to create and restore Incremental Backups (Premium version) * FIX: Work around an issue with 'SSH2 Server Host Key Algorithm Mismatch' occurring with the current phpseclib release by temporarily reverting to an earlier one * TWEAK: Improve performance by aggregating separate SQL SELECT queries (previously one for each backup) when loading the settings page * TWEAK: internal backup extradata parameter to prevent unwanted PHP notices * TWEAK: Fork a method UpdraftPlus_Filesystem_Functions::unzip_file() to allow for future enhancements * TWEAK: Periodic purging of obsolete job data that didn't get cleaned when expected was not happening on multisite * TWEAK: Improve logging when the initial call to jobdata_set_multi fails * TWEAK: Any stored backup/restore progress log files will now be deleted after 40 days. (Since they are attached to email reports, you can keep and retrieve them from those if needed). Over-ride this with the filter updraftplus_log_delete_age if desired. = 1.15.7 - 06/Dec/2018 = * FIX: a method call on an incorrect class which caused a fatal error = 1.15.6 - 06/Dec/2018 = * FEATURE: Added WordPress 5.0 support to UpdraftClone * FEATURE: Added the ability to choose the UpdraftClone server location * FEATURE: Cut a step from the activation procedure on paid versions, improving reliability on some installs that did not detect available updates * TWEAK: The UpdraftClone video is inserted after clicking a link (prevent unwanted call to the video server) * TWEAK: Replace a 'continue' with a 'break' to prevent a PHP notice on PHP 7.3 * TWEAK: (Paid versions) Simplify the constants involved in defining a custom/over-ride licensing server; and show in the 'Extensions' tab if an over-ride applies. * TWEAK: (Paid versions) Remove a library versioning assumption in the processing of results from a licensing claim * TWEAK: (Paid versions) A regression had caused the current UD install version to be sent in an updates check * TWEAK: Re-factoring of scheduling methods into their own class * TWEAK: Tweak the scheduling engine to separate the next resumption time from the maximum run time in the case of overlapping runs, in order to prevent unnecessary large gaps between resumptions in cases where the server allows very long run times = 1.15.5 - 19/Nov/2018 = * TWEAK: Include the backup set ID in clone ready state file * TWEAK: For Premium users with grand-fathered lifetime updates (i.e. purchased before August 2013), a regression had caused support entitlement expiries to no longer be notified * TWEAK: For Premium users with who have downgraded from unlimited licences to another package, a licence expiry message could show when in fact the real situation was that they just needed to specifically allocate a licence to the site. The relevant message has been adjusted to improve this. * TWEAK: Track "more files" incremental backup locations * TWEAK: Don't show individual add-ons that have not been bought in the account add-ons page if the user has Premium. * TWEAK: Include the raw updates check response information in the internal/advanced dump * TWEAK: Added the UpdraftClone video * TWEAK: Ability for user to buy Premium without leaving the plugin's settings pages = 1.15.3 - 29/Oct/2018 = * FEATURE: UpdraftPlus now has an option to auto-update * FEATURE: Azure for Government endpoint support (Premium) * FIX: SSL verification settings were not allowing verification to be turned off for generic S3 storage * FIX: In some situations in which a user had defined UTF8 as their character set but WordPress was using UTF8MB4, UpdraftPlus was not detecting this * FIX: Prevent particular a SQL text pattern wrongly triggering detection of database features when it is within content * TWEAK: Marked as supporting WordPress 5.0 * TWEAK: Automatically re-scan for presence of database backup after restoring it, to prevent confusion over its status * TWEAK: Change logic that controls whether the minified or full JavaScript is used * TWEAK: Improve Settings tab UI on mobile * TWEAK: Improve UpdraftClone UI * TWEAK: Improve UpdraftClone temporary page UI * TWEAK: Change method used to record the MySQL version to deal with how MariaDB can report when using a non-MariaDB client library (see: https://github.com/joomla/joomla-cms/issues/9062) * TWEAK: Replace Base64 encoded logo by image file * TWEAK: Hide guided tour on UpdraftClone * TWEAK: Fixed broken automatic backup modal layout * TWEAK: Auto rescan after restoring the remote database * TWEAK: Explicitly set the backup history option to not autoload, as it can get non-trivial in size * TWEAK: Improve UI of excluding things from the backup * TWEAK: Prevent a possible PHP debug notice in methods/backup-module.php * TWEAK: Show progress in browser view port instead of modal dialog when we delete the backup(s). * TWEAK: Added a --db-dummy-restore option to WP-CLI which will run a dummy restore of the database (under an unused prefix) and then drop the tables after it finishes. This option can be useful for testing. * TWEAK: Update the UpdraftClone UI when site information becomes available * TWEAK: Curl errors when interacting with Backblaze B2 will now be passed up for easier debugging * TWEAK: Re-factor add-on remote storage credential testing to make passing debugging information easier * TWEAK: Implement non-default SSL options with Backblaze B2 (previously the defaults were always used) * TWEAK: UpdraftClone: redirect to admin page after using the auto login link * TWEAK: Improve internal more files backup location tracking * TWEAK: Send a single request to download a backup set not for each file entity * TWEAK: Fix a DOM element whereby multiple nonces had the same id * TWEAK: Automatically build the more files backup location tracking on local rescan * TWEAK: Refactor the remote storage logging code in Onedrive module = 1.15.2 - 19/Sep/2018 = * FIX: Asking the tour to cancel on the plugins page did not work * FIX: an issue where some jobdata did not get set which resulted in the backup email not being sent * FIX: a regression whereby network-activated plugins could get deactivated on multisites when restoring * FIX: When database encryption was active, UpdraftClone would fail * TWEAK: There is now a 'Rescan remote storage - log results to console' link in 'Advanced Tools' to aid with debugging * TWEAK: Fixes Migrate / clone tab contents showing on the Advanced tools tab * TWEAK: Attempt to catch, work-around and log when the backup history cannot be saved due to too long a history relative to the MySQL server's maximum packet size * TWEAK: Re-factor and introduce the UpdraftPlus_Storage_Methods_Interface class * TWEAK: Introduce the UPDRAFTPLUS_ENABLE_TOUR constant for power users; set it to false as part of your automated WP installation process (or manually) if you wish to disable all tour functionality. = 1.15.0 - 12/Sep/2018 = * FEATURE: Introducing UpdraftClone. Create a live copy of your site with a button press. Great for testing changes, testing updates (e.g. WordPress core, plugins, PHP versions) and anything else you can think of. More information: https://updraftplus.com/updraftclone/ * FIX: Fix the logic for claiming and activating licences/add-ons. * FIX: Fixed OneDrive for Business Germany authentication tenant issue * TWEAK: WP-CLI - use dash (-) instead of underscore (_) to separate words, in order to match WP-CLI standards. * TWEAK: Adds close_browser_connection capability for servers using phpfpm * TWEAK: Change multiple backups selection and actions UI * TWEAK: Prevent PHP debug message on backup from UpdraftCentral when processing the service list * TWEAK: Improves manual backup feedback * TWEAK: Fix an out-of-date 'lost password' link * TWEAK: Add filter updraftplus_disk_space_check to allow over-riding disk space check result * TWEAK: Re-factor some of the restore code to enable future enhancements * TWEAK: In the case of an 'always keep' backup, it was possible for the wrong log message to be logged concerning the reason for it being kept * TWEAK: Add log warning and WP Admin notice regarding DreamObjects objects-us-west-1.dream.io endpoint shutting down * TWEAK: Refactor the remote storage logging code * TWEAK: Clean up some confusing UI when dealing with remote send backups = 1.14.13 - 15/Aug/2018 = * FEATURE: WP-CLI - add a 'get_latest_full_backup' command * FIX: An issue when deleting multiple backups could result in a backup set not found error * FIX: Polling during a backup when called from outside UpdraftPlus * FIX: Plugin activation check was running at the wrong point in the restore process * FIX: The WP-CLI "restore" command returned an unnecessary error if the incremental shim was not present * TWEAK: Multisite tweaks for UpdraftCentral's plugin and theme module handlers * TWEAK: Prevent potential PHP notice on page load when no backup storage is selected * TWEAK: Add scoping to some CSS rules that were too general. * TWEAK: A new "Backup / Restore" tab, which consists of backup status and existing backup with rid the "Current Status" tab and the "Existing Backups" tab * TWEAK: Remove the possibility of a false-positive warning of a migration-rather-than-restoration if the WordPress home_url setting has legitimate oddities * TWEAK: Improve UI of more database delete button (Premium) * TWEAK: Removed Gold column and redesigned Premium page * TWEAK: Improve UC factoring and introduce a UPDRAFTCENTRAL_COMMAND constant to allow context detection * TWEAK: Tweaked downwards the minimum time in the future for rescheduling a resumption * TWEAK: Deal with a possible issue in automatic collation selection in restoration when all character sets are supported and a collation is not supported * TWEAK: Replace absolute URLs in place of relative URLs in anchor links * TWEAK: Update error code URL for binary zip errors * FEATURE: Added OneDrive for Business Germany compatibility = 1.14.12 - 17/Jul/2018 = * FEATURE: Added Plugin guided tour for new users * FEATURE: Added UpdraftCentral's theme management module handler * FEATURE: User can mark any backup as "do not delete", and it will then not be deleted even when retention limits are hit * FEATURE: WP-CLI - add a 'restore' command * FEATURE: WP-CLI - Add an option 'delete-during-restore' in the 'restore' command * FEATURE: Add optional 'fingerprint' configuration for sftp/scp remote storage, allowing the connection to be halted if the server's fingerprint does not match what was entered * FEATURE: Added the ability to take an incremental backup via WP-CLI (note: incremental backups are still considered an experimental/work-in-progress feature) * FIX: If a user gave the wrong key to decrypt an encrypted database, the "Decryption failed" message did not display * FIX: The Migration was not changing an unsupported database table engine with the MyISAM engine automatically * FIX: Issue with the Dropbox account API call on some installs * FIX: The web server disk space refresh link of the existing backups is not working * FIX: The UpdraftPlus News couldn't print first time when the news cache was not made * FIX: Activating the "all addons" licence did not remove the corresponding 'activate on this account' link in the "Premium / Extensions" tab * FIX: When set names query character set hadn't support from the current MySQL server, the restoration process wasn't giving the option to replace the character set * TWEAK: Updated the plugin.php handler for UpdraftCentral's new plugin management module * TWEAK: Update posts handler to fix and update pagination in UpdraftCentral * TWEAK: Refresh UpdraftCentral keys upon successful login or registration using the UpdraftCentral Cloud wizard * TWEAK: Correct admin page URL in WP-CLI 'restore' command when on multisite without multisite add-on * TWEAK: Prevent PHP notice when checking non-existent files in relation to an extraneous whitespace warning * TWEAK: Prevent PHP notices in add-ons with non-present settings * TWEAK: Add the "Migrate / Clone" tab in place of the "Migrate / Clone" dialog * TWEAK: Prevent call to the the wp_get_sites() deprecated function on WP 4.6 and newer * TWEAK: Prevent a potential PHP debugging notice when displaying the 'Connect with your UpdraftPlus.com' form * TWEAK: Do not show the confusing JetPack 'backup' notice on the 'Updates' page * TWEAK: Added clone notices and commands for when UpdraftPlus is running on a UpdraftClone * TWEAK: Move 'Log all messages to syslog (only server admins are likely to want this)' into the 'expert' settings section * TWEAK: Replace a missing class constant in the Dropbox SDK (only relevant to people upgrading from Dropbox API v1 tokens - indicates upgrading UpdraftPlus from a very old version that previously used Dropbox APIv1 but never v2) * TWEAK: It's "backup", not "back up" * TWEAK: Prevent potential PHP debugging notices in restoration step 2 * TWEAK: Allow non-Super Admins to access UpdraftPlus Premium if they have 'manage_network_plugins' capability and the updraft_user_can_manage filter is used * TWEAK: Improved code in a way that prevents continuous polling in the themes page, the plugins page and the updates page = 1.14.11 - 25/May/2018 = * FIX: Revert a change in 1.14.9 that could cause backups to not be sent to remote storage (fix in 1.14.10 was not 100% complete (but worked for almost everyone)) = 1.14.9 - 24/May/2018 = * FEATURE: Make it more seamless to sign up to UpdraftCentral Cloud * FEATURE: Microsoft Azure storage (Premium) compatibility with Azure Germany * FEATURE: Added the ability to create migration keys from WP-CLI (Premium) * FIX: A backup icon/storage shows for a storage type even if all instances were disabled * FIX: WP CLI updraftplus command was not running on few environments like the Windows command line * FIX: A PHP fatal error was occurring when a user try to restore an encrypted DB when defining the "UPDRAFTPLUS_DECRYPTION_ENGINE" constant * TWEAK: Added the ability to schedule incremental backups (Note you can not yet take incremental backups) * REFACTOR: Completed factoring for tabs of the settings page. * TWEAK: Some re-factoring and tidying of the restoration code for easier maintenance * TWEAK: Add a longer timeout on SFTP logins to cope with a 'long delay, but then worked' situation seen in the wild * TWEAK: An "Incremental backups" extension was displayed in the Premium / Extensions tab, causing confusion since it is not yet finished/launched * TWEAK: Displays a Byte Order Mark (BOM) warning by giving the file names along with the path in the "Existing Backups" tab, if a BOM is detected at the start of common files that people tend to edit * TWEAK: A WP CLI Existing backup command didn't display a date time in the "job_identifier" column * TWEAK: Add links to the relevant app privacy policies within the settings sections for storage methods using OAuth authorization apps * TWEAK: Log user and group IDs of process and file/folder, when permissions for an operation is denied * TWEAK: Prevent a potential PHP debugging notice when showing the 'Upload' button * TWEAK: Update an out-of-date "wrong password" link * TWEAK: Added the "Web-server disk space in use by UpdraftPlus" information to "Site information" section in the "Advanced Tools" tab; it won't show in the 'Existing Backups' tab if you are using less than 100MB. * TWEAK: When a Google Cloud token was invalid, a PHP Fatal could result instead of catching the error and informing/logging nicely * TWEAK: If php-xml (SimpleXMLElement) is not installed, then show an appropriate warning in the Azure configuration section * TWEAK: If the user tries to install another version of UpdraftPlus, then tweak the default error message that they are shown by WP, which is too obscure/cryptic for many users * TWEAK: If a fatal error occurred during uploading a backup, try to recover it and process the upload further = 1.14.8 - 12/May/2018 = * FIX: Resuming of a partially uploaded backup archive in the new 'OneDrive for Business' module was not working * TWEAK: When testing SFTP settings, if debug is activated, activate debug logging and pass the results back in the event of test failure (previous attempt was incomplete) * TWEAK: OneDrive SDK cleaned up to remove the obsolete Live 5.0 API = 1.14.7 - 25/Apr/2018 = * FIX: Fix incompatibility with loading the dashboard on WP 4.6 and older. If you have this problem, then you cannot visit /wp-admin/ - you will need to update via another tool (e.g. if you have a multiple site management tool), or via FTP (download the https://downloads.wordpress.org/plugin/updraftplus.1.14.7.zip , unzip it on your PC, log in to your site via FTP into the folder wp-content/plugins, remove the existing folder 'updraftplus' and then upload the unzipped 'updraftplus' folder). Many apologies! = 1.14.6 - 25/Apr/2018 = * FEATURE: Added the option to upload locally-available backups to remote storage * FEATURE: Add post management module for UpdraftCentral (client-side; UC-side still pending) * FEATURE: Added WP-CLI "rescan-storage" subcommand to the WP-CLI add-on rescan either remote storage or local storage * FEATURE: Compatibility of the (paid) OneDrive module with 'OneDrive for Business' * FIX: Multisite restoration did not display single site restoration option when URLs were different but clearly the same site (http/https difference) * FIX: WebDAV uploads could fail if the user defined the constant UPDRAFTPLUS_WEBDAV_NEVER_CHUNK * FIX: If UpdraftVault remote had failed, UpdraftVault couldn't recover without settings wipe * TWEAK: Handle a DreamObjects server that was not sending an application/xml content-type header * TWEAK: Handle a case where the root cause of an error from DreamObjects was not being clearly shown * TWEAK: Alert the user of their mistake if they try to enter a URL instead of a folder path in the OneDrive settings folder field * TWEAK: Adjust the PclZip log message to clarify the implications of using PclZip (i.e.: it's significantly slower) * TWEAK: Add support for the upcoming objects-us-east-1.dream.io DreamObjects endpoint * TWEAK: Prevent potential PHP notice in WP-CLI subcommand for existing backups * TWEAK: Add UpdraftPlus news in admin dashboard "WordPress Events & News" widget = 1.14.5 - 3/Apr/2018 = * FEATURE: Add a "Database only" option to the UpdraftPlus email backup options * FEATURE: An UpdraftPlus add-on (paid) to run the backup process through WP CLI * FIX: Restoration did not display the decryption passphrase input (but always used the saved one) * FIX: Browse content download file was not working in Windows hosting * FIX: The wrong default for the 'Delete local backup' setting was applied if you had never saved your settings * TWEAK: Prevent a PHP notice showing when testing S3 storage * TWEAK: Prevent a PHP notice when downloading from Dropbox * TWEAK: Improved the migrate UI * TWEAK: Update bundle cacert bundle to latest (2018-01-17) release * TWEAK: Ajouter soutien pour le nouveau region AWS Paris (eu-west-3) * TWEAK: Handle short filesystem reads when sending data to Google Drive * TWEAK: Improve handling of PHP errors and exceptions during back-end calls * TWEAK: Update internal OneDrive SDK for compatibility with 'OneDrive for Business' (not yet fully supported) * TWEAK: Internal refactoring and improvements to the UpdraftPlus.com form * TWEAK: Job ID is now separate from the file nonce * TWEAK: Show increments in the UI * TWEAK: Add visibility controls to functions of a stream wrapper class for WebDAV access * TWEAK: Handle errors when getting folder ID from Google Drive more patiently * TWEAK: Displays more descriptive error when google drive authentication error occur = 1.14.4 - 19/Feb/2018 = * FEATURE: Now supports AWS v4 signatures (allowing use of new AWS regions) with old S3 SDK (which is used on PHP 5.2) * FIX: WebDAV options filter was not correctly saving any human-chosen description * FIX: Regression: Rackspace 'new user' wizard was not functioning * FIX: For chunked storage APIs that require a method to finally re-assemble chunks, if the first attempt failed, then a subsequent failed attempt could be incorrectly marked as having succeeded * FIX: First instance of each remote storage object was not using its internal default options * TWEAK: Added the ability to restore incremental backup sets (N.B. currently you cannot create incremental backup sets; this is part of our development of that feature) * TWEAK: Edit welcome banner * TWEAK: If 'lock admin' functionality (Premium) has been disabled by the site administrator, then include a line to that effect in the relevant section. * TWEAK: Allow UpdraftCentral classes to have boiler-plate pre and post-call methods * TWEAK: Do a bit more logging for Backblaze B2 uploads * TWEAK: Add a sanity check to prevent some PHP debug notices being logged in an upgrade situation * TWEAK: Resolved unwanted WebDAV remote storage JavaScript console message = 1.14.3 - 24/Jan/2018 = * FEATURE: OneDrive and Google Cloud deauthorise link provided after authentication * FEATURE: Added the ability to label remote storage instances (Premium) * TWEAK: Handle a combined error/timing condition seen on DigitalOcean Spaces that could lead to UD thinking that an upload that actually succeeded, did not * TWEAK: Add functions to pull backup status and log for UpdraftCentral * TWEAK: Add command multiplexer function for UpdraftCentral * TWEAK: Audit and regularise use of slash-handling code in AJAX layer * TWEAK: A couple of remote storage error paths were not returning the error information to the upper level correctly * TWEAK: Prevent phpseclib from throwing a fatal upon autoload if mbstring.func_overload is set (see: https://github.com/phpseclib/phpseclib/issues/762); instead, log, or handle in some other way appropriate to the context * TWEAK: Some minor code-styling and linting ignore tweaks * TWEAK: (Regression) After filling the UpdraftVault connect form, pressing Enter was no longer triggering submission * TWEAK: If counting up the total "More files" data when none are configured to be backed up, show "None configured" instead of "Error" * TWEAK: Improve UI of notice when claiming an add-on * TWEAK: Standardise the way OAuth remote storage methods authorise/deauthorise settings * TWEAK: "Wipe Settings" button click event was not asking for confirmation * TWEAK: Add Server Side Encryption (SSE) support to old S3 SDK * TWEAK: Dropbox now uses the internal chunked download API = 1.14.2 - 22/Dec/2017 = * FIX: Email backups not sending correctly * FIX: Buttons in the 'Migrate' dialog box stopped working after you switched tabs (until you reload the page) * FIX: Unable to delete multi-storage S3 instances * TWEAK: Remove duplicate DOM id for nonce fields * TWEAK: Correct name of PutObjectAclVersion permission when requesting it in S3 wizard * TWEAK: Improve S3 log message to make clear which back-end a message is coming from * TWEAK: Improved migration warning message if migrator addon is available and restoration site url is slightly different than current site url * TWEAK: New non-existent Backblaze B2 buckets are now created automatically * TWEAK: Suppress expected (but confusing to some users) "404 not found" message in the log when WebDAV backup file is at 0% uploaded = 1.14.1 - 12/Dec/2017 = * FEATURE: Backup to multiple remote storage accounts of the same type * TWEAK: Remove all the lines "X is a great choice, because is supports chunked uploading..." from the UI. Almost everything did support it, but not everything mentioned it, which could cause confusion. * TWEAK: Prevent a PHP log notice in some settings savings scenarios * TWEAK: Add missing filter for processing changes to Google Cloud, OneDrive and Azure settings (Premium storage option) on multisite * TWEAK: Minor internal re-factoring: move hard-coded storage back-end names out of options and multisite addon classes. * TWEAK: Prevent a PHP log notice during backup on PHP 7.2 = 1.13.16 - 07/Dec/2017 = * TWEAK: Remove Ukrainian translation files from wordpress.org zip (translation now complete, will download from wordpress.org separately) * TWEAK: Adding V4 Signature properties and methods to old S3 SDK * TWEAK: Migrator add-on: keep a log of tables as they are created * TWEAK: Tweak wording on the 'Premium/Extensions' tab * TWEAK: Change the order of classes in methods/cloudfiles.php to work around a PHP install bug seen in one instance * TWEAK: Be less aggressive about logging a usually unnecessary internal message about settings * TWEAK: Improve UI of migration notice in free version * TWEAK: Resolve PSR4 autoloading conflict with older version of Composer * TWEAK: Pruning will now prune backups from multiple storage destinations of the same type (not yet a user-visible feature) * TWEAK: Update the 'ifeq' handlebars helper to resolve a conflict with MainWP = 1.13.15 - 28/Nov/2017 = * FIX: Updated OneDrive SDK to allow for PHP 7.2 (due for release soon) compatibility * FIX: When multiple remote backup destinations existed, pruning of old backup sets was not removing from all destinations (recent regression) * FIX: When re-scanning a Rackspace Cloud Files remote location, only the first 100 files were processed * FIX: Backups being downloaded twice from Dropbox during a restore which could cause unexpected results upon a site migration * FIX: The 'SCP' and 'Server-side encryption' checkboxes in the settings was always ticked in the browser upon reload, regardless of the saved setting (regression in 1.13.14) * TWEAK: Improve export settings file name by appending site name to export download file * TWEAK: Perform escaping of table names in SQL calls without using esc_sql() * TWEAK: Site option is deleted before updating it in multisite * TWEAK: Improve WebDAV remote method upload speed * TWEAK: Improve WebDAV remote method download speed = 1.13.14 - 21/Nov/2017 = * FIX: Search/replace checkbox was not appearing when migrating a multisite setup * FIX: WordPress 4.8.3 introduced a breaking internal change in the WordPress database API, which broke the search/replace of strings including percent signs. Updated Migrator code to handle this. * FIX: WebDAV remote storage settings not being loaded onto the settings page properly * FIX: Rewrite of legacy (PHP 5.2) S3 SDK Class to fix pruning old backup sets when multiple storage back-ends that are all based on S3 are in use. * TWEAK: Improve formatting of restoration warnings * TWEAK: Add css classes to backup templates * TWEAK: Standardise the way storage classes are internally stored/retrieved * TWEAK: Remote storage modules configuration templates transition using handlebars.js * TWEAK: Adjust message mentioning mcrypt which is not needed if php-openssl is installed * TWEAK: Add UPDRAFTPLUS_USE_WPDB constant = 1.13.13 - 02/Nov/2017 = * FIX: Google Drive Custom App authorisation and de-authorisation was not working * FIX: Rackspace new user creation had stopped filling the new credential fields automatically after successful creation of a new user * TWEAK: When migrating, the detected search/replace terms now make sure that http and https variants are both included as search terms * TWEAK: Make the internal error code with OneDrive auth failures more accurate * TWEAK: Remote storage modules configuration templates transition using xamin/handlebars.php libraries * TWEAK: Changed the Dropbox authentication flow to not send a GET request on large URLs * TWEAK: Improve error message when invalid bucket name given by user for Backblaze remote storage method = 1.13.12 - 25/Oct/2017 = * TWEAK: Showing search/replace checkbox option only when needed. * FEATURE: Warn the user if their .htaccess seems to contain a redirect (or any other reference) to the old site after migration. * FEATURE: When importing a database, warn the user if the current MySQL server does not support a used collation, and offer to replace it * FIX: Saving of S3 settings had taken a dislike to buckets beginning with a capital 'B' * FIX: UpdraftCentral users' module was failing to handle loading a very large number of users * TWEAK: Allows the installation and/or activation of the WP-Optimize plugin from UpdraftCentral * TWEAK: Add multisite attribute to the error response object for the create user, delete user and edit user actions. * TWEAK: All remote storage methods are ported over to using configuration templates internally * TWEAK: Include a method to add a manifest file inside each backup archive * TWEAK: All code relating to the now-dead Dropbox APIv1 removed (N.B. If you've not updated UpdraftPlus since November 2016 and were using Dropbox, it won't be working - https://blogs.dropbox.com/developers/2017/09/api-v1-shutdown-details/) * TWEAK: Prevent a PHP log notice upon database backup restore when using Google Drive without a client ID * TWEAK: Prevent the final 'Restore' button being pressed a second time * TWEAK: Improvements to the UpdraftCentral wizard * TWEAK: Update to trunk version of plugin updater (paid versions), restoring the ability to work on older WP versions (3.8 and before) * TWEAK: Add lbakut_activity_log to the list of large log tables * TWEAK: Updater in paid versions now requests JSON as response format for responses when claiming entitlements * TWEAK: Resolve: Backup labels could end up with extraneous slashes in output * TWEAK: Updater in paid versions can now receive and process update information in respond to entitlement claim - one less HTTP round-trip * TWEAK: Improve Google Cloud authentication success message for bucket name is not defined * TWEAK: UpdraftVault commands now pass an instance identifier * FEATURE: Backups can now be uploaded to multiple instances of the same remote storage but not yet possible to add multiple instances = 1.13.11 - 27/Sep/2017 = * FIX: Fix a failure (regression in 1.13.8+) to download some backup sets which pre-date the existence of instances * FIX: Fix a failure to backup in the short-lived 1.13.10 (many apologies) * TWEAK: When logging an Exception or Error, include a backtrace (WP 3.4+) * TWEAK: Prevent a PHP warning during a save of the backup history * TWEAK: Added a MetaSlider notice in the notices collection * TWEAK: Put a try/catch block that will catch PHP exceptions/fatals (PHP 7.0+) during encryption phase, so that any issues can be logged = 1.13.9 - 25/Sep/2017 = * FEATURE: Backblaze B2 (https://www.backblaze.com/b2/) support in UpdraftPlus Premium * TWEAK: Port job data used by Azure, Google Cloud and OneDrive storage to being instance-local (now believed to all be ported) * TWEAK: The automatic correcting of wrongly-input S3 and FTP settings had regressed in a recent version * TWEAK: Various small fixes to the standards compliance of the HTML output in the remote storage settings area * TWEAK: When deleting backups with multiple remote storage instances of the same type, order the attempts = 1.13.8 - 21/Sep/2017 = * FEATURE: When importing a database, warn the user if the current MySQL server does not support a used character set, and offer to replace it (with a link explaining the risks) * FEATURE: Generic S3 storage module can now use non-default ports (specify by appending :(port number) to the host name) * FIX: Re-scanning of remote storage would fail to detect a file manually uploaded to a secondary remote storage location if not also present locally. Various other (unlikely) corner-case rescanning scenarios also tested and fixed. * TWEAK: Some enhancements to the S3 internals, to make the "S3 Generic" module behave better (it already worked) with the forthcoming DigitalOcean Spaces (object storage) (see: https://updraftplus.com/use-updraftplus-digital-ocean-spaces/) * TWEAK: UpdraftCentral will no longer show updates which WordPress core lists which appear to be of the same version number * TWEAK: Handle trying to download a zero-sized file through the browser more elegantly * TWEAK: When pressing 'Delete', the "also delete remote backup" checkbox was showing even for backups without remote storage * TWEAK: Abstract history handling into a separate class, UpdraftPlus_Backup_History, for easier maintenance * TWEAK: Remove a use of count() on a string to prevent a new PHP notice on PHP 7.2+ * TWEAK: Some changes to the UpdraftCentral connection tool to make it more user-friendly * TWEAK: Clarified and documented the re-scanning code, and made it compatible with the increased flexibility needed for incremental backups in future * TWEAK: Tweaked UpdraftCentral GA handler to support Tracking ID editing and disconnection. * TWEAK: In the free version, if the only difference between backup and site URLs is http/https, then show a different message to make the situation clearer * TWEAK: Make the UPDRAFTPLUS_IPV4_ONLY constant take effect more widely * TWEAK: Do not duplicate remote instance ID records in the backup history when re-scanning * TWEAK: Keep the remote instance ID list consistent with the remote service list when re-scanning * TWEAK: Prevent a PHP notice that could appear for locally stored backups in UpdraftPlus::get_storage_objects_and_ids() = 1.13.7 - 06/Sep/2017 = * FIX: UpdraftCentral connectivity for various operations restored (regression in 1.13.6) * FIX: No error message was being shown when a backup to local storage was missing upon restore * COMPATIBILITY: Replace uses of the deprecated (PHP 7.2+) each() function * TRANSLATION: Portuguese (Portugal) and Romanian translations are now complete and supplied from wordpress.org, so can be removed from the free plugin zip * TWEAK: Fix some wrongly-called translation functions, and pull more known strings into the Premium version * TWEAK: Remove the legacy parameter for setting storage upload job status data (only useful for version downgrades of more than 1 release during in-progress backups) * TWEAK: Exclude some unnecessary build and unused files from the release zip (reduce disk space and download size) = 1.13.6 - 05/Sep/2017 = * FEATURE: Google Drive authorisation now goes via an officially registered app for easier connections to Google Drive. * FEATURE: Include commands for UpdraftCentral's (https://updraftcentral.com) Google Analytics management facility (check the changelog.txt for the release) * FIX: Correct handling of OneDrive folder names featuring spaces (possibly a regression/change in the handling at OneDrive's end) * TWEAK: Prevent messy layout when the last log message is very long * TWEAK: Log catchable fatal errors and exceptions during backup in PHP 7 * TWEAK: Log catchable fatal errors and exceptions during restore in PHP 7 * TWEAK: Log catchable fatal errors and exceptions during backup download in PHP 7 * TWEAK: Reduce amount of database logging during existing zip analysis, database backup and pruning stages * TWEAK: In AJAX/JSON responses, automatically detect and handle corrupted output (e.g. setups where PHP debugging notices are configured to come to the browser) * TWEAK: Catches and more elegantly handles errors when a settings import file cannot be JSON-parsed * TWEAK: Request list of available add-ons (paid versions) from the mothership in current format * TWEAK: Added custom backup message parameter backupnow_message in function updraft_backupnow_inpage_go() * TWEAK: General code tidy-up, making older code conform to our current standards * TWEAK: Add the possibility of passing back associated data with test results, and log it in the browser console * TWEAK: When carrying out a remote storage test, pass the state of the 'debug' setting * TWEAK: When testing SFTP settings, if debug is activated, activate debug logging and pass the results back in the event of test failure * TWEAK: Optimise away a database query in the case of no UpdraftCentral keys existing * TWEAK: Removed "Reduced Redundancy" storage class from Amazon S3 remote storage options, because Amazon are deprecating it (and it now costs more, for inferior redundancy - https://updraftplus.com/forums/topic/amazon-is-phasing-out-reduced-redundancy-storage/) * TWEAK: Backup files missing error message corrected * TWEAK: Add the handlebars-js and xamin/handlebars.php libraries * TWEAK: The FTP storage module has been ported to outputting its configuration via a template * TWEAK: Introduce internal API and port all job data saved in storage modules to be instance-local = 1.13.5 - 08/Aug/2017 = * TWEAK: Manage phpseclib through composer * TWEAK: Do less logging to database when resuming and noticing already-processed tables (saves resources) * TWEAK: Returns comment status when updating comments from UpdraftCentral * TWEAK: Update plugin-updates-checker library to current (4.2), and manage via composer, replacing bundled copy in the build source * TWEAK: Replace uses of create_function(), which is deprecated on PHP 7.2 * TWEAK: Replace deprecated constructors (PHP 7+) in webdav module * TWEAK: Documentation showing plugin developers how easy it is to add in-page backups to their plugin: https://updraftplus.com/add-take-backup-functionality-plugin/ * TWEAK: Make the UpdraftCentral updates checking able to cope with a wider range of third-party schemes * TWEAK: General code tidy-up, making older code conform to our current standards * TWEAK: Minor version updates of some bundled libraries * TWEAK: Produce and use minified resources (CSS/JS) where available * TWEAK: Update class-udrpc to latest (1.4.14) which removes a conflict with other code that may interact with CORS OPTIONS requests * TWEAK: Escape log lines when sending for display (theoretically an XSS security issue, but to achieve a successful attack, someone would have to first get something malicious into the log file, which is difficult as there are not many places where foreign input can end up in the log file - e.g. hack into Dropbox and cause Dropbox to send you back malicious HTML in an error message - and then be able to persuade you to both take a backup triggering the problem and then view the log file in your WP dashboard) * TWEAK: Update Google Cloud bucket locations = 1.13.4 - 08/Jun/2017 = * FIX: Import function had a regression and was not coping with all formats * TWEAK: When the import function failed, the error was not shown to the user = 1.13.3 - 07/Jun/2017 = * FIX: Revert Dropbox authentication change in 1.13.2, which was not working on all sites = 1.13.2 - 07/Jun/2017 = * TWEAK: Marked as tested and compatible on WordPress 4.8 * TWEAK: Dropbox authentication flow can now use POST for the final step, side-stepping (arbitrary) parameter length restrictions on some Apache mod_security setups * TWEAK: Prevent a possible PHP notice when curl is not present * TWEAK: Point Clef users towards Keyy * TWEAK: Do not open an alert box when the user changes their site ID in 'Advanced Tools' * TWEAK: Fix parameters to updraft_check_overduecrons() JS function = 1.13.1 - 09/May/2017 = * REFACTOR: Completed re-factoring of the remote storage modules, so that now all remote storage code has completed this current stage of re-factoring (more to come in future - laying the foundation for a significant new feature) * FIX: Added a nonce to the Dropbox deauth link. This is a minor security issue - someone personally targeting you, who knew that you were logged in to your WordPress admin, and who could persuade you to visit a personally-crafted web page, could cause the connection between UpdraftPlus and your Dropbox to be broken. The only impact of this is that the sending of your next backup to Dropbox would fail, and you would be alerted about the need to re-connect. * FIX: Import settings now handle the new remote storage options format * FIX: The zip file browser was not working in free versions * TWEAK: Added a version check when saving settings to prevent errors or lost settings * TWEAK: 'Existing Backups' table now shows an icon for each remote destination that the backup was sent to * TWEAK: Update SSL CA certificates file * TWEAK: If, when uploading to S3, a file is not found, handle it slightly more elegantly * TWEAK: Work with some WebDAV servers that previously sent empty responses to OPTIONS requests = 1.12.40 - 01/Apr/2017 = * TWEAK: The in-page log file display had stopped continuously updating in 1.12.32 * FIX: In some circumstances, settings for the storage modules refactored in 1.12.37 could fail to show * FIX: The free version of 1.12.37/38 in some circumstances could fail to complete Dropbox authentication = 1.12.38 - 31/Mar/2017 = * TWEAK: Dropbox API v2 call to de-authorise a token was failing * FIX: Prevent a fatal error when attempting to use a backup method with no options set = 1.12.37 - 31/Mar/2017 = * FEATURE: Browse the contents of a backup from within your WordPress dashboard, and (with Premium) download individual files from it * FIX: Fix an issue that could occasionally cause corruption of interrupted Dropbox backups. All Dropbox users are recommended to update asap. * TWEAK: Remove debugging statement inadvertently left in 1.12.36 * TWEAK: Re-factored remote storage handlers via add-ons so that there was a cleaner and more consistent class hierarchy (preparation for future improvements). N.B. If you subsequently downgrade to an older version of UpdraftPlus, you will need to re-enter the settings for some remote storage options. * TWEAK: List of checksum algorithms run over backups and logged now includes SHA256, and is filterable (SHA1 now considered deprecated) * TWEAK: Allow chunked database encryption to try and resume in the event of an error * TWEAK: Improve the premium/extension tab content * TWEAK: Fix an issue whereby the UpdraftVault settings section could show a bogus problem with checking quota immediately after initial setup * TWEAK: When requesting a download, work around buggy browser/server that continued after Connection: close * TWEAK: Improve the UI experience when downloading a log file for display fails * TWEAK: Prevent PHP notice if another plugin cancels a cron event * TWEAK: Tweak semaphore handling and enhance logging Older changes are found <a href="https://plugins.svn.wordpress.org/updraftplus/trunk/changelog-old.txt">in the changelog-old.txt file in the plugin directory.</a> == Screenshots == 1. Main dashboard - screenshots are from UpdraftPlus Premium, so may reference some features that are not part of the free version 2. Configuring your backups 3. Take a backup 4. Choose which components to restore 5. Restoration shows as successful 6. To migrate, first click 'Database', 'Plugins' etc. to download these backups to your local machine. 7. On the destination site, 'upload backup files' from the source site to restore and migrate to the new destination. == License == Copyright 2011-24 David Anderson This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Non-English translators are provided by volunteers, and wordpress.org does not give plugin developers control over their translations; thus relying on them is at your own risk; UpdraftPlus cannot guarantee that translations from the original English are accurate. We recognise and thank those mentioned at https://updraftplus.com/acknowledgements/ for code and/or libraries used and/or modified under the terms of their open source licences. == Upgrade Notice == * 1.25.8: Support for new Amazon AWS S3 regions (New Zealand, Taipei and Mexico), better statuses in the backup email report, search and replace improvement for the __PHP_Incomplete_Class. Various fixes and small tweaks - see the changelog for details. A recommended update for all.	169.02 KB	2025-10-09 08:53
📄 restorer.php <?php if (!defined('UPDRAFTPLUS_DIR')) die('No direct access allowed'); if (!class_exists('Updraft_Restorer_Skin')) updraft_try_include_file('includes/updraft-restorer-skin.php', 'require_once'); if (!class_exists('UpdraftPlus_Search_Replace')) updraft_try_include_file('includes/class-search-replace.php', 'require_once'); class Updraft_Restorer { // This just stores the result of is_multisite() private $is_multisite; // This is just used so far for detecting whether we're on the second run for an entity or not. public $been_restored = array(); private $tables_been_dropped = array(); private $delete_archives_upon_restoration = false; private $errors; private $created_by_version = false; // This one can be set externally, if the information is available public $ud_backup_is_multisite = -1; public $ud_multisite_selective_restore = false; /** * Information about the backup set being restored * * @var Array\|Null / private $ud_backup_set; private $ud_foreign_working_dir; private $ud_foreign_package; public $ud_foreign; private $ud_extract_count; private $ud_working_dir; private $ud_extract_dir; private $ud_made_dirs; // store restored table names public $restored_table_names = array(); public $is_dummy_db_restore = false; // The default of false means "use the global $wpdb" private $wpdb_obj = false; private $mysql_dbh = false; private $use_mysqli = false; private $line_last_logged = 0; private $our_siteurl; private $configuration_bundle; /* * User inputted restore options. It is public because read in multisite and migrator addons. * * @var array / public $restore_options; private $restore_this_site = array(); private $restore_this_table = array(); private $restoring_table = ''; private $line = 0; private $statements_run = 0; private $use_wpdb = null; private $import_table_prefix = null; private $final_import_table_prefix = null; private $disable_atomic_on_current_table = false; private $table_engine = ''; private $table_name = ''; private $new_table_name = ''; private $original_table_name = ''; private $tables_created = 0; private $view_names = array(); private $continuation_data; private $current_index = 0; private $current_type = ''; private $previous_table_name = ''; private $include_unspecified_tables = false; private $include_unspecified_plugins = false; private $include_unspecified_themes = false; private $tables_to_restore = array(); private $plugins_to_restore = array(); private $themes_to_restore = array(); private $stored_routine_supported = null; private $tables_to_skip = array(); private $plugins_to_skip = array(); private $themes_to_skip = array(); public $search_replace_obj = null; // Constants for use with the move_backup_in method // These can't be arbitrarily changed; there is legacy code doing bitwise operations and numerical comparisons, and possibly legacy code still using the values directly. const MOVEIN_OVERWRITE_NO_BACKUP = 0; const MOVEIN_MAKE_BACKUP_OF_EXISTING = 1; const MOVEIN_DO_NOTHING_IF_EXISTING = 2; const MOVEIN_COPY_IN_CONTENTS = 3; private $wp_upgrader; public $skin = null; public $strings = array(); private $generated_columns = array(); private $supported_generated_column_engines = array(); private $generated_columns_exist_in_the_statement = array(); private $printed_new_table_prefix = false; private $old_siteurl = ''; private $old_home = ''; private $old_content = ''; private $old_uploads = ''; private $old_table_prefix = null; /* * Old site information from the Database backup file. It is public because read in multisite and migrator addons. * * @var array / public $old_siteinfo = array(); private $old_abspath = ''; /* * UpdraftPlus plugin slug of the backup site. It is public because read in multisite addon. * * @var String / public $old_updraftplus_plugin_slug = ''; private $pre_restore_updatedir_writable; /* * A WP_Filesystem path * * @var String / private $abspath; /* * Entries indicate forbidden SQL permissions which restore code should thus not attempt to use ('create', 'drop', 'lock', rename', 'triggers') * * @var Array / private $db_permissons_forbidden = array(); private $prior_upload_path; private $insert_statements_run; private $start_time; private $last_error; private $last_error_no; private $max_allowed_packet; private $set_names; /* * Constructor * * @param WP_Upgrader_Skin\|Null $skin - an upgrader skin * @param Array\|Null $backup_set - the backup set to restore * @param Boolean $short_init - whether just to do a minimal initialisation * @param Array $restore_options - options to guide the restoration * @param Array\|Null $continuation_data - continuation data; the jobdata of the job thus far (but only a few properties are used - including second_loop_entities; $restore_options will have come from there too if relevant, but that is passed in here separately); the 'last_index_' entries also indicate unzipping progress / public function __construct($skin = null, $backup_set = null, $short_init = false, $restore_options = array(), $continuation_data = null) { $this->our_siteurl = untrailingslashit(site_url()); $this->continuation_data = $continuation_data; $this->setup_database_objects(); $this->search_replace_obj = new UpdraftPlus_Search_Replace(); if ($short_init) return; // If updraft_incremental_restore_point is equal to -1 then this is either not a incremental restore or we are going to restore up to the latest increment, so there is no need to prune the backup set of any unwanted backup archives. if (isset($restore_options['updraft_incremental_restore_point']) && $restore_options['updraft_incremental_restore_point'] > 0) { $restore_point = $restore_options['updraft_incremental_restore_point']; foreach ($backup_set['incremental_sets'] as $increment_timestamp => $entities) { if ($increment_timestamp > $restore_point) { foreach ($entities as $entity => $backups) { foreach ($backups as $key => $value) { unset($backup_set[$entity][$key]); } } } } } // if updraft_include_more_path is set then, the user has chosen where they want these backup files to be restored as either UD did not know where to restore them or the original location is not found on disk any more if (isset($restore_options['updraft_include_more_path'])) { if (!isset($backup_set['morefiles_linked_indexes']) \|\| !isset($backup_set['morefiles_more_locations'])) { $backup_set['morefiles_more_locations'] = $restore_options['updraft_include_more_path']; foreach ($restore_options['updraft_include_more_path'] as $key => $path) { $backup_set['morefiles_linked_indexes'][] = $key; } } else { foreach ($restore_options['updraft_include_more_path'] as $key => $path) { $backup_set['morefiles_more_locations'][$key] = $path; } } if (isset($restore_options['updraft_include_more_index'])) { // unset any backups the user has chosen not to restore foreach (array_keys($backup_set['more']) as $key) { if (!in_array($key, $restore_options['updraft_include_more_index'])) unset($backup_set['more'][$key]); } } } if (isset($restore_options['include_unspecified_tables'])) $this->include_unspecified_tables = $restore_options['include_unspecified_tables']; if (isset($restore_options['tables_to_restore'])) $this->tables_to_restore = $restore_options['tables_to_restore']; if (isset($restore_options['tables_to_skip'])) $this->tables_to_skip = $restore_options['tables_to_skip']; if (isset($restore_options['include_unspecified_plugins'])) $this->include_unspecified_plugins = $restore_options['include_unspecified_plugins']; if (isset($restore_options['plugins_to_restore'])) $this->plugins_to_restore = $restore_options['plugins_to_restore']; if (isset($restore_options['plugins_to_skip'])) $this->plugins_to_skip = (array) $restore_options['plugins_to_skip']; if (isset($restore_options['include_unspecified_themes'])) $this->include_unspecified_themes = $restore_options['include_unspecified_themes']; if (isset($restore_options['themes_to_restore'])) $this->themes_to_restore = $restore_options['themes_to_restore']; if (isset($restore_options['themes_to_skip'])) $this->themes_to_skip = (array) $restore_options['themes_to_skip']; // Restore in the most helpful order uksort($backup_set, array('UpdraftPlus_Manipulation_Functions', 'sort_restoration_entities')); $this->ud_backup_set = $backup_set; add_filter('updraftplus_logline', array($this, 'updraftplus_logline'), 10, 5); add_action('updraftplus_restored_db_table', array($this, 'updraftplus_restored_db_table'), 10, 3); do_action('updraftplus_restorer_restore_options', $restore_options); $this->ud_multisite_selective_restore = (is_array($restore_options) && !empty($restore_options['updraft_restore_ms_whichsites']) && $restore_options['updraft_restore_ms_whichsites'] > 0) ? $restore_options['updraft_restore_ms_whichsites'] : false; $this->restore_options = $restore_options; $this->ud_foreign = empty($backup_set['meta_foreign']) ? false : $backup_set['meta_foreign']; if (isset($backup_set['is_multisite'])) $this->ud_backup_is_multisite = $backup_set['is_multisite']; if (isset($backup_set['created_by_version'])) $this->created_by_version = $backup_set['created_by_version']; $this->backup_strings(); $this->is_multisite = is_multisite(); updraft_try_include_file('includes/class-database-utility.php', 'require_once'); if (!class_exists('WP_Upgrader')) include_once(ABSPATH.'wp-admin/includes/class-wp-upgrader.php'); $this->skin = $skin; $this->wp_upgrader = new WP_Upgrader($skin); $this->wp_upgrader->init(); } /** * This function will check if we are using wpdb, if we are not then it will setup our wpdb-like objects * * @param boolean $reconnect_wpdb - if we should include and create a new instance of wpdb * * @return void / private function setup_database_objects($reconnect_wpdb = false) { global $wpdb; if ($reconnect_wpdb) { $wpdb->db_connect(true); } // Line up a wpdb-like object if (!$this->use_wpdb()) { // We have our own extension which drops lots of the overhead on the query $wpdb_obj = new UpdraftPlus_WPDB(DB_USER, DB_PASSWORD, DB_NAME, DB_HOST); // Was that successful? if (!$wpdb_obj->is_mysql \|\| !$wpdb_obj->ready) { $this->use_wpdb = true; } else { $this->wpdb_obj = $wpdb_obj; $this->mysql_dbh = $wpdb_obj->updraftplus_get_database_handle(); $this->use_mysqli = $wpdb_obj->updraftplus_use_mysqli(); } } } /* * This function will try to restore the database connection, if it succeeds then it returns true otherwise false * * @return boolean - true if the connection is restored, otherwise false / private function restore_database_connection() { global $updraftplus, $wpdb; $wpdb_connected = $updraftplus->check_db_connection($wpdb, false, false, true); if (false === $wpdb_connected \|\| -1 === $wpdb_connected) { sleep(10); $this->setup_database_objects(true); return false; } return true; } /* * Get the wpdb-like object that we are using, if we are using one * * @return UpdraftPlus_WPDB\|Boolean / public function get_db_object() { return $this->wpdb_obj; } /* * Restore has been completed - clean some things up * * @param Boolean\|WP_Error $successful - if the restore was successful (true) or not (false or WP_Error). If not, then only a minimum of necessary clean-up things is done. * @param Boolean $browser_context - if true, then extra messages will be echo-ed * * @uses UpdraftPlus::log() / public function post_restore_clean_up($successful = true, $browser_context = true) { global $updraftplus, $updraftplus_admin; $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'cleaning', 'data' => array())); if (is_wp_error($successful)) { foreach ($successful->get_error_codes() as $code) { if ('already_exists' == $code) { if ($browser_context) { global $updraftplus_admin; $updraftplus_admin->print_delete_old_dirs_form(false); } else { $updraftplus->log(__('Your WordPress install has old directories from its state before you restored/migrated (technical information: these are suffixed with -old).', 'updraftplus')); } } $data = $successful->get_error_data($code); if (!empty($data)) { $pdata = is_string($data) ? $data : serialize($data); $updraftplus->log(__('Error data:', 'updraftplus').' '.$pdata, 'warning-restore'); if (false !== strpos($pdata, 'PCLZIP_ERR_BAD_FORMAT (-10)')) { $url = apply_filters('updraftplus_com_link', 'https://teamupdraft.com/documentation/updraftplus/topics/restoration/troubleshooting/what-does-error-message-pclzip_err_bad_format-10-mean/?utm_source=udp-plugin&utm_medium=referral&utm_campaign=paac&utm_content=unknown&utm_creative_format=unknown'); if ($browser_context) { echo '<a href="'.esc_url($url).'" target="_blank"><strong>'.esc_html__('Follow this link for more information', 'updraftplus').'</strong></a><br>'; } else { $updraftplus->log(__('Follow this link for more information', 'updraftplus').': '.$url); } } } } $successful = false; } // From this point on, $successful is a boolean if ($successful) { // All done - remove the intermediate marker delete_site_option('updraft_restore_in_progress'); foreach (array('template', 'stylesheet', 'template_root', 'stylesheet_root') as $opt) { add_filter('pre_option_'.$opt, array($this, 'option_filter_'.$opt)); } // Clear any cached pages after the restore $this->clear_caches(); // Have seen a case where the current theme in the DB began with a capital, but not on disk - and this breaks migrating from Windows to a case-sensitive system $template = get_option('template'); if (!empty($template) && WP_DEFAULT_THEME != $template && strtolower($template) != $template) { $theme_root = get_theme_root($template); if (!file_exists("$theme_root/$template/style.css") && file_exists("$theme_root/".strtolower($template)."/style.css")) { $updraftplus->log_e("Theme directory (%s) not found, but lower-case version exists; updating database option accordingly", $template); update_option('template', strtolower($template)); } } if (!function_exists('validate_current_theme')) include_once(ABSPATH.WPINC.'/themes'); if (!validate_current_theme()) { if ($browser_context) echo '<strong>'; $updraftplus->log_e("The current theme was not found; to prevent this stopping the site from loading, your theme has been reverted to the default theme"); if ($browser_context) echo '</strong>'; } do_action('updraftplus_restore_completed'); } if ($browser_context) echo '</div>'; // Close the updraft_restore_progress div restore_error_handler(); } /* * Whether or not we must use the global $wpdb object for database queries. * That is to say: we can always use it. But we prefer to avoid the overhead since we are potentially doing very many queries. * * This is the getter. We have no use-case for a setter outside of this class, so we just set it directly. * * @return Boolean / public function use_wpdb() { if (!is_bool($this->use_wpdb)) { global $wpdb; if (defined('UPDRAFTPLUS_USE_WPDB')) { $this->use_wpdb = (bool) UPDRAFTPLUS_USE_WPDB; } else { $this->use_wpdb = ((!function_exists('mysql_query') && !function_exists('mysqli_query')) \|\| !$wpdb->is_mysql \|\| !$wpdb->ready) ? true : false; } } return $this->use_wpdb; } /* * Get the skin * * @return WP_Upgrader_Skin / public function ud_get_skin() { return $this->skin; } /* * Ensure that needed files are present locally, and return data for the next step (plus do some internal configuration) * * @param Array $entities_to_restore * @param Array $backupable_entities - list of entities * @param Array $services - list of services that the backup can be found at * * @uses self::pre_restore_backup() (and some other internal properties) * @uses UpdraftPlus::log() * * @return Boolean\|Array\|WP_Error - a sorted array (of entity types and files for each entity type) or false or a WP_Error if there was an error / private function ensure_restore_files_present($entities_to_restore, $backupable_entities, $services) { global $updraftplus; // First loop: make sure that files are present + readable; and populate array for second loop $second_loop = $this->check_file_availability_and_log($entities_to_restore, $backupable_entities, $services); // A WP_Error or boolean indicates that the restore cannot proceed if (!is_array($second_loop)) return $second_loop; $this->delete_archives_upon_restoration = UpdraftPlus_Options::get_updraft_option('updraft_delete_local', 1) ? true : false; if (empty($services) \|\| array('email') === $services \|\| !empty($this->ud_foreign)) { if ($this->delete_archives_upon_restoration) $updraftplus->log_e('Will not delete any archives after unpacking them, because there was no cloud storage for this backup'); $this->delete_archives_upon_restoration = false; } if (!empty($this->ud_foreign)) $updraftplus->log("Foreign backup; created by: ".$this->ud_foreign); // Second loop: prepare to launch the restoration uksort($second_loop, array('UpdraftPlus_Manipulation_Functions', 'sort_restoration_entities')); // If continuing, then prune those already done if (is_array($this->continuation_data) && isset($this->continuation_data['second_loop_entities'])) { foreach ($second_loop as $type => $files) { if (isset($this->continuation_data['second_loop_entities'][$type])) { $second_loop[$type] = $this->continuation_data['second_loop_entities'][$type]; } else { $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'files', 'data' => array('entity' => $type, 'index' => 0, 'file' => '', 'fileindex' => 0, 'size_written' => 0, 'total_files' => 0))); unset($second_loop[$type]); } } } return $second_loop; } /* * Check that the files in the backup set in self::$backup_set are available and as expected; log the results; return a processed array with information * * @param Array $entities_to_restore * @param Array $backupable_entities - list of entities * @param Array $services - services to fetch from if files are not available locally * * @uses self::$backup_set * @uses self::$ud_backup_is_multisite * @uses self::$continuation_data * @uses self::$been_restored * @uses self::$ud_foreign * * @return Array\|WP_Error\|Boolean - if successful, then an array for the second loop; otherwise, an error returned (either a WP_Error or boolean false) / private function check_file_availability_and_log($entities_to_restore, $backupable_entities, $services) { global $updraftplus; $updraft_dir = $updraftplus->backups_dir_location(); $foreign_known = apply_filters('updraftplus_accept_archivename', array()); $entities_to_download = $this->get_entities_to_download($entities_to_restore); $backup_set = $this->ud_backup_set; $timestamp = $backup_set['timestamp']; $second_loop = array(); foreach ($backup_set as $type => $files) { // All restorable entities must be given explicitly, as we can store other arbitrary data in the history array if (!isset($backupable_entities[$type]) && 'db' != $type) continue; if (isset($backupable_entities[$type]['restorable']) && false == $backupable_entities[$type]['restorable']) continue; if (!isset($entities_to_download[$type])) continue; if ('wpcore' == $type && is_multisite() && 0 === $this->ud_backup_is_multisite) { $updraftplus->log('wpcore: '.__('Skipping restoration of WordPress core when importing a single site into a multisite installation.', 'updraftplus').' '.__('If you had anything necessary in your WordPress directory then you will need to re-add it manually from the zip file.', 'updraftplus'), 'notice-restore'); // TODO // $updraftplus->log_e('Skipping restoration of WordPress core when importing a single site into a multisite installation. If you had anything necessary in your WordPress directory then you will need to re-add it manually from the zip file.'); continue; } if (is_string($files)) $files = array($files); foreach ($files as $ind => $file) { $fullpath = $updraft_dir.'/'.$file; $updraftplus->log(sprintf(__("Looking for %s archive: file name: %s", 'updraftplus'), $type, $file), 'notice-restore'); if (is_array($this->continuation_data) && isset($this->continuation_data['second_loop_entities'][$type]) && !in_array($file, $this->continuation_data['second_loop_entities'][$type])) { $updraftplus->log(__('Skipping: this archive was already restored.', 'updraftplus'), 'notice-restore'); // Set the marker so that the existing directory isn't moved out of the way $this->been_restored[$type] = true; continue; } if (!is_readable($fullpath) \|\| 0 == filesize($fullpath)) { UpdraftPlus_Storage_Methods_Interface::get_remote_file($services, $file, $timestamp, true); } $index = (0 == $ind) ? '' : $ind; // If a file size is stored in the backup data, then verify correctness of the local file if (isset($backup_set[$type.$index.'-size'])) { $fs = $backup_set[$type.$index.'-size']; $print_message = __("Archive is expected to be size:", 'updraftplus')." ".round($fs/1024, 1)." KB: "; $as = @filesize($fullpath);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- the ensuing code handles any issues if ($as == $fs) { $updraftplus->log($print_message.__('OK', 'updraftplus'), 'notice-restore'); } else { $updraftplus->log($print_message.__('Error:', 'updraftplus')." ".__('file is size:', 'updraftplus')." ".round($as/1024)." ($fs, $as)", 'warning-restore'); } } else { $updraftplus->log(__("The backup records do not contain information about the proper size of this file.", 'updraftplus'), 'notice-restore'); } if (!is_readable($fullpath)) { $updraftplus->log(__('Could not read one of the files for restoration', 'updraftplus')." ($file)", 'warning-restore'); $updraftplus->log("$file: ".__('Could not read one of the files for restoration', 'updraftplus'), 'error'); return false; } } if (empty($this->ud_foreign)) { $types = array($type); } else { if ('db' != $type \|\| empty($foreign_known[$this->ud_foreign]['separatedb'])) { $types = array('wpcore'); } else { $types = array('db'); } } foreach ($types as $check_type) { $info = isset($backupable_entities[$check_type]) ? $backupable_entities[$check_type] : array(); $val = $this->pre_restore_backup($files, $check_type, $info); if (is_wp_error($val)) { $updraftplus->log_wp_error($val); foreach ($val->get_error_messages() as $msg) { $updraftplus->log(__('Error:', 'updraftplus').' '.$msg, 'warning-restore'); } return $val; } elseif (false === $val) { return false; } } foreach ($entities_to_restore as $entity => $via) { if ($via == $type) { if ('wpcore' == $via && 'db' == $entity && count($files) > 1) { $second_loop[$entity] = apply_filters('updraftplus_select_wpcore_file_with_db', $files, $this->ud_foreign); } else { $second_loop[$entity] = $files; } } } } return $second_loop; } /* * Perform the restoration. No code here (or called) should assume anything about the method used to call it (e.g. wp-admin or WP-CLI); it should be independent of how it is being called. * * The path through this class is: perform_restore() -> restore_backup() -> unpack_package_(archive\|database) and then (for standard UD archives) UpdraftPlus_Filesystem_Functions::unzip_file() * * @param Array $entities_to_restore - entities to restore * @param Array $restore_options - restoration options * * @uses the WordPress action updraftplus_restoration_title, allowing the title to be printed * * @return Boolean\|WP_Error / public function perform_restore($entities_to_restore, $restore_options) { global $updraftplus; $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'verifying', 'data' => implode(', ', array_flip($entities_to_restore)))); // Now log. We first remove any encryption passphrase from the log data. $copy_restore_options = $restore_options; if (!empty($copy_restore_options['updraft_encryptionphrase'])) $copy_restore_options['updraft_encryptionphrase'] = ''; $updraftplus->log("Restore job started. Entities to restore: ".implode(', ', array_flip($entities_to_restore)).'. Restore options: '.json_encode($copy_restore_options)); do_action('updraftplus_restoration_title', __('Final checks', 'updraftplus')); add_action('updraftplus_unzip_progress_restore_info', array($this, 'unzip_progress_restore_info'), 10, 4); $backup_set = $this->ud_backup_set; $services = isset($backup_set['service']) ? $updraftplus->get_canonical_service_list($backup_set['service']) : array(); $backupable_entities = $updraftplus->get_backupable_file_entities(true, true); $remove_zip = isset($restore_options['delete_during_restore']) ? $restore_options['delete_during_restore'] : false; if (!empty($restore_options['dummy_db_restore'])) { $this->is_dummy_db_restore = true; add_filter('updraftplus_restore_table_prefix', array($this, 'updraftplus_random_restore_table_prefix')); } // Allow add-ons to adjust the restore directory (but only in the case of restore - otherwise, they could just use the filter built into UpdraftPlus::get_backupable_file_entities) $backupable_entities = apply_filters('updraft_backupable_file_entities_on_restore', $backupable_entities, $restore_options, $backup_set); if (function_exists('set_time_limit')) @set_time_limit(UPDRAFTPLUS_SET_TIME_LIMIT);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // Get an ordered list of things to restore // This requires the global $updraft_restorer to be set up $second_loop = $this->ensure_restore_files_present($entities_to_restore, $backupable_entities, $services); if (!is_array($second_loop)) return $second_loop; $timestamp = $backup_set['timestamp']; $updraftplus->jobdata_set('second_loop_entities', $second_loop); $updraftplus->jobdata_set('backup_timestamp', $timestamp); // Use a site option, as otherwise on multisite when all the array of options is updated via UpdraftPlus_Options::update_site_option(), it will over-write any restored UD options from the backup update_site_option('updraft_restore_in_progress', $updraftplus->nonce); // Now process the actual restoration of the entities foreach ($second_loop as $type => $files) { $this->current_type = $type; // Types: uploads, themes, plugins, others, db $info = isset($backupable_entities[$type]) ? $backupable_entities[$type] : array(); $restoration_title = ('db' == $type) ? __('Database', 'updraftplus') : $info['description']; // Indicate the type changed $updraftplus->log_restore_update(array('type' => 'state_change', 'stage' => $type, 'data' => array())); do_action('updraftplus_restoration_title', $restoration_title); $updraftplus->log('Entity: '.$type); if (is_string($files)) $files = array($files); // Don't assume that the caller pre-sorted the array. We do need it sorted, so that incremental zips get restored in the right order ksort($files); foreach ($files as $fkey => $file) { $this->current_index = $fkey; $last_one = (1 == count($second_loop) && 1 == count($files)); $last_entity = (1 == count($files)); try { do_action('updraftplus_pre_entity_restoration', $type, $fkey); // Returns a boolean or WP_Error $restore_result = $this->restore_backup($file, $type, $info, $last_one, $last_entity); } catch (Exception $e) { $log_message = 'Exception ('.get_class($e).') occurred during restore: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; $display_log_message = sprintf(__('A PHP exception (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()); error_log($log_message); // @codingStandardsIgnoreLine if (function_exists('wp_debug_backtrace_summary')) $log_message .= ' Backtrace: '.str_replace(array(ABSPATH, "\n"), array('', ', '), $e->getTraceAsString()); $updraftplus->log($display_log_message, 'notice-restore'); die(); // @codingStandardsIgnoreLine } catch (Error $e) { $log_message = 'PHP Fatal error ('.get_class($e).') has occurred. Error Message: '.$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); // @codingStandardsIgnoreLine if (function_exists('wp_debug_backtrace_summary')) $log_message .= ' Backtrace: '.str_replace(array(ABSPATH, "\n"), array('', ', '), $e->getTraceAsString()); $display_log_message = sprintf(__('A PHP fatal error (%s) has occurred: %s', 'updraftplus'), get_class($e), $e->getMessage()); $updraftplus->log($display_log_message, 'notice-restore'); die(); } if (is_wp_error($restore_result)) { $codes = $restore_result->get_error_codes(); if (is_array($codes) && in_array('not_found', $codes) && !empty($this->ud_foreign) && apply_filters('updraftplus_foreign_allow_missing_entity', false, $type, $this->ud_foreign)) { $updraftplus->log('Entity to move not found in this zip - but this is possible with this foreign backup type'); } else { $updraftplus->log_e($restore_result); foreach ($restore_result->get_error_messages() as $msg) { $updraftplus->log(__('Error message', 'updraftplus').': '.$msg, 'notice-restore'); } return $restore_result; } } elseif (false === $restore_result) { return false; } elseif ($restore_result && $remove_zip) { $deleted = unlink($updraftplus->backups_dir_location().'/'.$file); $updraftplus->log("Delete zip during restore active; removing backup file: $file: ".($deleted ? 'OK' : 'Failed')); } unset($files[$fkey]); $second_loop[$type] = $files; $updraftplus->jobdata_set_multi(array('second_loop_entities' => $second_loop, 'backup_timestamp' => $timestamp)); do_action('updraft_restored_archive', $file, $type, $restore_result, $fkey, $timestamp); } // Update the job data each time we go round the loop, so that if it aborts, it can be resumed from the correct point unset($second_loop[$type]); update_site_option('updraft_restore_in_progress', $updraftplus->nonce); $updraftplus->jobdata_set_multi(array('second_loop_entities' => $second_loop, 'backup_timestamp' => $timestamp)); } // If the database was restored, then check active plugins and make sure they all exist; otherwise, the site may go down if (null !== $this->final_import_table_prefix) $this->check_active_plugins($this->final_import_table_prefix); return true; } / * Calculate the entities to download for a given backup set * * @param Array $entities_to_restore - entities to restore, in the format returned by UpdraftPlus_Admin::get_entities_to_restore * * @return Array - keys are entities, and values are 0\|1 / public function get_entities_to_download($entities_to_restore) { $backup_set = $this->ud_backup_set; $foreign_known = apply_filters('updraftplus_accept_archivename', array()); if (empty($backup_set['meta_foreign'])) return $entities_to_restore; if (empty($foreign_known[$backup_set['meta_foreign']]['separatedb'])) return array('wpcore' => 1); $entities_to_download = array(); if (in_array('db', $entities_to_restore)) $entities_to_download['db'] = 1; if (count($entities_to_restore) > 1 \|\| !in_array('db', $entities_to_restore)) { $entities_to_download['wpcore'] = 1; } return $entities_to_download; } /* * Logs a line from the restore process, being called from UpdraftPlus::log(). Currently, this means adding it to the browser output log file and either (depending on the constant WP_CLI) echoing it or passing it to a WPCLI method. * Hooks the WordPress filter updraftplus_logline * In future, this can get more sophisticated. For now, things are funnelled through here, giving the future possibility. * * @param String $line the line to be logged * @param String $nonce the job ID of the restore job * @param String $level the level of the log notice * @param String\|Boolean $uniq_id a unique ID for the log if it should only be logged once; or false otherwise * @param String $destination the type of job ongoing. If it is not 'restore', then we will skip the logging. * @return The filtered value. If set to false, then UpdraftPlus::log() will stop processing the log line. / public function updraftplus_logline($line, $nonce, $level, $uniq_id, $destination) { if ('restore' != $destination) return $line; global $updraftplus; static $logfile_handle; if (empty($logfile_handle)) { $logfile_name = $updraftplus->backups_dir_location()."/log.$nonce-browser.txt"; $logfile_handle = fopen($logfile_name, 'a'); } if (!empty($logfile_handle)) { $rtime = microtime(true)-$updraftplus->job_time_ms; fwrite($logfile_handle, sprintf("%08.03f", round($rtime, 3))." (R) ".'['.$level.'] '.$line."\n"); } if (defined('WP_CLI') && WP_CLI) { switch ($level) { case 'error': case 'warning': // WP_CLI::error() displays message with the prefix "Error: ", We don't like message which are double prefixed like the "Error: Error: ". if (0 === stripos($line, 'Error: ')) { $log_line = substr($line, 7); } else { $log_line = $line; } WP_CLI::error($log_line, false); break; case 'notice': default: WP_CLI::log($line, false); break; } } else { if ('warning' == $level \|\| 'error' == $level \|\| $uniq_id) { $line = '<strong>'.htmlspecialchars($line).'</strong>'; } else { $line = htmlspecialchars($line); } $updraftplus->output_to_browser($line.'<br>'); } return false; } /* * Configures self::$strings / private function backup_strings() { $this->strings['not_possible'] = __('UpdraftPlus is not able to directly restore this kind of entity.', 'updraftplus').' '.__('It must be restored manually.', 'updraftplus'); $this->strings['no_package'] = __('Backup file not available.', 'updraftplus'); $this->strings['copy_failed'] = __('Copying this entity failed.', 'updraftplus'); $this->strings['unpack_package'] = __('Unpacking backup...', 'updraftplus'); $this->strings['decrypt_database'] = __('Decrypting database (can take a while)...', 'updraftplus'); $this->strings['decrypted_database'] = __('Database successfully decrypted.', 'updraftplus'); $this->strings['moving_old'] = __('Moving old data out of the way...', 'updraftplus'); $this->strings['moving_backup'] = __('Moving unpacked backup into place...', 'updraftplus'); $this->strings['restore_database'] = __('Restoring the database (on a large site this can take a long time - if it times out (which can happen if your web hosting company has configured your hosting to limit resources) then you should use a different method, such as phpMyAdmin)...', 'updraftplus'); $this->strings['cleaning_up'] = __('Cleaning up rubbish...', 'updraftplus'); $this->strings['old_move_failed'] = __('Could not move old files out of the way.', 'updraftplus').' '.__('You should check the file ownerships and permissions in your WordPress installation', 'updraftplus'); $this->strings['old_delete_failed'] = __('Could not delete old path.', 'updraftplus'); $this->strings['new_move_failed'] = __('Could not move new files into place.', 'updraftplus').' '.__('Check your wp-content/upgrade folder.', 'updraftplus'); $this->strings['move_failed'] = __('Could not move the files into place.', 'updraftplus').' '.__('Check your file permissions.', 'updraftplus'); $this->strings['delete_failed'] = __('Failed to delete working directory after restoring.', 'updraftplus'); $this->strings['multisite_error'] = __('You are running on WordPress multisite - but your backup is not of a multisite site.', 'updraftplus'); $this->strings['unpack_failed'] = __('Failed to unpack the archive', 'updraftplus'); $this->strings['read_manifest_failed'] = __('Failed to read the manifest file from backup.', 'updraftplus'); $this->strings['manifest_not_found'] = __('Failed to find a manifest file in the backup.', 'updraftplus'); $this->strings['read_working_dir_failed'] = __('Failed to read from the working directory.', 'updraftplus'); } /* * This function will build the unzip progress restore info array ready to be output to the js * * @param String $filepath - the current file we are working on * @param Integer $fileindex - how far into the zip we got * @param Integer $size_written - net total number of bytes thus far * @param Integer $num_files - the total number of files (i.e. one more than the the maximum value of $fileindex) * * @return void / public function unzip_progress_restore_info($filepath, $fileindex, $size_written, $num_files) { global $updraftplus; $index = $this->current_index; $file_type = $this->current_type; $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'files', 'data' => array('entity' => $file_type, 'index' => $index, 'file' => basename($filepath), 'fileindex' => $fileindex, 'size_written' => $size_written, 'total_files' => $num_files))); } /* * This returns a WP_Filesystem location. * * This function is copied from class WP_Upgrader (WP 3.8 - no significant changes since 3.2 at least); we only had to fork it because it hard-codes using the basename of the zip file as its unpack directory; which can be long; and then combining that with long pathnames in the zip being unpacked can overflow a 256-character path limit (yes, they apparently still exist - amazing!) * Subsequently, we have also added the ability to unpack tarballs * * In the 'ordinary' case of unzipping a UD zip backup, this method basically does some preparation, and then calls UpdraftPlus_Filesystem_Functions::unzip_file() for the actual unzipping * * @param String $package - specify package - relative to UpdraftPlus::backups_dir_location() * @param String\|Boolean $type - type of archive e.g. db. * * @return String\|WP_Error If successful, then this indicates the working directory that the archive was unpacked in; a WP_Filesystem path / private function unpack_package_archive($package, $type = false) { global $wp_filesystem, $updraftplus; $delete_package = $this->delete_archives_upon_restoration; $package = $updraftplus->backups_dir_location().'/'.$package; // If it is a non-UD archive that is already unpacked, then don't re-run, but return the existing result if (!empty($this->ud_foreign) && !empty($this->ud_foreign_working_dir) && $package == $this->ud_foreign_package) { if (is_dir($this->ud_foreign_working_dir)) { return $this->ud_foreign_working_dir; } else { $updraftplus->log('Previously unpacked directory seems to have disappeared; will unpack again'); } } $this->skin->feedback($this->strings['unpack_package'].' ('.basename($package).', '.round(filesize($package)/1048576, 1).' MB)'); $upgrade_folder = $wp_filesystem->wp_content_dir().'upgrade/'; $zip_starting_index = 0; // We need a working directory. This has a change from the WP core version - minimise path length // N.B. It is deterministic; the same package file will get the same working directory // $working_dir = $upgrade_folder . basename($package, '.zip'); $working_dir = $upgrade_folder.substr(md5($package), 0, 8); if (preg_match('#\.zip$#i', $package)) { $last_index_key = UpdraftPlus_Filesystem_Functions::get_jobdata_progress_key($package); // Turn off the feature with define('UPDRAFTPLUS_UNZIP_RESUME_ENABLED', false); if ((!defined('UPDRAFTPLUS_UNZIP_RESUME_ENABLED') \|\| UPDRAFTPLUS_UNZIP_RESUME_ENABLED) && !empty($this->continuation_data[$last_index_key]) && !empty($this->continuation_data[$last_index_key]['info']['name'])) { $reached = $this->continuation_data[$last_index_key]; $last_exists = $wp_filesystem->exists($working_dir.'/'.$reached['info']['name']); $last_size = $last_exists ? $wp_filesystem->size($working_dir.'/'.$reached['info']['name']) : 'n/a'; if ($last_exists && $last_size == $reached['info']['size'] && isset($reached['index'])) $zip_starting_index = $reached['index']; $updraftplus->log("Unpack resumption may be possible: zip_starting_index=$zip_starting_index, last_exists=$last_exists, last_size=$last_size, last_status=".serialize($this->continuation_data[$last_index_key])); } } if (0 == $zip_starting_index) { // Clean up contents of upgrade directory beforehand. $upgrade_files = $wp_filesystem->dirlist($upgrade_folder); if (!empty($upgrade_files)) { foreach ($upgrade_files as $file) { if (!$wp_filesystem->delete($upgrade_folder.$file['name'], true)) { $this->restore_log_permission_failure_message($upgrade_folder, 'Delete '.$upgrade_folder.$file['name']); } } } // Clean up working directory - this is redundant, as we already cleared out the parent folder if ($wp_filesystem->is_dir($working_dir)) { if (!$wp_filesystem->delete($working_dir, true)) { $this->restore_log_permission_failure_message(dirname($working_dir), 'Delete '.$working_dir); } } } // Unzip package to working directory if (preg_match('#\.zip$#i', $package)) { $folders_to_include = array(); if ('themes' == $type && !$this->include_unspecified_themes) $folders_to_include = $this->themes_to_restore; if ('plugins' == $type && !$this->include_unspecified_plugins) $folders_to_include = $this->plugins_to_restore; $result = UpdraftPlus_Filesystem_Functions::unzip_file($package, $working_dir, $zip_starting_index, $folders_to_include); } elseif (preg_match('#\.tar(\.(gz\|bz2))?$#i', $package)) { if (!class_exists('UpdraftPlus_Archive_Tar')) { if (false === strpos(get_include_path(), UPDRAFTPLUS_DIR.'/includes/PEAR')) set_include_path(UPDRAFTPLUS_DIR.'/includes/PEAR'.PATH_SEPARATOR.get_include_path()); updraft_try_include_file('includes/PEAR/Archive/Tar.php', 'include_once'); } $p_compress = null; if ('.tar.gz' == strtolower(substr($package, -7, 7))) { $p_compress = 'gz'; } elseif ('.tar.bz2' == strtolower(substr($package, -8, 8))) { $p_compress = 'bz2'; } // It's not pretty, but it works. if (is_a($wp_filesystem, 'WP_Filesystem_Direct')) { $extract_dir = $working_dir; } else { $updraft_dir = $updraftplus->backups_dir_location(); if (!UpdraftPlus_Filesystem_Functions::really_is_writable($updraft_dir)) { $updraftplus->log_e("Backup directory (%s) is not writable, or does not exist.", $updraft_dir); $result = new WP_Error('unpack_failed', $this->strings['unpack_failed']); } else { $extract_dir = $updraft_dir.'/'.basename($working_dir).'-old'; if (file_exists($extract_dir)) UpdraftPlus_Filesystem_Functions::remove_local_directory($extract_dir); $updraftplus->log("Using a temporary folder to extract before moving over WPFS: $extract_dir"); } } // Slightly hackish - rather than re-write Archive_Tar to use wp_filesystem, we instead unpack into the location that we already require to be directly writable for other reasons, and then move from there. if (empty($result)) { $this->ud_extract_count = 0; $this->ud_working_dir = trailingslashit($working_dir); $this->ud_extract_dir = untrailingslashit($extract_dir); $this->ud_made_dirs = array(); add_filter('updraftplus_tar_wrote', array($this, 'tar_wrote'), 10, 2); $tar = new UpdraftPlus_Archive_Tar($package, $p_compress); $result = $tar->extract($extract_dir, false); if (!is_a($wp_filesystem, 'WP_Filesystem_Direct')) UpdraftPlus_Filesystem_Functions::remove_local_directory($extract_dir); if (true != $result) { $result = new WP_Error('unpack_failed', $this->strings['unpack_failed'], $result); } else { if (!is_a($wp_filesystem, 'WP_Filesystem_Direct')) { $updraftplus->log('Moved unpacked tarball contents'); } } remove_filter('updraftplus_tar_wrote', array($this, 'tar_wrote'), 10, 2); } } // Once extracted, delete the package if required. if ($delete_package) unlink($package); if (is_wp_error($result)) { $wp_filesystem->delete($working_dir, true); if ('incompatible_archive' == $result->get_error_code()) { return new WP_Error('incompatible_archive', $this->wp_upgrader->strings['incompatible_archive'], $result->get_error_data()); } return $result; } if (!empty($this->ud_foreign)) { $this->ud_foreign_working_dir = $working_dir; $this->ud_foreign_package = $package; // Zip containing an SQL file. We try a default pattern. if ('db' === $type) { $basepack = basename($package, '.zip'); if ($wp_filesystem->exists($working_dir.'/'.$basepack.'.sql')) { if (!$wp_filesystem->move($working_dir.'/'.$basepack.'.sql', $working_dir . "/backup.db", true)) { $this->restore_log_permission_failure_message($working_dir, 'Move '. $working_dir.'/'.$basepack.'.sql'.' -> '.$working_dir . "/backup.db", 'Destination'); } $updraftplus->log("Moving database file $basepack.sql to backup.db"); } } } return $working_dir; } public function tar_wrote($result, $file) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use if (0 !== strpos($file, $this->ud_extract_dir)) return false; global $wp_filesystem, $updraftplus; if (!is_a($wp_filesystem, 'WP_Filesystem_Direct')) { $modint = 100; $leaf = substr($file, strlen($this->ud_extract_dir)); $dirname = dirname($leaf); $need_dirs = explode('/', $dirname); if (empty($this->ud_made_dirs[$dirname])) { $cdir = ''; foreach ($need_dirs as $ndir) { $cdir .= ($cdir) ? '/'.$ndir : $ndir; if (empty($this->ud_made_dirs[$cdir])) { if (!$wp_filesystem->mkdir($this->ud_working_dir.$cdir, FS_CHMOD_DIR) && !$wp_filesystem->is_dir($this->ud_working_dir.$cdir)) { $updraftplus->log("Failed to create WPFS directory: ".$this->ud_working_dir.$cdir); return false; } else { $this->ud_made_dirs[$cdir] = true; } } } } $put = $wp_filesystem->put_contents($this->ud_working_dir.$leaf, file_get_contents($file)); if (is_wp_error($put)) $updraftplus->log_wp_error($put); @unlink($file);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise if the file doesn't exist. } else { $modint = 500; $put = true; } if ($put) { $this->ud_extract_count++; if (0 == $this->ud_extract_count % $modint) { $updraftplus->log_e("%s files have been extracted", $this->ud_extract_count); } } return (true == $put); } /* * Unpack a database backup file. This returns a WP_Filesystem location. * In the case of an encrypted database file it decrypts it and returns the path to the decrypted version. * * @uses self::delete_archives_upon_restoration * * @param String $package - file to unpack; relative filepath * * @return String\|WP_Error If successful, then this indicates the working directory that the archive was unpacked in (a WP_Filesystem path) / private function unpack_package_database($package) { global $wp_filesystem, $updraftplus; $delete_package = $this->delete_archives_upon_restoration; $updraft_dir = $updraftplus->backups_dir_location(); // The general shape of the following comes from class-wp-upgrader.php $backup_dir = $wp_filesystem->find_folder($updraft_dir); if (function_exists('set_time_limit')) @set_time_limit(1800);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $packsize = round(filesize($backup_dir.$package)/1048576, 1).' Mb'; $this->skin->feedback($this->strings['unpack_package'].' ('.basename($package).', '.$packsize.')'); $upgrade_folder = $wp_filesystem->wp_content_dir() . 'upgrade/'; @$wp_filesystem->mkdir($upgrade_folder, octdec($this->calculate_additive_chmod_oct(FS_CHMOD_DIR, 0775)));// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. // Clean up contents of upgrade directory beforehand. $upgrade_files = $wp_filesystem->dirlist($upgrade_folder); if (!empty($upgrade_files)) { foreach ($upgrade_files as $file) { if (!$wp_filesystem->delete($upgrade_folder.$file['name'], true)) { $this->restore_log_permission_failure_message($upgrade_folder, 'Delete '.$upgrade_folder.$file['name']); } } } // We need a working directory $working_dir = $upgrade_folder . basename($package, '.crypt'); // Clean up working directory if ($wp_filesystem->is_dir($working_dir)) { if (!$wp_filesystem->delete($working_dir, true)) { $this->restore_log_permission_failure_message(dirname($working_dir), 'Delete '.$working_dir); } } if (!$wp_filesystem->mkdir($working_dir, octdec($this->calculate_additive_chmod_oct(FS_CHMOD_DIR, 0775)))) return new WP_Error('mkdir_failed', __('Failed to create a temporary directory', 'updraftplus').' ('.$working_dir.')'); // Unpack package to working directory if (UpdraftPlus_Encryption::is_file_encrypted($package)) { $this->skin->feedback($this->strings['decrypt_database']); $encryption = empty($this->restore_options['updraft_encryptionphrase']) ? UpdraftPlus_Options::get_updraft_option('updraft_encryptionphrase') : $this->restore_options['updraft_encryptionphrase']; if (!$encryption) return new WP_Error('no_encryption_key', __('Decryption failed.', 'updraftplus').' '.__('The database file is encrypted, but you have no encryption key entered.', 'updraftplus')); // function decrypt $decrypted_file = UpdraftPlus_Encryption::decrypt($backup_dir.$package, $encryption); if (is_array($decrypted_file)) { $this->skin->feedback($this->strings['decrypted_database']); if (!copy($decrypted_file['fullpath'], $working_dir.'/backup.db.gz')) { return new WP_Error('write_failed', __('Failed to write out the decrypted database to the filesystem', 'updraftplus')); } else { unlink($decrypted_file['fullpath']); } } else { return new WP_Error('decryption_failed', __('Decryption failed.', 'updraftplus').' '.__('The most likely cause is that you used the wrong key.', 'updraftplus')); } } else { if (preg_match('/\.sql$/i', $package)) { if (!$wp_filesystem->copy($backup_dir.$package, $working_dir.'/backup.db')) { if ($wp_filesystem->errors->get_error_code()) { foreach ($wp_filesystem->errors->get_error_messages() as $message) show_message($message); } return new WP_Error('copy_failed', $this->strings['copy_failed']); } } elseif (preg_match('/\.bz2$/i', $package)) { if (!$wp_filesystem->copy($backup_dir.$package, $working_dir.'/backup.db.bz2')) { if ($wp_filesystem->errors->get_error_code()) { foreach ($wp_filesystem->errors->get_error_messages() as $message) show_message($message); } return new WP_Error('copy_failed', $this->strings['copy_failed']); } } elseif (!$wp_filesystem->copy($backup_dir.$package, $working_dir.'/backup.db.gz')) { if ($wp_filesystem->errors->get_error_code()) { foreach ($wp_filesystem->errors->get_error_messages() as $message) show_message($message); } return new WP_Error('copy_failed', $this->strings['copy_failed']); } } // Once extracted, delete the package if required (non-recursive, is a file) // if ($delete_package) $wp_filesystem->delete($decrypted_file['fullpath'], false, true); if ($delete_package) { if (!$wp_filesystem->delete($backup_dir.$package, false, true)) { $this->restore_log_permission_failure_message($backup_dir, 'Delete '.$backup_dir.$package); } } $updraftplus->log('Database successfully unpacked'); return $working_dir; } /* * For moving files out of a directory into their new location * The purposes of the $type parameter are 1) to detect 'others' and apply a historical bugfix 2) to detect wpcore, and apply the setting for what to do with wp-config.php 3) to work out whether to delete the directory itself * Must use only wp_filesystem * $dest_dir must already have a trailing slash * * N.B. Public, because also called from the Migrator and More Files add-ons * * @param String $working_dir specify working directory * @param String $dest_dir specify destination directory (a WP_Filesystem path) * @param Integer $preserve_existing this setting only applies at the top level: 0 = overwrite with no backup; 1 = make backup of existing; 2 = do nothing if there is existing, 3 = do nothing to the top level directory, but do copy-in contents (and over-write files). Thus, on a multi-archive set where you want a backup, you'd do this: first call with $preserve_existing === 1, then on subsequent zips call with 3 * @param Array $do_not_overwrite Specify files or directories not to overwrite * @param String $type specify type * @param Boolean $send_actions send actions * @param Boolean $force_local if set, then this will ensure that move operations are doing using rename() (i.e. direct filesystem access) * @param Boolean $moving_old indicates if we are moving old files * * @return Boolean / public function move_backup_in($working_dir, $dest_dir, $preserve_existing = 1, $do_not_overwrite = array('plugins', 'themes', 'uploads', 'upgrade'), $type = 'not-others', $send_actions = false, $force_local = false, $moving_old = false) { global $wp_filesystem, $updraftplus; $updraft_dir = $updraftplus->backups_dir_location(); if (true == $force_local \|\| is_a($wp_filesystem, 'WP_Filesystem_Direct')) { $wpfs = new UpdraftPlus_WP_Filesystem_Direct(true); } else { $wpfs = $wp_filesystem; } // Get the content to be moved in. Include hidden files = true. Recursion is only required if we're likely to copy-in $recursive = (self::MOVEIN_COPY_IN_CONTENTS === $preserve_existing) ? true : false; $upgrade_files = $wpfs->dirlist($working_dir, true, $recursive); if (empty($upgrade_files)) return true; // check if our path is a file by looking to see if it's in the list of files we want to restore; if it is then remove the file from the path if (isset($upgrade_files[basename($dest_dir)]) && 'f' === $upgrade_files[basename($dest_dir)]['type']) $dest_dir = trailingslashit(dirname($dest_dir)); if (!$wpfs->is_dir($dest_dir)) { if ($wpfs->is_dir(dirname($dest_dir))) { if (!$wpfs->mkdir($dest_dir, FS_CHMOD_DIR)) return new WP_Error('mkdir_failed', __('The directory does not exist, and the attempt to create it failed', 'updraftplus') . ' (' . $dest_dir . ')'); $updraftplus->log("Destination directory did not exist, but was successfully created ($dest_dir)"); } else { return new WP_Error('no_such_dir', __('The directory does not exist', 'updraftplus') . " ($dest_dir)"); } } if ('plugins' == $type \|\| 'themes' == $type) { $upgrade_files_log = implode(', ', array_keys($upgrade_files)); if ('plugins' == $type && !empty($this->plugins_to_restore) && !$this->include_unspecified_plugins) $upgrade_files_log = implode(', ', $this->plugins_to_restore); if ('themes' == $type && !empty($this->themes_to_restore) && !$this->include_unspecified_themes) $upgrade_files_log = implode(', ', $this->themes_to_restore); $updraftplus->log("Top-level entities being moved: ".$upgrade_files_log); } $checksums = $updraftplus->which_checksums(); foreach ($upgrade_files as $file => $filestruc) { if (empty($file)) continue; if ($dest_dir.$file == $updraft_dir) { $updraftplus->log('Skipping attempt to replace updraft_dir whilst processing '.$type); continue; } // Handle various hard-wired and backwards-compatibility cases $special_case = $this->carry_out_restore_special_cases($type, $file, $working_dir, $wpfs); if (!empty($special_case['filename'])) $file = $special_case['filename']; // The "do not overwrite" check is a sanity check, as these things ought to be excluded at backup time if (!empty($special_case['result']) \|\| in_array($file, $do_not_overwrite)) continue; // Skip plugins which the user specified to be skipped. This may include deleting them from the source directory so that it is clean at the end. if ('plugins' == $type && in_array($file, $this->plugins_to_skip)) { if (!$moving_old) { $updraftplus->log("Skipping {$file} as user requested this plugin to not be restored.", "notice-restore"); // Remove it from the temporary directory - so that it will be clean later @$wpfs->delete($working_dir.'/'.$file, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. } continue; } elseif ('plugins' == $type && !empty($this->plugins_to_restore) && !in_array($file, $this->plugins_to_restore) && !$this->include_unspecified_plugins) { if (!$moving_old) { $updraftplus->log("Skipping {$file} as it's not in the list of plugins to restore and we are not including unspecified plugins.", "notice-restore"); // Remove it from the temporary directory - so that it will be clean later @$wpfs->delete($working_dir.'/'.$file, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. } continue; } // Skip themes which the user specified to be skipped. This may include deleting them from the source directory so that it is clean at the end. if ('themes' == $type && in_array($file, $this->themes_to_skip)) { if (!$moving_old) { $updraftplus->log("Skipping {$file} as user requested this theme to not be restored.", "notice-restore"); // Remove it from the temporary directory - so that it will be clean later @$wpfs->delete($working_dir.'/'.$file, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. } continue; } elseif ('themes' == $type && !empty($this->themes_to_restore) && !in_array($file, $this->themes_to_restore) && !$this->include_unspecified_themes) { if (!$moving_old) { $updraftplus->log("Skipping {$file} as it's not in the list of themes to restore and we are not including unspecified themes.", "notice-restore"); // Remove it from the temporary directory - so that it will be clean later @$wpfs->delete($working_dir.'/'.$file, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. } continue; } // If an existing destination is present, then move it if ($wpfs->exists($dest_dir.$file)) { if (self::MOVEIN_MAKE_BACKUP_OF_EXISTING == $preserve_existing) { if (!$wpfs->move($dest_dir.$file, $dest_dir.$file.'-old', true)) { // The entity could not be moved out of the way, so is likely still there. Check its contents are already what was desired. if ('others' == $type && hash_file($checksums[0], $working_dir.'/'.$file) == hash_file($checksums[0], $dest_dir.$file)) { $updraftplus->log($dest_dir.$file." could not be moved out of the way, but the new version had an identical hash, so the existing version will be left as-is"); @$wpfs->delete($working_dir.'/'.$file, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced because failure to delete the source will be noted later and is not useful to record on individual files. } else { $this->restore_log_permission_failure_message($dest_dir, 'Move '.$dest_dir.$file.' -> '.$dest_dir.$file.'-old', 'Destination'); return new WP_Error('old_move_failed', $this->strings['old_move_failed']." ($dest_dir$file)"); } } } elseif (self::MOVEIN_OVERWRITE_NO_BACKUP == $preserve_existing) { if (!$wpfs->delete($dest_dir.$file, true)) { if ('others' == $type && hash_file($checksums[0], $working_dir.'/'.$file) == hash_file($checksums[0], $dest_dir.$file)) { $updraftplus->log($dest_dir.$file." could not be removed, but the new version had an identical hash, so the existing version will be left as-is"); @$wpfs->delete($working_dir.'/'.$file, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced because failure to delete the source will be noted later and is not useful to record on individual files. } else { $this->restore_log_permission_failure_message($dest_dir, 'Delete '.$dest_dir.$file); return new WP_Error('old_delete_failed', $this->strings['old_delete_failed']." ($file)"); } } } } // Secondly, move in the new one $is_dir = $wpfs->is_dir($working_dir."/".$file); if (self::MOVEIN_DO_NOTHING_IF_EXISTING == $preserve_existing && $wpfs->exists($dest_dir.$file)) { // Something exists - no move. Remove it from the temporary directory - so that it will be clean later @$wpfs->delete($working_dir.'/'.$file, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. // The $is_dir check was added in version 1.11.18; without this, files in the top-level that weren't in the first archive didn't get over-written } elseif (self::MOVEIN_COPY_IN_CONTENTS != $preserve_existing \|\| !$wpfs->exists($dest_dir.$file) \|\| !$is_dir) { if ($wpfs->move($working_dir."/".$file, $dest_dir.$file, true)) { if ($send_actions) do_action('updraftplus_restored_'.$type.'_one', $file); // Make sure permissions are at least as great as those of the parent if ($is_dir) { // This method is broken due to https://core.trac.wordpress.org/ticket/26598 if (empty($chmod)) $chmod = octdec(sprintf("%04d", $this->get_current_chmod($dest_dir, $wpfs)));// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UndefinedVariable -- The variable is defined after the check. if (!empty($chmod)) $this->chmod_if_needed($dest_dir.$file, $chmod, false, $wpfs); } } else { if (!$is_dir) { $this->restore_log_permission_failure_message($dest_dir, 'Move '. $working_dir."/".$file." -> ".$dest_dir.$file, 'Destination'); return new WP_Error('move_failed', $this->strings['move_failed'], $working_dir.'/'.$file.' -> '.$dest_dir.$file); } $updraftplus->log(sprintf("There was an error when performing the move operation by renaming or copying %s to %s: will attempt a recursive copy instead.", $working_dir."/".$file, $dest_dir.$file), 'updraftplus'); if (empty($chmod)) $chmod = octdec(sprintf("%04d", $this->get_current_chmod($dest_dir, $wpfs))); if (!$wpfs->exists($dest_dir.$file)) $wpfs->mkdir($dest_dir.$file, $chmod); $delete_root = ('others' !== $type && 'wpcore' !== $type) ? true : false; $copy_in = UpdraftPlus_Filesystem_Functions::copy_files_in($working_dir.'/'.$file, $dest_dir.$file, $filestruc['files'], $chmod, $delete_root); if (!empty($chmod)) $this->chmod_if_needed($dest_dir.$file, $chmod, false, $wpfs); if (is_wp_error($copy_in) \|\| !$copy_in) { $this->restore_log_permission_failure_message($dest_dir, 'Move '. $working_dir."/".$file." -> ".$dest_dir.$file, 'Destination'); } if (is_wp_error($copy_in)) return $copy_in; if (!$copy_in) return new WP_Error('move_failed', $this->strings['move_failed'], $working_dir."/".$file." -> ".$dest_dir.$file); if (!$wpfs->rmdir($working_dir.'/'.$file)) { $this->restore_log_permission_failure_message($working_dir, 'Delete '.$working_dir.'/'.$file); } } } elseif (self::MOVEIN_COPY_IN_CONTENTS == $preserve_existing && !empty($filestruc['files'])) { // The directory ($dest_dir) already exists, and we've been requested to copy-in. We need to perform the recursive copy-in // $filestruc['files'] is then a new structure like $upgrade_files // First pass: create directory structure // Get chmod value for the parent directory, and re-use it (instead of passing false) // This method is broken due to https://core.trac.wordpress.org/ticket/26598 if (empty($chmod)) $chmod = octdec(sprintf("%04d", $this->get_current_chmod($dest_dir, $wpfs))); // Copy in the files. This also needs to make sure the directories exist, in case the zip file lacks entries $delete_root = ('others' == $type \|\| 'wpcore' == $type) ? false : true; $copy_in = UpdraftPlus_Filesystem_Functions::copy_files_in($working_dir.'/'.$file, $dest_dir.$file, $filestruc['files'], $chmod, $delete_root); if (!empty($chmod)) $this->chmod_if_needed($dest_dir.$file, $chmod, false, $wpfs); if (is_wp_error($copy_in) \|\| !$copy_in) { $this->restore_log_permission_failure_message($dest_dir, 'Move '. $working_dir."/".$file." -> ".$dest_dir.$file, 'Destination'); } if (is_wp_error($copy_in)) return $copy_in; if (!$copy_in) return new WP_Error('move_failed', $this->strings['move_failed'], "(2) ".$working_dir.'/'.$file." -> ".$dest_dir.$file); if (!$wpfs->rmdir($working_dir.'/'.$file)) { $this->restore_log_permission_failure_message($working_dir, 'Delete '.$working_dir.'/'.$file); } } else { if (!$wpfs->rmdir($working_dir.'/'.$file)) { $this->restore_log_permission_failure_message($working_dir, 'Delete '.$working_dir.'/'.$file); } } } return true; } /* * This method handles some special cases (the code is abstracted into this separate method for tidiness) * * @param String $type - entity type, e.g. 'plugins', 'wpcore' * @param String $file - relative path * @param String $working_dir - a WP_Filesystem path * @param Object $wpfs - a WP_Filesystem object to use * * @return Array { * Array of information about the the special case that took place while moving out a file to its new location * @type Boolean $result - the only meaning of this is that if true, then the caller should carry out no further processing on the file (i.e. this method has done everything necessary) * @type String $filename - Base URL and subdirectory or absolute URL to upload directory. * } / private function carry_out_restore_special_cases($type, $file, $working_dir, $wpfs) { global $updraftplus; static $wpcore_config_moved = false; $ret = array(); // Correctly restore files in 'others' in no directory that were wrongly backed up in versions 1.4.0 - 1.4.48 if (('others' == $type \|\| 'wpcore' == $type) && preg_match('/^([\-_A-Za-z0-9]+\.php)$/i', $file, $matches) && $wpfs->exists($working_dir . "/$file/$file")) { if ('others' == $type) { $updraftplus->log("Found file: $file/$file: presuming this is a backup with a known fault (backup made with versions 1.4.0 - 1.4.48, and sometimes up to 1.6.55 on some Windows servers); will rename to simply $file", 'notice-restore'); } else { $updraftplus->log("Found file: $file/$file: presuming this is a backup with a known fault (backup made with versions before 1.6.55 in certain situations on Windows servers); will rename to simply $file", 'notice-restore'); } $updraftplus->log("$file/$file: rename to $file"); $file = $matches[1]; $tmp_file = rand(0, 999999999).'.php'; // Rename directory if (!$wpfs->move($working_dir . "/$file", $working_dir . "/".$tmp_file, true)) { $this->restore_log_permission_failure_message($working_dir, 'Move '. $working_dir . "/$file -> ".$working_dir . "/".$tmp_file, 'Destination'); } if (!$wpfs->move($working_dir . "/$tmp_file/$file", $working_dir ."/".$file, true)) { $this->restore_log_permission_failure_message($working_dir, 'Move '.$working_dir . "/$tmp_file/$file -> ".$working_dir ."/".$file, 'Destination'); } if (!$wpfs->rmdir($working_dir . "/$tmp_file", false)) { $this->restore_log_permission_failure_message($working_dir, 'Delete '.$working_dir . "/$tmp_file"); } } if ('wp-config.php' == $file && 'wpcore' == $type) { if (empty($this->restore_options['updraft_restorer_wpcore_includewpconfig'])) { $updraftplus->log_e('wp-config.php from backup: will restore as wp-config-pre-ud-restore-backup.php', 'updraftplus'); if (!$wpfs->move($working_dir . "/$file", $working_dir . "/wp-config-pre-ud-restore-backup.php", true)) { $this->restore_log_permission_failure_message($working_dir, 'Move '.$working_dir . "/$file -> ".$working_dir . "/wp-config-pre-ud-restore-backup.php", 'Destination'); // rename failed - take no further action with this file; we should not restore unless rename successful $ret['result'] = true; return $ret; } else { $wpcore_config_moved = true; $ret['filename'] = 'wp-config-pre-ud-restore-backup.php'; } } else { $updraftplus->log_e("wp-config.php from backup: restoring (as per user's request)", 'updraftplus'); } } elseif ('wpcore' == $type && 'wp-config-pre-ud-restore-backup.php' == $file && $wpcore_config_moved) { // The file is already gone; nothing to do $ret['result'] = true; return $ret; } if (('object-cache.php' == $file \|\| 'advanced-cache.php' == $file) && 'others' == $type) { if (false == apply_filters('updraftplus_restorecachefiles', true, $file)) { $nfile = preg_replace('/\.php$/', '-backup.php', $file); if (!$wpfs->move($working_dir . "/$file", $working_dir . "/" .$nfile, true)) { $this->restore_log_permission_failure_message($working_dir, 'Move '. $working_dir . '/' . $file .' -> '.$working_dir . '/' . $nfile, 'Destination'); // rename failed - take no further action with this file, as `updraftplus_restorecachefiles` indicated we should not restore the file without renaming it $ret['result'] = true; return $ret; } else { // the file was moved successfully, return the new filename so restore process can move it into place $ret['filename'] = $nfile; } } } elseif (('object-cache-backup.php' == $file \|\| 'advanced-cache-backup.php' == $file) && 'others' == $type) { if (!$wpfs->delete($working_dir."/".$file)) { $this->restore_log_permission_failure_message($working_dir, 'Delete '.$working_dir."/".$file); } $ret['result'] = true; return $ret; } $ret['result'] = false; return $ret; } /* * Pre-flight check: chance to complain and abort before anything at all is done * * @param Array $backup_files - An array of backup files * @param String $type - Type of file * @param Array $info - Information about the backup * * @return Boolean\|WP_Error / private function pre_restore_backup($backup_files, $type, $info) { if (is_string($backup_files)) $backup_files = array($backup_files); // convert this to an array if it's not one as more files uses an array of paths if (empty($info['path'])) $info['path'] = array(); if (!is_array($info['path'])) $info['path'] = array($info['path']); // Ensure access to the indicated directory - and to WP_CONTENT_DIR (in which we use upgrade/) $need_these = array(WP_CONTENT_DIR); foreach ($info['path'] as $path) { $need_these[] = $path; } $res = $this->wp_upgrader->fs_connect($need_these); if (false === $res \|\| is_wp_error($res)) return $res; // Check upgrade directory is writable (instead of having non-obvious messages when we try to write) // In theory, this is redundant (since we already checked for access to WP_CONTENT_DIR); but in practice, this extra check has been needed global $wp_filesystem, $updraftplus, $updraftplus_addons_migrator; if (empty($this->pre_restore_updatedir_writable)) { $upgrade_folder = $wp_filesystem->wp_content_dir() . 'upgrade/'; @$wp_filesystem->mkdir($upgrade_folder, octdec($this->calculate_additive_chmod_oct(FS_CHMOD_DIR, 0775)));// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. if (!$wp_filesystem->is_dir($upgrade_folder)) { return new WP_Error('no_dir', sprintf(__('UpdraftPlus needed to create a %s in your content directory, but failed - please check your file permissions and enable the access (%s)', 'updraftplus'), __('folder', 'updraftplus'), $upgrade_folder)); } $rand_file = 'testfile_'.rand(0, 9999999).md5(microtime(true)).'.txt'; if ($wp_filesystem->put_contents($upgrade_folder.$rand_file, 'testing...')) { @$wp_filesystem->delete($upgrade_folder.$rand_file);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. $this->pre_restore_updatedir_writable = true; } else { $this->restore_log_permission_failure_message($upgrade_folder, 'Put contents '.$upgrade_folder.$rand_file, 'Destination'); return new WP_Error('no_file', sprintf(__('UpdraftPlus needed to create a %s in your content directory, but failed - please check your file permissions and enable the access (%s)', 'updraftplus'), __('file', 'updraftplus'), $upgrade_folder.$rand_file)); } } // Code below here assumes that we're dealing with file-based entities if ('db' == $type) return true; foreach ($info['path'] as $path) { $wp_filesystem_dir = $this->get_wp_filesystem_dir($path); if (false === $wp_filesystem_dir) return false; $ret_val = true; $updraft_dir = $updraftplus->backups_dir_location(); if (isset($this->continuation_data['updraftplus_ajax_restore']) && 'continue_ajax_restore' != $this->continuation_data['updraftplus_ajax_restore'] && (('plugins' == $type \|\| 'uploads' == $type \|\| 'themes' == $type \|\| 'more' == $type) && (!is_multisite() \|\| 0 !== $this->ud_backup_is_multisite \|\| ('uploads' != $type \|\| empty($updraftplus_addons_migrator->new_blogid))))) { if (file_exists($updraft_dir.'/'.basename($wp_filesystem_dir)."-old")) { $ret_val = new WP_Error('already_exists', sprintf(__('Existing unremoved folders from a previous restore exist (please use the "Delete old folders" button to delete them before trying again): %s', 'updraftplus'), $updraft_dir.'/'.basename($wp_filesystem_dir)."-old")); } } } if (!empty($this->ud_foreign)) { $known_foreigners = apply_filters('updraftplus_accept_archivename', array()); if (!is_array($known_foreigners) \|\| empty($known_foreigners[$this->ud_foreign])) { return new WP_Error('uk_foreign', __('This version of UpdraftPlus does not know how to handle this type of foreign backup', 'updraftplus').' ('.$this->ud_foreign.')'); } } return $ret_val; } private function get_wp_filesystem_dir($path) { global $wp_filesystem; // Get the wp_filesystem location for the folder on the local install switch ($path) { case ABSPATH: case '': $wp_filesystem_dir = $wp_filesystem->abspath(); break; case WP_CONTENT_DIR: $wp_filesystem_dir = $wp_filesystem->wp_content_dir(); break; case WP_PLUGIN_DIR: $wp_filesystem_dir = $wp_filesystem->wp_plugins_dir(); break; case WP_CONTENT_DIR . '/themes': $wp_filesystem_dir = $wp_filesystem->wp_themes_dir(); // If the themes directory does not exist then it's possible to get a broken path, confirm and try to resolve this if (!$wp_filesystem->exists($wp_filesystem_dir) && $wp_filesystem_dir == $wp_filesystem->find_folder(WP_CONTENT_DIR.get_theme_root()) && $wp_filesystem->exists($wp_filesystem->wp_content_dir())) { $wp_filesystem_dir = $wp_filesystem->find_folder(WP_CONTENT_DIR.'/themes'); } break; default: $wp_filesystem_dir = $wp_filesystem->find_folder($path); break; } if (!$wp_filesystem_dir) return false; return untrailingslashit($wp_filesystem_dir); } /* * $backup_file is just the basename, and must be a string; we expect the caller to deal with looping over an array (multi-archive sets). We do, however, record whether we have already unpacked an entity of the same type - so that we know to add (not replace). * * @param String $backup_file name of file being backed up * @param String $type type of file * @param Array $info information array * @param Boolean $last_one indicate if this is the last file to be restored * @param Boolean $last_entity indicate if this is the last entity of this type to be restored * @return WP_Error\|Boolean - true if successful; otherwise false or an error / private function restore_backup($backup_file, $type, $info, $last_one = false, $last_entity = false) { global $wp_filesystem, $updraftplus; $updraftplus->log("restore_backup(backup_file=$backup_file, type=$type, info=".serialize($info).", last_one=$last_one)"); if ('db' == $type) { $get_dir = ''; } else { $entity_path = isset($info['path']) ? $info['path'] : ''; $path = apply_filters('updraftplus_restore_path', $entity_path, $backup_file, $this->ud_backup_set, $type); $get_dir = empty($path) ? '' : $path; } if (false === ($wp_filesystem_dir = $this->get_wp_filesystem_dir($get_dir))) return false; if (empty($this->abspath)) $this->abspath = trailingslashit($wp_filesystem->abspath()); // We copy the variable because we may be importing with a different prefix (e.g. on multisite imports of individual blog data) // The filter allows you to restore to a completely different prefix - i.e. don't replace this site; possibly useful for testing the restore process (but not yet tested) $import_table_prefix = apply_filters('updraftplus_restore_table_prefix', $updraftplus->get_table_prefix(false)); $this->import_table_prefix = $import_table_prefix; $this->final_import_table_prefix = $updraftplus->get_table_prefix(false); if (function_exists('set_time_limit')) @set_time_limit(1800);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. // Based upon how WP updates work, the following code unpacks the "package" (the backup archive) and then later its contents are moved to their destination. // If successful, this returns the WP_Filesystem path for the unpacked zip or unencrypted database if (preg_match('/-db(\.gz(\.crypt)?)?$/i', $backup_file) \|\| preg_match('/\.sql(\.gz\|\.bz2)?$/i', $backup_file)) { $working_dir = $this->unpack_package_database($backup_file); } else { $working_dir = $this->unpack_package_archive($backup_file, $type); } if (is_wp_error($working_dir)) return $working_dir; // Allow developers to modify the temporary unzip path $working_dir_localpath = apply_filters('updraftplus_working_dir_localpath', WP_CONTENT_DIR.'/upgrade/'.basename($working_dir)); if (function_exists('set_time_limit')) @set_time_limit(1800);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- The call is speculative // Allow extensions to either perform the move-in instead of the code below, or to modify the destination directory $now_done = apply_filters('updraftplus_pre_restore_move_in', false, $type, $working_dir, $info, $this->ud_backup_set, $this, $wp_filesystem_dir); if (is_wp_error($now_done)) return $now_done; // If a string is returned from the filter, then this indicates to proceed but with a different destination directory (e.g. restoring into a sub-site's site-specific directory) if (is_string($now_done)) { $wp_filesystem_dir = $now_done; $now_done = false; $do_not_move_old = true; } if (!$now_done) { if ('db' == $type) { $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'db', 'data' => array('stage' => 'begun', 'table' => ''))); $restored_db = $this->restore_backup_db($working_dir, $working_dir_localpath, $import_table_prefix); if (false === $restored_db \|\| is_wp_error($restored_db)) return $restored_db; $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'db', 'data' => array('stage' => 'finished', 'table' => ''))); } elseif ('others' == $type) { // For foreign 'Simple Backup', we need to keep going down until we find wp-content if (empty($this->ud_foreign)) { $move_from = $working_dir; } else { $move_from = $this->search_for_folder('wp-content', $working_dir); if (!is_string($move_from)) return new WP_Error('not_found', __('The WordPress content folder (wp-content) was not found in this zip file.', 'updraftplus')); } // In this special case, the backup contents are not in a folder, so it is not simply a case of moving the folder around, but rather looping over all that we find // On subsequent archives of a multi-archive set, don't move anything; but do on the first $preserve_existing = isset($this->been_restored['others']) ? self::MOVEIN_COPY_IN_CONTENTS : self::MOVEIN_MAKE_BACKUP_OF_EXISTING; $preserve_existing = apply_filters('updraft_move_others_preserve_existing', $preserve_existing, $this->been_restored, $this->restore_options, $this->ud_backup_set); $new_move_from = apply_filters('updraft_restore_backup_move_from', $move_from, 'others', $this->restore_options, $this->ud_backup_set); if ($new_move_from != $move_from && 0 === strpos($new_move_from, $move_from)) { $new_suffix = substr($new_move_from, strlen($move_from)); $wp_filesystem_dir .= $new_suffix; $move_from = $new_move_from; } $move_in = $this->move_backup_in($move_from, trailingslashit($wp_filesystem_dir), $preserve_existing, array('plugins', 'themes', 'uploads', 'upgrade'), 'others'); if (is_wp_error($move_in)) return $move_in; if (!$move_in) return new WP_Error('new_move_failed', $this->strings['new_move_failed']); $this->been_restored['others'] = true; } else { // Default action: used for plugins, themes and uploads (and wpcore, via a filter) // Multi-archive sets: we record what we've already begun on, and on subsequent runs, copy in instead of replacing $movedin = apply_filters('updraftplus_restore_movein_'.$type, $working_dir, $this->abspath, $wp_filesystem_dir); // A filter, to allow add-ons to perform the install of non-standard entities, or to indicate that it's not possible if (false === $movedin) { $this->skin->feedback($this->strings['not_possible']); } elseif (is_wp_error($movedin)) { return $movedin; } elseif (true !== $movedin) { // We get the directory to move from early, in case there is a problem with the backup that affects the result - we want to detect that before moving existing data out of the way $short_circuit = false; // For foreign 'Simple Backup', we need to keep going down until we find wp-content if (empty($this->ud_foreign)) { $working_dir_use = $working_dir; } else { $working_dir_use = $this->search_for_folder('wp-content', $working_dir); if (!is_string($working_dir_use)) { if (empty($this->ud_foreign) \|\| !apply_filters('updraftplus_foreign_allow_missing_entity', false, $type, $this->ud_foreign)) { return new WP_Error('not_found', __('The WordPress content folder (wp-content) was not found in this zip file.', 'updraftplus')); } else { $short_circuit = true; } } } // The backup may not actually have /$type, since that is info from the present site $move_from = $this->get_first_directory($working_dir_use, array(basename($path), $type)); if (false !== $move_from) $move_from = apply_filters('updraft_restore_backup_move_from', $move_from, $type, $this->restore_options, $this->ud_backup_set); if (false === $move_from) { if (!empty($this->ud_foreign) && !apply_filters('updraftplus_foreign_allow_missing_entity', false, $type, $this->ud_foreign)) { return new WP_Error('new_move_failed', $this->strings['new_move_failed']); } } // On the first time, create the -old directory in updraft_dir // (Old style was: On the first time, move the existing data to -old) if (!isset($this->been_restored[$type]) && empty($do_not_move_old)) { $this->move_existing_to_old($type, $get_dir, $wp_filesystem, $wp_filesystem_dir); } if (empty($short_circuit)) { if (false === $move_from) { if (!empty($this->ud_foreign) && !apply_filters('updraftplus_foreign_allow_missing_entity', false, $type, $this->ud_foreign)) { return new WP_Error('new_move_failed', $this->strings['new_move_failed']); } } else { $this->skin->feedback($this->strings['moving_backup']); $move_in = $this->move_backup_in($move_from, trailingslashit($wp_filesystem_dir), self::MOVEIN_COPY_IN_CONTENTS, array(), $type); if (is_wp_error($move_in)) return $move_in; if (!$move_in) return new WP_Error('new_move_failed', $this->strings['new_move_failed']); if (!$wp_filesystem->rmdir($move_from)) { $this->restore_log_permission_failure_message(dirname($move_from), 'Delete '.$move_from); } } } } $this->been_restored[$type] = true; } } // Attempt deletion if relevant if (empty($this->ud_foreign) \|\| $last_one) { // Non-recursive, so the directory needs to be empty $this->skin->feedback($this->strings['cleaning_up']); if (!empty($do_not_move_old)) @$wp_filesystem->delete($working_dir.'/'.$type);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. // Foreign backups can contain extra data and thus leave stuff behind, thus causing errors $recurse = empty($this->ud_foreign) ? false : true; $recurse = apply_filters('updraftplus_restore_delete_recursive', $recurse, $this->ud_foreign, $this->restore_options, $type); if (!$wp_filesystem->delete($working_dir, $recurse)) { // Can remove this after 1-Jan-2015; or at least, make it so that it requires the version number to be present. $fixed_it_now = false; // Deal with a corner-case in version 1.8.5 if ('uploads' == $type && (empty($this->created_by_version) \|\| (version_compare($this->created_by_version, '1.8.5', '>=') && version_compare($this->created_by_version, '1.8.8', '<')))) { $updraftplus->log("Clean-up failed with uploads: will attempt 1.8.5-1.8.7 fix (".$this->created_by_version.")"); $move_in = @$this->move_backup_in(dirname($move_from), trailingslashit($wp_filesystem_dir), 3, array(), $type);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. $updraftplus->log("Result: ".serialize($move_in)); if ($wp_filesystem->delete($working_dir)) $fixed_it_now = true; } if (file_exists($working_dir.DIRECTORY_SEPARATOR.'updraftplus-manifest.json')) { // Before we cleanup and remove the manifest check if this is the last entity of this type, if it is then we want to remove anything that no longer exists in this manifest if ($last_entity) { $incremental_restore_prune = $this->incremental_restore_prune_files($working_dir, $type); if (is_wp_error($incremental_restore_prune)) return $incremental_restore_prune; } $wp_filesystem->delete($working_dir.DIRECTORY_SEPARATOR.'updraftplus-manifest.json'); if ($wp_filesystem->delete($working_dir)) $fixed_it_now = true; } if (!$fixed_it_now) { $updraftplus->log_e('Error: %s', $this->strings['delete_failed'].' ('.$working_dir.')'); // List contents // No need to make this a restoration-aborting error condition - it's not $dirlist = $wp_filesystem->dirlist($working_dir, true, true); if (is_array($dirlist)) { $updraftplus->log(__('Files found:', 'updraftplus'), 'notice-restore'); foreach (array_keys($dirlist) as $name) { $updraftplus->log(" $name", 'notice-restore'); } } else { $updraftplus->log_e('Unable to enumerate files in that directory.'); } } } } // Permissions changes (at the top level - i.e. this does not apply if using recursion) are now additive - i.e. there's no danger of permissions being removed from what's on-disk switch ($type) { case 'wpcore': $this->adjust_auto_prepend_directive(); $this->chmod_if_needed($wp_filesystem_dir, FS_CHMOD_DIR, false, $wp_filesystem); // In case we restored a .htaccess which is incorrect for the local setup $this->flush_rewrite_rules(); break; case 'uploads': $this->chmod_if_needed($wp_filesystem_dir, FS_CHMOD_DIR, false, $wp_filesystem); break; case 'themes': // Cherry Framework needs its cache files removing after migration if ((empty($this->old_siteurl) \|\| ($this->old_siteurl != $this->our_siteurl)) && function_exists('glob')) { $cherry_child = glob(WP_CONTENT_DIR.'/themes/theme'); if (is_array($cherry_child)) { foreach ($cherry_child as $theme) { if (file_exists($theme.'/style.less.cache')) unlink($theme.'/style.less.cache'); if (file_exists($theme.'/bootstrap/less/bootstrap.less.cache')) unlink($theme.'/bootstrap/less/bootstrap.less.cache'); } } } break; case 'db': if (function_exists('wp_cache_flush')) wp_cache_flush(); do_action('updraftplus_restored_db', array( 'expected_oldsiteurl' => $this->old_siteurl, 'expected_oldhome' => $this->old_home, 'expected_oldcontent' => $this->old_content ), $import_table_prefix); // N.B. flush_rewrite_rules() causes $wp_rewrite to become up to date again - important for the no_mod_rewrite() call $this->flush_rewrite_rules(); if ($updraftplus->mod_rewrite_unavailable()) { $updraftplus->log("Using Apache, with permalinks (".get_option('permalink_structure').") but no mod_rewrite enabled - enable it to make your permalinks work"); $warn_no_rewrite = sprintf(__('You are using the %s webserver, but do not seem to have the %s module loaded.', 'updraftplus'), 'Apache', 'mod_rewrite').' '.sprintf(__('You should enable %s to make any pretty permalinks (e.g. %s) work', 'updraftplus'), 'mod_rewrite', 'http://example.com/my-page/'); $updraftplus->log($warn_no_rewrite, 'warning-restore'); } break; default: $this->chmod_if_needed($wp_filesystem_dir, FS_CHMOD_DIR, false, $wp_filesystem); } // db was already done if ('db' != $type) do_action('updraftplus_restored_'.$type); return true; } /* * This method will read in the latest manifest file for an entity type and start the file prune. * * @param string $working_dir - the directory we are working in * @param string $type - the type of file * @return boolean\|WP_Error / private function incremental_restore_prune_files($working_dir, $type) { // Check file exists again just in case it some how got removed $manifest_file = $working_dir.DIRECTORY_SEPARATOR.'updraftplus-manifest.json'; if (file_exists($manifest_file) && filesize($manifest_file) > 0) { $entity_manifest = file_get_contents($working_dir.DIRECTORY_SEPARATOR.'updraftplus-manifest.json'); $decoded_manifest = json_decode($entity_manifest, true); if (null === $decoded_manifest) { // 2.16.0 could fail to put a comma after the first 'files' item $entity_manifest = preg_replace('/files":(.)""/', 'files":$1","', $entity_manifest); $decoded_manifest = json_decode($entity_manifest, true); if (null === $decoded_manifest) return new WP_Error('decode_manifest_failed', 'Failed to JSON-decode the manifest file'); global $updraftplus; $updraftplus->log('Manifest file had invalid JSON, but it was successfully patched'); } $base_path = trailingslashit(WP_CONTENT_DIR); $path = $base_path.$type; return $this->incremental_restore_scan_dir($base_path, $path, 1, $decoded_manifest); } else { return new WP_Error('manifest_not_found', $this->strings['manifest_not_found']); } } /** * This method will recursively scan each directory to the given listed_level which is located in the manifest and prune and files or folders that do not exist in the manifest. * * @param string $base_path - the base path of the entity type * @param string $path - the current path we are scanning * @param integer $current_level - the level we are currently scanning at * @param array $entity_manifest - the manifest array which includes the listed_level, directories and files to keep * @return boolean\|WP_Error / private function incremental_restore_scan_dir($base_path, $path, $current_level, $entity_manifest) { global $wp_filesystem; $directory_level = $entity_manifest['listed_levels']; $entity_directories = $entity_manifest['contents']['directories']; $entity_files = $entity_manifest['contents']['files']; if (!isset($directory_level) \|\| !isset($entity_directories) \|\| !isset($entity_files)) return new WP_Error('read_manifest_failed', $this->strings['read_manifest_failed']); $directory_files = $wp_filesystem->dirlist($path); if (isset($directory_files)) { foreach ($directory_files as $file => $filestruc) { if ($wp_filesystem->is_dir($path . DIRECTORY_SEPARATOR . $file)) { $directory = $path . DIRECTORY_SEPARATOR . $file; // Check if we should go deeper in the file path, if not then check if this directory exists in the manifest, if not then remove it. if ($current_level + 1 < $directory_level) { $incremental_restore_prune = $this->incremental_restore_scan_dir($base_path, $directory, $current_level + 1, $entity_manifest); if (is_wp_error($incremental_restore_prune)) return $incremental_restore_prune; } else { $directory = str_replace($base_path, "", $directory); if (!in_array($directory, $entity_directories)) { $wp_filesystem->delete($base_path . $directory, true); } } } else { $file = str_replace($base_path, "", $path . DIRECTORY_SEPARATOR . $file); if (!in_array($file, $entity_files)) { $wp_filesystem->delete($base_path . $file, false); } } } return true; } else { return new WP_Error('read_working_dir_failed', $this->strings['read_working_dir_failed']); } } private function move_existing_to_old($type, $get_dir, $wp_filesystem, $wp_filesystem_dir) { if (apply_filters('updraft_move_existing_to_old_short_circuit', false, $type, $this->restore_options)) { // Users of the filter should do their own logging return; } global $updraftplus; $updraft_dir = $updraftplus->backups_dir_location(); // Firstly, if there's already an '-old' directory, get rid of it // Try filesystem-level move $old_dir = $updraft_dir.'/'.$type.'-old'; if (is_dir($old_dir)) { $updraftplus->log_e('%s: This directory already exists, and will be replaced', $old_dir); UpdraftPlus_Filesystem_Functions::remove_local_directory($old_dir); } $move_old_destination = apply_filters('updraftplus_restore_move_old_mode', 0, $type, $this->restore_options); if (0 == $move_old_destination && @mkdir($old_dir)) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $updraftplus->log("Moving old data: filesystem method / updraft_dir is potentially possible"); $move_old_destination = 1; } // Try wp_filesystem instead if ($wp_filesystem->exists($wp_filesystem_dir."-old")) { // Is better to warn and delete the restore than abort mid-restore and leave inconsistent site $updraftplus->log_e('%s: This directory already exists, and will be replaced', $wp_filesystem_dir."-old"); // In theory, supplying true as the 3rd parameter achieves this; in practice, not always so (leads to support requests) $wp_filesystem->delete($wp_filesystem_dir."-old", true); if ($wp_filesystem->exists($wp_filesystem_dir."-old")) { $updraftplus->log("Failed to remove existing directory (".$wp_filesystem_dir."-old"); $failed_to_remove = true; } } if (-1 != $move_old_destination && empty($failed_to_remove) && @$wp_filesystem->mkdir($wp_filesystem_dir."-old")) {// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. $updraftplus->log("Moving old data: can potentially use wp_filesystem method / -old"); $move_old_destination += 2; } if (0 == $move_old_destination) { $updraftplus->log_e("File permissions do not allow the old data to be moved and retained; instead, it will be deleted."); } $this->skin->feedback($this->strings['moving_old']); // Firstly, try direct filesystem method into updraft_dir if ($move_old_destination > 0 && 1 == $move_old_destination % 2) { // The final 'true' forces direct filesystem access $move_old = @$this->move_backup_in($get_dir, $updraft_dir.'/'.$type.'-old/', 3, array(), $type, false, true, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. if (is_wp_error($move_old)) $updraftplus->log_wp_error($move_old); } // Try wp_filesystem method into -old if that failed if (2 >= $move_old_destination && (0 == $move_old_destination % 2 \|\| (!empty($move_old) && is_wp_error($move_old)))) { $move_old = @$this->move_backup_in($wp_filesystem_dir, $wp_filesystem_dir."-old/", 3, array(), $type, false, false, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. if (is_wp_error($move_old)) $updraftplus->log_wp_error($move_old); } // Finally, when all else fails, nuke it if (-1 == $move_old_destination \|\| 0 == $move_old_destination \|\| (!empty($move_old) && is_wp_error($move_old))) { if (-1 == $move_old_destination) { $updraftplus->log("$type: $wp_filesystem_dir: deleting contents"); } else { $updraftplus->log("$type: $wp_filesystem_dir: deleting contents (as attempts to copy failed)"); } $del_files = $wp_filesystem->dirlist($wp_filesystem_dir, true, false); if (empty($del_files)) $del_files = array(); foreach ($del_files as $file => $filestruc) { if (empty($file)) continue; if (!$wp_filesystem->delete($wp_filesystem_dir.'/'.$file, true)) { $this->restore_log_permission_failure_message($wp_filesystem_dir, 'Delete '.$wp_filesystem_dir.'/'.$file); } } } } /* * First added in UD 1.9.47. / private function clear_caches() { global $updraftplus; // Functions called here need to not assume that the relevant plugin actually exists - they should check for any functions they intend to call, before calling them. $methods = array( 'clear_cache_wpsupercache', 'clear_avada_fusion_cache', // avada theme with its theme engine called fusion 'clear_elementor_cache', 'clear_divi_cache', ); foreach ($methods as $method) { try { call_user_func(array($this, $method)); } catch (Exception $e) { $log_message = 'Exception ('.get_class($e).") occurred when cleaning up third-party cache ($method) during post-restore: ".$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); $updraftplus->log($log_message); } catch (Error $e) { // phpcs:ignore PHPCompatibility.Classes.NewClasses.errorFound -- The Error class does not exist in PHP below 5.6. $log_message = 'Error ('.get_class($e).") occurred when cleaning up third-party cache ($method) during post-restore: ".$e->getMessage().' (Code: '.$e->getCode().', line '.$e->getLine().' in '.$e->getFile().')'; error_log($log_message); $updraftplus->log($log_message); } } // It should be harmless to just purge the standard directory anyway (it's not backed up by default), and any others from other plugins $cache_sub_directories = array('cache', 'wphb-cache', 'endurance-page-cache'); foreach ($cache_sub_directories as $sub_dir) { if (!is_dir(WP_CONTENT_DIR.'/'.$sub_dir)) continue; $updraftplus->log("Purging cache directory: ".WP_CONTENT_DIR.'/'.$sub_dir); UpdraftPlus_Filesystem_Functions::remove_local_directory(WP_CONTENT_DIR.'/'.$sub_dir, true); } } /* * Clear cached Fusion-theme's Dynamic CSS / private function clear_avada_fusion_cache() { global $updraftplus; $upload_dir = $updraftplus->wp_upload_dir(); $fusion_css_dir = realpath($upload_dir['basedir']).DIRECTORY_SEPARATOR.'fusion-styles'; if (is_dir($fusion_css_dir)) { $updraftplus->log("Avada/Fusion's dynamic CSS folder exists, and will be emptied (so that it will be automatically regenerated)"); UpdraftPlus_Filesystem_Functions::remove_local_directory($fusion_css_dir, true); } } /* * Clear cached Divi Theme Dynamic CSS / private function clear_divi_cache() { global $updraftplus; $clear_cache = true; $divi_cache_dir = (defined('ET_CORE_CACHE_DIR')) ? ET_CORE_CACHE_DIR : WP_CONTENT_DIR.DIRECTORY_SEPARATOR.'et-cache'; if (apply_filters('updraftplus_divi_direct_clear_cache', $clear_cache) && class_exists('ET_Core_PageResource') && method_exists('ET_Core_PageResource', 'remove_static_resources')) { $updraftplus->log("Divi's clear cache method exists and will be executed"); ET_Core_PageResource::remove_static_resources('all', 'all'); $clear_cache = false; } if (apply_filters('updraftplus_divi_manual_clear_cache', $clear_cache) && is_dir($divi_cache_dir)) { $updraftplus->log("Divi's cache directory exists, and will be emptied (so that it will be automatically regenerated)"); UpdraftPlus_Filesystem_Functions::remove_local_directory($divi_cache_dir, true); } } /* * Clear cached Elementor styles that are saved in CSS files in the uploads folder. Clearing the caches will regenerate new CSS files, according to the most recent settings. / private function clear_elementor_cache() { global $updraftplus; $cache_uncleared = true; if (apply_filters('updraftplus_elementor_direct_clear_cache', $cache_uncleared)) { if (class_exists('\Elementor\Plugin')) class_alias('\Elementor\Plugin', 'UpdraftPlus_Elementor_Plugin'); // phpcs:ignore PHPCompatibility.FunctionUse.NewFunctions.class_aliasFound -- Ignore class_alias function. if (class_exists('UpdraftPlus_Elementor_Plugin') && isset(UpdraftPlus_Elementor_Plugin::$instance) && isset(UpdraftPlus_Elementor_Plugin::$instance->files_manager) && is_object(UpdraftPlus_Elementor_Plugin::$instance->files_manager) && method_exists(UpdraftPlus_Elementor_Plugin::$instance->files_manager, 'clear_cache')) { $updraftplus->log("Elementor's clear cache method exists and will be executed"); UpdraftPlus_Elementor_Plugin::$instance->files_manager->clear_cache(); $cache_uncleared = false; } } if (apply_filters('updraftplus_elementor_manual_clear_cache', $cache_uncleared)) { $upload_dir = $updraftplus->wp_upload_dir(); $elementor_css_dir = realpath($upload_dir['basedir']).DIRECTORY_SEPARATOR.'elementor'.DIRECTORY_SEPARATOR.'css'; if (is_dir($elementor_css_dir)) { $updraftplus->log("Elementor's CSS directory exists, and will be emptied (so that it will be automatically regenerated)"); UpdraftPlus_Filesystem_Functions::remove_local_directory($elementor_css_dir, true); } // deleting only the Elementor's CSS files won't make Elementor regenerate the new CSS files the next time the website is loaded/visited again // Elementor will regenerate the files only if these meta and options get deleted as well delete_post_meta_by_key('_elementor_css'); delete_option('_elementor_global_css'); delete_option('elementor-custom-breakpoints-files'); } } /* * Adapted from wp_cache_clean_cache($file_prefix, $all = false) in WP Super Cache (wp-cache.php) * * @return boolean / private function clear_cache_wpsupercache() { $all = true; global $updraftplus, $cache_path, $wp_cache_object_cache; if ($wp_cache_object_cache && function_exists('reset_oc_version')) reset_oc_version(); // Removed check: && wpsupercache_site_admin() if (true == $all && function_exists('prune_super_cache')) { if (!empty($cache_path)) { $updraftplus->log_e("Clearing cached pages (%s)...", 'WP Super Cache'); prune_super_cache($cache_path, true); } return true; } } private function search_for_folder($folder, $startat) { if (!is_dir($startat)) return false; // Exists in this folder? if (is_dir($startat.'/'.$folder)) return trailingslashit($startat).$folder; // Does not if ($handle = opendir($startat)) { while (($file = readdir($handle)) !== false) { if ('.' != $file && '..' != $file && is_dir($startat).'/'.$file) { $ss = $this->search_for_folder($folder, trailingslashit($startat).$file); if (is_string($ss)) return $ss; } } closedir($handle); } return false; } /* * Returns an octal string (but not an octal number) * * @param String $file The file to get the permissions for * @param WP_Filesystem\|Boolean $wpfs WP_Filesystem object, at least support the getchmod() method * * @return String / private function get_current_chmod($file, $wpfs = false) { if (false == $wpfs) { global $wp_filesystem; $wpfs = $wp_filesystem; } // getchmod() is broken at least as recently as WP3.8 - see: https://core.trac.wordpress.org/ticket/26598 return (is_a($wpfs, 'WP_Filesystem_Direct')) ? substr(sprintf("%06d", decoct(@fileperms($file))), 3) : $wpfs->getchmod($file);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } /* * Returns a string in octal format * $new_chmod should be an octal, i.e. what you'd pass to chmod() * * @param string $old_chmod specify old chmod * @param string $new_chmod specify new chmod * @return string / private function calculate_additive_chmod_oct($old_chmod, $new_chmod) { // chmod() expects octal form, which means a preceding zero - see http://php.net/chmod $old_chmod = sprintf("%04d", $old_chmod); $new_chmod = sprintf("%04d", decoct($new_chmod)); for ($i=1; $i<=3; $i++) { $oldbit = substr($old_chmod, $i, 1); $newbit = substr($new_chmod, $i, 1); for ($j=0; $j<=2; $j++) { if (($oldbit & (1<<$j)) && !($newbit & (1<<$j))) { $newbit = (string) ($newbit \| 1<<$j); $new_chmod = sprintf("%04d", substr($new_chmod, 0, $i).$newbit.substr($new_chmod, $i+1)); } } } return $new_chmod; } /* * "If needed" means, "If the permissions are not already more permissive than this". i.e. This will not tighten permissions from what the user had before (we trust them) * $chmod should be an octal - i.e. the same as you'd pass to chmod() * * @param String $dir a WP_Filesystem path * @param String $chmod specific chmod * @param Boolean $recursive indicate if recursive chmod is needed * @param Boolean $wpfs indicate whether to use wpfs access methods * @param Boolean $suppress suppress PHP error/warning output * * @return Boolean - whether the operation was successfully carried out / private function chmod_if_needed($dir, $chmod, $recursive = false, $wpfs = false, $suppress = true) { // Do nothing on Windows if ('WIN' === strtoupper(substr(PHP_OS, 0, 3))) return true; if (false == $wpfs) { global $wp_filesystem; $wpfs = $wp_filesystem; } $old_chmod = $this->get_current_chmod($dir, $wpfs); // Sanity check if (strlen($old_chmod) < 3) return false; $new_chmod = $this->calculate_additive_chmod_oct($old_chmod, $chmod); // Don't fix what isn't broken if (!$recursive && $new_chmod == $old_chmod) return true; $new_chmod = octdec($new_chmod); if ($suppress) { return @$wpfs->chmod($dir, $new_chmod, $recursive);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the method. } else { return $wpfs->chmod($dir, $new_chmod, $recursive); } } /* * This will return the path with the actual content we want to restore, ignoring any other files that may be in the top level of the zip file * $dirnames: an array of preferred names * * @param string $working_dir specify working directory * @param string $dirnames directory names * @return string the final path with the content we want to restore / public function get_first_directory($working_dir, $dirnames) { global $wp_filesystem, $updraftplus; $fdirnames = array_flip($dirnames); $dirlist = $wp_filesystem->dirlist($working_dir, true, false); if (is_array($dirlist)) { $move_from = false; foreach ($dirlist as $name => $struct) { if (isset($struct['type']) && 'd' != $struct['type']) continue; if (false === $move_from) { if (isset($fdirnames[$name])) { $move_from = $working_dir . "/".$name; } elseif (preg_match('/^([^\.].)$/', $name, $fmatch)) { // In the case of a third-party backup, the first entry may be the wrong entity. We could try a more sophisticated algorithm, but a third party backup requiring one has never been seen (and it is not easy to envisage what the algorithm might be). if (empty($this->ud_foreign)) { $first_entry = $working_dir."/".$fmatch[1]; } } } } if (false === $move_from && isset($first_entry)) { $updraftplus->log_e('Using directory from backup: %s', basename($first_entry)); $move_from = $first_entry; } } else { // That shouldn't happen. Fall back to default $move_from = $working_dir."/".$dirnames[0]; } return $move_from; } /** * Enter or leave maintenance mode * * @param Boolean $active - whether to activate, or de-activate, maintenance mode / private function maintenance_mode($active) { // This allows add-ons to do something different if they prefer if (apply_filters('updraft_restore_maintenance_mode', true, $active, $this, $this->wp_upgrader)) { $this->wp_upgrader->maintenance_mode($active); } } /* * Gets the table prefix to use, using the filter updraftplus_restore_set_import_table_prefix * * @param String $import_table_prefix - table prefix to act upon * * @return String\|WP_Error\|Boolean - the modified table prefix, or an error or indication of an error / private function pre_sql_actions($import_table_prefix) { global $updraftplus; $import_table_prefix = apply_filters('updraftplus_restore_set_table_prefix', $import_table_prefix, $this->ud_backup_is_multisite); if (!is_string($import_table_prefix)) { $this->maintenance_mode(false); if (false === $import_table_prefix) { $updraftplus->log(__('Please supply the requested information, and then continue.', 'updraftplus'), 'notice-restore'); return false; } elseif (is_wp_error($import_table_prefix)) { return $import_table_prefix; } else { return new WP_Error('invalid_table_prefix', __('Error:', 'updraftplus').' '.serialize($import_table_prefix)); } } $updraftplus->log_e('New table prefix: %s', $import_table_prefix); return $import_table_prefix; } /* * WordPress options filter * * @param String $val - pre-filter value * * @return String - filtered value / public function option_filter_permalink_structure($val) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; return $updraftplus->option_filter_get('permalink_structure'); } /* * WordPress options filter * * @param String $val - pre-filter value * * @return String - filtered value / public function option_filter_page_on_front($val) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; return $updraftplus->option_filter_get('page_on_front'); } /* * WordPress options filter * * @param String $val - pre-filter value * * @return String - filtered value / public function option_filter_rewrite_rules($val) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; return $updraftplus->option_filter_get('rewrite_rules'); } /* * Assign a value to log_bin_trust_function_creators system variable and return its previous value * * @see https://mariadb.com/kb/en/library/binary-logging-of-stored-routines/ * @see https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html * * @param String $value It can only be set to ON or OFF * @return String\|WP_Error the variable value before it got assigned a new value, or WP_Error object on failure / private function set_log_bin_trust_function_creators($value) { global $wpdb; static $saved_value = null; static $initial_value = null; $old_val = $wpdb->suppress_errors(); try { if (is_null($initial_value) \|\| is_wp_error($initial_value)) { $creators_val = $wpdb->get_var("SELECT @@GLOBAL.log_bin_trust_function_creators"); if (is_null($creators_val)) throw new Exception(sprintf(__('An error occurred while attempting to retrieve the MySQL global log_bin_trust_function_creators variable %s', 'updraftplus'), '('. $wpdb->last_error.' - '.$wpdb->last_query.')'), 0); $initial_value = '1' === $creators_val \|\| 'on' === strtolower($creators_val) ? 'ON' : 'OFF'; } if ((is_null($saved_value) \|\| ($saved_value != $value))) { $res = $wpdb->query("SET GLOBAL log_bin_trust_function_creators = ".$value); if (false === $res) { $saved_value = null; throw new Exception(sprintf(__('An error occurred while attempting to set a new value to the MySQL global log_bin_trust_function_creators variable %s', 'updraftplus'), '('. $wpdb->last_error.' - '.$wpdb->last_query.')'), 0); } if (!is_null($saved_value)) { $initial_value = $saved_value; } $saved_value = $value; } } catch (Exception $ex) { $initial_value = new WP_Error('log_bin_trust_function_creators', $ex->getMessage()); } $wpdb->suppress_errors($old_val); return $initial_value; } /* * Prepare the create table statement before sending it to the query execution * * @param String $create_table_statement an SQL create table statement in which some part of the SQL is going to be parsed and/or replaced * @param String $import_table_prefix table prefix to use * @param Array $supported_engines the list of supported DB engines * @param Array $supported_charsets the list of supported DB charsets * @param Array $supported_collations the list of supported DB collations * @return String the processed create table statement that may have been transformed, sanitised or cleaned / private function prepare_create_table($create_table_statement, $import_table_prefix, $supported_engines, $supported_charsets, $supported_collations) { global $updraftplus, $wpdb; $updraft_restorer_collate = isset($this->restore_options['updraft_restorer_collate']) ? $this->restore_options['updraft_restorer_collate'] : ''; $non_wp_table = false; // Legacy, less reliable - in case it was not caught before. We added it in here (CREATE) as well as in DROP because of SQL dumps which lack DROP statements. if (null === $this->old_table_prefix && preg_match('/^([a-z0-9]+)_.$/i', $this->table_name, $tmatches)) { $this->old_table_prefix = $tmatches[1].'_'; $updraftplus->log(__('Old table prefix:', 'updraftplus').' '.$this->old_table_prefix, 'notice-restore', 'old-table-prefix'); $updraftplus->log("Old table prefix (detected from creating first table): ".$this->old_table_prefix); } // MySQL 4.1 outputs TYPE=, but accepts ENGINE=; 5.1 onwards accept only ENGINE= $create_table_statement = UpdraftPlus_Manipulation_Functions::str_lreplace('TYPE=', 'ENGINE=', $create_table_statement); if ('' === $this->old_table_prefix) { $this->new_table_name = $import_table_prefix.$this->table_name; } else { $this->new_table_name = $this->old_table_prefix ? UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $this->table_name) : $this->table_name; // if we have a different prefix but the table name has not changed after the replace then we are dealing with a table that does not use the WordPress table prefix, in order for an Atomic restore to work on this table we need to attach our temporary prefix if (empty($this->db_permissons_forbidden['rename']) && $this->old_table_prefix && $this->new_table_name == $this->table_name) { $non_wp_table = true; $this->new_table_name = $import_table_prefix.$this->table_name; } } // This CREATE TABLE command may be the de-facto mark for the end of processing a previous table (which is so if this is not the first table in the SQL dump) if ($this->restoring_table) { // Attempt to reconnect if the DB connection dropped (may not succeed, of course - but that will soon become evident) $updraftplus->check_db_connection($this->wpdb_obj); // After restoring the options table, we can set old_siteurl if on legacy (i.e. not already set) if ($this->restoring_table == $import_table_prefix.'options') { if ('' == $this->old_siteurl \|\| '' == $this->old_home \|\| '' == $this->old_content) { global $updraftplus_addons_migrator; if (!empty($updraftplus_addons_migrator->new_blogid)) switch_to_blog($updraftplus_addons_migrator->new_blogid); if ('' == $this->old_siteurl) { $this->old_siteurl = untrailingslashit($wpdb->get_row("SELECT option_value FROM ".$import_table_prefix.'options'." WHERE option_name='siteurl'")->option_value); do_action('updraftplus_restore_db_record_old_siteurl', $this->old_siteurl); } if ('' == $this->old_home) { $this->old_home = untrailingslashit($wpdb->get_row("SELECT option_value FROM ".$import_table_prefix.'options'." WHERE option_name='home'")->option_value); do_action('updraftplus_restore_db_record_old_home', $this->old_home); } if ('' == $this->old_content) { $this->old_content = $this->old_siteurl.'/wp-content'; do_action('updraftplus_restore_db_record_old_content', $this->old_content); } if (!empty($updraftplus_addons_migrator->new_blogid)) restore_current_blog(); } } if ('' !== $this->restoring_table && $this->restoring_table != $this->new_table_name) { $final_table_name = $this->maybe_rename_restored_table(); $this->restored_table($final_table_name, $this->final_import_table_prefix, $this->old_table_prefix, $this->table_engine); } } // Detect this as early as possible so we can turn off atomic restores if needed. If the table prefix has changed and key constraints are found, make sure they are updated $constraint_change_message = ''; $constraints = array(); $constraint_found = false; if (preg_match_all('/CONSTRAINT ([\a-zA-Z0-9_\']+) FOREIGN KEY $[a-zA-z0-9_\', ]+$ REFERENCES \'?([a-zA-z0-9_]+)\'? /i', $create_table_statement, $constraint_matches)) { $constraints = $constraint_matches; $constraint_found = true; } elseif (preg_match_all('/ FOREIGN KEY $[a-zA-z0-9_\', ]+$ REFERENCES \'?([a-zA-z0-9_]+)\'? /i', $create_table_statement, $constraint_matches)) { $constraints = $constraint_matches; $constraint_found = true; } // Constraints were found so we need to disable the atomic restore for this table, which means resetting the import table prefix and current table name and finally dropping the original table if it exists if ($constraint_found && empty($this->db_permissons_forbidden['rename']) && !$this->is_dummy_db_restore) { $import_table_prefix = $this->final_import_table_prefix; $this->disable_atomic_on_current_table = true; if ('' === $this->old_table_prefix) { $this->new_table_name = $import_table_prefix.$this->table_name; } else { $this->new_table_name = $this->old_table_prefix ? UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $this->table_name) : $this->table_name; } $updraftplus->log('Constraints found, will disable atomic restore for current table ('.$this->table_name.')', 'notice-restore'); $this->drop_tables(array($this->new_table_name)); } $this->table_engine = "(?)"; $engine_change_message = ''; if (preg_match('/ENGINE=([^\s;]+)/', $create_table_statement, $eng_match)) { $this->table_engine = $eng_match[1]; if (isset($supported_engines[strtolower($this->table_engine)])) { if ('myisam' == strtolower($this->table_engine)) { $create_table_statement = preg_replace('/PAGE_CHECKSUM=\d\s?/', '', $create_table_statement, 1); } } else { $engine_change_message = sprintf(__('Requested table engine (%s) is not present - changing to MyISAM.', 'updraftplus'), $this->table_engine)."<br>"; $create_table_statement = UpdraftPlus_Manipulation_Functions::str_lreplace("ENGINE=$this->table_engine", "ENGINE=MyISAM", $create_table_statement); $this->table_engine = "MyISAM"; // Remove (M)aria options if ('maria' == strtolower($this->table_engine) \|\| 'aria' == strtolower($this->table_engine) \|\| 'myisam' == strtolower($this->table_engine)) { $create_table_statement = preg_replace('/PAGE_CHECKSUM=\d\s?/', '', $create_table_statement, 1); $create_table_statement = preg_replace('/TRANSACTIONAL=\d\s?/', '', $create_table_statement, 1); } } } $charset_change_message = ''; if (preg_match_all('/\b(CHARSET\|CHARACTER SET)(\s=?\s)([^\s;,]+)(?:\s+(COLLATE)(\s=?\s)([^\s;,]+))?/i', $create_table_statement, $matches, PREG_SET_ORDER)) { $charset_replaced = array(); $table_definitions = end($matches); // Extract the character set from the CREATE TABLE statement $table_charset = !empty($table_definitions[3]) ? $table_definitions[3] : ''; // Extract the collation from the CREATE TABLE statement $table_collation = !empty($table_definitions[6]) ? $table_definitions[6] : ''; foreach ($matches as $match) { $full_match = $match[0]; $charset_keyword = $match[1]; $charset_separator = $match[2]; $charset_original = $match[3]; $collate_keyword = isset($match[4]) ? $match[4] : 'COLLATE'; $collate_separator = isset($match[5]) ? $match[5] : ' '; if (!isset($supported_charsets[strtolower($charset_original)]) && !in_array($full_match, $charset_replaced)) { if (!empty($this->restore_options['updraft_restorer_charset'])) { // Use the character set from the restoration settings $change_charset_to = $charset_keyword.$charset_separator.$this->restore_options['updraft_restorer_charset']; if (!empty($updraft_restorer_collate) && 'choose_a_default_for_each_table' != $updraft_restorer_collate) $change_charset_to .= ' '.$collate_keyword.$collate_separator.$updraft_restorer_collate; } elseif (!empty($table_charset) && isset($supported_charsets[strtolower($table_charset)])) { // Use the character set from the CREATE TABLE statement if no override is provided $change_charset_to = $charset_keyword.$charset_separator.$table_charset; // Use the collation from the CREATE TABLE statement if no override is provided if (!empty($table_collation) && isset($supported_collations[strtolower($table_collation)])) $change_charset_to .= ' '.$collate_keyword.$collate_separator.$table_collation; } else { // Remove character set $change_charset_to = ''; } $charset_replaced[] = $full_match; /* translators: 1: Requested character set, 2: Fallback character set. / $charset_change_message = sprintf(__('Requested character set (%1$s) is not present - changing to %2$s.', 'updraftplus'), esc_html($charset_original), esc_html($this->restore_options['updraft_restorer_charset'])); $create_table_statement = str_replace($full_match, $change_charset_to, $create_table_statement); } } } if (!empty($constraints) && $this->old_table_prefix != $this->final_import_table_prefix) { foreach ($constraints[0] as $constraint) { $updated_constraint = str_replace($this->old_table_prefix, $this->final_import_table_prefix, $constraint); $create_table_statement = str_replace($constraint, $updated_constraint, $create_table_statement); } $constraint_change_message = __('Found and replaced existing table foreign key constraints as the table prefix has changed.', 'updraftplus'); } $collate_change_message = ''; $unsupported_collates_in_sql_line = array(); if (!empty($updraft_restorer_collate) && preg_match('/ COLLATE=([a-zA-Z0-9._-]+)/i', $create_table_statement, $collate_match)) { $collate = $collate_match[1]; if (!isset($supported_collations[strtolower($collate)])) { $unsupported_collates_in_sql_line[] = $collate; if ('choose_a_default_for_each_table' == $updraft_restorer_collate) { $create_table_statement = UpdraftPlus_Manipulation_Functions::str_lreplace("COLLATE=$collate", "", $create_table_statement, false); } else { $create_table_statement = UpdraftPlus_Manipulation_Functions::str_lreplace("COLLATE=$collate", "COLLATE=".$updraft_restorer_collate, $create_table_statement, false); } } } if (!empty($updraft_restorer_collate) && preg_match_all('/ COLLATE ([a-zA-Z0-9._-]+) /i', $create_table_statement, $collate_matches)) { $collates = array_unique($collate_matches[1]); foreach ($collates as $collate) { if (!isset($supported_collations[strtolower($collate)])) { $unsupported_collates_in_sql_line[] = $collate; if ('choose_a_default_for_each_table' == $updraft_restorer_collate) { $create_table_statement = str_ireplace("COLLATE $collate ", "", $create_table_statement); } else { $create_table_statement = str_ireplace("COLLATE $collate ", "COLLATE ".$updraft_restorer_collate." ", $create_table_statement); } } } } if (!empty($updraft_restorer_collate) && preg_match_all('/ COLLATE ([a-zA-Z0-9._-]+),/i', $create_table_statement, $collate_matches)) { $collates = array_unique($collate_matches[1]); foreach ($collates as $collate) { if (!isset($supported_collations[strtolower($collate)])) { $unsupported_collates_in_sql_line[] = $collate; if ('choose_a_default_for_each_table' == $updraft_restorer_collate) { $create_table_statement = str_ireplace("COLLATE $collate,", ",", $create_table_statement); } else { $create_table_statement = str_ireplace("COLLATE $collate,", "COLLATE ".$updraft_restorer_collate.",", $create_table_statement); } } } } if (count($unsupported_collates_in_sql_line) > 0) { $unsupported_unique_collates_in_sql_line = array_unique($unsupported_collates_in_sql_line); $collate_change_message = sprintf(_n('Requested table collation (%1$s) is not present - changing to %2$s.', 'Requested table collations (%1$s) are not present - changing to %2$s.', count($unsupported_unique_collates_in_sql_line), 'updraftplus'), esc_html(implode(', ', $unsupported_unique_collates_in_sql_line)), esc_html($this->restore_options['updraft_restorer_collate'])); } $print_line = sprintf(__('Processing table (%s)', 'updraftplus'), $this->table_engine).": ".$this->table_name; $logline = "Processing table ($this->table_engine): ".$this->table_name; if (null !== $this->old_table_prefix && $import_table_prefix != $this->old_table_prefix) { if ($this->restore_this_table($this->table_name)) { $print_line .= ' - '.__('will restore as:', 'updraftplus').' '.htmlspecialchars($this->new_table_name); $logline .= " - will restore as: ".$this->new_table_name; } else { $logline .= ' - skipping'; } if ('' === $this->old_table_prefix \|\| $non_wp_table) { $create_table_statement = UpdraftPlus_Manipulation_Functions::str_replace_once($this->table_name, $this->new_table_name, $create_table_statement); } else { $create_table_statement = UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $create_table_statement); } $this->restored_table_names[] = $this->new_table_name; } if (!empty($this->generated_columns[$this->table_name]) && isset($this->generated_columns[$this->table_name]['columns'])) { // get all the keys definition in the create table statement if any. // preg_match_all('/\s[^,]+?key\s[^(]+$\s(`.+?(?:$\|`))\s\),?/i', $create_table_statement, $key_definitions); // https://regex101.com/r/NEXaLy/1/ preg_match_all('/(?<![\S"\',])[^"\',]+?KEY\s[^(]+$\s(`.+?(?:$\|`))\s\)\s(?:,\|\))(?![\S"\',])/i', $create_table_statement, $key_definitions); $reversed_generated_columns = array_reverse((array) $this->generated_columns[$this->table_name]['columns']); foreach ((array) $reversed_generated_columns as $generated_column) { if (empty($generated_column)) continue; if (!isset($this->supported_generated_column_engines[strtolower($this->table_engine)])) $this->supported_generated_column_engines[strtolower($this->table_engine)] = UpdraftPlus_Database_Utility::is_generated_column_supported($this->table_engine); if ($generated_column_db_info = $this->supported_generated_column_engines[strtolower($this->table_engine)]) { $reversed_data_type_definition = array_reverse((array) $generated_column['column_data_type_definition']); foreach ($reversed_data_type_definition as $key => &$data_type_definition) { if (in_array($key, array('DATA_TYPE_TOKEN', 'GENERATED_ALWAYS_TOKEN', 'COMMENT_TOKEN'))) continue; // we dont want to replace "not null" in the "generated always as" expression, neither in the comments' string as well, so we continue if (empty($data_type_definition) \|\| 0 === strlen(trim($data_type_definition[0]))) continue; if (!$generated_column_db_info['is_not_null_supported']) { // If the database server doesn't support either null or not null constraint on generated virtual/stored/persistent column then the constraints need to be removed $replaced_data_type_definition = preg_replace('/\b(?:not\s+null\|null)\b/i', '', $data_type_definition[0]); $create_table_statement = substr_replace($create_table_statement, $replaced_data_type_definition, $data_type_definition[1], strlen($data_type_definition[0])); $data_type_definition[0] = $replaced_data_type_definition; } if (!$generated_column['is_virtual'] && !$generated_column_db_info['is_persistent_supported']) { // If the persistent type is not supported it likely means that the currently running db server is MySQL, Mariadb uses persistent as an alias for stored type so if the backup file is taken from MariaDB then it needs to be changed to stored $replaced_data_type_definition = preg_replace('/\bpersistent\b/i', 'STORED', $data_type_definition[0]); $create_table_statement = substr_replace($create_table_statement, $replaced_data_type_definition, $data_type_definition[1], strlen($data_type_definition[0])); $data_type_definition[0] = $replaced_data_type_definition; } } if ($generated_column['is_virtual'] && ($generated_column_db_info['can_insert_ignore_to_generated_column'] \|\| (isset($this->generated_columns_exist_in_the_statement[$this->table_name]) && false === $this->generated_columns_exist_in_the_statement[$this->table_name])) && !$generated_column_db_info['is_virtual_index_supported'] && !empty($key_definitions)) { // MySQL doesn't support index on MyISAM's virtual generated column, in case that the restoration process is importing from MariaDB backup file which contains create index definition on virtual generated column then it needs to be removed too // the column can be defined as a single or composite index, so we have no choice but loop until the end foreach ($key_definitions[1] as $array_index => $column_names) { if (empty($column_names)) continue; if (empty($key_definitions[0][$array_index])) continue; if (is_numeric(stripos($column_names, $generated_column['column_name']))) { $replaced_key_definition = preg_replace('/(\s,?[^,]+?key\s[^(]+$.?)(`'.$generated_column['column_name'].'`\s(?:\([0-9]+$\s)?,\|,\s`'.$generated_column['column_name'].'`\s(?:$[0-9]+$\s)?\|\s`'.$generated_column['column_name'].'`\s(?:$[0-9]+$\s)?)(.\))/ism', '$1$3', $key_definitions[0][$array_index]); $create_table_statement = str_ireplace($key_definitions[0][$array_index], $replaced_key_definition, $create_table_statement); $key_definitions[0][$array_index] = $replaced_key_definition; if (preg_match('/\s,?[^,]+?key\s[^(]+$\s$\s,?/i', $key_definitions[0][$array_index])) { $create_table_statement = preg_replace('/\s,?[^,]+?key\s+[^(]+$\s$\s/i', '', $create_table_statement); $key_definitions[0][$array_index] = ''; } } } } if (!$generated_column_db_info['can_insert_ignore_to_generated_column'] && isset($this->generated_columns_exist_in_the_statement[$this->table_name]) && true === $this->generated_columns_exist_in_the_statement[$this->table_name]) { foreach ($reversed_data_type_definition as $key => &$data_type_definition) { if (empty($data_type_definition) \|\| 0 === strlen(trim($data_type_definition[0]))) continue; if ('GENERATED_ALWAYS_TOKEN' === $key) { // if it's not possible to use insert ignore for the generated column even if the sql strict mode has been turned off then first we need to change the generated column to a normal/standard column $create_table_statement = substr_replace($create_table_statement, '', $data_type_definition[1], strlen($data_type_definition[0])); $data_type_definition[0] = ''; } elseif (!in_array($key, array('DATA_TYPE_TOKEN', 'COMMENT_TOKEN'))) { // since "comments" and "generated always as" could contain a string of these keywords (virtual/stored/persistent), so we can't use preg_replace and $generated_column['column_definition'] var as the subject to replace the keyword to an empty string, but instead we lookup the keyword through column_data_type_definition that has captured data type definitions $replaced_data_type_definition = preg_replace('/\b(?:virtual\|stored\|persistent)\b/i', '', $data_type_definition[0]); $create_table_statement = substr_replace($create_table_statement, $replaced_data_type_definition, $data_type_definition[1], strlen($data_type_definition[0])); $data_type_definition[0] = $replaced_data_type_definition; } } // once the create table and also the insert ignore statement for the corresponding table have been executed, we will use alter table statement to change back the columns to STORED type // this is the only way to avoid "value specified for generated column is not allowed" error, and I think it is the best we can do for now rather than checking the insert statement for virtual columns and replacing the value with DEFAULT } } else { // generated column is not supported but we found a virtual/stored/persistent column type, so it needs to be changed to a normal/standard column // we need to keep the generated column along with its single key index and composite key index so that the select statement on the upper layer of the application which selects the the virtual column does not break the application itself due to unknown column error $reversed_data_type_definition = array_reverse((array) $generated_column['column_data_type_definition']); foreach ($reversed_data_type_definition as $key => &$data_type_definition) { if (empty($data_type_definition) \|\| 0 === strlen(trim($data_type_definition[0]))) continue; if ('GENERATED_ALWAYS_TOKEN' === $key) { $create_table_statement = substr_replace($create_table_statement, '', $data_type_definition[1], strlen($data_type_definition[0])); $data_type_definition[0] = ''; } elseif (!in_array($key, array('DATA_TYPE_TOKEN', 'COMMENT_TOKEN'))) { $replaced_data_type_definition = preg_replace('/\b(?:virtual\|stored\|persistent)\b/i', '', $data_type_definition[0]); $create_table_statement = substr_replace($create_table_statement, $replaced_data_type_definition, $data_type_definition[1], strlen($data_type_definition[0])); $data_type_definition[0] = $replaced_data_type_definition; } } } } } $updraftplus->log($logline); $updraftplus->log($print_line, 'notice-restore'); // If this is a non wp table we don't want to replace our temp prefix with the final prefix, we need to drop our prefix if ($non_wp_table) { $this->original_table_name = UpdraftPlus_Manipulation_Functions::str_replace_once($this->import_table_prefix, '', $this->new_table_name); } else { $this->original_table_name = UpdraftPlus_Manipulation_Functions::str_replace_once($this->import_table_prefix, $this->final_import_table_prefix, $this->new_table_name); } $this->restoring_table = $this->new_table_name; if ($charset_change_message) $updraftplus->log($charset_change_message, 'notice-restore'); if ($constraint_change_message) $updraftplus->log($constraint_change_message, 'notice-restore'); if ($collate_change_message) $updraftplus->log($collate_change_message, 'notice-restore'); if ($engine_change_message) $updraftplus->log($engine_change_message, 'notice-restore'); return $create_table_statement; } /** * Callback function that will be triggered when the script execution ends. Reset log_bin_trust_function_creators variable's value to its original value / public function on_shutdown() { global $updraftplus; if (!empty($this->stored_routine_supported) && is_array($this->stored_routine_supported) && $this->stored_routine_supported['is_binary_logging_enabled']) { // if this condition is met, it means that db server binary logging is enabled and the value of the log_bin_trust_function_system_variable has previously been set to ON (1), and now the value must be changed back to what it originally was if (isset($this->continuation_data['old_log_bin_trust_function_creators'])) { $old_log_bin_trust_function_creators = $this->continuation_data['old_log_bin_trust_function_creators']; } else { $old_log_bin_trust_function_creators = $updraftplus->jobdata_get('old_log_bin_trust_function_creators'); } if (is_string($old_log_bin_trust_function_creators) && '' !== $old_log_bin_trust_function_creators) $this->set_log_bin_trust_function_creators($old_log_bin_trust_function_creators); } } /* * Restore the database backup * * @param string $working_dir specify working directory * @param string $working_dir_localpath specify working local directory * @param string $import_table_prefix table prefix to use * @return boolean\|WP_Error / private function restore_backup_db($working_dir, $working_dir_localpath, $import_table_prefix) { global $updraftplus; do_action('updraftplus_restore_db_pre'); // This is now a legacy option (at least on the front end), so we should not see it much $this->prior_upload_path = get_option('upload_path'); // There is a file backup.db(.gz) inside the working directory // The 'off' check is for badly configured setups - http://wordpress.org/support/topic/plugin-wp-super-cache-warning-php-safe-mode-enabled-but-safe-mode-is-off // @codingStandardsIgnoreLine if (@ini_get('safe_mode') && 'off' != strtolower(@ini_get('safe_mode'))) { $updraftplus->log(__('Warning: PHP safe_mode is active on your server.', 'updraftplus').' '.__('Timeouts are much more likely.', 'updraftplus').' '.__('If these happen, then you will need to manually restore the file via phpMyAdmin or another method.', 'updraftplus'), 'notice-restore'); } $db_basename = 'backup.db.gz'; if (!empty($this->ud_foreign)) { $plugins = apply_filters('updraftplus_accept_archivename', array()); if (empty($plugins[$this->ud_foreign])) return new WP_Error('unknown', sprintf(__('Backup created by unknown source (%s) - cannot be restored.', 'updraftplus'), $this->ud_foreign)); if (!file_exists($working_dir_localpath.'/'.$db_basename) && file_exists($working_dir_localpath.'/backup.db')) { $db_basename = 'backup.db'; } elseif (!file_exists($working_dir_localpath.'/'.$db_basename) && file_exists($working_dir_localpath.'/backup.db.bz2')) { $db_basename = 'backup.db.bz2'; } if (!file_exists($working_dir_localpath.'/'.$db_basename)) { $separatedb = empty($plugins[$this->ud_foreign]['separatedb']) ? false : true; $filtered_db_name = apply_filters('updraftplus_foreign_dbfilename', false, $this->ud_foreign, $this->ud_backup_set, $working_dir_localpath, $separatedb); if (is_string($filtered_db_name)) $db_basename = $filtered_db_name; } } // wp_filesystem has no gzopen method, so we switch to using the local filesystem (which is harmless, since we are performing read-only operations) if (false === $db_basename \|\| !is_readable($working_dir_localpath.'/'.$db_basename)) return new WP_Error('dbopen_failed', __('Failed to find database file', 'updraftplus')." ($working_dir/".$db_basename.")"); global $wpdb, $updraftplus; $this->skin->feedback($this->strings['restore_database']); $is_plain = ('.db' == substr($db_basename, -3, 3)); $is_bz2 = ('.db.bz2' == substr($db_basename, -7, 7)); // Read-only access: don't need to go through WP_Filesystem if ($is_plain) { $dbhandle = fopen($working_dir_localpath.'/'.$db_basename, 'r'); } elseif ($is_bz2) { if (!function_exists('bzopen')) { $updraftplus->log_e("Your web server's PHP installation has these functions disabled: %s.", 'bzopen'); $updraftplus->log_e('Your hosting company must enable these functions before %s can work.', __('restoration', 'updraftplus')); } $dbhandle = bzopen($working_dir_localpath.'/'.$db_basename, 'r'); } else { $dbhandle = gzopen($working_dir_localpath.'/'.$db_basename, 'r'); } if (!$dbhandle) return new WP_Error('dbopen_failed', __('Failed to open database file', 'updraftplus')); $this->line = 0; if ($this->use_wpdb()) { $updraftplus->log_e('Database access: Direct MySQL access is not available, so we are falling back to wpdb (this will be considerably slower)'); } else { $updraftplus->log("Using direct MySQL access; value of use_mysqli is: ".($this->use_mysqli ? '1' : '0')); if ($this->use_mysqli) { @mysqli_query($this->mysql_dbh, 'SET SESSION query_cache_type = OFF;');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } else { // @codingStandardsIgnoreLine @mysql_query('SET SESSION query_cache_type = OFF;', $this->mysql_dbh); } } UpdraftPlus_Database_Utility::set_sql_mode(array('NO_AUTO_VALUE_ON_ZERO'), array(), $this->use_wpdb() ? null : $this->mysql_dbh); // register restoration shutdown event so that we can set some mysql's global variable back to its original value register_shutdown_function(array($this, 'on_shutdown')); // Find the supported engines - in case the dump had something else (case seen: saved from MariaDB with engine Aria; imported into plain MySQL without) $supported_engines = array_change_key_case((array) $wpdb->get_results("SHOW ENGINES", OBJECT_K)); $supported_charsets = array_change_key_case((array) $wpdb->get_results("SHOW CHARACTER SET", OBJECT_K)); $supported_collations = array_change_key_case((array) $wpdb->get_results('SHOW COLLATION', OBJECT_K)); $this->table_engine = ''; $this->errors = 0; $this->statements_run = 0; $this->insert_statements_run = 0; $this->tables_created = 0; $sql_line = ""; $sql_type = -1; $this->start_time = microtime(true); $this->old_siteurl = ''; $this->old_home = ''; $this->old_content = ''; $this->old_uploads = ''; $this->old_table_prefix = (defined('UPDRAFTPLUS_OVERRIDE_IMPORT_PREFIX') && UPDRAFTPLUS_OVERRIDE_IMPORT_PREFIX) ? UPDRAFTPLUS_OVERRIDE_IMPORT_PREFIX : null; $this->old_siteinfo = array(); $gathering_siteinfo = true; $this->db_permissons_forbidden['create'] = false; $this->db_permissons_forbidden['drop'] = false; $this->db_permissons_forbidden['lock'] = false; $this->db_permissons_forbidden['rename'] = false; // This will get flipped if positive success is confirmed $this->db_permissons_forbidden['triggers'] = true; $this->last_error = ''; $random_table_name = 'updraft_tmp_'.rand(0, 9999999).md5(microtime(true)); $renamed_random_table_name = 'updraft_tmp_'.rand(0, 9999999).md5(microtime(true)); $last_created_generated_columns_table = ''; // The only purpose in funnelling queries directly here is to be able to get the error number if ($this->use_wpdb()) { $req = $wpdb->query("CREATE TABLE $random_table_name (test INT)"); // WPDB, for several query types, returns the number of rows changed; in distinction from an error, indicated by (bool)false if (0 === $req) $req = true; if (!$req) $this->last_error = $wpdb->last_error; $this->last_error_no = false; if ($req && false !== $wpdb->query("CREATE TRIGGER test_trigger BEFORE INSERT ON $random_table_name FOR EACH ROW SET @sum = @sum + NEW.test")) $this->db_permissons_forbidden['triggers'] = false; } else { if ($this->use_mysqli) { $req = mysqli_query($this->mysql_dbh, "CREATE TABLE $random_table_name (test INT)"); } else { // @codingStandardsIgnoreLine $req = mysql_unbuffered_query("CREATE TABLE $random_table_name (test INT)", $this->mysql_dbh); } if (!$req) { // @codingStandardsIgnoreLine $this->last_error = $this->use_mysqli ? mysqli_error($this->mysql_dbh) : mysql_error($this->mysql_dbh); // @codingStandardsIgnoreLine $this->last_error_no = $this->use_mysqli ? mysqli_errno($this->mysql_dbh) : mysql_errno($this->mysql_dbh); } else { if ($this->use_mysqli) { $reqtrigger = mysqli_query($this->mysql_dbh, "CREATE TRIGGER test_trigger BEFORE INSERT ON $random_table_name FOR EACH ROW SET @sum = @sum + NEW.test"); } else { // @codingStandardsIgnoreLine $reqtrigger = mysql_unbuffered_query("CREATE TRIGGER test_trigger BEFORE INSERT ON $random_table_name FOR EACH ROW SET @sum = @sum + NEW.test", $this->mysql_dbh); } if ($reqtrigger) $this->db_permissons_forbidden['triggers'] = false; } } if (!$req && ($this->use_wpdb() \|\| 1142 === $this->last_error_no)) { $this->db_permissons_forbidden['create'] = true; // If we can't create, then there's no point dropping $this->db_permissons_forbidden['drop'] = true; // abort dummy restore process if ($this->is_dummy_db_restore) { return new WP_Error('abort_dummy_restore', __('Your database user does not have permission to drop tables', 'updraftplus')); } $updraftplus->log(__('Your database user does not have permission to create tables.', 'updraftplus').' '.__('We will attempt to restore by simply emptying the tables; this should work as long as a) you are restoring from a WordPress version with the same database structure, and b) Your imported database does not contain any tables which are not already present on the importing site.', 'updraftplus'), 'warning-restore'); $updraftplus->log('Your database user does not have permission to create tables. We will attempt to restore by simply emptying the tables; this should work as long as a) you are restoring from a WordPress version with the same database structure, and b) Your imported database does not contain any tables which are not already present on the importing site.'); $updraftplus->log('Error was: '.$this->last_error.' ('.$this->last_error_no.')'); } else { if (1142 === $this->rename_table($random_table_name, $renamed_random_table_name)) { $this->db_permissons_forbidden['rename'] = true; $updraftplus->log('Database user has no permission to rename tables - restoration will be non-atomic', 'warning-restore'); } else { // We renamed the table so update the $random_table_name $random_table_name = $renamed_random_table_name; } if (1142 === $this->lock_table($random_table_name)) { $this->db_permissons_forbidden['lock'] = true; $updraftplus->log("Database user has no permission to lock tables - will not lock after CREATE", "warning-restore"); } if ($this->use_wpdb()) { $req = $wpdb->query("DROP TABLE $random_table_name"); // WPDB, for several query types, returns the number of rows changed; in distinction from an error, indicated by (bool)false if (0 === $req) { $req = true; } if (!$req) $this->last_error = $wpdb->last_error; $this->last_error_no = false; } else { if ($this->use_mysqli) { $req = mysqli_query($this->mysql_dbh, "DROP TABLE $random_table_name"); } else { // @codingStandardsIgnoreLine $req = mysql_unbuffered_query("DROP TABLE $random_table_name", $this->mysql_dbh); } if (!$req) { // @codingStandardsIgnoreLine $this->last_error = ($this->use_mysqli) ? mysqli_error($this->mysql_dbh) : mysql_error($this->mysql_dbh); // @codingStandardsIgnoreLine $this->last_error_no = ($this->use_mysqli) ? mysqli_errno($this->mysql_dbh) : mysql_errno($this->mysql_dbh); } } if (!$req && ($this->use_wpdb() \|\| 1142 === $this->last_error_no)) { $this->db_permissons_forbidden['drop'] = true; $this->db_permissons_forbidden['rename'] = true; // abort dummy restore process if ($this->is_dummy_db_restore) { return new WP_Error('abort_dummy_restore', __('Your database user does not have permission to drop tables', 'updraftplus')); } $updraftplus->log(sprintf('Your database user does not have permission to drop tables. We will attempt to restore by simply emptying the tables; this should work as long as you are restoring from a WordPress version with the same database structure (%s)', '('.$this->last_error.', '.$this->last_error_no.')')); $updraftplus->log(__('Your database user does not have permission to drop tables.', 'updraftplus').' '.sprintf(__('We will attempt to restore by simply emptying the tables; this should work as long as you are restoring from a WordPress version with the same database structure (%s)', 'updraftplus'), '('.$this->last_error.', '.$this->last_error_no.')'), 'warning-restore'); } } if (defined('UPDRAFTPLUS_ATOMIC_RESTORE_DISABLED') && UPDRAFTPLUS_ATOMIC_RESTORE_DISABLED) { $updraftplus->log('Atomic restore disabled by constant UPDRAFTPLUS_ATOMIC_RESTORE_DISABLED - restoration will be non-atomic', 'warning-restore'); $this->db_permissons_forbidden['rename'] = true; } // If this is not a dummy restore or not importing a single site into a multisite and we can rename and drop tables then change the import prefix and proceed with atomic restore if (empty($this->db_permissons_forbidden['rename']) && !$this->is_dummy_db_restore && !isset($this->restore_options['updraftplus_migrate_blogname']) && empty($this->ud_foreign)) { add_filter('updraftplus_restore_table_prefix', array($this, 'updraftplus_random_restore_table_prefix')); $import_table_prefix = isset($this->continuation_data['temp_import_table_prefix']) ? $this->continuation_data['temp_import_table_prefix'] : apply_filters('updraftplus_restore_table_prefix', $this->final_import_table_prefix); $this->import_table_prefix = $import_table_prefix; $updraftplus->jobdata_set('temp_import_table_prefix', $this->import_table_prefix); } else { $this->db_permissons_forbidden['rename'] = true; } $this->restoring_table = ''; $this->max_allowed_packet = $updraftplus->max_packet_size(); $updraftplus->log('Entering maintenance mode'); $this->maintenance_mode(true); $delimiter = ';'; $delimiter_regex = ';'; $virtual_columns_exist = false; $old_log_bin_trust_function_creators = null; if (is_null($this->stored_routine_supported)) $this->stored_routine_supported = UpdraftPlus_Database_Utility::is_stored_routine_supported(); if (is_wp_error($this->stored_routine_supported)) $updraftplus->log('is_stored_routine_supported(): '.$this->stored_routine_supported->get_error_message()); // N.B. There is no such function as bzeof() - we have to detect that another way while (($is_plain && !feof($dbhandle)) \|\| (!$is_plain && (($is_bz2) \|\| (!$is_bz2 && !gzeof($dbhandle))))) { // Up to 1Mb if ($is_plain) { $buffer = rtrim(fgets($dbhandle, 1048576)); } elseif ($is_bz2) { if (!isset($bz2_buffer)) $bz2_buffer = '';// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UndefinedVariable -- The variable is defined after check. $buffer = ''; if (strlen($bz2_buffer) < 524288) $bz2_buffer .= bzread($dbhandle, 1048576); if (bzerrno($dbhandle) !== 0) { $updraftplus->log("bz2 error: ".bzerrstr($dbhandle)." (code: ".bzerrno($dbhandle).")"); break; } if (false !== $bz2_buffer && '' !== $bz2_buffer) { if (false !== ($p = strpos($bz2_buffer, "\n"))) { $buffer .= substr($bz2_buffer, 0, $p+1); $bz2_buffer = substr($bz2_buffer, $p+1); } else { $buffer .= $bz2_buffer; $bz2_buffer = ''; } } else { break; } $buffer = rtrim($buffer); } else { $buffer = rtrim(gzgets($dbhandle, 1048576)); } // Discard comments if (empty($buffer) \|\| '#' == substr($buffer, 0, 1) \|\| preg_match('/^--(\s\|$)/', substr($buffer, 0, 3))) { if ('' == $this->old_siteurl && preg_match('/^\# Backup of: (http(.))$/', $buffer, $matches)) { $this->old_siteurl = untrailingslashit($matches[1]); $updraftplus->log("Backup of: ".$this->old_siteurl); $updraftplus->log(sprintf(__('Backup of: %s', 'updraftplus'), $this->old_siteurl), 'notice-restore', 'backup-of'); do_action('updraftplus_restore_db_record_old_siteurl', $this->old_siteurl); $this->save_configuration_bundle(); } elseif (false === $this->created_by_version && preg_match('/^\# Created by UpdraftPlus version ([\d\.]+)/', $buffer, $matches)) { $this->created_by_version = trim($matches[1]); $updraftplus->log(__('Backup created by:', 'updraftplus').' '.$this->created_by_version, 'notice-restore', 'created-by'); $updraftplus->log('Backup created by: '.$this->created_by_version); } elseif ('' == $this->old_home && preg_match('/^\# Home URL: (http(.))$/', $buffer, $matches)) { $this->old_home = untrailingslashit($matches[1]); if ($this->old_siteurl && $this->old_home != $this->old_siteurl) { $updraftplus->log(__('Site home:', 'updraftplus').' '.$this->old_home, 'notice-restore', 'site-home'); $updraftplus->log('Site home: '.$this->old_home); } do_action('updraftplus_restore_db_record_old_home', $this->old_home); } elseif ('' == $this->old_content && preg_match('/^\# Content URL: (http(.))$/', $buffer, $matches)) { $this->old_content = untrailingslashit($matches[1]); $updraftplus->log(__('Content URL:', 'updraftplus').' '.$this->old_content, 'notice-restore', 'content-url'); $updraftplus->log('Content URL: '.$this->old_content); do_action('updraftplus_restore_db_record_old_content', $this->old_content); } elseif ('' == $this->old_uploads && preg_match('/^\# Uploads URL: (http(.))$/', $buffer, $matches)) { $this->old_uploads = untrailingslashit($matches[1]); $updraftplus->log(__('Uploads URL:', 'updraftplus').' '.$this->old_uploads, 'notice-restore', 'uploads-url'); $updraftplus->log('Uploads URL: '.$this->old_uploads); do_action('updraftplus_restore_db_record_old_uploads', $this->old_uploads); } elseif (null === $this->old_table_prefix && (preg_match('/^\# Table prefix: ?(\S)$/', $buffer, $matches) \|\| preg_match('/^-- Table Prefix: ?(\S)$/i', $buffer, $matches))) { // We also support backwpup style: // -- Table Prefix: wp_ $this->old_table_prefix = $matches[1]; $updraftplus->log(__('Old table prefix:', 'updraftplus').' '.$this->old_table_prefix, 'notice-restore', 'old-table-prefix'); $updraftplus->log("Old table prefix: ".$this->old_table_prefix); } elseif (preg_match('/^\# Skipped tables: (.)$/', $buffer, $matches)) { $updraftplus->log(__('Skipped tables:', 'updraftplus').' '.$matches[1], 'notice-restore', 'skipped-tables'); $updraftplus->log("Skipped tables: ".$matches[1]); } elseif ($gathering_siteinfo && preg_match('/^\# Site info: (\S+)$/', $buffer, $matches)) { if ('end' == $matches[1]) { $gathering_siteinfo = false; // Sanity checks if (isset($this->old_siteinfo['multisite']) && !$this->old_siteinfo['multisite'] && is_multisite()) { if (!class_exists('UpdraftPlusAddOn_MultiSite') \|\| !class_exists('UpdraftPlus_Addons_Migrator')) { return new WP_Error('missing_addons', sprintf(__('To import an ordinary WordPress site into a multisite installation requires %s.', 'updraftplus'), 'UpdraftPlus Premium')); } } } elseif (preg_match('/^([^=]+)=(.)$/', $matches[1], $kvmatches)) { $key = $kvmatches[1]; $val = $kvmatches[2]; $updraftplus->log(__('Site information:', 'updraftplus')." $key = $val", 'notice-restore', 'site-information'); $updraftplus->log("Site information: $key=$val"); if ('multisite_data' == $key) { $this->old_siteinfo[$key] = json_decode($val, true); } else { $this->old_siteinfo[$key] = $val; } if ('multisite' == $key) { $this->ud_backup_is_multisite = ($val) ? 1 : 0; } } } elseif ('' == $this->old_abspath && preg_match('/^\# ABSPATH: ?(.)$/', $buffer, $matches)) { if (ABSPATH != $matches[1] && '/' != $matches[1]) { $this->old_abspath = $matches[1]; $updraftplus->log(__('Old ABSPATH:', 'updraftplus').' '.$this->old_abspath, 'notice-restore', 'old-abspath'); $updraftplus->log("Old ABSPATH: {$this->old_abspath}"); do_action('updraftplus_restore_db_record_old_abspath', $this->old_abspath); } } elseif ('' == $this->old_updraftplus_plugin_slug && preg_match('/^\# UpdraftPlus plugin slug: ?(.)$/', $buffer, $matches)) { $this->old_updraftplus_plugin_slug = $matches[1]; $updraftplus->log(__('UpdraftPlus plugin slug:', 'updraftplus').' '.$this->old_updraftplus_plugin_slug, 'notice-restore', 'old-updraftplus-plugin-slug'); $updraftplus->log("UpdraftPlus plugin slug: {$this->old_updraftplus_plugin_slug}"); } continue; } // Detect INSERT and various other commands early, so that we can split or combine them if necessary if (preg_match('/^\s(insert\s\sinto(?:\s`(.+?)`\|[^$]+)(?:\s\(.+?$)?\s(?:values\|\())/i', $sql_line.$buffer, $matches)) { // https://regex101.com/r/zrQquQ/2 $this->table_name = $matches[2]; $sql_type = 3; $insert_prefix = $matches[1]; // if the current table is a generated columns table, that means at this stage the table creation is being postponed and the block of code below will get executed first to filter the create statement if (!empty($this->generated_columns[$this->table_name])) { // parse the generated columns insert statement so that later we can instantly retrieve the information needed when creating the table $this->generated_columns_exist_in_the_statement[$this->table_name] = UpdraftPlus_Database_Utility::generated_columns_exist_in_the_statement($sql_line.$buffer, $this->generated_columns[$this->table_name]['column_names']); if ($this->table_name != $last_created_generated_columns_table) { $create_statement = $this->prepare_create_table($this->generated_columns[$this->table_name]['create_statement'], $import_table_prefix, $supported_engines, $supported_charsets, $supported_collations); // after getting the filtered create statement, continue with the table creation $do_exec = $this->sql_exec($create_statement, 2, $import_table_prefix); $last_created_generated_columns_table = $this->table_name; if (is_wp_error($do_exec)) return $do_exec; } // on MySQL 5.7.x, we could get an error "the value specified for generated column is not allowed", disabling strict mode doesn't work, adding insert ignore doesn't work either // disabling strict mode works fine on MariaDB, it may be good if we can strengthen the insert statement by adding ignore keyword into it $sql_line = preg_replace('/^(\sinsert\s\sinto)(.+)$/is', 'insert ignore into$2', $sql_line); $insert_prefix = preg_replace('/^(\sinsert\s\sinto)(.+)$/is', 'insert ignore into$2', $matches[0]); } } elseif (preg_match('/^\sdelimiter (\S+)\s$/i', $sql_line.$buffer, $matches)) { // This also needs processing early so that the correct delimiter is used a few lines down $sql_type = 10; $delimiter = $matches[1]; // Obviously, what is supported here is quite limited $delimiter_regex = str_replace(array('$', '#', '/'), array('\$', '\#', '\/'), $delimiter); } elseif (preg_match('/^\screate trigger /i', $sql_line.$buffer)) { $sql_type = 9; $buffer = $buffer."\n"; } elseif (preg_match("/^\sCREATE\s\s(?:DEFINER\s=\s(?:`.{1,17}`@`[^\s]+`\s\|'.{1,17}'@'[^\s]+'\s\|[^\s]+?\s))?(?:AGGREGATE\s\s)?(?:PROCEDURE\|FUNCTION)((?:\s\s[^\(`]+\|\s`(?:[^`]\|``)+`))\s\(/is", $sql_line.$buffer)) { $sql_type = 12; $buffer = $buffer."\n"; // need to do this so that the functions/procedures which have double dash and/or shell comment style (i.e -- comment, # comment) doesn't block the rest of the code in the routines body and also because we want to keep the routines as it is or in multiline (in a form that people prefer) so they who will edit it later don't get surprised by the look of it in a single line/one line } elseif (preg_match('/^\screate table \`?([^\`\(])\`?\s\(/i', $sql_line.$buffer, $matches)) { $sql_type = 2; $this->table_name = $matches[1]; // check whether the column definition is a generated column $generated_column_info = UpdraftPlus_Database_Utility::get_generated_column_info($buffer, strlen($sql_line)); if ($generated_column_info) { if (!isset($this->generated_columns[$this->table_name])) $this->generated_columns[$this->table_name] = array(); if (!$virtual_columns_exist) $virtual_columns_exist = $generated_column_info['is_virtual']; $this->generated_columns[$this->table_name]['columns'][] = $generated_column_info; $this->generated_columns[$this->table_name]['column_names'][] = $generated_column_info['column_name']; } if (!empty($this->generated_columns[$this->table_name]) && substr($sql_line.$buffer, -strlen($delimiter), strlen($delimiter)) == $delimiter) { $this->generated_columns[$this->table_name]['create_statement'] = $sql_line.$buffer; $this->generated_columns[$this->table_name]['virtual_columns_exist'] = $virtual_columns_exist; $virtual_columns_exist = false; } } // Deal with case where adding this line will take us over the MySQL max_allowed_packet limit - must split, if we can (if it looks like consecutive rows) // Allow a 100-byte margin for error (including searching/replacing table prefix) if (3 == $sql_type && $sql_line && strlen($sql_line.$buffer) > ($this->max_allowed_packet - 100) && preg_match('/,\s$/', $sql_line) && preg_match('/^\s\(/', $buffer)) { if ($this->table_should_be_skipped($this->table_name)) { // Reset - we need the insert prefix so following lines get detected correctly $sql_line = $insert_prefix." "; continue; } // Remove the final comma; replace with delimiter $sql_line = substr(rtrim($sql_line), 0, strlen($sql_line)-1).';'; if ($import_table_prefix != $this->old_table_prefix) { if ('' != $this->old_table_prefix) { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $sql_line); } else { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->table_name, $this->table_prefix.$this->table_name, $sql_line); } } // Run the SQL command; then set up for the next one. $this->line++; $updraftplus->log(__("Split line to avoid exceeding maximum packet size", 'updraftplus')." (".strlen($sql_line)." + ".strlen($buffer)." : ".$this->max_allowed_packet.")", 'notice-restore'); $updraftplus->log("Split line to avoid exceeding maximum packet size (".strlen($sql_line)." + ".strlen($buffer)." : ".$this->max_allowed_packet.")"); $do_exec = $this->sql_exec($sql_line, $sql_type, $import_table_prefix); if (is_wp_error($do_exec)) return $do_exec; // Reset, then carry on $sql_line = $insert_prefix." "; } $sql_line .= (9 == $sql_type && '' != $sql_line) ? ' '.$buffer : $buffer; // Do we have a complete line yet? We used to just test the final character for ';' here (up to 1.8.12), but that was too unsophisticated // From 1.16.16, we don't hard-code the delimiter here, and we also add the knowledge that CREATE TRIGGER statements finish with END // The aim, in order to get something valid to execute, is to get something like this, with the entire trigger on a single line: // // $wpdb->query("CREATE TRIGGER `civicrm_acl_after_insert` AFTER INSERT ON `civicrm_acl` FOR EACH ROW BEGIN IF (@civicrm_disable_logging IS NULL OR @civicrm_disable_logging = 0 ) THEN INSERT INTO log_civicrm_acl (`id`, `name`, `deny`, `entity_table`, `entity_id`, `operation`, `object_table`, `object_id`, `acl_table`, `acl_id`, `is_active`, log_conn_id, log_user_id, log_action) VALUES ( NEW.`id`, NEW.`name`, NEW.`deny`, NEW.`entity_table`, NEW.`entity_id`, NEW.`operation`, NEW.`object_table`, NEW.`object_id`, NEW.`acl_table`, NEW.`acl_id`, NEW.`is_active`, COALESCE(@uniqueID, LEFT(CONCAT('c_', unix_timestamp()/3600, CONNECTION_ID()), 17)), @civicrm_user_id, 'insert'); END IF; END")); if ((3 == $sql_type && !preg_match('/\)\s'.$delimiter_regex.'$/', substr($sql_line, -5, 5))) \|\| (!in_array($sql_type, array(3, 9, 10, 12)) && substr($sql_line, -strlen($delimiter), strlen($delimiter)) != $delimiter) \|\| (9 == $sql_type && !preg_match('/(?:END)?\s'.$delimiter_regex.'\s$/', $sql_line))) continue; $this->line++; // We now have a complete line - process it if (3 == $sql_type && $sql_line && strlen($sql_line) > $this->max_allowed_packet) { $this->log_oversized_packet($sql_line); // Reset $sql_line = ''; $sql_type = -1; // If this is the very first SQL line of the options table, we need to bail; it's essential if (0 == $this->insert_statements_run && $this->restoring_table && $this->restoring_table == $import_table_prefix.'options') { $updraftplus->log("Leaving maintenance mode"); $this->maintenance_mode(false); return new WP_Error('initial_db_error', sprintf(__('An error occurred on the first %s command - aborting run', 'updraftplus'), 'INSERT (options)')); } continue; } // The timed overhead of this is negligible if (preg_match('/^\sdrop view (if exists )?\`?([^\`])\`?\s'.$delimiter_regex.'/i', $sql_line, $matches)) { $sql_type = 16; $this->view_names[] = $matches[2]; $this->view_names = array_unique($this->view_names); } elseif (preg_match('/^\sdrop table (if exists )?\`?([^\`])\`?\s'.$delimiter_regex.'/i', $sql_line, $matches)) { $sql_type = 1; if (!$this->printed_new_table_prefix) { $import_table_prefix = $this->pre_sql_actions($import_table_prefix); if (false === $import_table_prefix \|\| is_wp_error($import_table_prefix)) return $import_table_prefix; $this->printed_new_table_prefix = true; } $this->table_name = $matches[2]; if ($this->table_should_be_skipped($this->table_name)) { // Reset $sql_line = ''; $sql_type = -1; continue; } // Legacy, less reliable - in case it was not caught before if (null === $this->old_table_prefix && preg_match('/^([a-z0-9]+)_.$/i', $this->table_name, $tmatches)) { $this->old_table_prefix = $tmatches[1].'_'; $updraftplus->log(__('Old table prefix:', 'updraftplus').' '.$this->old_table_prefix, 'notice-restore', 'old-table-prefix'); $updraftplus->log("Old table prefix (detected from first table): ".$this->old_table_prefix); } $this->new_table_name = $this->old_table_prefix ? UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $this->table_name) : $this->table_name; $non_wp_table = false; // if we have a different prefix but the table name has not changed after the replace then we are dealing with a table that does not use the WordPress table prefix, in order for an Atomic restore to work on this table we need to attach our temporary prefix if (empty($this->db_permissons_forbidden['rename']) && $this->old_table_prefix && $this->new_table_name == $this->table_name) { $non_wp_table = true; $this->new_table_name = $import_table_prefix.$this->table_name; } if ($import_table_prefix != $this->old_table_prefix) { if ('' === $this->old_table_prefix \|\| $non_wp_table) { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->table_name, $this->new_table_name, $sql_line); } else { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $sql_line); } } if (empty($matches[1])) { // Seen with some foreign backups $sql_line = preg_replace('/drop table/i', 'drop table if exists', $sql_line, 1); } $this->tables_been_dropped[] = $this->new_table_name; } elseif (preg_match('/^\screate table \`?([^\`$])\`?\s\(/i', $sql_line, $matches)) { $sql_type = 2; $this->insert_statements_run = 0; $this->table_name = $matches[1]; // regardless of whether or not the table should be skipped, the table creation should also be postponed if the table contains one or more generated columns if ($this->table_should_be_skipped($this->table_name) \|\| !empty($this->generated_columns[$this->table_name])) { // Reset $sql_line = ''; $sql_type = -1; continue; } if (!$this->printed_new_table_prefix) { $import_table_prefix = $this->pre_sql_actions($import_table_prefix); if (false === $import_table_prefix \|\| is_wp_error($import_table_prefix)) return $import_table_prefix; $this->printed_new_table_prefix = true; } $sql_line = $this->prepare_create_table($sql_line, $import_table_prefix, $supported_engines, $supported_charsets, $supported_collations); } elseif (preg_match('/^\sinsert(?:\s\signore)?\s\sinto(?:\s`(.+?)`\|[^\(]+)(?:\s\(.+?$)?\s(?:values\|\()/i', $sql_line, $matches)) { $sql_type = 3; $this->table_name = $matches[1]; if ($this->table_should_be_skipped($this->table_name)) { // Reset $sql_line = ''; $sql_type = -1; continue; } $non_wp_table = false; $this->new_table_name = $this->old_table_prefix ? UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $this->table_name) : $this->table_name; // if we have a different prefix but the table name has not changed after the replace then we are dealing with a table that does not use the WordPress table prefix, in order for an Atomic restore to work on this table we need to attach our temporary prefix if (empty($this->db_permissons_forbidden['rename']) && $this->old_table_prefix && $this->new_table_name == $this->table_name) { $non_wp_table = true; $this->new_table_name = $import_table_prefix.$this->table_name; } // If this is set then we have disabled atomic restores for this table so we need to make sure we are using the correct prefix when inserting the data $temp_insert_table_prefix = $this->disable_atomic_on_current_table ? $this->final_import_table_prefix : $import_table_prefix; if ($temp_insert_table_prefix != $this->old_table_prefix) { if ('' === $this->old_table_prefix \|\| $non_wp_table) { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->table_name, $this->new_table_name, $sql_line); } else { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $temp_insert_table_prefix, $sql_line); } } } elseif (preg_match('/^\s(\/\\!40000 )?(alter\|lock) tables? \`?([^\`\(])\`?\s+(write\|disable\|enable)/i', $sql_line, $matches)) { // Only binary mysqldump produces this pattern (LOCK TABLES `table` WRITE, ALTER TABLE `table` (DISABLE\|ENABLE) KEYS) $sql_type = 4; if (!empty($matches[3]) && $this->table_should_be_skipped($matches[3])) { // Reset $sql_line = ''; $sql_type = -1; continue; } $temp_insert_table_prefix = $this->disable_atomic_on_current_table ? $this->final_import_table_prefix : $import_table_prefix; if ($temp_insert_table_prefix != $this->old_table_prefix) { if ('' === $this->old_table_prefix \|\| $non_wp_table) { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->table_name, $this->new_table_name, $sql_line); } else { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $temp_insert_table_prefix, $sql_line); } } } elseif (preg_match('/^(un)?lock tables/i', $sql_line)) { // BackWPup produces these $sql_type = 15; } elseif (preg_match('/^(create\|drop) database /i', $sql_line)) { // WPB2D produces these, as do some phpMyAdmin dumps $sql_type = 6; } elseif (preg_match('/^use /i', $sql_line)) { // WPB2D produces these, as do some phpMyAdmin dumps $sql_type = 7; } elseif (preg_match('#^\s/\\!40\d+ (SET NAMES) (.)\\/#i', $sql_line, $smatches)) { $sql_type = 8; $charset = rtrim($smatches[2]); $connection_charset = $updraftplus->get_connection_charset(); if ('utf8' === $charset && 'utf8mb4' === $connection_charset) { $sql_line = UpdraftPlus_Manipulation_Functions::str_lreplace("SET NAMES $charset", "SET NAMES $connection_charset", $sql_line); $updraftplus->log(sprintf(__('Found SET NAMES %s, but changing to %s as suggested by WPDB::determine_charset().', 'updraftplus'), $charset, $connection_charset), 'notice-restore'); $charset = $connection_charset; } $this->set_names = $charset; if (!isset($supported_charsets[strtolower($charset)])) { $sql_line = UpdraftPlus_Manipulation_Functions::str_lreplace($smatches[1]." ".$charset, "SET NAMES ".$this->restore_options['updraft_restorer_charset'], $sql_line); $updraftplus->log('SET NAMES: '.sprintf(__('Requested character set (%s) is not present - changing to %s.', 'updraftplus'), esc_html($charset), esc_html($this->restore_options['updraft_restorer_charset'])), 'notice-restore'); } } elseif (preg_match('/^\screate trigger /i', $sql_line)) { $sql_type = 9; // If the statement is not yet complete, then continue (to get the next line) if (!preg_match('/(?:END)?\s'.$delimiter_regex.'\s$/', $sql_line)) continue; // If it's a comment then continue; if (preg_match('/(?:--\|#).+?'.$delimiter_regex.'\s$/i', $buffer)) continue; $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'db', 'data' => array('stage' => 'trigger', 'table' => ''))); if ($import_table_prefix != $this->old_table_prefix) { if ('' != $this->old_table_prefix) { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, $import_table_prefix, $sql_line); } else { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once($this->table_name, $this->new_table_name, $sql_line); } } if (';' !== $delimiter) { $sql_line = preg_replace('/END\s'.$delimiter_regex.'\s$/', 'END', $sql_line); // handle trigger statement which doesn't include begin and end in the trigger body, and remove the delimiter $sql_line = preg_replace('/\s'.$delimiter_regex.'\s$/', '', $sql_line); } if (!empty($this->db_permissons_forbidden['triggers'])) $updraftplus->log("Database user lacks permission to create triggers; statement will not be executed ($sql_line)"); } elseif (preg_match('/^\sdrop trigger /i', $sql_line)) { // Avoid sending unrecognised delimiters to the SQL server (this only affects backups created outside UD; we use ";;" which is cunningly compatible) if (';' !== $delimiter) $sql_line = preg_replace('/'.$delimiter_regex.'\s$/', '', $sql_line); } elseif (preg_match("/^\sCREATE\s\s(?:OR\s\sREPLACE\s\s)?(?:DEFINER\s=\s(?:`.{1,17}`@`[^\s]+`\s\|'.{1,17}'@'[^\s]+'\s\|[^\s]+?\s))?(?:AGGREGATE\s\s)?(?:PROCEDURE\|FUNCTION)((?:\s\s[^\(`]+\|\s`(?:[^`]\|``)+`))\s\(/is", $sql_line, $routine_matches)) { // ^\screate\s\s(?:or\s\sreplace\s\s)?.?(?:(?:aggregate\s\s)?function\|procedure)\s\s`(.+)`(?:\s\sif\s\snot\s\sexists\s\|\s)?\( // ^[^'\"]create[^'\"](?:function(?:\s\sif\s\snot\s\sexists)?\|procedure)\s`([^\r\n]+)` $sql_type = 12; // it's possible that a routine doesn't have BEGIN and END statements in its routine body, unfortunately sometimes it does have the statement separator (;) at the end of the routine statement but sometimes it doesn't // if it has the statement separator (;) then we add the statement separator into the regex and the preceding delimiter, if it doesn't have statement separator then check only the delimiter if (!preg_match('/END\s(?:\\/)?'.$delimiter_regex.'\s$/is', rtrim($sql_line)) && !preg_match('/\;\s'.$delimiter_regex.'\s$/is', rtrim($sql_line)) && !preg_match('/\s(?:\\/)?'.$delimiter_regex.'\s$/is', rtrim($sql_line))) continue; // if it's already at the end of the statement check whether it's a comment or not (e.g. SET @VARIABLE = 'the value'; -- the comment END;; or SET @VARIABLE = 'the value'; # the comment END;;;) if (preg_match('/(?:--\|#).+?END\s'.$delimiter_regex.'\s$/i', rtrim($sql_line)) && preg_match('/(?:--\|#).+?'.$delimiter_regex.'\s$/i', rtrim($sql_line))) continue; if (is_array($this->stored_routine_supported) && !empty($this->stored_routine_supported) && !is_wp_error($old_log_bin_trust_function_creators)) { $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'db', 'data' => array('stage' => 'stored_routine', 'routine_name' => preg_replace('/^`?(.+?)`?$/i', "$1", trim(str_replace('``', '`', $routine_matches[1])))))); if ($this->stored_routine_supported['is_binary_logging_enabled'] && !$this->stored_routine_supported['is_function_creators_trusted'] && !isset($this->continuation_data['old_log_bin_trust_function_creators']) && is_null($old_log_bin_trust_function_creators)) { // it's a new restoration // no matter what the database server is and the privileges the current DB user has, if the binary logging is enabled, log_bin_trust_function_creators is set to off and DB current, we could end up getting the below error when restoring routines // ERROR 1418 (HY000): This function has none of DETERMINISTIC, NO SQL, or READS SQL DATA in its declaration and binary logging is enabled (you might* want to use the less safe log_bin_trust_function_creators variable) // we need to set the log_bin_trust_function_creators "ON" so that the db server will treat all functions as deterministic safe functions. // https://mariadb.com/kb/en/library/binary-logging-of-stored-routines/ // https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html // if the DB current user is a non super admin, binary logging is enabled and log_bin_trust_function_creators is set to OFF/0 it will produce this error "(You do not have the SUPER privilege and binary logging is enabled (you might want to use the less safe log_bin_trust_function_creators variable)" // the log_bin_trust_function_creators variable is a global variable that should only be changed with caution because other plugins may also use it for some purpose, this can lead to an inaccurate value of log_bin_trust_function_creators especially if the restoration failed and the resumption could not be triggered $old_log_bin_trust_function_creators = $this->set_log_bin_trust_function_creators('ON'); if (is_wp_error($old_log_bin_trust_function_creators)) { $updraftplus->log('set_log_bin_trust_function_creators(ON): '.$old_log_bin_trust_function_creators); } else { $updraftplus->log('log_bin_trust_function_creators value has been set to: ON'); // we also need to store the original value of the log_bin_trust_function_creator variable to UDP jobdata so that if something goes wrong in the restoration, we're still able in a earlier time to set this global variable back to what it was (register_shutdown_function seems to be the good one) $updraftplus->jobdata_set('old_log_bin_trust_function_creators', $old_log_bin_trust_function_creators); $updraftplus->log('The original value of log_bin_trust_function_creators variable has been successfully added to UDP jobdata'); } } elseif ($this->stored_routine_supported['is_binary_logging_enabled'] && !$this->stored_routine_supported['is_function_creators_trusted'] && is_null($old_log_bin_trust_function_creators) && isset($this->continuation_data['old_log_bin_trust_function_creators'])) { // it's a resumption of the previous run, it can be recognised from the existence of old_log_bin_trust_function_creators index in $continuation_data variable $old_log_bin_trust_function_creators = $this->continuation_data['old_log_bin_trust_function_creators']; $updraftplus->log('Running a resumption from the previous restoration'); $this->set_log_bin_trust_function_creators('ON'); $updraftplus->log('log_bin_trust_function_creators value has been set to: ON'); } // the routine's definer in the backup file could be different with the user and host on the targeted restore site, so we need to replace the user and host information for the definer option with the current user account or remove the DEFINER clause and let the system use the default value (which is current user) // replace the user and host with db_user and db_host // $sql_line = preg_replace("/^([^'\"]create[^'\"]definer\s=\s)(?:`.{1,17}`@`[^\s]+`\|'.{1,17}'@'[^\s]+')(.+?(?:function(?:\s\sif\s\snot\s\sexists)?\|procedure)\s`)/is", "$1`".DB_USER."`@`".DB_HOST."`$2", $sql_line); // remove the DEFINER clause $sql_line = preg_replace("/^\s(CREATE(?:\s\sOR\s\sREPLACE)?)\s\sDEFINER\s=\s(?:`.{1,17}`@`[^\s]+`\s\|'.{1,17}'@'[^\s]+'\s\|[^\s]+?\s)((?:AGGREGATE\s\s)?(?:PROCEDURE\|FUNCTION))/is", "$1 $2", $sql_line); if (preg_match('/^\sCREATE(?:\s\sOR\s\sREPLACE)?\s\s(?:DEFINER\s=\s(?:`.{1,17}`@`[^\s]+`\s\|\'.{1,17}\'@\'[^\s]+\'\s\|[^\s]+?\s))?PROCEDURE(?:\s`(?:[^`]\|``)+`\s\|\s[^$]+)(?\'params\'(?:[^()]+\|\((?1)$))(?:(.?)COMMENT\s\s\'[^\']+\'\|COMMENT\s\s\'[^\']+\'(.?)\|(.?))(?:(.?)BEGIN\|([^\'"]+))/is', $sql_line, $sql_security_matches, PREG_OFFSET_CAPTURE) \|\| preg_match('/^\sCREATE(?:\s\sOR\s\sREPLACE)?\s\s(?:DEFINER\s=\s(?:`.{1,17}`@`[^\s]+`\s\|\'.{1,17}\'@\'[^\s]+\'\s\|[^\s]+?\s))?(?:AGGREGATE\s\s)?FUNCTION(?:\s`(?:[^`]\|``)+`\s\|\s[^$]+)(?\'params\'(?:[^()]+\|\((?1)$))\sRETURNS\s[\w]+(?:$.?$)?\s(?:CHARSET\s\s[^\s]+\s\s)?(?:COLLATE\s\s[^\s]+\s\s)?(?:(.?)COMMENT\s\s\'[^\']+\'\|COMMENT\s\s\'[^\']+\'(.?)\|(.?))(?:(.?)BEGIN\|(.?)RETURN)/is', $sql_line, $sql_security_matches, PREG_OFFSET_CAPTURE)) { // replace SQL SECURITY DEFINER and add SQL SECURITY INVOKER $is_last_index_replaced = false; $sql_security_matches = array_reverse($sql_security_matches); foreach ($sql_security_matches as $key => $match) { if ((int) $match[1] <= 0 \|\| 'params' === $key) continue; $length = strlen($match[0]); $match[0] = preg_replace('/SQL\s\sSECURITY\s\s(?:DEFINER\|INVOKER)/is', ' ', $match[0]); if (!$is_last_index_replaced) { // $match[0] .= ' SQL SECURITY INVOKER '; $match[0] = ' SQL SECURITY INVOKER ' . $match[0]; $is_last_index_replaced = true; } $sql_line = substr_replace($sql_line, $match[0], $match[1], max(0, $length)); } } // there could be a text/varchar variable declaration in the routine body in which the charset is also being specified in it, this could lead to an error when restoring the routine because of unsupported charset. for example, the declaration for a varchar/text variable in the routine body or the function parameter with the uf8mb4 charset defined but the running DB doesn't support utf8mb4 // to handle this we first check the routine creation statement and collect all the variable declarations which in relation with text/char variables that contain charset specification and then replace or remove the charset if necessary /* e.g: create procedure `test`(_user_id varchar(50) CHARSET utf8, _user_passwd varchar(255) CHARSET utf8, success_text text CHARSET utf8mb4, failure_text text CHARSET utf8) begin declare insert_status int default 0; declare _user_id varchar(2049) CHARSET utf8; declare _password varchar(255) CHARSET utf8mb4; declare _parent_nid bigint; declare _uid bigint; declare _node varchar(255) CHARSET utf8mb4; end ;; / if (preg_match_all('/(\s(?:long\|medium\|tiny)?text\s(?:$[0-9]+$)?\|\s(?:var)?char\s(?:$[0-9]+$)?).?charset\s([^;,\)\s]+).?(?:,\|;\|\))/is', $sql_line, $charset_matches)) { foreach ((array) $charset_matches[2] as $key => $charset) { $replaced_charset_declaration = $charset_matches[0][$key]; if (!empty($charset) && !isset($supported_charsets[strtolower(trim($charset))])) { $replaced_charset_declaration = !empty($this->restore_options['updraft_restorer_charset']) ? str_ireplace($charset, $this->restore_options['updraft_restorer_charset'], $replaced_charset_declaration) : str_ireplace(array('charset', $charset), array('', ''), $replaced_charset_declaration); $sql_line = str_ireplace($charset_matches[0][$key], $replaced_charset_declaration, $sql_line); } } } if (!$this->stored_routine_supported['is_create_or_replace_supported']) { // "create or replace" syntax is used by MariaDB only, in case we are restoring from the MariaDB backup file to MySQL database server, we need to remove the "or replace" syntax if any $sql_line = preg_replace("/^([^'\"])create\s\sor\s\sreplace([^'\"](?:function(?:\s\sif\s\snot\s\sexists)?\|procedure)\s`)/is", "$1create$2", $sql_line); } if (!$this->stored_routine_supported['is_if_not_exists_function_supported']) { // MariaDB supports IF NOT EXISTS syntax after the FUNCTION keyword (e.g create function if not exists function_name), we need to remove it to ensure the syntax compatility with MySQL $sql_line = preg_replace("/^([^'\"]create[^'\"]function)\s\sif\s\snot\s\sexists(\s`)/is", "$1$2", $sql_line); } if (!$this->stored_routine_supported['is_aggregate_function_supported'] && preg_match("/^[^'\"]create[^'\"](?:\baggregate\s\sfunction\b)\s`([^\r\n]+)`/is", $sql_line, $aggregate_matches)) { // there's no way that we can make mariadb aggregate function compatible with MySQL, the function itself must contain "FETCH GROUP NEXT ROW" in the routine body which mysql doesn't know what that is $aggregate_log = "Function {$aggregate_matches[1]} has been neglected due to the unsupported function type (aggregate)"; $updraftplus->log($aggregate_log); $updraftplus->log($aggregate_log, 'notice-restore'); $sql_line = ''; // we ignore the routine and move to the next line $sql_type = -1; continue; } } else { $updraftplus->log("Stored function/procedure {$routine_matches[1]} has been neglected due to the unsupported database routine creation"); // move to the next line if stored routine is not supported $sql_line = ''; $sql_type = -1; continue; } } elseif (preg_match('/^.?drop\s\s(?:function\|procedure)\s\s(?:if\s\sexists\s\s)?/i', $sql_line)) { $sql_type = 13; // if (';' !== $delimiter) $sql_line = preg_replace('/'.$delimiter_regex.'\s$/', '', $sql_line); } elseif (preg_match('/^\sdelimiter (\S+)\s$/i', $sql_line, $matches)) { // Nothing to do here - deliberate no-op (is processed earlier) $sql_type = 10; } elseif (preg_match('/^CREATE(\s+ALGORITHM=\S+)?(\s+DEFINER=\S+)?(\s+SQL SECURITY (\S+))?\s+VIEW/i', $sql_line, $matches)) { $sql_type = 11; // remove DEFINER clause from the create view statement and add or replace SQL SECURITY DEFINER with INVOKER // https://regex101.com/r/2tOEhe/4/ $sql_line = preg_replace('/^(\sCREATE\s\s(?\'or_replace\'OR\s\sREPLACE\s\s)?(?\'algorithm\'ALGORITHM\s=\s[^\s]+\s\s)?)(?\'definer\'DEFINER\s=\s(?:`.{1,17}`@`[^\s]+`\s\|\'.{1,17}\'@\'[^\s]+\'\s\|[^\s]+?\s\s))?(?\'sql_security\'SQL\s\sSECURITY\s\s[^\s]+?\s\s)?(VIEW(?:\s\sIF\s\sNOT\s\sEXISTS)?(?:\s`(?:[^`]\|``)+`\s\|\s\s[^\s]+\s\s)AS)/is', "$1 SQL SECURITY INVOKER $6", $sql_line); if (null !== $this->old_table_prefix) { foreach (array_keys($this->restore_this_table) as $table_name) { // Code for a view can contain pretty much anything. As such, we want to be minimise the risks of unwanted matches. if (in_array($table_name, $this->view_names)) continue; // since DROP VIEW statement is preceded by DROP TABLE statement (@see UpdraftPlus_Backup::write_table_backup_beginning), it makes the view name to be recognised as a real table and to be added to the $this->restore_this_table variable when executing the DROP TABLE statement via UpdraftPlus_Restore::sql_exec method. This line prevents a view name from being replaced and suffixed with $import_table_prefix during an atomic restoration and/or when the view uses the same table prefix if (false !== strpos($sql_line, $table_name)) { $new_table_name = ('' == $this->old_table_prefix) ? $import_table_prefix.$table_name : UpdraftPlus_Manipulation_Functions::str_replace_once($this->old_table_prefix, empty($this->db_permissons_forbidden['rename']) ? $this->final_import_table_prefix : $import_table_prefix, $table_name); $sql_line = str_replace($table_name, $new_table_name, $sql_line); } } // by default during an atomic restoration, the last created table is renamed at the end of the restoration process (@see the `if ($this->restoring_table)` code at the end of this method), typically the DB server will throw an error when creating a view that requires a table that doesn't exist in the database if ($this->restoring_table) { $final_table_name = $this->maybe_rename_restored_table(); $this->restored_table($final_table_name, $this->final_import_table_prefix, $this->old_table_prefix, $this->table_engine); $this->restoring_table = ''; // reset this variable so that the same table renaming procedure at the end of this method doesn't get executed } } } elseif (preg_match('/^SET @@GLOBAL.GTID_PURGED/i', $sql_line)) { // skip the SET @@GLOBAL.GTID_PURGED command $sql_type = 17; } elseif (preg_match('/^\/\\!\d+\s+SET\s+(?:[^,].)?(?=SQL_MODE\s=)/i', $sql_line)) { // skip the SET SQL_MODE command because we adjust the SQL mode dynamically during restoration and offer users the flexibility to change it themselves using action or filter, we don't use the SQL mode specified in the dumped file. Skipping this line prevents any unintended changes to the default SQL mode already set by our system or any custom mode chosen by the user. $sql_type = 18; } else { // Prevent the previous value of $sql_type being retained for an unknown type $sql_type = 0; } // Do not execute "USE" or "CREATE\|DROP DATABASE" or "SET @@GLOBAL.GTID_PURGED" or "SET SQL_MODE" commands if (!in_array($sql_type, array(6, 7, 10, 17, 18)) && (9 != $sql_type \|\| empty($this->db_permissons_forbidden['triggers']))) { $do_exec = $this->sql_exec($sql_line, $sql_type); if (is_wp_error($do_exec)) return $do_exec; } else { $updraftplus->log("Skipped execution of SQL statement (unwanted or internally handled type=$sql_type): $sql_line"); } // currently, the way UDP backups the generated column is different with the way mysqldump does it. // mysqldump doesn't include all of the columns/fields value into the insert statement but instead it specifies only non generated-columns to be included in the insert statement (i.e insert into `table`(`non-generated-column1`,`non-generated-column2`) values('value','value2')) // UDP includes all the columns (i.e insert into `table` values ('non-generated-column-value1', 'non-generated-column-value2', 'virtual-column-value', 'stored-column-value')) // the code below will only get executed if the running DB server is MySQL and the insert statement has all the columns included. If we change the way UDP backup the generated columns to be the same as mysqldump then the code below is no longer necessary and can be removed if (3 == $sql_type && !empty($this->generated_columns[$this->table_name])) { // MySQL doesn't allow the "generated columns" value takes its place in the insert statement, and because of that the only solution is to change the generated columns to standard columns which have been done previously // now we need to change it back to generated columns but unfortunately changing it to virtual type wont work, it can only be changed to stored type if (!isset($this->supported_generated_column_engines[strtolower($this->table_engine)])) $this->supported_generated_column_engines[strtolower($this->table_engine)] = UpdraftPlus_Database_Utility::is_generated_column_supported($this->table_engine); if (($generated_column_db_info = $this->supported_generated_column_engines[strtolower($this->table_engine)]) && !$generated_column_db_info['can_insert_ignore_to_generated_column'] && isset($this->generated_columns_exist_in_the_statement[$this->table_name]) && true === $this->generated_columns_exist_in_the_statement[$this->table_name]) { foreach ((array) $this->generated_columns[$this->table_name]['columns'] as $generated_column) { $new_data_type_definition = "`{$generated_column['column_name']}`"; foreach ((array) $generated_column['column_data_type_definition'] as $key => $data_type_definition) { if (empty($data_type_definition) \|\| 0 === strlen(trim($data_type_definition[0]))) continue; if (in_array($key, array('DATA_TYPE_TOKEN', 'GENERATED_ALWAYS_TOKEN', 'COMMENT_TOKEN'))) { $new_data_type_definition .= " ".$data_type_definition[0]; continue; // we only want the data type options after the "generated always as()", so we continue } // If the database server doesn't support either null or not null constraint on generated virtual/stored/persistent column then the constraints need to be removed $new_data_type_definition .= $generated_column_db_info['is_not_null_supported'] ? $data_type_definition[0] : preg_replace('/\b(?:not\s+null\|null)\b/i', '', $data_type_definition[0]); if (!$generated_column['is_virtual']) { // If the persistent type is not supported it likely means that the currently running db server is MySQL, Mariadb uses persistent as an alias for stored type so if the backup file is taken from MariaDB then it needs to be changed to stored $new_data_type_definition = $generated_column_db_info['is_persistent_supported'] ? $new_data_type_definition : preg_replace('/\bpersistent\b/i', 'STORED', $new_data_type_definition); } } $new_data_type_definition = preg_replace('/\bvirtual\b/i', 'STORED', $new_data_type_definition); // altering table could take minutes or hours to complete depending on the size of the rows of the table $do_exec = $this->sql_exec(sprintf("alter table `%s` change `%s` %s", $this->new_table_name, $generated_column['column_name'], $new_data_type_definition), -1); if (is_wp_error($do_exec)) return $do_exec; } } } // Reset $sql_line = ''; $sql_type = -1; } if (is_array($this->stored_routine_supported) && $this->stored_routine_supported['is_binary_logging_enabled']) { // if this condition is met, it means that db server binary logging is enabled and the value of the log_bin_trust_function_system_variable has previously been set to ON (1), and now the value must be changed back to what it originally was if (isset($this->continuation_data['old_log_bin_trust_function_creators'])) { // it's a resumption $old_log_bin_trust_function_creators = $this->continuation_data['old_log_bin_trust_function_creators']; } else { $old_log_bin_trust_function_creators = $updraftplus->jobdata_get('old_log_bin_trust_function_creators'); } if (is_string($old_log_bin_trust_function_creators) && '' !== $old_log_bin_trust_function_creators) { $this->set_log_bin_trust_function_creators($old_log_bin_trust_function_creators); // no need to check the return value of the set_log_bin_trust_function_creators here as if it is an wp error it has been handled already and this block of code wont be executed $updraftplus->log("log_bin_trust_function_creators variable has been reset: ".$old_log_bin_trust_function_creators); // unset the old_log_bin_trust_function_creators index from the continuation_data so that the on_shutdown function won't check it again unset($this->continuation_data['old_log_bin_trust_function_creators']); // also delete the old_log_bin_trust_function_creators jobdata to prevent the on_shutdown function accessing and deleting it twice $updraftplus->jobdata_delete('old_log_bin_trust_function_creators'); $updraftplus->log("log_bin_trust_function_creators variable has successfully been removed from UDP jobdata"); } } // Rescan storage, but only if there was remote storage and a database; otherwise just re-scan locally if (!empty($this->ud_backup_set['db']) && !empty($this->ud_backup_set['service']) && ('none' !== $this->ud_backup_set['service'] && 'email' !== $this->ud_backup_set['service'] && array('') !== $this->ud_backup_set['service'] && array('none') !== $this->ud_backup_set['service'] && array('email') !== $this->ud_backup_set['service'])) { $only_add_this_file = array('file' => $this->ud_backup_set['db']); UpdraftPlus_Backup_History::rebuild(true, $only_add_this_file); } else { UpdraftPlus_Backup_History::rebuild(); } if (!empty($this->db_permissons_forbidden['lock'])) { $updraftplus->log("Leaving maintenance mode"); } else { $updraftplus->log("Unlocking database and leaving maintenance mode"); $this->unlock_tables(); } $this->maintenance_mode(false); if ($this->restoring_table) { $final_table_name = $this->maybe_rename_restored_table(); $this->restored_table($final_table_name, $this->final_import_table_prefix, $this->old_table_prefix, $this->table_engine); } // drop the dummy restored tables if ($this->is_dummy_db_restore) $this->drop_tables($this->restored_table_names); $time_taken = microtime(true) - $this->start_time; $updraftplus->log_e('Finished: lines processed: %d in %.2f seconds', $this->line, $time_taken); if ($is_plain) { fclose($dbhandle); } elseif ($is_bz2) { bzclose($dbhandle); } else { gzclose($dbhandle); } global $wp_filesystem; if (!$wp_filesystem->delete($working_dir.'/'.$db_basename, false, 'f')) { $this->restore_log_permission_failure_message($working_dir, 'Delete '.$working_dir.'/'.$db_basename); } return true; } /** * This function will check if the passed in table should be skipped e.g it was processed on another run * * @param string $table_name - the name of the table we want to check * * @return boolean - returns true if we should skip the table, otherwise false if the table should be processed / private function table_should_be_skipped($table_name) { global $updraftplus; $skip_table = false; $last_table = isset($this->continuation_data['last_processed_db_table']) ? $this->continuation_data['last_processed_db_table'] : ''; $table_should_be_skipped = false; if (!empty($this->tables_to_skip) && in_array($table_name, $this->tables_to_skip)) { $table_should_be_skipped = true; } elseif (!empty($this->tables_to_restore) && !in_array($table_name, $this->tables_to_restore) && !$this->include_unspecified_tables) { $table_should_be_skipped = true; } if ($table_should_be_skipped) { if (empty($this->previous_table_name) \|\| $table_name != $this->previous_table_name) $updraftplus->log(sprintf(__('Skipping table %s: user has chosen not to restore this table', 'updraftplus'), $table_name), 'notice-restore'); $skip_table = true; } elseif (!empty($last_table) && !empty($table_name) && $table_name != $last_table) { if (empty($this->previous_table_name) \|\| $table_name != $this->previous_table_name) $updraftplus->log(sprintf(__('Skipping table %s: already restored on a prior run; next table to restore: %s', 'updraftplus'), $table_name, $last_table), 'notice-restore'); $skip_table = true; } elseif (!empty($last_table) && !empty($table_name) && $table_name == $last_table) { unset($this->continuation_data['last_processed_db_table']); $skip_table = false; } $this->previous_table_name = $table_name; if (!$skip_table) { $updraftplus->log_restore_update(array('type' => 'state', 'stage' => 'db', 'data' => array('stage' => 'table', 'table' => $table_name))); $updraftplus->jobdata_set('last_processed_db_table', $table_name); } return $skip_table; } /* * This function will check if we are performing an atomic restore by renaming a temporary table to the final table name and returning the final table name * * @return string - returns the final table name / private function maybe_rename_restored_table() { global $updraftplus; // If this is set then we do not want to attempt an atomic restore as it will remove the final table if ($this->disable_atomic_on_current_table) { $this->disable_atomic_on_current_table = false; return $this->original_table_name; } // If the table names are the same then we do not want to attempt an atomic restore as it will remove the final table if ($this->original_table_name == $this->restoring_table) return $this->original_table_name; // If we have skipped this table then we don't want to attempt the atomic restore if (!$this->restore_this_table($this->original_table_name)) { return $this->original_table_name; } if (empty($this->db_permissions_forbidden['rename'])) { $updraftplus->log_e('Atomic restore: dropping original table (%s)', $this->original_table_name); $this->drop_tables(array($this->original_table_name)); $updraftplus->log_e('Atomic restore: renaming new table (%s) to final table name (%s)', $this->restoring_table, $this->original_table_name); $this->rename_table($this->restoring_table, $this->original_table_name); } return $this->original_table_name; } /* * This function will try to rename a table, if successful returns true otherwise returns an error number * * @param string $current_table_name - the current table name * @param string $new_table_name - the new table name * * @return boolean\|integer - returns true if successful otherwise an error number / private function rename_table($current_table_name, $new_table_name) { $current_table_name = UpdraftPlus_Manipulation_Functions::backquote($current_table_name); $new_table_name = UpdraftPlus_Manipulation_Functions::backquote($new_table_name); return $this->sql_exec("ALTER TABLE $current_table_name RENAME TO $new_table_name;", 14, '', false); } private function lock_table($table) { // Not yet working return true; global $updraftplus;// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Function isnt being used yet $table = UpdraftPlus_Manipulation_Functions::backquote($table); if ($this->use_wpdb()) { $req = $wpdb->query("LOCK TABLES $table WRITE;");// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UndefinedVariable -- Function isnt being used yet } else { if ($this->use_mysqli) { $req = mysqli_query($this->mysql_dbh, "LOCK TABLES $table WRITE;"); } else { // @codingStandardsIgnoreLine $req = mysql_unbuffered_query("LOCK TABLES $table WRITE;", $this->mysql_dbh); } if (!$req) { // @codingStandardsIgnoreLine $lock_error_no = $this->use_mysqli ? mysqli_errno($this->mysql_dbh) : mysql_errno($this->mysql_dbh); } } if (!$req && ($this->use_wpdb() \|\| 1142 === $lock_error_no)) { // Permission denied return 1142; } return true; } public function unlock_tables() { return; // Not yet working if ($this->use_wpdb()) { $wpdb->query("UNLOCK TABLES;");// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UndefinedVariable -- Function isnt being used yet } elseif ($this->use_mysqli) { $req = mysqli_query($this->mysql_dbh, "UNLOCK TABLES;");// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Function isnt being used yet } else { // @codingStandardsIgnoreLine $req = mysql_unbuffered_query("UNLOCK TABLES;"); } } /* * Save configuration bundle, ready to restore it once the options table has been restored / private function save_configuration_bundle() { $this->configuration_bundle = array(); // Some items must always be saved + restored; others only on a migration // Remember, if modifying this, that a restoration can include restoring a destroyed site from a backup onto a fresh WP install on the same URL. So, it is not necessarily desirable to retain the current settings and drop the ones in the backup. $keys_to_save = array('updraft_remotesites', 'updraft_migrator_localkeys', 'updraft_central_localkeys', 'updraft_restore_in_progress'); if ($this->old_siteurl != $this->our_siteurl \|\| (defined('UPDRAFTPLUS_RESTORE_ALL_SETTINGS') && UPDRAFTPLUS_RESTORE_ALL_SETTINGS)) { global $updraftplus; $keys_to_save = array_merge($keys_to_save, $updraftplus->get_settings_keys()); $keys_to_save[] = 'updraft_backup_history'; } foreach ($keys_to_save as $key) { $this->configuration_bundle[$key] = UpdraftPlus_Options::get_updraft_option($key, ''); } } /* * The table here is just for logging/info. The actual restoration itself is done via the standard options class. * * @param string $table specific table / private function restore_configuration_bundle($table) { if (!is_array($this->configuration_bundle)) return; global $updraftplus; $updraftplus->log("Restoring prior UD configuration (table: $table; keys: ".count($this->configuration_bundle).")"); foreach ($this->configuration_bundle as $key => $value) { UpdraftPlus_Options::delete_updraft_option($key); UpdraftPlus_Options::update_updraft_option($key, $value); } // reset the Litespeed server warning message for migration if (!empty($this->restore_options['updraft_restorer_replacesiteurl'])) { if (isset($_SERVER['SERVER_SOFTWARE']) && false !== strpos($_SERVER['SERVER_SOFTWARE'], 'LiteSpeed')) { if (!is_file(ABSPATH.'.htaccess') \|\| !preg_match('/noabort/i', file_get_contents(ABSPATH.'.htaccess'))) { UpdraftPlus_Options::delete_updraft_option('updraft_dismiss_admin_warning_litespeed'); } } } } /* * Log the information that a particular SQL commandment is too long * * @param String $sql_line - the SQL / private function log_oversized_packet($sql_line) { global $updraftplus; $logit = substr($sql_line, 0, 100); $updraftplus->log(sprintf("An SQL line that is larger than the maximum packet size and cannot be split was found: %s", '('.strlen($sql_line).', '.$logit.' ...)')); $updraftplus->log(__('Warning:', 'updraftplus').' '.sprintf(__("An SQL line that is larger than the maximum packet size and cannot be split was found; this line will not be processed, but will be dropped: %s", 'updraftplus'), '('.strlen($sql_line).', '.$this->max_allowed_packet.', '.$logit.' ...)'), 'notice-restore'); } private function restore_this_table($table_name) { global $updraftplus; $unprefixed_table_name = substr($table_name, strlen($this->old_table_prefix)); // First, check whether it's a multisite site which we're not restoring. This is stored in restore_this_site (once we know the site). if (!empty($this->ud_multisite_selective_restore)) { if (preg_match('/^(\d+)_.$/', $unprefixed_table_name, $matches)) { $site_id = $matches[1]; if (!isset($this->restore_this_site[$site_id])) { $this->restore_this_site[$site_id] = apply_filters( 'updraftplus_restore_this_site', true, $site_id, $unprefixed_table_name, $this->restore_options ); } if (false === $this->restore_this_site[$site_id]) { // The first time it's looked into, it gets logged $updraftplus->log_e('Skipping site %s: this table (%s) and others from the site will not be restored', $site_id, $table_name); $this->restore_this_site[$site_id] = 0; } if (!$this->restore_this_site[$site_id]) { return false; } } } // Secondly, if we're still intending to proceed, check the table specifically if (!isset($this->restore_this_table[$table_name])) { $this->restore_this_table[$table_name] = apply_filters( 'updraftplus_restore_this_table', true, $unprefixed_table_name, $this->restore_options ); if (false === $this->restore_this_table[$table_name]) { // The first time it's looked into, it gets logged $updraftplus->log_e('Skipping table %s: this table will not be restored', $table_name); $this->restore_this_table[$table_name] = 0; } } return $this->restore_this_table[$table_name]; } /** * UPDATE is sql_type=5 (not used in the function, but used in Migrator and so noted here for reference) * $import_table_prefix is only use in one place in this function (long INSERTTs), and otherwise need/should not be supplied * * SQL Types: * 1 DROP * 2 CREATE * 3 INSERT * 4 LOCK * 5 UPDATE * 6 WPB2D CREATE/DROP * 7 WPB2D USE * 8 SET NAMES * 9 TRIGGER * 10 DELIMITER * 11 CREATE VIEW * 12 ROUTINE * 13 DROP FUNCTION\|PROCEDURE * 14 ALTER * 15 UNLOCK * 16 DROP VIEW * 17 SET GLOBAL.GTID_PURGED * 18 SET SQL_MODE\|@OLD_SQL_MODE * * @param String $sql_line sql line to execute * @param Integer $sql_type sql type * @param String $import_table_prefix import type prefix * @param Boolean $check_skipping if true, then check whether the table is on the list of tables to skip * * @return Boolean\|WP_Error\|Void / public function sql_exec($sql_line, $sql_type, $import_table_prefix = '', $check_skipping = true) { global $wpdb, $updraftplus; if ($check_skipping && !empty($this->table_name) && !$this->restore_this_table($this->table_name)) return; $ignore_errors = false; // Type 2 = CREATE TABLE if (2 == $sql_type && !empty($this->db_permissons_forbidden['create'])) { $updraftplus->log_e('Cannot create new tables, so skipping this command (%s)', htmlspecialchars($sql_line)); $req = true; } else { if (2 == $sql_type && empty($this->db_permissons_forbidden['drop'])) { // We choose, for now, to be very conservative - we only do the apparently-missing drop if we have never seen any drop - i.e. assume that in SQL dumps with missing DROPs, that it's because there are no DROPs at all if (!in_array($this->new_table_name, $this->tables_been_dropped)) { $updraftplus->log_e('Table to be implicitly dropped: %s', $this->new_table_name); $this->sql_exec('DROP TABLE IF EXISTS '.UpdraftPlus_Manipulation_Functions::backquote($this->new_table_name), 1, '', false); $this->tables_been_dropped[] = $this->new_table_name; } } // Type 1 = DROP TABLE if (1 == $sql_type) { if (!empty($this->db_permissons_forbidden['drop'])) { $sql_line = "DELETE FROM ".UpdraftPlus_Manipulation_Functions::backquote($this->new_table_name); $updraftplus->log_e('Cannot drop tables, so deleting instead (%s)', $sql_line); $ignore_errors = true; } } if (3 == $sql_type && $sql_line && strlen($sql_line) > $this->max_allowed_packet) { $this->log_oversized_packet($sql_line); // If this is the very first SQL line of the options table, we need to bail; it's essential $this->errors++; if (0 == $this->insert_statements_run && $this->new_table_name && $this->new_table_name == $import_table_prefix.'options') { $updraftplus->log('Leaving maintenance mode'); $this->maintenance_mode(false); return new WP_Error('initial_db_error', sprintf(__('An error occurred on the first %s command - aborting run', 'updraftplus'), 'INSERT (options)')); } return false; } static $first_trigger = true; if (9 == $sql_type && $first_trigger) { $first_trigger = false; $updraftplus->log('Restoring TRIGGERs...'); } static $first_stored_routine = true; if (12 == $sql_type && $first_stored_routine) { $first_stored_routine = false; $updraftplus->log('Restoring STORED ROUTINES...'); } if ($this->use_wpdb()) { $req = $wpdb->query($sql_line); // WPDB, for several query types, returns the number of rows changed; in distinction from an error, indicated by (bool)false if (0 === $req) { $req = true; } if (!$req) $this->last_error = $wpdb->last_error; } else { if ($this->use_mysqli) { $req = mysqli_query($this->mysql_dbh, $sql_line); if (!$req) $this->last_error = mysqli_error($this->mysql_dbh); } else { // @codingStandardsIgnoreLine $req = mysql_unbuffered_query($sql_line, $this->mysql_dbh); // @codingStandardsIgnoreLine if (!$req) $this->last_error = mysql_error($this->mysql_dbh); } } if (3 == $sql_type) $this->insert_statements_run++; if (1 == $sql_type) $this->tables_been_dropped[] = $this->new_table_name; $this->statements_run++; } if (!$req) { if (!$ignore_errors) $this->errors++; $print_err = (strlen($sql_line) > 100) ? substr($sql_line, 0, 100).' ...' : $sql_line; $updraftplus->log(sprintf(_x('An error (%s) occurred:', 'The user is being told the number of times an error has happened, e.g. An error (27) occurred', 'updraftplus'), $this->errors)." - ".$this->last_error." - ".__('the database query being run was:', 'updraftplus').' '.$print_err, 'notice-restore'); $updraftplus->log("An error (".$this->errors.") occurred: ".$this->last_error." - SQL query was (type=$sql_type): ".substr($sql_line, 0, 65536)); if ('MySQL server has gone away' == $this->last_error \|\| 'Connection was killed' == $this->last_error) { $restored = false; for ($i = 0; $i < 3; $i++) { if ($this->restore_database_connection()) { $restored = true; break; } } if (!$restored) { $updraftplus->log("The Database connection has been closed and cannot be reopened."); $updraftplus->log("Leaving maintenance mode"); $this->maintenance_mode(false); return new WP_Error('db_connection_closed', __('The Database connection has been closed and cannot be reopened.', 'updraftplus')); } return $this->sql_exec($sql_line, $sql_type, $import_table_prefix, $check_skipping); } // First command is expected to be DROP TABLE if (1 == $this->errors && 2 == $sql_type && 0 == $this->tables_created) { if (!empty($this->db_permissons_forbidden['drop'])) { $updraftplus->log_e("Create table failed - probably because there is no permission to drop tables and the table already exists; will continue"); } else { $updraftplus->log("Leaving maintenance mode"); $this->maintenance_mode(false); return new WP_Error('initial_db_error', sprintf(__('An error occurred on the first %s command - aborting run', 'updraftplus'), 'CREATE TABLE')); } } elseif (2 == $sql_type && 0 == $this->tables_created && !empty($this->db_permissons_forbidden['drop'])) { // Decrease error counter again; otherwise, we'll cease if there are >=50 tables if (!$ignore_errors) $this->errors--; } elseif (3 == $sql_type && false !== strpos($this->last_error, 'Duplicate entry') && false !== strpos($sql_line, 'INSERT')) { $sql_line = UpdraftPlus_Manipulation_Functions::str_replace_once('INSERT', 'INSERT IGNORE', $sql_line); $updraftplus->log('Retrying SQL query with INSERT IGNORE', 'notice-restore'); $this->sql_exec($sql_line, $sql_type, $import_table_prefix, $check_skipping); } elseif (8 == $sql_type && 1 == $this->errors) { $updraftplus->log("Aborted: SET NAMES ".$this->set_names." failed: leaving maintenance mode"); $this->maintenance_mode(false); $extra_msg = ''; $dbv = $wpdb->db_version(); if ('utf8mb4' == strtolower($this->set_names) && $dbv && version_compare($dbv, '5.2.0', '<=')) { $extra_msg = ' '.__('This problem is caused by trying to restore a database on a very old MySQL version that is incompatible with the source database.', 'updraftplus').' '.sprintf(__('This database needs to be deployed on MySQL version %s or later.', 'updraftplus'), '5.5'); } return new WP_Error('initial_db_error', sprintf(__('An error occurred on the first %s command - aborting run', 'updraftplus'), 'SET NAMES').'. '.sprintf(__('To use this backup, your database server needs to support the %s character set.', 'updraftplus'), $this->set_names).$extra_msg); } elseif (12 == $sql_type) { // sql_type 12 is stored routine creation // in case we dealt with an sql syntax error from the stored routine body, the restore operation should not be stopped $req = true; // Type 14 = ALTER TABLE } elseif (14 == $sql_type && 1 == $this->errors) { return 1142; } if ($this->errors >= (defined('UPDRAFTPLUS_SQLEXEC_MAXIMUM_ERRORS') ? UPDRAFTPLUS_SQLEXEC_MAXIMUM_ERRORS : 50)) { $this->maintenance_mode(false); return new WP_Error('too_many_db_errors', __('Too many database errors have occurred - aborting', 'updraftplus')); } } elseif (2 == $sql_type) { if (empty($this->db_permissons_forbidden['lock'])) $this->lock_table($this->new_table_name); $this->tables_created++; do_action('updraftplus_creating_table', $this->new_table_name); } if ($this->line >0 && 0 == $this->line % 50) { if ($this->line > $this->line_last_logged && (0 == $this->line % 250 \|\| $this->line < 250)) { $this->line_last_logged = $this->line; $time_taken = microtime(true) - $this->start_time; $updraftplus->log_e('Database queries processed: %d in %.2f seconds', $this->line, $time_taken); } } return $req; } private function flush_rewrite_rules() { // We have to deal with the fact that the procedures used call get_option, which could be looking at the wrong table prefix, or have the wrong thing cached global $updraftplus_addons_migrator; if (!empty($updraftplus_addons_migrator->new_blogid)) switch_to_blog($updraftplus_addons_migrator->new_blogid); $filter_these = array('permalink_structure', 'rewrite_rules', 'page_on_front'); foreach ($filter_these as $opt) { add_filter('pre_option_'.$opt, array($this, 'option_filter_'.$opt)); } global $wp_rewrite; $wp_rewrite->init(); // Don't do this: it will cause rules created by plugins that weren't active at the start of the restore run to be lost // flush_rewrite_rules(true); if (function_exists('save_mod_rewrite_rules')) save_mod_rewrite_rules(); if (function_exists('iis7_save_url_rewrite_rules')) iis7_save_url_rewrite_rules(); foreach ($filter_these as $opt) { remove_filter('pre_option_'.$opt, array($this, 'option_filter_'.$opt)); } if (!empty($updraftplus_addons_migrator->new_blogid)) restore_current_blog(); } /* * WordPress options filter * * @param String $val - pre-filter value * * @return String - filtered value / public function option_filter_template($val) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; return $updraftplus->option_filter_get('template'); } /* * WordPress options filter * * @param String $val - pre-filter value * * @return String - filtered value / public function option_filter_stylesheet($val) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; return $updraftplus->option_filter_get('stylesheet'); } /* * WordPress options filter * * @param String $val - pre-filter value * * @return String - filtered value / public function option_filter_template_root($val) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; return $updraftplus->option_filter_get('template_root'); } /* * WordPress options filter * * @param String $val - pre-filter value * * @return String - filtered value / public function option_filter_stylesheet_root($val) {// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Filter use global $updraftplus; return $updraftplus->option_filter_get('stylesheet_root'); } /* * Called when a table has been restored * * @param String $table - The full table name that has been restored * @param String $import_table_prefix - The table prefix being used to import * @param String $old_table_prefix - The table prefix in the backup file * @param String $engine - The database engine, if known / private function restored_table($table, $import_table_prefix, $old_table_prefix, $engine = '') { $table_without_prefix = substr($table, strlen($import_table_prefix)); if (isset($this->restore_this_table[$old_table_prefix.$table_without_prefix]) && !$this->restore_this_table[$old_table_prefix.$table_without_prefix]) return; global $wpdb, $updraftplus; if ($table == $import_table_prefix.UpdraftPlus_Options::options_table()) { // This became necessary somewhere around WP 4.5 - otherwise deleting and re-saving options stopped working wp_cache_flush(); $this->restore_configuration_bundle($table); } if ($this->is_multisite && $import_table_prefix.'sitemeta' === $table) { // the reason why this if statement is needed is that when _options table is not included in the backup, then updraft_jobdata will never be wiped out from the _sitemeta table as the below elseif statement will call wipe_state_data() only if _options table is included $updraftplus->wipe_state_data(false, 'sitemeta'); } elseif (preg_match('/^([\d+]_)?options$/', substr($table, strlen($import_table_prefix)), $matches)) { // The second prefix here used to have a '!$this->is_multisite' on it (i.e. 'options' table on non-multisite). However, the user_roles entry exists in the main options table on multisite too. if (($this->is_multisite && !empty($matches[1])) \|\| $table == $import_table_prefix.'options') { $updraftplus->wipe_state_data(); $mprefix = empty($matches[1]) ? '' : $matches[1]; $new_table_name = $import_table_prefix.$mprefix."options"; // WordPress has an option name predicated upon the table prefix. Yuk. if ($import_table_prefix != $old_table_prefix) { $updraftplus->log("Table prefix has changed: changing options table field(s) accordingly (".$mprefix."options)"); $print_line = sprintf(__('Table prefix has changed: changing %s table field(s) accordingly:', 'updraftplus'), 'option').' '; if (false === $wpdb->query("UPDATE $new_table_name SET option_name='{$import_table_prefix}".$mprefix."user_roles' WHERE option_name='{$old_table_prefix}".$mprefix."user_roles' LIMIT 1")) { $print_line .= __('Error', 'updraftplus'); $updraftplus->log("Error when changing options table fields: ".$wpdb->last_error); } else { $updraftplus->log("Options table fields changed OK"); $print_line .= __('OK', 'updraftplus'); } $updraftplus->log($print_line, 'notice-restore'); } // Now deal with the situation where the imported database sets a new over-ride upload_path that is absolute - which may not be wanted $new_upload_path = $wpdb->get_row($wpdb->prepare("SELECT option_value FROM {$import_table_prefix}".$mprefix."options WHERE option_name = %s LIMIT 1", 'upload_path')); $new_upload_path = (is_object($new_upload_path)) ? $new_upload_path->option_value : ''; // The danger situation is absolute and points somewhere that is now perhaps not accessible at all if (!empty($new_upload_path) && $new_upload_path != $this->prior_upload_path && (strpos($new_upload_path, '/') === 0) \|\| preg_match('#^[A-Za-z]:[/\\\]#', $new_upload_path)) { // $this->old_siteurl != untrailingslashit(site_url()) is not a perfect proxy for "is a migration" (other possibilities exist), but since the upload_path option should not exist since WP 3.5 anyway, the chances of other possibilities are vanishingly small if (!file_exists($new_upload_path) \|\| $this->old_siteurl != $this->our_siteurl) { if (!file_exists($new_upload_path)) { $updraftplus->log_e("Uploads path (%s) does not exist - resetting (%s)", $new_upload_path, $this->prior_upload_path); } else { $updraftplus->log_e("Uploads path (%s) has changed during a migration - resetting (to: %s)", $new_upload_path, $this->prior_upload_path); } if (false === $wpdb->query($wpdb->prepare("UPDATE {$import_table_prefix}".$mprefix."options SET option_value='%s' WHERE option_name='upload_path' LIMIT 1", array($this->prior_upload_path)))) { $updraftplus->log(__('Error', 'updraftplus'), 'notice-restore'); $updraftplus->log("Error when changing upload path: ".$wpdb->last_error); $updraftplus->log("Failed"); } } } // TODO:Do on all WPMU tables if ($table == $import_table_prefix.'options') { // Bad plugin that hard-codes path references - https://wordpress.org/plugins/custom-content-type-manager/ $cctm_data = $wpdb->get_row($wpdb->prepare("SELECT option_value FROM $new_table_name WHERE option_name = %s LIMIT 1", 'cctm_data')); if (!empty($cctm_data->option_value)) { $cctm_data = empty($cctm_data->option_value) ? array() : $updraftplus->unserialize($cctm_data->option_value); if (is_array($cctm_data) && !empty($cctm_data['cache']) && is_array($cctm_data['cache'])) { $cctm_data['cache'] = array(); $updraftplus->log_e("Custom content type manager plugin data detected: clearing option cache"); update_option('cctm_data', $cctm_data); } } } if ($table == $import_table_prefix.$mprefix.'options') { // Another - http://www.elegantthemes.com/gallery/elegant-builder/ $elegant_data = $wpdb->get_row($wpdb->prepare("SELECT option_value FROM $new_table_name WHERE option_name = %s LIMIT 1", 'et_images_temp_folder')); if (!empty($elegant_data->option_value)) { $dbase = basename($elegant_data->option_value); $wp_upload_dir = wp_upload_dir(); $edir = $wp_upload_dir['basedir']; $new_dir = $edir.'/'.$dbase; if (!is_dir($new_dir)) @mkdir($new_dir, 0775, true);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. $updraftplus->log_e("Elegant themes theme builder plugin data detected: resetting temporary folder"); $wpdb->update($new_table_name, array('option_value' => $new_dir), array('option_name' => 'et_images_temp_folder')); } // check if current restoration is a migration if (!empty($this->restore_options['updraft_restorer_replacesiteurl'])) { $wp_rocket_settings = $wpdb->get_row($wpdb->prepare("SELECT option_value FROM $new_table_name WHERE option_name = %s LIMIT 1", 'wp_rocket_settings')); if (!empty($wp_rocket_settings->option_value)) { $wp_rocket_settings = empty($wp_rocket_settings->option_value) ? array() : $updraftplus->unserialize($wp_rocket_settings->option_value); // if WP Rocket settings is found and cdn is enabled if (isset($wp_rocket_settings['cdn'])) { unset($wp_rocket_settings['cdn']); $wpdb->update($new_table_name, array('option_value' => serialize($wp_rocket_settings)), array('option_name' => 'wp_rocket_settings')); $updraftplus->log_e("WP Rocket CDN option detected: disabling the option"); } } } } // The gantry menu plugin sometimes uses too-long transient names, causing the timeout option to be missing; and hence the transient becomes permanent. // WP 3.4 onwards has $wpdb->delete(). But we support 3.2 onwards. $wpdb->query("DELETE FROM $new_table_name WHERE option_name LIKE '_transient_gantry-menu%' OR option_name LIKE '_transient_timeout_gantry-menu%'"); // Jetpack: see: https://wordpress.org/support/topic/issues-with-dev-site if ($this->old_siteurl != $this->our_siteurl) { $wpdb->query("DELETE FROM $new_table_name WHERE option_name = 'jetpack_options'"); } // if we are importing a single site into a multisite (which means we have the multisite add-on) we need to clear our saved options and crons to prevent unwanted backups if (isset($this->restore_options['updraftplus_migrate_blogname'])) { $wpdb->query("DELETE FROM {$import_table_prefix}{$mprefix}options WHERE option_name LIKE 'updraft_%'"); $crons = $updraftplus->unserialize($wpdb->get_var("SELECT option_value FROM {$import_table_prefix}{$mprefix}options WHERE option_name = 'cron'")); if (is_array($crons)) { foreach ($crons as $timestamp => $cron) { if (!is_array($cron)) continue; foreach (array_keys($cron) as $key) { if (false !== strpos($key, 'updraft_')) unset($crons[$timestamp][$key]); if (empty($crons[$timestamp])) unset($crons[$timestamp]); } } } $crons = serialize($crons); $wpdb->query($wpdb->prepare("UPDATE {$import_table_prefix}{$mprefix}options SET option_value='%s' WHERE option_name='cron'", $crons)); } } } elseif ($import_table_prefix != $old_table_prefix && preg_match('/^([\d+]_)?usermeta$/', substr($table, strlen($import_table_prefix)), $matches)) { // This table is not a per-site table, but per-install $updraftplus->log("Table prefix has changed: changing usermeta table field(s) accordingly"); $print_line = sprintf(__('Table prefix has changed: changing %s table field(s) accordingly:', 'updraftplus'), 'usermeta').' '; $errors_occurred = false; if (false === strpos($old_table_prefix, '_')) { // Old, slow way: do it row-by-row // By Jul 2015, doing this on the updraftplus.com database took 20 minutes on a slow test machine $old_prefix_length = strlen($old_table_prefix); $um_sql = "SELECT umeta_id, meta_key FROM {$import_table_prefix}usermeta WHERE meta_key LIKE '".UpdraftPlus_Database_Utility::esc_like($old_table_prefix)."%'"; $meta_keys = $wpdb->get_results($um_sql); foreach ($meta_keys as $meta_key) { // Create new meta key $new_meta_key = $import_table_prefix . substr($meta_key->meta_key, $old_prefix_length); $query = "UPDATE " . $import_table_prefix . "usermeta SET meta_key='".$new_meta_key."' WHERE umeta_id=".$meta_key->umeta_id; if (false === $wpdb->query($query)) $errors_occurred = true; } } else { // New, fast way: do it in a single query $sql = "UPDATE {$import_table_prefix}usermeta SET meta_key = REPLACE(meta_key, '$old_table_prefix', '{$import_table_prefix}') WHERE meta_key LIKE '".UpdraftPlus_Database_Utility::esc_like($old_table_prefix)."%';"; if (false === $wpdb->query($sql)) $errors_occurred = true; } if ($errors_occurred) { $updraftplus->log("Error when changing usermeta table fields"); $print_line .= __('Error', 'updraftplus'); } else { $updraftplus->log("Usermeta table fields changed OK"); $print_line .= __('OK', 'updraftplus'); } $updraftplus->log($print_line, 'notice-restore'); } do_action('updraftplus_restored_db_table', $table, $import_table_prefix, $engine); // Re-generate permalinks. Do this last - i.e. make sure everything else is fixed up first. if ($table == $import_table_prefix.'options') $this->flush_rewrite_rules(); } /** * This function will search and replace ABSPATH in the restored table * * @param string $table - the table to search and replace * @param string $import_table_prefix - the import table prefix * * @return void / public function updraftplus_restored_db_table($table, $import_table_prefix) { global $updraftplus; // If this is set return as migrator will handle the abspath change, this way we don't search and replace each table twice if (!empty($this->restore_options['updraft_restorer_replacesiteurl'])) return; // If old abspath is not empty then it has changed so try and search replace it, just in case a bad plugin/theme has saved abspath to the DB if (!empty($this->old_abspath)) { $from_array = array(); $from_array[] = $this->old_abspath; $to_array = array(); $to_array[] = ABSPATH; $stripped_table = substr($table, strlen($import_table_prefix)); // The search/replace parameters are allowed to be either strings or arrays $report = $this->search_replace_obj->icit_srdb_replacer($from_array, $to_array, array($table => $stripped_table), 5000); // Output any errors encountered during the db work. if (!empty($report['errors']) && is_array($report['errors'])) { $updraftplus->log(__('Error:', 'updraftplus'), 'warning-restore', 'restore-db-error'); $processed_errors = array(); foreach ($report['errors'] as $error) { if (in_array($error, $processed_errors)) continue; $processed_errors[] = $error; $num = count(array_keys($report['errors'], $error)); $err_string = $error; if ($num > 1) $err_string .= ' (x'.$num.')'; $updraftplus->log($err_string, 'warning-restore'); } } elseif (false == $report) { $updraftplus->log(sprintf(__('Failed: the %s operation was not able to start.', 'updraftplus'), __('search and replace', 'updraftplus')), 'warning-notice'); } elseif (!is_array($report)) { $updraftplus->log(sprintf(__('Failed: we did not understand the result returned by the %s operation.', 'updraftplus'), __('search and replace', 'updraftplus')), 'warning-notice'); } } } /* * Log permission failure message when restoring a backup * * @param string $path full path of file or folder * @param string $log_message_prefix action which is performed to path * @param string $directory_prefix_in_log_message Directory Prefix. It should be either "Parent" or "Destination" / private function restore_log_permission_failure_message($path, $log_message_prefix, $directory_prefix_in_log_message = 'Parent') { global $updraftplus; $log_message = $updraftplus->log_permission_failure_message($path, $log_message_prefix, $directory_prefix_in_log_message); if ($log_message) { $updraftplus->log($log_message, 'warning-restore'); } } /* * This function will loop through all the sites available and get their active plugins and ensure any missing plugins are removed from the active list to prevent crashes. * * @param string $import_table_prefix - the table prefix * * @return void / private function check_active_plugins($import_table_prefix) { global $wpdb; if ($this->is_multisite) { // Get the site wide active plugins $plugins = $wpdb->get_row("SELECT meta_value FROM {$import_table_prefix}sitemeta WHERE meta_key = 'active_sitewide_plugins'"); if (!empty($plugins->meta_value)) { $plugins = $this->deactivate_missing_plugins($plugins->meta_value); $wpdb->query($wpdb->prepare("UPDATE {$import_table_prefix}sitemeta SET meta_value=%s WHERE meta_key='active_sitewide_plugins'", $plugins)); } $offset = 0; $limit = 250; while (true) { // Loop over and get each sites active plugins $blogs = $wpdb->get_results("SELECT blog_id FROM {$wpdb->blogs} LIMIT {$offset}, {$limit}", ARRAY_A); if (empty($blogs)) break; foreach ($blogs as $row) { if (!apply_filters('updraftplus_restore_this_site', true, $row['blog_id'], '', $this->restore_options)) continue; $plugins = $wpdb->get_row("SELECT option_value FROM ".$wpdb->get_blog_prefix($row['blog_id'])."options WHERE option_name = 'active_plugins'"); if (empty($plugins->option_value)) continue; $plugins = $this->deactivate_missing_plugins($plugins->option_value); $wpdb->query($wpdb->prepare("UPDATE ".$wpdb->get_blog_prefix($row['blog_id'])."options SET option_value=%s WHERE option_name='active_plugins'", $plugins)); } $offset += $limit; } } else { $plugins = $wpdb->get_row("SELECT option_value FROM {$import_table_prefix}options WHERE option_name = 'active_plugins'"); if (empty($plugins->option_value)) return; $plugins = $this->deactivate_missing_plugins($plugins->option_value); $plugins = UpdraftPlus::unserialize($plugins); if (!is_array($plugins)) $plugins = array(); $old_updraftplus_plugin_slug = $this->old_updraftplus_plugin_slug; if (empty($old_updraftplus_plugin_slug) \|\| !file_exists(WP_PLUGIN_DIR.'/'.$old_updraftplus_plugin_slug)) $old_updraftplus_plugin_slug = UPDRAFTPLUS_PLUGIN_SLUG; if (!in_array($old_updraftplus_plugin_slug, $plugins)) { $plugins[] = $old_updraftplus_plugin_slug; } $plugins = serialize($plugins); $wpdb->query($wpdb->prepare("UPDATE {$import_table_prefix}options SET option_value=%s WHERE option_name='active_plugins'", $plugins)); } } /* * This function will check the list of active plugins and ensure they are still installed, if any are missing it will deactivate them to prevent the site from crashing. * * @param String $plugins - serialized active plugins * * @return String - filtered results / private function deactivate_missing_plugins($plugins) { global $updraftplus; if (!function_exists('get_plugins')) include_once(ABSPATH.'wp-admin/includes/plugin.php'); $installed_plugins = array_keys(get_plugins()); $plugins = $updraftplus->unserialize($plugins); foreach ($plugins as $key => $path) { // Single site and multisite have a different array structure, in single site the path is the array value, in multisite the path is the array key. if (!in_array($key, $installed_plugins) && !in_array($path, $installed_plugins)) { $log_path = $this->is_multisite ? $key : $path; $updraftplus->log_e('Plugin path %s not found: de-activating.', $log_path); unset($plugins[$key]); } } $plugins = serialize($plugins); return $plugins; } /* * This function will return a random table prefix * * @param String $string - default prefix * * @return String - the random prefix / public function updraftplus_random_restore_table_prefix($string) { global $wpdb; while (true) { $random_string = UpdraftPlus_Manipulation_Functions::generate_random_string(2). '_'; if ($string != $random_string) { if (0 === $wpdb->query("SHOW TABLES LIKE '".$random_string."%'")) return $random_string; } } } /* * This function will drop all tables from the database * * @param Array $tables - list of table names / private function drop_tables($tables) { foreach ($tables as $table) $this->sql_exec('DROP TABLE IF EXISTS '.UpdraftPlus_Manipulation_Functions::backquote($table), 1, '', false); } /* * Adjust and replace the invalid root path of the auto_prepend_file values with the current server's root path / private function adjust_auto_prepend_directive() { global $wp_filesystem, $updraftplus; $external_plugins = array( 'wordfence' => array( 'filename' => 'wordfence-waf.php', // this file is located in the root directory so there's no additional path in it, other plugins may place the corresponding file in its plugin directory, in that case the additional path should be added (e.g. 'wp-content/plugins/plugin-name/file-name.php') 'callback' => 'adjust_wordfencewaf_root_path', ) ); foreach ($updraftplus->server_configuration_file_list() as $server_config_file) { if (empty($server_config_file)) continue; if (file_exists($this->abspath.$server_config_file)) { $updraftplus->log("$server_config_file configuration file has been detected during the restoration. Trying to open the file now for various-fixing tasks"); $server_config_file_content = file_get_contents($this->abspath.$server_config_file); if (false !== $server_config_file_content) { foreach ($external_plugins as $data) { $file_pattern = str_replace(array('/', '.', "'", '"'), array('\/', '\.', "\'", '\"'), $data['filename']); if (file_exists($this->abspath.$data['filename'])) { if (!$wp_filesystem->put_contents($this->abspath.$server_config_file, preg_replace('/((?:php_value\s\s)?auto_prepend_file(?:\s=)?\s(?:\'\|")).+?'.$file_pattern.'(\'\|")/is', "$1{$this->abspath}{$data['filename']}$2", $server_config_file_content))) { $updraftplus->log("Couldn't write a fix into the $server_config_file file"); } if (isset($data['callback']) && method_exists($this, $data['callback'])) call_user_func(array($this, $data['callback'])); } else { // if somehow, some way, the plugin's auto prepended file is missing then the auto_prepend_file directive in the config file needs to be removed or it will cause a fatal error if (!$wp_filesystem->put_contents($this->abspath.$server_config_file, preg_replace('/((?:php_value\s\s)?auto_prepend_file(?:\s=)?\s(?:\'\|")).+?'.$file_pattern.'(\'\|")/is', "", $server_config_file_content))) { $updraftplus->log("The {$data['filename']} file doesn't exist, couldn't write a fix into the $server_config_file file"); } } } } else { $updraftplus->log("Failed to read the $server_config_file file"); } } } } /* * Adjust and replace the root paths in the wordfence-waf.php file with the current server's root path / private function adjust_wordfencewaf_root_path() { global $wp_filesystem, $updraftplus; if (file_exists($this->abspath.'wordfence-waf.php')) { $updraftplus->log("Wordfence auto-prepended file has been detected during the restoration. Trying to open the file now for various-fixing tasks"); $wordfence_waf = file_get_contents($this->abspath.'wordfence-waf.php'); if (false !== $wordfence_waf) { // https://regex101.com/r/VeCwzH/1/ if (preg_match_all('/(?:wp-content[\/\\\]+plugins[\/\\\]+wordfence[\/\\\]+waf[\/\\\]+bootstrap\.php\|wp-content[\/\\\]+wflogs[\/\\\])((?:\'\|"))/is', $wordfence_waf, $matches, PREG_OFFSET_CAPTURE \| PREG_SET_ORDER)) { $matches = array_reverse($matches); foreach ($matches as $match) { $enclosure_cnt = 0; $start = (int) $match[0][1]; $enclosure = $match[1][0]; $offset = -1; for ($i=$start; $i>=0; $i--) { if ($enclosure_cnt > 0) { if ('\\' === $wordfence_waf[$i]) { $enclosure_cnt--; } else { $offset = $i+2; break; } } else { if ($enclosure === $wordfence_waf[$i]) { $enclosure_cnt++; } } } if ($offset >= 0) { if (false !== stripos($match[0][0], 'wflogs')) { $wordfence_waf = substr_replace($wordfence_waf, WP_CONTENT_DIR.'/wflogs/', $offset, ((int) $match[1][1]) - $offset); } else { $wordfence_waf = substr_replace($wordfence_waf, WP_PLUGIN_DIR.'/wordfence/waf/bootstrap.php', $offset, ((int) $match[1][1]) - $offset); } } } if (!$wp_filesystem->put_contents($this->abspath.'wordfence-waf.php', $wordfence_waf)) { $updraftplus->log("Couldn't write fixes into the wordfence-waf.php file"); } } } else { $updraftplus->log("Failed to read the wordfence-waf.php file"); } } } } // The purpose of this is that, in a certain case, we want to forbid the "move" operation from doing a copy/delete if a direct move fails... because we have our own method for retrying (and don't want to risk copying a tonne of data if we can avoid it) if (!class_exists('WP_Filesystem_Direct')) { if (!class_exists('WP_Filesystem_Base')) include_once(ABSPATH.'wp-admin/includes/class-wp-filesystem-base.php'); include_once(ABSPATH.'wp-admin/includes/class-wp-filesystem-direct.php'); } class UpdraftPlus_WP_Filesystem_Direct extends WP_Filesystem_Direct { /** * Moves a file * * @param String $source Path to the source file. * @param String $destination Path to the destination file. * @param Boolean $overwrite Whether to overwrite the destination file if it exists. * * @return Boolean Success status / public function move($source, $destination, $overwrite = false) { if (!$overwrite && $this->exists($destination)) return false; // try using rename first. if that fails (for example, source is read only) try copy if (@rename($source, $destination))// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- errors are handled via a different strategy return true; return false; } } /* * Plugin class that is used for Elementor's namespace aliasing or could also be used for a variety of purposes of Elementor need / if (!class_exists('\Elementor\Plugin')) { class UpdraftPlus_Elementor_Plugin { } } /* * Get a protected property / class UpdraftPlus_WPDB extends wpdb { /* * Get the database handle * * @return Mixed - the database handle / public function updraftplus_get_database_handle() { return $this->dbh; } /* * Return whether the object is using mysqli or not. * * @return Boolean */ public function updraftplus_use_mysqli() { return $this->dbh instanceof mysqli; } }	241.34 KB	2025-10-09 08:53
📁 templates	-	2025-10-09 08:53
📄 updraftplus.php <?php // @codingStandardsIgnoreStart /* Plugin Name: UpdraftPlus - Backup/Restore Plugin URI: https://updraftplus.com Description: Backup and restore: take backups locally, or backup to Amazon S3, Dropbox, Google Drive, Rackspace, (S)FTP, WebDAV & email, on automatic schedules. Author: TeamUpdraft, DavidAnderson Version: 1.25.8 Donate link: https://david.dw-perspective.org.uk/donate License: GPLv3 or later Text Domain: updraftplus Domain Path: /languages Author URI: https://updraftplus.com / // @codingStandardsIgnoreEnd / Portions copyright 2011-25 David Anderson Portions copyright 2010 Paul Kehrer Other portions copyright as indicated by authors in the relevant files This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA / if (!defined('ABSPATH')) die('No direct access allowed'); if ((isset($updraftplus) && is_object($updraftplus) && is_a($updraftplus, 'UpdraftPlus')) \|\| function_exists('updraftplus_modify_cron_schedules')) return; // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UndefinedVariable -- There is a possibility that the $updraftplus variable is already defined from previous process. define('UPDRAFTPLUS_DIR', dirname(__FILE__)); define('UPDRAFTPLUS_URL', plugins_url('', __FILE__)); define('UPDRAFTPLUS_PLUGIN_SLUG', plugin_basename(__FILE__)); define('UPDRAFT_DEFAULT_OTHERS_EXCLUDE', 'upgrade,cache,updraft,backup,backups,mysql.sql,debug.log'); define('UPDRAFT_DEFAULT_UPLOADS_EXCLUDE', 'backup,backups,backwpup,wp-clone,snapshots,wp-staging'); // The following can go in your wp-config.php // Tables whose data can be skipped without significant loss, if (and only if) the attempt to back them up fails (e.g. bwps_log, from WordPress Better Security, is log data; but individual entries can be huge and cause out-of-memory fatal errors on low-resource environments). Comma-separate the table names (without the WordPress table prefix). if (!defined('UPDRAFTPLUS_DATA_OPTIONAL_TABLES')) define('UPDRAFTPLUS_DATA_OPTIONAL_TABLES', 'bwps_log,statpress,slim_stats,redirection_logs,Counterize,Counterize_Referers,Counterize_UserAgents,wbz404_logs,wbz404_redirects,tts_trafficstats,tts_referrer_stats,wponlinebackup_generations,svisitor_stat,simple_feed_stats,itsec_log,relevanssi_log,blc_instances,wysija_email_user_stat,woocommerce_sessions,et_bloom_stats,redirection_404,lbakut_activity_log,stream_meta,wfFileMods,wffilemods,wfBlockedIPLog,wfblockediplog,page_visit_history,strack_st'); if (!defined('UPDRAFTPLUS_ZIP_EXECUTABLE')) define('UPDRAFTPLUS_ZIP_EXECUTABLE', "/usr/bin/zip,/bin/zip,/usr/local/bin/zip,/usr/sfw/bin/zip,/usr/xdg4/bin/zip,/opt/bin/zip"); if (!defined('UPDRAFTPLUS_MYSQLDUMP_EXECUTABLE')) define('UPDRAFTPLUS_MYSQLDUMP_EXECUTABLE', updraftplus_build_mysqldump_list()); // If any individual file size is greater than this, then a warning is given if (!defined('UPDRAFTPLUS_WARN_FILE_SIZE')) define('UPDRAFTPLUS_WARN_FILE_SIZE', 10241024250); // On a test on a Pentium laptop, 100,000 rows needed ~ 1 minute to write out - so 150,000 is around the CPanel default of 90 seconds execution time. if (!defined('UPDRAFTPLUS_WARN_DB_ROWS')) define('UPDRAFTPLUS_WARN_DB_ROWS', 150000); // The smallest value (in megabytes) that the "split zip files at" setting is allowed to be set to if (!defined('UPDRAFTPLUS_SPLIT_MIN')) define('UPDRAFTPLUS_SPLIT_MIN', 25); // The maximum number of files to batch at one time when writing to the backup archive. You'd only be likely to want to raise (not lower) this. if (!defined('UPDRAFTPLUS_MAXBATCHFILES')) define('UPDRAFTPLUS_MAXBATCHFILES', 1000); // If any individual email attachment is greater than this, then a warning is given (and then removed if the email actually succeeds) if (!defined('UPDRAFTPLUS_WARN_EMAIL_SIZE')) define('UPDRAFTPLUS_WARN_EMAIL_SIZE', 201048576); // Filetypes that should be stored inside the zip without any attempt at further compression. By default, we mark several extensions that refer to filetypes that are already compressed as not needing further compression - which saves time/resources. This option only applies to zip engines that support varying the compression method. Specify in lower-case, and upper-case variants (and for some zip engines, all variants) will automatically be included. if (!defined('UPDRAFTPLUS_ZIP_NOCOMPRESS')) define('UPDRAFTPLUS_ZIP_NOCOMPRESS', '.jpg,.jpeg,.png,.gif,.zip,.gz,.bz2,.xz,.rar,.mp3,.mp4,.mpeg,.avi,.mov'); // This is passed to set_time_limit() at various points, to try to maximise run-time. (UD resumes if it gets killed, but more in one stretch always helps). The effect of this varies according to the hosting setup - it can't necessarily always be controlled. if (!defined('UPDRAFTPLUS_SET_TIME_LIMIT')) define('UPDRAFTPLUS_SET_TIME_LIMIT', 900); // Options to pass to the zip binary (if that method happens to be used). By default, we mark the extensions specified in UPDRAFTPLUS_ZIP_NOCOMPRESS for non-compression via the -n flag if (!defined('UPDRAFTPLUS_BINZIP_OPTS')) { $zip_nocompress = array_map('trim', explode(',', UPDRAFTPLUS_ZIP_NOCOMPRESS)); $zip_binzip_opts = ''; foreach ($zip_nocompress as $ext) { if (empty($zip_binzip_opts)) { $zip_binzip_opts = "-n $ext:".strtoupper($ext); } else { $zip_binzip_opts .= ':'.$ext.':'.strtoupper($ext); } } define('UPDRAFTPLUS_BINZIP_OPTS', $zip_binzip_opts); } /* * A wrapper for (require\|include)(_once)? that will first check for existence, and direct the user what to do (since the traditional PHP error messages aren't clear enough for all users) * * @param String $path the file path to check * @param String $method the method to load the file / function updraft_try_include_file($path, $method = 'include') { $file_to_include = UPDRAFTPLUS_DIR.'/'.$path; if (!file_exists($file_to_include)) { // phpcs:disable WordPress.Security.EscapeOutput.OutputNotEscaped,WordPress.PHP.DevelopmentFunctions.error_log_trigger_error -- Error message to be printed when it is caught. trigger_error( sprintf( / translators: %s: File along with full path. / __('The expected file %s is missing from your UpdraftPlus installation.', 'updraftplus').' '. __('Most likely, WordPress did not correctly unpack the plugin when installing it.', 'updraftplus').' '.__('You should de-install and then re-install the plugin (your settings and data will be retained).', 'updraftplus'), $file_to_include ), E_USER_WARNING ); // phpcs:enable WordPress.Security.EscapeOutput.OutputNotEscaped,WordPress.PHP.DevelopmentFunctions.error_log_trigger_error } if ('include' === $method) { include($file_to_include); } elseif ('include_once' === $method) { include_once($file_to_include); } elseif ('require' === $method) { require($file_to_include); // phpcs:ignore PEAR.Files.IncludingFile.UseInclude -- File required intentionally. } else { require_once($file_to_include); } } // Load add-ons and files that may or may not be present, depending on where the plugin was distributed if (is_file(UPDRAFTPLUS_DIR.'/autoload.php')) updraft_try_include_file('autoload.php', 'require_once'); /* * Get cron schedules list of our own * DEVELOPER NOTES: Intervals should be presented in chronological order of time because we also use this list for ordering purpose especially when merging WP default intervals to ours * * @return Boolean The list of our own schedules / function updraftplus_list_cron_schedules() { global $wp_current_filter; // To prevent "_load_textdomain_just_in_time was called incorrectly" warning if (((function_exists('doing_action') && !doing_action('after_setup_theme')) \|\| !in_array('after_setup_theme', $wp_current_filter, true)) && !did_action('after_setup_theme')) { $every_particular_hour_label = 'Every %s hours'; $every_hour = 'Every hour'; } else { / translators: %s: Number of Hours. / $every_particular_hour_label = __('Every %s hours', 'updraftplus'); $every_hour = __('Every hour', 'updraftplus'); } return array( 'everyhour' => array( 'interval' => 3600, 'display' => apply_filters('updraftplus_cron_schedule_description', $every_hour, 'everyhour'), ), 'every2hours' => array( 'interval' => 7200, 'display' => apply_filters('updraftplus_cron_schedule_description', sprintf($every_particular_hour_label, '2'), 'every2hours'), ), 'every4hours' => array( 'interval' => 14400, 'display' => apply_filters('updraftplus_cron_schedule_description', sprintf($every_particular_hour_label, '4'), 'every4hours'), ), 'every8hours' => array( 'interval' => 28800, 'display' => apply_filters('updraftplus_cron_schedule_description', sprintf($every_particular_hour_label, '8'), 'every8hours'), ), 'twicedaily' => array( 'interval' => 43200, 'display' => apply_filters('updraftplus_cron_schedule_description', sprintf($every_particular_hour_label, '12'), 'twicedaily'), ), 'daily' => array( 'interval' => 86400, 'display' => apply_filters('updraftplus_cron_schedule_description', __('Daily'), 'daily'), ), 'weekly' => array( 'interval' => 604800, 'display' => apply_filters('updraftplus_cron_schedule_description', __('Weekly'), 'weekly'), ), 'fortnightly' => array( 'interval' => 1209600, 'display' => apply_filters('updraftplus_cron_schedule_description', __('Fortnightly'), 'fortnightly'), ), 'monthly' => array( 'interval' => 2592000, 'display' => apply_filters('updraftplus_cron_schedule_description', __('Monthly'), 'monthly'), ), ); } if (!function_exists('updraftplus_modify_cron_schedules')) : /* * wp-cron only has hourly, daily and twicedaily, so we need to add some of our own * * @param array $schedules an array of schedule types * @return array cron schedules which contains schedules of our own / function updraftplus_modify_cron_schedules($schedules) { return array_merge($schedules, updraftplus_list_cron_schedules()); } endif; // http://codex.wordpress.org/Plugin_API/Filter_Reference/cron_schedules. Raised priority because some plugins wrongly over-write all prior schedule changes (including BackupBuddy!) add_filter('cron_schedules', 'updraftplus_modify_cron_schedules', 30); // The checks here before loading are for performance only - unless one of those conditions is met, then none of the hooks will ever be used if (!is_admin() && (!defined('DOING_CRON') \|\| !DOING_CRON) && (!defined('XMLRPC_REQUEST') \|\| !XMLRPC_REQUEST) && empty($_SERVER['SHELL']) && empty($_POST['udrpc_message']) && empty($_GET['udcentral_action']) && (defined('UPDRAFTPLUS_THIS_IS_CLONE') && '1' != UPDRAFTPLUS_THIS_IS_CLONE) && empty($_GET['uc_auto_login']) && (empty($_SERVER['REQUEST_METHOD']) \|\| 'OPTIONS' != $_SERVER['REQUEST_METHOD']) && (!defined('WP_CLI') \|\| !WP_CLI)) { // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended -- False positive: nonce verification not required here. // There is no good way to work out if the cron event is likely to be called under the ALTERNATE_WP_CRON system, other than re-running the calculation // If ALTERNATE_WP_CRON is not active (and a few other things), then we are done if (!defined('ALTERNATE_WP_CRON') \|\| !ALTERNATE_WP_CRON \|\| !empty($_POST) \|\| defined('DOING_AJAX') \|\| isset($_GET['doing_wp_cron'])) return; // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended -- False positive: nonce verification not required here. // The check below is the one used by spawn_cron() to decide whether cron events should be run $gmt_time = microtime(true); $lock = get_transient('doing_cron'); if ($lock > $gmt_time + 10 60) $lock = 0; if ((defined('WP_CRON_LOCK_TIMEOUT') && $lock + WP_CRON_LOCK_TIMEOUT > $gmt_time) \|\| (!defined('WP_CRON_LOCK_TIMEOUT') && $lock + 60 > $gmt_time)) return; if (function_exists('_get_cron_array')) { $crons = _get_cron_array(); } else { $crons = get_option('cron'); } if (!is_array($crons)) return; $keys = array_keys($crons); if (isset($keys[0]) && $keys[0] > $gmt_time) return; // If we got this far, then cron is going to be fired, so we do want to load all our hooks } $updraftplus_have_addons = 0; if (is_dir(UPDRAFTPLUS_DIR.'/addons') && $dir_handle = opendir(UPDRAFTPLUS_DIR.'/addons')) { while (false !== ($e = readdir($dir_handle))) { if (is_file(UPDRAFTPLUS_DIR.'/addons/'.$e) && preg_match('/\.php$/', $e)) { // We used to have 1024 bytes here - but this meant that if someone's site was hacked and a lot of code added at the top, and if they were running a too-low PHP version, then they might just see the symptom rather than the cause - and raise the support request with us. $header = file_get_contents(UPDRAFTPLUS_DIR.'/addons/'.$e, false, null, 0, 16384); $phprequires = preg_match("/RequiresPHP: (\d[\d\.]+)/", $header, $matches) ? $matches[1] : false; $phpinclude = preg_match("/IncludePHP: (\S+)/", $header, $matches) ? $matches[1] : false; if (false === $phprequires \|\| version_compare(PHP_VERSION, $phprequires, '>=')) { $updraftplus_have_addons++; if ($phpinclude) updraft_try_include_file(''.$phpinclude, 'include_once'); updraft_try_include_file('addons/'.$e, 'include_once'); } unset($header); } } @closedir($dir_handle);// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged -- Silenced to suppress errors that may arise because of the function. } if (is_file(UPDRAFTPLUS_DIR.'/udaddons/updraftplus-addons.php')) updraft_try_include_file('udaddons/updraftplus-addons.php', 'require_once'); if (!file_exists(UPDRAFTPLUS_DIR.'/class-updraftplus.php') \|\| !file_exists(UPDRAFTPLUS_DIR.'/options.php')) { /** * Warn if they've not got the whole plugin - can happen if WP crashes (e.g. out of disk space) when upgrading the plugin / function updraftplus_incomplete_install_warning() { echo '<div class="updraftmessage error"><p><strong>'.esc_html(__('Error', 'updraftplus')).':</strong> '.esc_html(__('You do not have UpdraftPlus completely installed - please de-install and install it again.', 'updraftplus').' '.__('Most likely, WordPress malfunctioned when copying the plugin files.', 'updraftplus')).' <a href="https://updraftplus.com/faqs/wordpress-crashed-when-updating-updraftplus-what-can-i-do/">'.esc_html__('Go here for more information.', 'updraftplus').'</a></p></div>'; } add_action('all_admin_notices', 'updraftplus_incomplete_install_warning'); } else { updraft_try_include_file('class-updraftplus.php', 'include_once'); $updraftplus = new UpdraftPlus(); $GLOBALS['updraftplus'] = $updraftplus; $updraftplus->have_addons = $updraftplus_have_addons; if (!$updraftplus->memory_check(192)) { // Experience appears to show that the memory limit is only likely to be hit (unless it is very low) by single files that are larger than available memory (when compressed) // Add sanity checks - found someone who'd set WP_MAX_MEMORY_LIMIT to 256K ! if (!$updraftplus->memory_check($updraftplus->memory_check_current(WP_MAX_MEMORY_LIMIT))) { $new = absint($updraftplus->memory_check_current(WP_MAX_MEMORY_LIMIT)); if ($new>32 && $new<100000) { @ini_set('memory_limit', $new.'M');// phpcs:ignore Generic.PHP.NoSilencedErrors.Discouraged,Squiz.PHP.DiscouragedFunctions.Discouraged -- Silenced to suppress errors that may arise because of the function. Safely using discouraged function ini_set(). } } } // Blocking updates during restore; placed here so that it still runs e.g. under WP-CLI $updraftplus->block_updates_during_restore_progress(); } // Ubuntu bug - https://bugs.launchpad.net/ubuntu/+source/php5/+bug/1315888 if (!function_exists('gzopen') && function_exists('gzopen64')) { function gzopen($filename, $mode, $use_include_path = 0) { return gzopen64($filename, $mode, $use_include_path); } } /* * For finding mysqldump. Added to include Windows locations. / function updraftplus_build_mysqldump_list() { if ('win' == strtolower(substr(PHP_OS, 0, 3)) && function_exists('glob')) { $drives = array('C', 'D', 'E'); if (!empty($_SERVER['DOCUMENT_ROOT'])) { // Get the drive that this is running on $current_drive = strtoupper(substr($_SERVER['DOCUMENT_ROOT'], 0, 1)); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Sanitization not needed as we are extracting only first letter and using it. if (!in_array($current_drive, $drives)) array_unshift($drives, $current_drive); } $directories = array(); foreach ($drives as $drive_letter) { $dir = glob("$drive_letter:\\{Program Files\\MySQL\\{,MySQL,etc}{,\\bin,\\?},mysqldump}\\mysqldump*", GLOB_BRACE); if (is_array($dir)) $directories = array_merge($directories, $dir); } $drive_string = implode(',', $directories); return $drive_string; } else { return "/usr/bin/mysqldump,/bin/mysqldump,/usr/local/bin/mysqldump,/usr/sfw/bin/mysqldump,/usr/xdg4/bin/mysqldump,/opt/bin/mysqldump"; } } // Do this even if the missing files detection above fired, as the "missing files" detection above has a greater chance of showing the user useful info if (!class_exists('UpdraftPlus_Options')) updraft_try_include_file('options.php', 'require_once');	17.43 KB	2025-10-09 08:53
📁 vendor	-	2025-10-09 08:53

Edit File:

Terminal