mirror of
https://github.com/moodle/moodle.git
synced 2025-01-18 05:58:34 +01:00
2cd901a4e7
This patch adds asynchronous backup and restore functionality to Moodle. This is an optional feature and is not enabled by default. It can be enabled by site administrators. Asynchronous backup and restores are actioned by the Moodle adhoc task API. The progress of backup and restores is displayedin the Moodle UI. Users can also be sent a message when a backup or restore operation completes via the Moodle messaging API.
208 lines
8.3 KiB
PHP
208 lines
8.3 KiB
PHP
<?php
|
|
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle 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.
|
|
//
|
|
// Moodle 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 Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
/**
|
|
* Import backup file or select existing backup file from moodle
|
|
* @package moodlecore
|
|
* @copyright 2010 Dongsheng Cai <dongsheng@moodle.com>
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
require_once('../config.php');
|
|
require_once(__DIR__ . '/restorefile_form.php');
|
|
require_once($CFG->dirroot . '/backup/util/includes/restore_includes.php');
|
|
|
|
// current context
|
|
$contextid = required_param('contextid', PARAM_INT);
|
|
$filecontextid = optional_param('filecontextid', 0, PARAM_INT);
|
|
// action
|
|
$action = optional_param('action', '', PARAM_ALPHA);
|
|
// file parameters
|
|
// non js interface may require these parameters
|
|
$component = optional_param('component', null, PARAM_COMPONENT);
|
|
$filearea = optional_param('filearea', null, PARAM_AREA);
|
|
$itemid = optional_param('itemid', null, PARAM_INT);
|
|
$filepath = optional_param('filepath', null, PARAM_PATH);
|
|
$filename = optional_param('filename', null, PARAM_FILE);
|
|
|
|
list($context, $course, $cm) = get_context_info_array($contextid);
|
|
|
|
// will be used when restore
|
|
if (!empty($filecontextid)) {
|
|
$filecontext = context::instance_by_id($filecontextid);
|
|
}
|
|
|
|
$url = new moodle_url('/backup/restorefile.php', array('contextid'=>$contextid));
|
|
|
|
switch ($context->contextlevel) {
|
|
case CONTEXT_MODULE:
|
|
$heading = get_string('restoreactivity', 'backup');
|
|
break;
|
|
case CONTEXT_COURSE:
|
|
default:
|
|
$heading = get_string('restorecourse', 'backup');
|
|
}
|
|
|
|
|
|
require_login($course, false, $cm);
|
|
require_capability('moodle/restore:restorecourse', $context);
|
|
|
|
if (is_null($course)) {
|
|
$courseid = 0;
|
|
$coursefullname = $SITE->fullname;
|
|
} else {
|
|
$courseid = $course->id;
|
|
$coursefullname = $course->fullname;
|
|
}
|
|
|
|
$browser = get_file_browser();
|
|
|
|
// check if tmp dir exists
|
|
$tmpdir = make_backup_temp_directory('', false);
|
|
if (!check_dir_exists($tmpdir, true, true)) {
|
|
throw new restore_controller_exception('cannot_create_backup_temp_dir');
|
|
}
|
|
|
|
// choose the backup file from backup files tree
|
|
if ($action == 'choosebackupfile') {
|
|
if ($filearea == 'automated') {
|
|
require_capability('moodle/restore:viewautomatedfilearea', $context);
|
|
}
|
|
if ($fileinfo = $browser->get_file_info($filecontext, $component, $filearea, $itemid, $filepath, $filename)) {
|
|
if (is_a($fileinfo, 'file_info_stored')) {
|
|
// Use the contenthash rather than copying the file where possible,
|
|
// to improve performance and avoid timeouts with large files.
|
|
$fs = get_file_storage();
|
|
$params = $fileinfo->get_params();
|
|
$file = $fs->get_file($params['contextid'], $params['component'], $params['filearea'],
|
|
$params['itemid'], $params['filepath'], $params['filename']);
|
|
$restore_url = new moodle_url('/backup/restore.php', array('contextid' => $contextid,
|
|
'pathnamehash' => $file->get_pathnamehash(), 'contenthash' => $file->get_contenthash()));
|
|
} else {
|
|
// If it's some weird other kind of file then use old code.
|
|
$filename = restore_controller::get_tempdir_name($courseid, $USER->id);
|
|
$pathname = $tmpdir . '/' . $filename;
|
|
if (!$fileinfo->copy_to_pathname($pathname)) {
|
|
throw new restore_ui_exception('errorcopyingbackupfile', null, $pathname);
|
|
}
|
|
$restore_url = new moodle_url('/backup/restore.php', array(
|
|
'contextid' => $contextid, 'filename' => $filename));
|
|
}
|
|
redirect($restore_url);
|
|
} else {
|
|
redirect($url, get_string('filenotfound', 'error'));
|
|
}
|
|
die;
|
|
}
|
|
|
|
$PAGE->set_url($url);
|
|
$PAGE->set_context($context);
|
|
$PAGE->set_title(get_string('course') . ': ' . $coursefullname);
|
|
$PAGE->set_heading($heading);
|
|
$PAGE->set_pagelayout('admin');
|
|
$PAGE->requires->js_call_amd('core_backup/async_backup', 'asyncBackupAllStatus', array($context->id));
|
|
|
|
$form = new course_restore_form(null, array('contextid'=>$contextid));
|
|
$data = $form->get_data();
|
|
if ($data && has_capability('moodle/restore:uploadfile', $context)) {
|
|
$filename = restore_controller::get_tempdir_name($courseid, $USER->id);
|
|
$pathname = $tmpdir . '/' . $filename;
|
|
if (!$form->save_file('backupfile', $pathname)) {
|
|
throw new restore_ui_exception('errorcopyingbackupfile', null, $pathname);
|
|
}
|
|
$restore_url = new moodle_url('/backup/restore.php', array('contextid'=>$contextid, 'filename'=>$filename));
|
|
redirect($restore_url);
|
|
die;
|
|
}
|
|
|
|
echo $OUTPUT->header();
|
|
|
|
// require uploadfile cap to use file picker
|
|
if (has_capability('moodle/restore:uploadfile', $context)) {
|
|
echo $OUTPUT->heading(get_string('importfile', 'backup'));
|
|
echo $OUTPUT->container_start();
|
|
$form->display();
|
|
echo $OUTPUT->container_end();
|
|
}
|
|
|
|
if ($context->contextlevel == CONTEXT_MODULE) {
|
|
echo $OUTPUT->heading_with_help(get_string('choosefilefromactivitybackup', 'backup'), 'choosefilefromuserbackup', 'backup');
|
|
echo $OUTPUT->container_start();
|
|
$treeview_options = array();
|
|
$user_context = context_user::instance($USER->id);
|
|
$treeview_options['filecontext'] = $context;
|
|
$treeview_options['currentcontext'] = $context;
|
|
$treeview_options['component'] = 'backup';
|
|
$treeview_options['context'] = $context;
|
|
$treeview_options['filearea'] = 'activity';
|
|
$renderer = $PAGE->get_renderer('core', 'backup');
|
|
echo $renderer->backup_files_viewer($treeview_options);
|
|
echo $OUTPUT->container_end();
|
|
}
|
|
|
|
echo $OUTPUT->heading_with_help(get_string('choosefilefromcoursebackup', 'backup'), 'choosefilefromcoursebackup', 'backup');
|
|
echo $OUTPUT->container_start();
|
|
$treeview_options = array();
|
|
$treeview_options['filecontext'] = $context;
|
|
$treeview_options['currentcontext'] = $context;
|
|
$treeview_options['component'] = 'backup';
|
|
$treeview_options['context'] = $context;
|
|
$treeview_options['filearea'] = 'course';
|
|
$renderer = $PAGE->get_renderer('core', 'backup');
|
|
echo $renderer->backup_files_viewer($treeview_options);
|
|
echo $OUTPUT->container_end();
|
|
|
|
echo $OUTPUT->heading_with_help(get_string('choosefilefromuserbackup', 'backup'), 'choosefilefromuserbackup', 'backup');
|
|
echo $OUTPUT->container_start();
|
|
$treeview_options = array();
|
|
$user_context = context_user::instance($USER->id);
|
|
$treeview_options['filecontext'] = $user_context;
|
|
$treeview_options['currentcontext'] = $context;
|
|
$treeview_options['component'] = 'user';
|
|
$treeview_options['context'] = 'backup';
|
|
$treeview_options['filearea'] = 'backup';
|
|
$renderer = $PAGE->get_renderer('core', 'backup');
|
|
echo $renderer->backup_files_viewer($treeview_options);
|
|
echo $OUTPUT->container_end();
|
|
|
|
$automatedbackups = get_config('backup', 'backup_auto_active');
|
|
if (!empty($automatedbackups)) {
|
|
echo $OUTPUT->heading_with_help(get_string('choosefilefromautomatedbackup', 'backup'), 'choosefilefromautomatedbackup', 'backup');
|
|
echo $OUTPUT->container_start();
|
|
$treeview_options = array();
|
|
$user_context = context_user::instance($USER->id);
|
|
$treeview_options['filecontext'] = $context;
|
|
$treeview_options['currentcontext'] = $context;
|
|
$treeview_options['component'] = 'backup';
|
|
$treeview_options['context'] = $context;
|
|
$treeview_options['filearea'] = 'automated';
|
|
$renderer = $PAGE->get_renderer('core', 'backup');
|
|
echo $renderer->backup_files_viewer($treeview_options);
|
|
echo $OUTPUT->container_end();
|
|
}
|
|
|
|
// In progress course restores.
|
|
if (async_helper::is_async_enabled()) {
|
|
echo $OUTPUT->heading_with_help(get_string('asyncrestoreinprogress', 'backup'), 'asyncrestoreinprogress', 'backup');
|
|
echo $OUTPUT->container_start();
|
|
$renderer = $PAGE->get_renderer('core', 'backup');
|
|
echo $renderer->restore_progress_viewer($USER->id, $context);
|
|
echo $OUTPUT->container_end();
|
|
}
|
|
|
|
echo $OUTPUT->footer();
|