Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
<?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/>.

/**
 * Course copy tests.
 *
 * @package    core_backup
 * @copyright  2020 onward The Moodle Users Association <https://moodleassociation.org/>
 * @author     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');
require_once($CFG->libdir . '/completionlib.php');

/**
 * Course copy tests.
 *
 * @package    core_backup
 * @copyright  2020 onward The Moodle Users Association <https://moodleassociation.org/>
 * @author     Matt Porritt <mattp@catalyst-au.net>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class core_backup_course_copy_testcase extends advanced_testcase {

    /**
     *
     * @var \stdClass Course used for testing.
     */
    protected $course;

    /**
     *
     * @var int User used to perform backups.
     */
    protected $userid;

    /**
     *
     * @var array Ids of users in test course.
     */
    protected $courseusers;

    /**
     *
     * @var array Names of the created activities.
     */
    protected $activitynames;

    /**
     * Set up tasks for all tests.
     */
< protected function setUp() {
> protected function setUp(): void {
global $DB, $CFG, $USER; $this->resetAfterTest(true); $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!')); // Create some users. $user1 = $generator->create_user(); $user2 = $generator->create_user(); $user3 = $generator->create_user(); $user4 = $generator->create_user(); $this->courseusers = array( $user1->id, $user2->id, $user3->id, $user4->id ); // Enrol users into the course. $generator->enrol_user($user1->id, $course->id, 'student'); $generator->enrol_user($user2->id, $course->id, 'editingteacher'); $generator->enrol_user($user3->id, $course->id, 'manager'); $generator->enrol_user($user4->id, $course->id, 'editingteacher'); $generator->enrol_user($user4->id, $course->id, 'manager'); $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)); // Add some user data to the course. $discussion = $generator->get_plugin_generator('mod_forum')->create_discussion(['course' => $course->id, 'forum' => $forum->id, 'userid' => $user1->id, 'timemodified' => time(), 'name' => 'Frog']); $generator->get_plugin_generator('mod_forum')->create_post(['discussion' => $discussion->id, 'userid' => $user1->id]); $this->course = $course; $this->userid = $USER->id; // Admin. $this->activitynames = array( $forum->name, $forum2->name, $assignrow->name ); // Set the user doing the backup to be a manager in the course. // By default Managers can restore courses AND users, teachers can only do users. $this->setUser($user3); // Disable all loggers. $CFG->backup_error_log_logger_level = backup::LOG_NONE; $CFG->backup_output_indented_logger_level = backup::LOG_NONE; $CFG->backup_file_logger_level = backup::LOG_NONE; $CFG->backup_database_logger_level = backup::LOG_NONE; $CFG->backup_file_logger_level_extra = backup::LOG_NONE; } /** * Test creating a course copy. */ public function test_create_copy() { // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'foo'; $formdata->shortname = 'bar'; $formdata->category = 1; $formdata->visible = 1; $formdata->startdate = 1582376400; $formdata->enddate = 0; $formdata->idnumber = 123; $formdata->userdata = 1; $formdata->role_1 = 1; $formdata->role_3 = 3; $formdata->role_5 = 5; $coursecopy = new \core_backup\copy\copy($formdata); $result = $coursecopy->create_copy(); // Load the controllers, to extract the data we need. $bc = \backup_controller::load_controller($result['backupid']); $rc = \restore_controller::load_controller($result['restoreid']); // Check the backup controller. $this->assertEquals($result, $bc->get_copy()->copyids); $this->assertEquals(backup::MODE_COPY, $bc->get_mode()); $this->assertEquals($this->course->id, $bc->get_courseid()); $this->assertEquals(backup::TYPE_1COURSE, $bc->get_type()); // Check the restore controller. $newcourseid = $rc->get_courseid(); $newcourse = get_course($newcourseid); $this->assertEquals($result, $rc->get_copy()->copyids); $this->assertEquals(get_string('copyingcourse', 'backup'), $newcourse->fullname); $this->assertEquals(get_string('copyingcourseshortname', 'backup'), $newcourse->shortname); $this->assertEquals(backup::MODE_COPY, $rc->get_mode()); $this->assertEquals($newcourseid, $rc->get_courseid()); // Check the created ad-hoc task. $now = time(); $task = \core\task\manager::get_next_adhoc_task($now); $this->assertInstanceOf('\\core\\task\\asynchronous_copy_task', $task); $this->assertEquals($result, (array)$task->get_custom_data()); $this->assertFalse($task->is_blocking()); \core\task\manager::adhoc_task_complete($task); } /** * Test getting the current copies. */ public function test_get_copies() { global $USER; // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'foo'; $formdata->shortname = 'bar'; $formdata->category = 1; $formdata->visible = 1; $formdata->startdate = 1582376400; $formdata->enddate = 0; $formdata->idnumber = ''; $formdata->userdata = 1; $formdata->role_1 = 1; $formdata->role_3 = 3; $formdata->role_5 = 5; $formdata2 = clone($formdata); $formdata2->shortname = 'tree'; // Create some copies. $coursecopy = new \core_backup\copy\copy($formdata); $result = $coursecopy->create_copy(); // Backup, awaiting. $copies = \core_backup\copy\copy::get_copies($USER->id); $this->assertEquals($result['backupid'], $copies[0]->backupid); $this->assertEquals($result['restoreid'], $copies[0]->restoreid); $this->assertEquals(\backup::STATUS_AWAITING, $copies[0]->status); $this->assertEquals(\backup::OPERATION_BACKUP, $copies[0]->operation); $bc = \backup_controller::load_controller($result['backupid']); // Backup, in progress. $bc->set_status(\backup::STATUS_EXECUTING); $copies = \core_backup\copy\copy::get_copies($USER->id); $this->assertEquals($result['backupid'], $copies[0]->backupid); $this->assertEquals($result['restoreid'], $copies[0]->restoreid); $this->assertEquals(\backup::STATUS_EXECUTING, $copies[0]->status); $this->assertEquals(\backup::OPERATION_BACKUP, $copies[0]->operation); // Restore, ready to process. $bc->set_status(\backup::STATUS_FINISHED_OK); $copies = \core_backup\copy\copy::get_copies($USER->id); $this->assertEquals($result['backupid'], $copies[0]->backupid); $this->assertEquals($result['restoreid'], $copies[0]->restoreid); $this->assertEquals(\backup::STATUS_REQUIRE_CONV, $copies[0]->status); $this->assertEquals(\backup::OPERATION_RESTORE, $copies[0]->operation); // No records. $bc->set_status(\backup::STATUS_FINISHED_ERR); $copies = \core_backup\copy\copy::get_copies($USER->id); $this->assertEmpty($copies); $coursecopy2 = new \core_backup\copy\copy($formdata2); $result2 = $coursecopy2->create_copy(); // Set the second copy to be complete. $bc = \backup_controller::load_controller($result2['backupid']); $bc->set_status(\backup::STATUS_FINISHED_OK); // Set the restore to be finished. $rc = \backup_controller::load_controller($result2['restoreid']); $rc->set_status(\backup::STATUS_FINISHED_OK); // No records. $copies = \core_backup\copy\copy::get_copies($USER->id); $this->assertEmpty($copies); } /** * Test getting the current copies for specific course. */ public function test_get_copies_course() { global $USER; // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'foo'; $formdata->shortname = 'bar'; $formdata->category = 1; $formdata->visible = 1; $formdata->startdate = 1582376400; $formdata->enddate = 0; $formdata->idnumber = ''; $formdata->userdata = 1; $formdata->role_1 = 1; $formdata->role_3 = 3; $formdata->role_5 = 5; // Create some copies. $coursecopy = new \core_backup\copy\copy($formdata); $coursecopy->create_copy(); // No copies match this course id. $copies = \core_backup\copy\copy::get_copies($USER->id, ($this->course->id + 1)); $this->assertEmpty($copies); } /** * Test getting the current copies if course has been deleted. */ public function test_get_copies_course_deleted() { global $USER; // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'foo'; $formdata->shortname = 'bar'; $formdata->category = 1; $formdata->visible = 1; $formdata->startdate = 1582376400; $formdata->enddate = 0; $formdata->idnumber = ''; $formdata->userdata = 1; $formdata->role_1 = 1; $formdata->role_3 = 3; $formdata->role_5 = 5; // Create some copies. $coursecopy = new \core_backup\copy\copy($formdata); $coursecopy->create_copy(); delete_course($this->course->id, false); // No copies match this course id as it has been deleted. $copies = \core_backup\copy\copy::get_copies($USER->id, ($this->course->id)); $this->assertEmpty($copies); } /* * Test course copy. */ public function test_course_copy() { global $DB; // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'copy course'; $formdata->shortname = 'copy course short'; $formdata->category = 1; $formdata->visible = 0; $formdata->startdate = 1582376400; $formdata->enddate = 1582386400; $formdata->idnumber = 123; $formdata->userdata = 1; $formdata->role_1 = 1; $formdata->role_3 = 3; $formdata->role_5 = 5; // Create the course copy records and associated ad-hoc task. $coursecopy = new \core_backup\copy\copy($formdata); $copyids = $coursecopy->create_copy(); $courseid = $this->course->id; // We are expecting trace output during this test. $this->expectOutputRegex("/$courseid/"); // Execute adhoc task. $now = time(); $task = \core\task\manager::get_next_adhoc_task($now); $this->assertInstanceOf('\\core\\task\\asynchronous_copy_task', $task); $task->execute(); \core\task\manager::adhoc_task_complete($task); $postbackuprec = $DB->get_record('backup_controllers', array('backupid' => $copyids['backupid'])); $postrestorerec = $DB->get_record('backup_controllers', array('backupid' => $copyids['restoreid'])); // Check backup was completed successfully. $this->assertEquals(backup::STATUS_FINISHED_OK, $postbackuprec->status); $this->assertEquals(1.0, $postbackuprec->progress); // Check restore was completed successfully. $this->assertEquals(backup::STATUS_FINISHED_OK, $postrestorerec->status); $this->assertEquals(1.0, $postrestorerec->progress); // Check the restored course itself. $coursecontext = context_course::instance($postrestorerec->itemid); $users = get_enrolled_users($coursecontext); $modinfo = get_fast_modinfo($postrestorerec->itemid); $forums = $modinfo->get_instances_of('forum'); $forum = reset($forums); $discussions = forum_get_discussions($forum); $course = $modinfo->get_course(); $this->assertEquals($formdata->startdate, $course->startdate); $this->assertEquals($formdata->enddate, $course->enddate); $this->assertEquals('copy course', $course->fullname); $this->assertEquals('copy course short', $course->shortname); $this->assertEquals(0, $course->visible); $this->assertEquals(123, $course->idnumber); foreach ($modinfo->get_cms() as $cm) { $this->assertContains($cm->get_formatted_name(), $this->activitynames); } foreach ($this->courseusers as $user) { $this->assertEquals($user, $users[$user]->id); } $this->assertEquals(count($this->courseusers), count($users)); $this->assertEquals(2, count($discussions)); } /* * Test course copy, not including any users (or data). */ public function test_course_copy_no_users() { global $DB; // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'copy course'; $formdata->shortname = 'copy course short'; $formdata->category = 1; $formdata->visible = 0; $formdata->startdate = 1582376400; $formdata->enddate = 1582386400; $formdata->idnumber = 123; $formdata->userdata = 1; $formdata->role_1 = 0; $formdata->role_3 = 0; $formdata->role_5 = 0; // Create the course copy records and associated ad-hoc task. $coursecopy = new \core_backup\copy\copy($formdata); $copyids = $coursecopy->create_copy(); $courseid = $this->course->id; // We are expecting trace output during this test. $this->expectOutputRegex("/$courseid/"); // Execute adhoc task. $now = time(); $task = \core\task\manager::get_next_adhoc_task($now); $this->assertInstanceOf('\\core\\task\\asynchronous_copy_task', $task); $task->execute(); \core\task\manager::adhoc_task_complete($task); $postrestorerec = $DB->get_record('backup_controllers', array('backupid' => $copyids['restoreid'])); // Check the restored course itself. $coursecontext = context_course::instance($postrestorerec->itemid); $users = get_enrolled_users($coursecontext); $modinfo = get_fast_modinfo($postrestorerec->itemid); $forums = $modinfo->get_instances_of('forum'); $forum = reset($forums); $discussions = forum_get_discussions($forum); $course = $modinfo->get_course(); $this->assertEquals($formdata->startdate, $course->startdate); $this->assertEquals($formdata->enddate, $course->enddate); $this->assertEquals('copy course', $course->fullname); $this->assertEquals('copy course short', $course->shortname); $this->assertEquals(0, $course->visible); $this->assertEquals(123, $course->idnumber); foreach ($modinfo->get_cms() as $cm) { $this->assertContains($cm->get_formatted_name(), $this->activitynames); } // Should be no discussions as the user that made them wasn't included. $this->assertEquals(0, count($discussions)); // There should only be one user in the new course, and that's the user who did the copy. $this->assertEquals(1, count($users)); $this->assertEquals($this->courseusers[2], $users[$this->courseusers[2]]->id); } /* * Test course copy, including students and their data. */ public function test_course_copy_students_data() { global $DB; // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'copy course'; $formdata->shortname = 'copy course short'; $formdata->category = 1; $formdata->visible = 0; $formdata->startdate = 1582376400; $formdata->enddate = 1582386400; $formdata->idnumber = 123; $formdata->userdata = 1; $formdata->role_1 = 0; $formdata->role_3 = 0; $formdata->role_5 = 5; // Create the course copy records and associated ad-hoc task. $coursecopy = new \core_backup\copy\copy($formdata); $copyids = $coursecopy->create_copy(); $courseid = $this->course->id; // We are expecting trace output during this test. $this->expectOutputRegex("/$courseid/"); // Execute adhoc task. $now = time(); $task = \core\task\manager::get_next_adhoc_task($now); $this->assertInstanceOf('\\core\\task\\asynchronous_copy_task', $task); $task->execute(); \core\task\manager::adhoc_task_complete($task); $postrestorerec = $DB->get_record('backup_controllers', array('backupid' => $copyids['restoreid'])); // Check the restored course itself. $coursecontext = context_course::instance($postrestorerec->itemid); $users = get_enrolled_users($coursecontext); $modinfo = get_fast_modinfo($postrestorerec->itemid); $forums = $modinfo->get_instances_of('forum'); $forum = reset($forums); $discussions = forum_get_discussions($forum); $course = $modinfo->get_course(); $this->assertEquals($formdata->startdate, $course->startdate); $this->assertEquals($formdata->enddate, $course->enddate); $this->assertEquals('copy course', $course->fullname); $this->assertEquals('copy course short', $course->shortname); $this->assertEquals(0, $course->visible); $this->assertEquals(123, $course->idnumber); foreach ($modinfo->get_cms() as $cm) { $this->assertContains($cm->get_formatted_name(), $this->activitynames); } // Should be no discussions as the user that made them wasn't included. $this->assertEquals(2, count($discussions)); // There should only be two users in the new course. The copier and one student. $this->assertEquals(2, count($users)); $this->assertEquals($this->courseusers[2], $users[$this->courseusers[2]]->id); $this->assertEquals($this->courseusers[0], $users[$this->courseusers[0]]->id); } /* * Test course copy, not including any users (or data). */ public function test_course_copy_no_data() { global $DB; // Mock up the form data. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'copy course'; $formdata->shortname = 'copy course short'; $formdata->category = 1; $formdata->visible = 0; $formdata->startdate = 1582376400; $formdata->enddate = 1582386400; $formdata->idnumber = 123; $formdata->userdata = 0; $formdata->role_1 = 1; $formdata->role_3 = 3; $formdata->role_5 = 5; // Create the course copy records and associated ad-hoc task. $coursecopy = new \core_backup\copy\copy($formdata); $copyids = $coursecopy->create_copy(); $courseid = $this->course->id; // We are expecting trace output during this test. $this->expectOutputRegex("/$courseid/"); // Execute adhoc task. $now = time(); $task = \core\task\manager::get_next_adhoc_task($now); $this->assertInstanceOf('\\core\\task\\asynchronous_copy_task', $task); $task->execute(); \core\task\manager::adhoc_task_complete($task); $postrestorerec = $DB->get_record('backup_controllers', array('backupid' => $copyids['restoreid'])); // Check the restored course itself. $coursecontext = context_course::instance($postrestorerec->itemid); $users = get_enrolled_users($coursecontext); get_fast_modinfo($postrestorerec->itemid, 0, true); $modinfo = get_fast_modinfo($postrestorerec->itemid); $forums = $modinfo->get_instances_of('forum'); $forum = reset($forums); $discussions = forum_get_discussions($forum); $course = $modinfo->get_course(); $this->assertEquals($formdata->startdate, $course->startdate); $this->assertEquals($formdata->enddate, $course->enddate); $this->assertEquals('copy course', $course->fullname); $this->assertEquals('copy course short', $course->shortname); $this->assertEquals(0, $course->visible); $this->assertEquals(123, $course->idnumber); foreach ($modinfo->get_cms() as $cm) { $this->assertContains($cm->get_formatted_name(), $this->activitynames); } // Should be no discussions as the user data wasn't included. $this->assertEquals(0, count($discussions)); // There should only be all users in the new course. $this->assertEquals(count($this->courseusers), count($users)); } /* * Test instantiation with incomplete formdata. */ public function test_malformed_instantiation() { // Mock up the form data, missing things so we get an exception. $formdata = new \stdClass; $formdata->courseid = $this->course->id; $formdata->fullname = 'copy course'; $formdata->shortname = 'copy course short'; $formdata->category = 1; // Expect and exception as form data is incomplete. $this->expectException(\moodle_exception::class); new \core_backup\copy\copy($formdata); } }