See Release Notes
Long Term Support Release
<?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/>.< /** < * PHPUnit tests for backup and restore functionality. < * < * @package quizaccess_seb < * @author Dmitrii Metelkin <dmitriim@catalyst-au.net> < * @copyright 2020 Catalyst IT < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */ <> namespace quizaccess_seb;defined('MOODLE_INTERNAL') || die(); require_once(__DIR__ . '/test_helper_trait.php'); /** * PHPUnit tests for backup and restore functionality. *> * @package quizaccess_seb * @copyright 2020 Catalyst IT > * @author Dmitrii Metelkin <dmitriim@catalyst-au.net>* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */< class quizaccess_seb_backup_restore_testcase extends advanced_testcase { < use quizaccess_seb_test_helper_trait;> class backup_restore_test extends \advanced_testcase { > use \quizaccess_seb_test_helper_trait;< /** @var \quizaccess_seb\template $template A test template. */> /** @var template $template A test template. */protected $template; /** * Called before every test. */ public function setUp(): void { global $USER; parent::setUp(); $this->resetAfterTest(); $this->setAdminUser(); $this->course = $this->getDataGenerator()->create_course(); $this->template = $this->create_template(); $this->user = $USER; } /** * A helper method to create a quiz with template usage of SEB. *< * @return \quizaccess_seb\quiz_settings> * @return quiz_settings*/ protected function create_quiz_with_template() {< $this->quiz = $this->create_test_quiz($this->course, \quizaccess_seb\settings_provider::USE_SEB_CONFIG_MANUALLY); < $quizsettings = \quizaccess_seb\quiz_settings::get_record(['quizid' => $this->quiz->id]); < $quizsettings->set('requiresafeexambrowser', \quizaccess_seb\settings_provider::USE_SEB_TEMPLATE);> $this->quiz = $this->create_test_quiz($this->course, settings_provider::USE_SEB_CONFIG_MANUALLY); > $quizsettings = quiz_settings::get_record(['quizid' => $this->quiz->id]); > $quizsettings->set('requiresafeexambrowser', settings_provider::USE_SEB_TEMPLATE);$quizsettings->set('templateid', $this->template->get('id')); $quizsettings->save(); return $quizsettings; } /** * A helper method to emulate backup and restore of the quiz. * * @return \cm_info|null */ protected function backup_and_restore_quiz() { return duplicate_module($this->course, get_fast_modinfo($this->course)->get_cm($this->quiz->cmid)); } /** * A helper method to backup test quiz. * * @return mixed A backup ID ready to be restored. */ protected function backup_quiz() { global $CFG; // Get the necessary files to perform backup and restore. require_once($CFG->dirroot . '/backup/util/includes/backup_includes.php'); require_once($CFG->dirroot . '/backup/util/includes/restore_includes.php'); $backupid = 'test-seb-backup-restore';< $bc = new backup_controller(backup::TYPE_1ACTIVITY, $this->quiz->coursemodule, backup::FORMAT_MOODLE, < backup::INTERACTIVE_NO, backup::MODE_GENERAL, $this->user->id);> $bc = new \backup_controller(\backup::TYPE_1ACTIVITY, $this->quiz->coursemodule, \backup::FORMAT_MOODLE, > \backup::INTERACTIVE_NO, \backup::MODE_GENERAL, $this->user->id);$bc->execute_plan(); $results = $bc->get_results(); $file = $results['backup_destination']; $fp = get_file_packer('application/vnd.moodle.backup'); $filepath = $CFG->dataroot . '/temp/backup/' . $backupid; $file->extract_to_pathname($fp, $filepath); $bc->destroy(); return $backupid; } /** * A helper method to restore provided backup. * * @param string $backupid Backup ID to restore. */ protected function restore_quiz($backupid) {< $rc = new restore_controller($backupid, $this->course->id, < backup::INTERACTIVE_NO, backup::MODE_GENERAL, $this->user->id, backup::TARGET_CURRENT_ADDING);> $rc = new \restore_controller($backupid, $this->course->id, > \backup::INTERACTIVE_NO, \backup::MODE_GENERAL, $this->user->id, \backup::TARGET_CURRENT_ADDING);$this->assertTrue($rc->execute_precheck()); $rc->execute_plan(); $rc->destroy(); } /** * A helper method to emulate restoring to a different site. */ protected function change_site() { set_config('siteidentifier', random_string(32) . 'not the same site'); } /** * A helper method to validate backup and restore results. * * @param cm_info $newcm Restored course_module object. */< protected function validate_backup_restore(cm_info $newcm) { < $this->assertEquals(2, quizaccess_seb\quiz_settings::count_records()); < $actual = \quizaccess_seb\quiz_settings::get_record(['quizid' => $newcm->instance]);> protected function validate_backup_restore(\cm_info $newcm) { > $this->assertEquals(2, quiz_settings::count_records()); > $actual = quiz_settings::get_record(['quizid' => $newcm->instance]);< $expected = \quizaccess_seb\quiz_settings::get_record(['quizid' => $this->quiz->id]);> $expected = quiz_settings::get_record(['quizid' => $this->quiz->id]);$this->assertEquals($expected->get('templateid'), $actual->get('templateid')); $this->assertEquals($expected->get('requiresafeexambrowser'), $actual->get('requiresafeexambrowser')); $this->assertEquals($expected->get('showsebdownloadlink'), $actual->get('showsebdownloadlink')); $this->assertEquals($expected->get('allowuserquitseb'), $actual->get('allowuserquitseb')); $this->assertEquals($expected->get('quitpassword'), $actual->get('quitpassword')); $this->assertEquals($expected->get('allowedbrowserexamkeys'), $actual->get('allowedbrowserexamkeys')); // Validate specific SEB config settings.< foreach (\quizaccess_seb\settings_provider::get_seb_config_elements() as $name => $notused) {> foreach (settings_provider::get_seb_config_elements() as $name => $notused) {$name = preg_replace("/^seb_/", "", $name); $this->assertEquals($expected->get($name), $actual->get($name)); } } /** * Test backup and restore when no seb. */ public function test_backup_restore_no_seb() {< $this->quiz = $this->create_test_quiz($this->course, \quizaccess_seb\settings_provider::USE_SEB_NO); < $this->assertEquals(0, quizaccess_seb\quiz_settings::count_records());> $this->quiz = $this->create_test_quiz($this->course, settings_provider::USE_SEB_NO); > $this->assertEquals(0, quiz_settings::count_records());$this->backup_and_restore_quiz();< $this->assertEquals(0, quizaccess_seb\quiz_settings::count_records());> $this->assertEquals(0, quiz_settings::count_records());} /** * Test backup and restore when manually configured. */ public function test_backup_restore_manual_config() {< $this->quiz = $this->create_test_quiz($this->course, \quizaccess_seb\settings_provider::USE_SEB_CONFIG_MANUALLY);> $this->quiz = $this->create_test_quiz($this->course, settings_provider::USE_SEB_CONFIG_MANUALLY);< $expected = \quizaccess_seb\quiz_settings::get_record(['quizid' => $this->quiz->id]);> $expected = quiz_settings::get_record(['quizid' => $this->quiz->id]);$expected->set('showsebdownloadlink', 0); $expected->set('quitpassword', '123'); $expected->save();< $this->assertEquals(1, quizaccess_seb\quiz_settings::count_records());> $this->assertEquals(1, quiz_settings::count_records());$newcm = $this->backup_and_restore_quiz(); $this->validate_backup_restore($newcm); } /** * Test backup and restore when using template. */ public function test_backup_restore_template_config() {< $this->quiz = $this->create_test_quiz($this->course, \quizaccess_seb\settings_provider::USE_SEB_CONFIG_MANUALLY);> $this->quiz = $this->create_test_quiz($this->course, settings_provider::USE_SEB_CONFIG_MANUALLY);< $expected = \quizaccess_seb\quiz_settings::get_record(['quizid' => $this->quiz->id]);> $expected = quiz_settings::get_record(['quizid' => $this->quiz->id]);$template = $this->create_template();< $expected->set('requiresafeexambrowser', \quizaccess_seb\settings_provider::USE_SEB_TEMPLATE);> $expected->set('requiresafeexambrowser', settings_provider::USE_SEB_TEMPLATE);$expected->set('templateid', $template->get('id')); $expected->save();< $this->assertEquals(1, quizaccess_seb\quiz_settings::count_records());> $this->assertEquals(1, quiz_settings::count_records());$newcm = $this->backup_and_restore_quiz(); $this->validate_backup_restore($newcm); } /** * Test backup and restore when using uploaded file. */ public function test_backup_restore_uploaded_config() {< $this->quiz = $this->create_test_quiz($this->course, \quizaccess_seb\settings_provider::USE_SEB_CONFIG_MANUALLY);> $this->quiz = $this->create_test_quiz($this->course, settings_provider::USE_SEB_CONFIG_MANUALLY);< $expected = \quizaccess_seb\quiz_settings::get_record(['quizid' => $this->quiz->id]); < $expected->set('requiresafeexambrowser', \quizaccess_seb\settings_provider::USE_SEB_UPLOAD_CONFIG);> $expected = quiz_settings::get_record(['quizid' => $this->quiz->id]); > $expected->set('requiresafeexambrowser', settings_provider::USE_SEB_UPLOAD_CONFIG);$xml = file_get_contents(__DIR__ . '/fixtures/unencrypted.seb'); $this->create_module_test_file($xml, $this->quiz->cmid); $expected->save();< $this->assertEquals(1, quizaccess_seb\quiz_settings::count_records());> $this->assertEquals(1, quiz_settings::count_records());$newcm = $this->backup_and_restore_quiz(); $this->validate_backup_restore($newcm);< $expectedfile = \quizaccess_seb\settings_provider::get_module_context_sebconfig_file($this->quiz->cmid); < $actualfile = \quizaccess_seb\settings_provider::get_module_context_sebconfig_file($newcm->id);> $expectedfile = settings_provider::get_module_context_sebconfig_file($this->quiz->cmid); > $actualfile = settings_provider::get_module_context_sebconfig_file($newcm->id);$this->assertEquals($expectedfile->get_content(), $actualfile->get_content()); } /** * No new template should be restored if restoring to a different site, * but the template with the same name and content exists.. */ public function test_restore_template_to_a_different_site_when_the_same_template_exists() { $this->create_quiz_with_template(); $backupid = $this->backup_quiz();< $this->assertEquals(1, quizaccess_seb\quiz_settings::count_records()); < $this->assertEquals(1, quizaccess_seb\template::count_records());> $this->assertEquals(1, quiz_settings::count_records()); > $this->assertEquals(1, template::count_records());$this->change_site(); $this->restore_quiz($backupid); // Should see additional setting record, but no new template record.< $this->assertEquals(2, quizaccess_seb\quiz_settings::count_records()); < $this->assertEquals(1, quizaccess_seb\template::count_records());> $this->assertEquals(2, quiz_settings::count_records()); > $this->assertEquals(1, template::count_records());} /** * A new template should be restored if restoring to a different site, but existing template * has the same content, but different name. */ public function test_restore_template_to_a_different_site_when_the_same_content_but_different_name() { $this->create_quiz_with_template(); $backupid = $this->backup_quiz();< $this->assertEquals(1, quizaccess_seb\quiz_settings::count_records()); < $this->assertEquals(1, quizaccess_seb\template::count_records());> $this->assertEquals(1, quiz_settings::count_records()); > $this->assertEquals(1, template::count_records());$this->template->set('name', 'New name for template'); $this->template->save(); $this->change_site(); $this->restore_quiz($backupid); // Should see additional setting record, and new template record.< $this->assertEquals(2, quizaccess_seb\quiz_settings::count_records()); < $this->assertEquals(2, quizaccess_seb\template::count_records());> $this->assertEquals(2, quiz_settings::count_records()); > $this->assertEquals(2, template::count_records());} /** * A new template should be restored if restoring to a different site, but existing template * has the same name, but different content. */ public function test_restore_template_to_a_different_site_when_the_same_name_but_different_content() { global $CFG; $this->create_quiz_with_template(); $backupid = $this->backup_quiz();< $this->assertEquals(1, quizaccess_seb\quiz_settings::count_records()); < $this->assertEquals(1, quizaccess_seb\template::count_records());> $this->assertEquals(1, quiz_settings::count_records()); > $this->assertEquals(1, template::count_records());$newxml = file_get_contents($CFG->dirroot . '/mod/quiz/accessrule/seb/tests/fixtures/simpleunencrypted.seb'); $this->template->set('content', $newxml); $this->template->save(); $this->change_site(); $this->restore_quiz($backupid); // Should see additional setting record, and new template record.< $this->assertEquals(2, quizaccess_seb\quiz_settings::count_records()); < $this->assertEquals(2, quizaccess_seb\template::count_records());> $this->assertEquals(2, quiz_settings::count_records()); > $this->assertEquals(2, template::count_records());} }