. /** * Weblib tests. * * @package core * @category phpunit * @copyright © 2006 The Open University * @author T.J.Hunt@open.ac.uk * @license http://www.gnu.org/copyleft/gpl.html GNU Public License */ class weblib_test extends advanced_testcase { /** * @covers ::s */ public function test_s(): void { // Special cases. $this->assertSame('0', s(0)); $this->assertSame('0', s('0')); $this->assertSame('0', s(false)); $this->assertSame('', s(null)); // Normal cases. $this->assertSame('This Breaks " Strict', s('This Breaks " Strict')); $this->assertSame('This Breaks <a>" Strict</a>', s('This Breaks " Strict')); // Unicode characters. $this->assertSame('Café', s('Café')); $this->assertSame('一, 二, 三', s('一, 二, 三')); // Don't escape already-escaped numeric entities. (Note, this behaviour // may not be desirable. Perhaps we should remove these tests and that // functionality, but we can only do that if we understand why it was added.) $this->assertSame('An entity: .', s('An entity: .')); $this->assertSame('An entity: б.', s('An entity: б.')); $this->assertSame('An entity: &.', s('An entity: &.')); $this->assertSame('Not an entity: &#x09ff;.', s('Not an entity: ৿.')); // Test all ASCII characters (0-127). for ($i = 0; $i <= 127; $i++) { $character = chr($i); $result = s($character); switch ($character) { case '"' : $this->assertSame('"', $result); break; case '&' : $this->assertSame('&', $result); break; case "'" : $this->assertSame(''', $result); break; case '<' : $this->assertSame('<', $result); break; case '>' : $this->assertSame('>', $result); break; default: $this->assertSame($character, $result); break; } } } /** * Test the format_string illegal options handling. * * @covers ::format_string * @dataProvider format_string_illegal_options_provider */ public function test_format_string_illegal_options( string $input, string $result, mixed $options, string $pattern, ): void { $this->assertEquals( $result, format_string($input, false, $options), ); $messages = $this->getDebuggingMessages(); $this->assertdebuggingcalledcount(1); $this->assertMatchesRegularExpression( "/{$pattern}/", $messages[0]->message, ); } /** * Data provider for test_format_string_illegal_options. * @return array */ public static function format_string_illegal_options_provider(): array { return [ [ 'Example', 'Example', \core\context\system::instance(), preg_quote('The options argument should not be a context object directly.'), ], [ 'Example', 'Example', true, preg_quote('The options argument should be an Array, or stdclass. boolean passed.'), ], [ 'Example', 'Example', false, preg_quote('The options argument should be an Array, or stdclass. boolean passed.'), ], ]; } /** * Ensure that if format_string is called with a context as the third param, that a debugging notice is emitted. * * @covers ::format_string */ public function test_format_string_context(): void { global $CFG; $this->resetAfterTest(true); // Disable the formatstringstriptags option to ensure that the HTML tags are not stripped. $CFG->stringfilters = 'multilang'; // Enable filters. $CFG->filterall = true; $course = $this->getDataGenerator()->create_course(); $coursecontext = \core\context\course::instance($course->id); // Set up the multilang filter at the system context, but disable it at the course. filter_set_global_state('multilang', TEXTFILTER_ON); filter_set_local_state('multilang', $coursecontext->id, TEXTFILTER_OFF); // Previously, if a context was passed, it was converted into an Array, and ignored. // The PAGE context was used instead -- often this is the system context. $input = 'I really do not do not like this!'; $result = format_string( $input, true, $coursecontext, ); // We emit a debugging notice to alert that the context has been moved to the options. $this->assertdebuggingcalledcount(1); // Check the result was _not_ filtered. $this->assertEquals( // Tags are stripped out due to striptags. "I really do not do not like this!", $result, ); // But it should be filtered if called with the system context. $result = format_string( $input, true, ['context' => \core\context\system::instance()], ); $this->assertEquals( 'I really do not like this!', $result, ); } /** * @covers ::format_text_email */ public function test_format_text_email(): void { $this->assertSame("This is a TEST\n", format_text_email('
This is a test
', FORMAT_HTML)); $this->assertSame("This is a TEST\n", format_text_email('This is a test
', FORMAT_HTML)); $this->assertSame('& so is this', format_text_email('& so is this', FORMAT_HTML)); $this->assertSame('Two bullets: ' . core_text::code2utf8(8226) . ' ' . core_text::code2utf8(8226), format_text_email('Two bullets: • •', FORMAT_HTML)); $this->assertSame(core_text::code2utf8(0x7fd2).core_text::code2utf8(0x7fd2), format_text_email('習習', FORMAT_HTML)); } /** * @covers ::obfuscate_email */ public function test_obfuscate_email(): void { $email = 'some.user@example.com'; $obfuscated = obfuscate_email($email); $this->assertNotSame($email, $obfuscated); $back = core_text::entities_to_utf8(urldecode($email), true); $this->assertSame($email, $back); } /** * @covers ::obfuscate_text */ public function test_obfuscate_text(): void { $text = 'Žluťoučký koníček 32131'; $obfuscated = obfuscate_text($text); $this->assertNotSame($text, $obfuscated); $back = core_text::entities_to_utf8($obfuscated, true); $this->assertSame($text, $back); } /** * @covers ::highlight */ public function test_highlight(): void { $this->assertSame('This is good', highlight('good', 'This is good')); $this->assertSame('span', highlight('SpaN', 'span')); $this->assertSame('SpaN', highlight('span', 'SpaN')); $this->assertSame('span', highlight('span', 'span')); $this->assertSame('He is good', highlight('good is', 'He is good')); $this->assertSame('This is good', highlight('+good', 'This is good')); $this->assertSame('This is good', highlight('-good', 'This is good')); $this->assertSame('This is goodness', highlight('+good', 'This is goodness')); $this->assertSame('This is goodness', highlight('good', 'This is goodness')); $this->assertSame('test 1
1
', highlight('test 1', 'test 1
1
', false, '', '')); $this->assertSame('test 1
1
', highlight('test +1', 'test 1
1
', false, '', '')); $this->assertSame('test 1
1
', highlight('test -1', 'test 1
1
', false, '', '')); } /** * @covers ::replace_ampersands_not_followed_by_entity */ public function test_replace_ampersands(): void { $this->assertSame("This & that ", replace_ampersands_not_followed_by_entity("This & that ")); $this->assertSame("This   that ", replace_ampersands_not_followed_by_entity("This   that ")); } /** * @covers ::strip_links */ public function test_strip_links(): void { $this->assertSame('this is a link', strip_links('this is a link')); } /** * @covers ::wikify_links */ public function test_wikify_links(): void { $this->assertSame('this is a link [ http://someaddress.com/query ]', wikify_links('this is a link')); } /** * @covers ::clean_text */ public function test_clean_text(): void { $text = "lala "; $this->assertSame($text, clean_text($text, FORMAT_PLAIN)); $this->assertSame('lala xx', clean_text($text, FORMAT_MARKDOWN)); $this->assertSame('lala xx', clean_text($text, FORMAT_MOODLE)); $this->assertSame('lala xx', clean_text($text, FORMAT_HTML)); } /** * Test trusttext enabling. * * @covers ::trusttext_active */ public function test_trusttext_active(): void { global $CFG; $this->resetAfterTest(); $this->assertFalse(trusttext_active()); $CFG->enabletrusttext = '1'; $this->assertTrue(trusttext_active()); } /** * Test trusttext detection. * * @covers ::trusttext_trusted */ public function test_trusttext_trusted(): void { global $CFG; $this->resetAfterTest(); $syscontext = context_system::instance(); $course = $this->getDataGenerator()->create_course(); $coursecontext = context_course::instance($course->id); $user1 = $this->getDataGenerator()->create_user(); $user2 = $this->getDataGenerator()->create_user(); $this->getDataGenerator()->enrol_user($user2->id, $course->id, 'editingteacher'); $this->setAdminUser(); $CFG->enabletrusttext = '0'; $this->assertFalse(trusttext_trusted($syscontext)); $this->assertFalse(trusttext_trusted($coursecontext)); $CFG->enabletrusttext = '1'; $this->assertTrue(trusttext_trusted($syscontext)); $this->assertTrue(trusttext_trusted($coursecontext)); $this->setUser($user1); $CFG->enabletrusttext = '0'; $this->assertFalse(trusttext_trusted($syscontext)); $this->assertFalse(trusttext_trusted($coursecontext)); $CFG->enabletrusttext = '1'; $this->assertFalse(trusttext_trusted($syscontext)); $this->assertFalse(trusttext_trusted($coursecontext)); $this->setUser($user2); $CFG->enabletrusttext = '0'; $this->assertFalse(trusttext_trusted($syscontext)); $this->assertFalse(trusttext_trusted($coursecontext)); $CFG->enabletrusttext = '1'; $this->assertFalse(trusttext_trusted($syscontext)); $this->assertTrue(trusttext_trusted($coursecontext)); } /** * Data provider for trusttext_pre_edit() tests. */ public function trusttext_pre_edit_provider(): array { return [ [true, 0, 'editingteacher', FORMAT_HTML, 1], [true, 0, 'editingteacher', FORMAT_MOODLE, 1], [false, 0, 'editingteacher', FORMAT_MARKDOWN, 1], [false, 0, 'editingteacher', FORMAT_PLAIN, 1], [false, 1, 'editingteacher', FORMAT_HTML, 1], [false, 1, 'editingteacher', FORMAT_MOODLE, 1], [false, 1, 'editingteacher', FORMAT_MARKDOWN, 1], [false, 1, 'editingteacher', FORMAT_PLAIN, 1], [true, 0, 'student', FORMAT_HTML, 1], [true, 0, 'student', FORMAT_MOODLE, 1], [false, 0, 'student', FORMAT_MARKDOWN, 1], [false, 0, 'student', FORMAT_PLAIN, 1], [true, 1, 'student', FORMAT_HTML, 1], [true, 1, 'student', FORMAT_MOODLE, 1], [false, 1, 'student', FORMAT_MARKDOWN, 1], [false, 1, 'student', FORMAT_PLAIN, 1], ]; } /** * Test text cleaning before editing. * * @dataProvider trusttext_pre_edit_provider * @covers ::trusttext_pre_edit * * @param bool $expectedsanitised * @param int $enabled * @param string $rolename * @param string $format * @param int $trust */ public function test_trusttext_pre_edit(bool $expectedsanitised, int $enabled, string $rolename, string $format, int $trust): void { global $CFG, $DB; $this->resetAfterTest(); $exploit = "abc < > &"; $sanitised = purify_html($exploit); $course = $this->getDataGenerator()->create_course(); $context = context_course::instance($course->id); $user = $this->getDataGenerator()->create_user(); $this->getDataGenerator()->enrol_user($user->id, $course->id, $rolename); $this->setUser($user); $CFG->enabletrusttext = (string)$enabled; $object = new stdClass(); $object->some = $exploit; $object->someformat = $format; $object->sometrust = (string)$trust; $result = trusttext_pre_edit(clone($object), 'some', $context); if ($expectedsanitised) { $message = "sanitisation is expected for: $enabled, $rolename, $format, $trust"; $this->assertSame($sanitised, $result->some, $message); } else { $message = "sanitisation is not expected for: $enabled, $rolename, $format, $trust"; $this->assertSame($exploit, $result->some, $message); } } /** * Test removal of legacy trusttext flag. * @covers ::trusttext_strip */ public function test_trusttext_strip(): void { $this->assertSame('abc', trusttext_strip('abc')); $this->assertSame('abc', trusttext_strip('ab#####TRUSTTEXT#####c')); } /** * Test trust option of format_text(). * @covers ::format_text */ public function test_format_text_trusted(): void { global $CFG; $this->resetAfterTest(); $text = "lala "; $CFG->enabletrusttext = 0; $this->assertSame(s($text), format_text($text, FORMAT_PLAIN, ['trusted' => true])); $this->assertSame("lala xx
\n", format_text($text, FORMAT_MARKDOWN, ['trusted' => true])); $this->assertSame('lala xx
\n", format_text($text, FORMAT_MARKDOWN, ['trusted' => false])); $this->assertSame('lala xx
\n", format_text($text, FORMAT_MARKDOWN, ['trusted' => true])); $this->assertSame('lala xx
\n", format_text($text, FORMAT_MARKDOWN, ['trusted' => false])); $this->assertSame('lala
\n", format_text($text, FORMAT_MARKDOWN, ['trusted' => true, 'noclean' => true])); $this->assertSame("lala
\n", format_text($text, FORMAT_MARKDOWN, ['trusted' => false, 'noclean' => true])); } /** * @covers ::qualified_me */ public function test_qualified_me(): void { global $PAGE, $FULLME, $CFG; $this->resetAfterTest(); $PAGE = new moodle_page(); $FULLME = $CFG->wwwroot.'/course/view.php?id=1&xx=yy'; $this->assertSame($FULLME, qualified_me()); $PAGE->set_url('/course/view.php', array('id'=>1)); $this->assertSame($CFG->wwwroot.'/course/view.php?id=1', qualified_me()); } /** * @covers ::set_debugging */ public function test_set_debugging(): void { global $CFG; $this->resetAfterTest(); $this->assertEquals(DEBUG_DEVELOPER, $CFG->debug); $this->assertTrue($CFG->debugdeveloper); $this->assertNotEmpty($CFG->debugdisplay); set_debugging(DEBUG_DEVELOPER, true); $this->assertEquals(DEBUG_DEVELOPER, $CFG->debug); $this->assertTrue($CFG->debugdeveloper); $this->assertNotEmpty($CFG->debugdisplay); set_debugging(DEBUG_DEVELOPER, false); $this->assertEquals(DEBUG_DEVELOPER, $CFG->debug); $this->assertTrue($CFG->debugdeveloper); $this->assertEmpty($CFG->debugdisplay); set_debugging(-1); $this->assertEquals(-1, $CFG->debug); $this->assertTrue($CFG->debugdeveloper); set_debugging(DEBUG_ALL); $this->assertEquals(DEBUG_ALL, $CFG->debug); $this->assertFalse($CFG->debugdeveloper); set_debugging(DEBUG_NORMAL); $this->assertEquals(DEBUG_NORMAL, $CFG->debug); $this->assertFalse($CFG->debugdeveloper); set_debugging(DEBUG_MINIMAL); $this->assertEquals(DEBUG_MINIMAL, $CFG->debug); $this->assertFalse($CFG->debugdeveloper); set_debugging(DEBUG_NONE); $this->assertEquals(DEBUG_NONE, $CFG->debug); $this->assertFalse($CFG->debugdeveloper); } /** * @covers ::strip_pluginfile_content */ public function test_strip_pluginfile_content(): void { $source = <<This is a test
', FORMAT_HTML, 'This is a TEST'), array("english català español français", FORMAT_HTML, "english català español français") ); } /** * Data provider for validate_email() function. * * @return array Returns aray of test data for the test_validate_email function */ public function data_validate_email() { return [ // Test addresses that should pass. [ 'email' => 'moodle@example.com', 'result' => true ], [ 'email' => 'moodle@localhost.local', 'result' => true ], [ 'email' => 'verp_email+is=mighty@moodle.org', 'result' => true ], [ 'email' => "but_potentially'dangerous'too@example.org", 'result' => true ], [ 'email' => 'posts+AAAAAAAAAAIAAAAAAAAGQQAAAAABFSXz1eM/P/lR2bYyljM+@posts.moodle.org', 'result' => true ], // Test addresses that should NOT pass. [ 'email' => 'moodle@localhost', 'result' => false ], [ 'email' => '"attacker\\" -oQ/tmp/ -X/var/www/vhost/moodle/backdoor.php some"@email.com', 'result' => false ], [ 'email' => "moodle@example.com>\r\nRCPT TO:This is a test.