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/>.

< /** < * Unit tests for parts of adminlib.php. < * < * @package core < * @subpackage admin < * @copyright 2020 Brendan Heywood <brendan@catalyst-au.net> < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */
> namespace core;
defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->libdir.'/adminlib.php'); /** * Unit tests for parts of adminlib.php. *
> * @package core
* @copyright 2020 Brendan Heywood <brendan@catalyst-au.net> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */
< class core_adminlib_testcase extends advanced_testcase {
> class adminlib_test extends \advanced_testcase {
/** * Data provider of serialized string. * * @return array */ public function db_should_replace_dataprovider() { return [ // Skipped tables. ['block_instances', '', false], ['config', '', false], ['config_plugins', '', false], ['config_log', '', false], ['events_queue', '', false], ['filter_config', '', false], ['log', '', false], ['repository_instance_config', '', false], ['sessions', '', false], ['upgrade_log', '', false], // Unknown skipped tables. ['foobar_log', '', false], ['foobar_logs', '', false], // Unknown ok tables. ['foobar_logical', '', true], // Normal tables. ['assign', '', true], // Normal tables with excluded columns. ['message_conversations', 'convhash', false], ['user_password_history', 'hash', false], ['foo', 'barhash', false], ]; } /** * Test which tables and column should be replaced. * * @dataProvider db_should_replace_dataprovider
> * @covers ::db_should_replace
* @param string $table name * @param string $column name * @param bool $expected whether it should be replaced */ public function test_db_should_replace(string $table, string $column, bool $expected) { $actual = db_should_replace($table, $column); $this->assertSame($actual, $expected); } /** * Data provider for additional skip tables. *
> * @covers ::db_should_replace
* @return array */ public function db_should_replace_additional_skip_tables_dataprovider() { return [ // Skipped tables. ['block_instances', '', false], ['config', '', false], ['config_plugins', '', false], ['config_log', '', false], ['events_queue', '', false], ['filter_config', '', false], ['log', '', false], ['repository_instance_config', '', false], ['sessions', '', false], ['upgrade_log', '', false], // Additional skipped tables. ['context', '', false], ['quiz_attempts', '', false], ['role_assignments', '', false], // Normal tables. ['assign', '', true], ['book', '', true], ]; } /** * Test additional skip tables. * * @dataProvider db_should_replace_additional_skip_tables_dataprovider
> * @covers ::db_should_replace
* @param string $table name * @param string $column name * @param bool $expected whether it should be replaced */ public function test_db_should_replace_additional_skip_tables(string $table, string $column, bool $expected) { $this->resetAfterTest(); $additionalskiptables = 'context, quiz_attempts, role_assignments '; $actual = db_should_replace($table, $column, $additionalskiptables); $this->assertSame($actual, $expected);
> } } > } > /** > * Test method used by upgradesettings.php to make sure > * there are no missing settings in PHPUnit and Behat tests. > * > * @covers ::admin_output_new_settings_by_page > */ > public function test_admin_output_new_settings_by_page() { > $this->resetAfterTest(); > $this->setAdminUser(); > > // Add settings not set during PHPUnit init. > set_config('supportemail', 'support@example.com'); > $frontpage = new \admin_setting_special_frontpagedesc(); > $frontpage->write_setting('test test'); > > // NOTE: if this test fails then it is most likely extra setting in > // some additional plugin without default - developer needs to add > // a workaround into their db/install.php for PHPUnit and Behat. > > $root = admin_get_root(true, true); > $new = admin_output_new_settings_by_page($root); > $this->assertSame([], $new); > > unset_config('numbering', 'book'); > unset_config('supportemail'); > $root = admin_get_root(true, true); > $new = admin_output_new_settings_by_page($root); > $this->assertCount(2, $new); > } > > /** > * Test repeated recursive application of default settings. > * > * @covers ::admin_apply_default_settings > */ > public function test_admin_apply_default_settings() { > global $DB; > > $this->resetAfterTest(); > $this->setAdminUser(); > > // There should not be any pending new defaults. > $saved = admin_apply_default_settings(null, false); > $this->assertSame([], $saved); > > // Emulation of upgrades from CLI. > unset_config('logocompact', 'core_admin'); > unset_config('grade_aggregationposition'); > unset_config('numbering', 'book'); > unset_config('enabled', 'core_competency'); > unset_config('pushcourseratingstouserplans', 'core_competency'); > $saved = admin_apply_default_settings(null, false); > $expected = [ > 'core_competency/enabled' => '1', > 'grade_aggregationposition' => '1', > 'book/numbering' => '1', > 'core_admin/logocompact' => '', > 'core_competency/pushcourseratingstouserplans' => '1', > ]; > $this->assertEquals($expected, $saved); > > // Repeated application of defaults - not done usually. > $saved = admin_apply_default_settings(null, true); > $this->assertGreaterThan(500, count($saved)); > $saved = admin_apply_default_settings(); > $this->assertGreaterThan(500, count($saved)); > > // Emulate initial application of defaults. > $DB->delete_records('config', []); > $DB->delete_records('config_plugins', []); > purge_all_caches(); > $saved = admin_apply_default_settings(null, true); > $this->assertGreaterThan(500, count($saved)); > > // Make sure there were enough repetitions. > $saved = admin_apply_default_settings(null, false); > $this->assertSame([], $saved);