mirror of
https://github.com/moodle/moodle.git
synced 2025-07-18 21:01:27 +02:00
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.
149 lines
6.0 KiB
PHP
149 lines
6.0 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/>.
|
|
|
|
/**
|
|
* Asyncronhous helper tests.
|
|
*
|
|
* @package core_backup
|
|
* @copyright 2018 Matt Porritt <mattp@catalyst-au.net>
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
defined('MOODLE_INTERNAL') || die();
|
|
|
|
global $CFG;
|
|
require_once($CFG->dirroot . '/backup/util/includes/backup_includes.php');
|
|
require_once($CFG->dirroot . '/backup/util/includes/restore_includes.php');
|
|
|
|
/**
|
|
* Asyncronhous helper tests.
|
|
*
|
|
* @copyright 2018 Matt Porritt <mattp@catalyst-au.net>
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class core_backup_async_helper_testcase extends \core_privacy\tests\provider_testcase {
|
|
|
|
/**
|
|
* Tests sending message for asynchronous backup.
|
|
*/
|
|
public function test_send_message() {
|
|
global $DB, $USER;
|
|
$this->preventResetByRollback();
|
|
$this->resetAfterTest(true);
|
|
$this->setAdminUser();
|
|
|
|
set_config('backup_async_message_users', '1', 'backup');
|
|
set_config('backup_async_message_subject', 'Moodle {operation} completed sucessfully', 'backup');
|
|
set_config('backup_async_message',
|
|
'Dear {user_firstname} {user_lastname}, <br/> Your {operation} (ID: {backupid}) has completed successfully!',
|
|
'backup');
|
|
set_config('allowedemaildomains', 'example.com');
|
|
|
|
$generator = $this->getDataGenerator();
|
|
$course = $generator->create_course(); // Create a course with some availability data set.
|
|
$user2 = $generator->create_user(array('firstname' => 'test', 'lastname' => 'human', 'maildisplay' => 1));
|
|
$generator->enrol_user($user2->id, $course->id, 'editingteacher');
|
|
|
|
$DB->set_field_select('message_processors', 'enabled', 0, "name <> 'email'");
|
|
set_user_preference('message_provider_moodle_asyncbackupnotification', 'email', $user2);
|
|
|
|
// Make the backup controller for an async backup.
|
|
$bc = new backup_controller(backup::TYPE_1COURSE, $course->id, backup::FORMAT_MOODLE,
|
|
backup::INTERACTIVE_YES, backup::MODE_ASYNC, $user2->id);
|
|
$bc->finish_ui();
|
|
$backupid = $bc->get_backupid();
|
|
$bc->destroy();
|
|
|
|
$sink = $this->redirectEmails();
|
|
|
|
// Send message.
|
|
$asynchelper = new async_helper('backup', $backupid);
|
|
$messageid = $asynchelper->send_message();
|
|
|
|
$emails = $sink->get_messages();
|
|
$this->assertCount(1, $emails);
|
|
$email = reset($emails);
|
|
|
|
$this->assertSame($USER->email, $email->from);
|
|
$this->assertSame($user2->email, $email->to);
|
|
$this->assertSame('Moodle backup completed sucessfully', $email->subject);
|
|
$this->assertNotEmpty($email->header);
|
|
$this->assertNotEmpty($email->body);
|
|
$this->assertRegExp("/$backupid/", $email->body);
|
|
$this->assertThat($email->body, $this->logicalNot($this->stringContains('{')));
|
|
$this->assertGreaterThan(0, $messageid);
|
|
$sink->clear();
|
|
}
|
|
|
|
/**
|
|
* Tests getting the asynchronous backup table items.
|
|
*/
|
|
public function test_get_async_backups() {
|
|
global $DB, $CFG, $USER, $PAGE;
|
|
|
|
$this->resetAfterTest(true);
|
|
$this->setAdminUser();
|
|
$CFG->enableavailability = true;
|
|
$CFG->enablecompletion = true;
|
|
|
|
// Create a course with some availability data set.
|
|
$generator = $this->getDataGenerator();
|
|
$course = $generator->create_course(
|
|
array('format' => 'topics', 'numsections' => 3,
|
|
'enablecompletion' => COMPLETION_ENABLED),
|
|
array('createsections' => true));
|
|
$forum = $generator->create_module('forum', array(
|
|
'course' => $course->id));
|
|
$forum2 = $generator->create_module('forum', array(
|
|
'course' => $course->id, 'completion' => COMPLETION_TRACKING_MANUAL));
|
|
|
|
// We need a grade, easiest is to add an assignment.
|
|
$assignrow = $generator->create_module('assign', array(
|
|
'course' => $course->id));
|
|
$assign = new assign(context_module::instance($assignrow->cmid), false, false);
|
|
$item = $assign->get_grade_item();
|
|
|
|
// Make a test grouping as well.
|
|
$grouping = $generator->create_grouping(array('courseid' => $course->id,
|
|
'name' => 'Grouping!'));
|
|
|
|
$availability = '{"op":"|","show":false,"c":[' .
|
|
'{"type":"completion","cm":' . $forum2->cmid .',"e":1},' .
|
|
'{"type":"grade","id":' . $item->id . ',"min":4,"max":94},' .
|
|
'{"type":"grouping","id":' . $grouping->id . '}' .
|
|
']}';
|
|
$DB->set_field('course_modules', 'availability', $availability, array(
|
|
'id' => $forum->cmid));
|
|
$DB->set_field('course_sections', 'availability', $availability, array(
|
|
'course' => $course->id, 'section' => 1));
|
|
|
|
// Make the backup controller for an async backup.
|
|
$bc = new backup_controller(backup::TYPE_1COURSE, $course->id, backup::FORMAT_MOODLE,
|
|
backup::INTERACTIVE_YES, backup::MODE_ASYNC, $USER->id);
|
|
$bc->finish_ui();
|
|
$bc->destroy();
|
|
unset($bc);
|
|
|
|
$coursecontext = context_course::instance($course->id);
|
|
$renderer = $PAGE->get_renderer('core', 'backup');
|
|
|
|
$result = \async_helper::get_async_backups($renderer, $coursecontext->instanceid);
|
|
|
|
$this->assertEquals(1, count($result));
|
|
$this->assertEquals('backup.mbz', $result[0][0]);
|
|
}
|
|
}
|