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/>.< /** < * Tests for moodle_url. < * < * @package core < * @copyright 2018 Andrew Nicols <andrew@nicols.co.uk> < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */ < < defined('MOODLE_INTERNAL') || die();> namespace core;/** * Tests for moodle_url. *> * @package core* @copyright 2018 Andrew Nicols <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later> * @covers \moodle_url*/< class core_moodle_url_testcase extends advanced_testcase {> class moodle_url_test extends \advanced_testcase {/** * Test basic moodle_url construction. */ public function test_moodle_url_constructor() { global $CFG;< $url = new moodle_url('/index.php');> $url = new \moodle_url('/index.php');$this->assertSame($CFG->wwwroot.'/index.php', $url->out());< $url = new moodle_url('/index.php', array());> $url = new \moodle_url('/index.php', array());$this->assertSame($CFG->wwwroot.'/index.php', $url->out());< $url = new moodle_url('/index.php', array('id' => 2));> $url = new \moodle_url('/index.php', array('id' => 2));$this->assertSame($CFG->wwwroot.'/index.php?id=2', $url->out());< $url = new moodle_url('/index.php', array('id' => 'two'));> $url = new \moodle_url('/index.php', array('id' => 'two'));$this->assertSame($CFG->wwwroot.'/index.php?id=two', $url->out());< $url = new moodle_url('/index.php', array('id' => 1, 'cid' => '2'));> $url = new \moodle_url('/index.php', array('id' => 1, 'cid' => '2'));$this->assertSame($CFG->wwwroot.'/index.php?id=1&cid=2', $url->out()); $this->assertSame($CFG->wwwroot.'/index.php?id=1&cid=2', $url->out(false));< $url = new moodle_url('/index.php', null, 'test');> $url = new \moodle_url('/index.php', null, 'test');$this->assertSame($CFG->wwwroot.'/index.php#test', $url->out());< $url = new moodle_url('/index.php', array('id' => 2), 'test');> $url = new \moodle_url('/index.php', array('id' => 2), 'test');$this->assertSame($CFG->wwwroot.'/index.php?id=2#test', $url->out()); } /**< * Tests moodle_url::get_path().> * Tests \moodle_url::get_path().*/ public function test_moodle_url_get_path() {< $url = new moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');> $url = new \moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');$this->assertSame('/my/file/is/here.txt', $url->get_path());< $url = new moodle_url('http://www.example.org/');> $url = new \moodle_url('http://www.example.org/');$this->assertSame('/', $url->get_path());< $url = new moodle_url('http://www.example.org/pluginfile.php/slash/arguments');> $url = new \moodle_url('http://www.example.org/pluginfile.php/slash/arguments');$this->assertSame('/pluginfile.php/slash/arguments', $url->get_path()); $this->assertSame('/pluginfile.php', $url->get_path(false)); } public function test_moodle_url_round_trip() { $strurl = 'http://moodle.org/course/view.php?id=5';< $url = new moodle_url($strurl);> $url = new \moodle_url($strurl);$this->assertSame($strurl, $url->out(false)); $strurl = 'http://moodle.org/user/index.php?contextid=53&sifirst=M&silast=D';< $url = new moodle_url($strurl);> $url = new \moodle_url($strurl);$this->assertSame($strurl, $url->out(false)); } /** * Test Moodle URL objects created with a param with empty value. */ public function test_moodle_url_empty_param_values() { $strurl = 'http://moodle.org/course/view.php?id=0';< $url = new moodle_url($strurl, array('id' => 0));> $url = new \moodle_url($strurl, array('id' => 0));$this->assertSame($strurl, $url->out(false)); $strurl = 'http://moodle.org/course/view.php?id';< $url = new moodle_url($strurl, array('id' => false));> $url = new \moodle_url($strurl, array('id' => false));$this->assertSame($strurl, $url->out(false)); $strurl = 'http://moodle.org/course/view.php?id';< $url = new moodle_url($strurl, array('id' => null));> $url = new \moodle_url($strurl, array('id' => null));$this->assertSame($strurl, $url->out(false)); $strurl = 'http://moodle.org/course/view.php?id';< $url = new moodle_url($strurl, array('id' => ''));> $url = new \moodle_url($strurl, array('id' => ''));$this->assertSame($strurl, $url->out(false)); $strurl = 'http://moodle.org/course/view.php?id';< $url = new moodle_url($strurl);> $url = new \moodle_url($strurl);$this->assertSame($strurl, $url->out(false)); } /** * Test set good scheme on Moodle URL objects. */ public function test_moodle_url_set_good_scheme() {< $url = new moodle_url('http://moodle.org/foo/bar');> $url = new \moodle_url('http://moodle.org/foo/bar');$url->set_scheme('myscheme'); $this->assertSame('myscheme://moodle.org/foo/bar', $url->out()); } /** * Test set bad scheme on Moodle URL objects.< * < * @expectedException coding_exception*/ public function test_moodle_url_set_bad_scheme() {< $url = new moodle_url('http://moodle.org/foo/bar');> $url = new \moodle_url('http://moodle.org/foo/bar'); > $this->expectException(\coding_exception::class);$url->set_scheme('not a valid $ scheme'); } public function test_moodle_url_round_trip_array_params() { $strurl = 'http://example.com/?a%5B1%5D=1&a%5B2%5D=2';< $url = new moodle_url($strurl);> $url = new \moodle_url($strurl);$this->assertSame($strurl, $url->out(false));< $url = new moodle_url('http://example.com/?a[1]=1&a[2]=2');> $url = new \moodle_url('http://example.com/?a[1]=1&a[2]=2');$this->assertSame($strurl, $url->out(false)); // For un-keyed array params, we expect 0..n keys to be returned. $strurl = 'http://example.com/?a%5B0%5D=0&a%5B1%5D=1';< $url = new moodle_url('http://example.com/?a[]=0&a[]=1');> $url = new \moodle_url('http://example.com/?a[]=0&a[]=1');$this->assertSame($strurl, $url->out(false)); } public function test_compare_url() {< $url1 = new moodle_url('index.php', array('var1' => 1, 'var2' => 2)); < $url2 = new moodle_url('index2.php', array('var1' => 1, 'var2' => 2, 'var3' => 3));> $url1 = new \moodle_url('index.php', array('var1' => 1, 'var2' => 2)); > $url2 = new \moodle_url('index2.php', array('var1' => 1, 'var2' => 2, 'var3' => 3));$this->assertFalse($url1->compare($url2, URL_MATCH_BASE)); $this->assertFalse($url1->compare($url2, URL_MATCH_PARAMS)); $this->assertFalse($url1->compare($url2, URL_MATCH_EXACT));< $url2 = new moodle_url('index.php', array('var1' => 1, 'var3' => 3));> $url2 = new \moodle_url('index.php', array('var1' => 1, 'var3' => 3));$this->assertTrue($url1->compare($url2, URL_MATCH_BASE)); $this->assertFalse($url1->compare($url2, URL_MATCH_PARAMS)); $this->assertFalse($url1->compare($url2, URL_MATCH_EXACT));< $url2 = new moodle_url('index.php', array('var1' => 1, 'var2' => 2, 'var3' => 3));> $url2 = new \moodle_url('index.php', array('var1' => 1, 'var2' => 2, 'var3' => 3));$this->assertTrue($url1->compare($url2, URL_MATCH_BASE)); $this->assertTrue($url1->compare($url2, URL_MATCH_PARAMS)); $this->assertFalse($url1->compare($url2, URL_MATCH_EXACT));< $url2 = new moodle_url('index.php', array('var2' => 2, 'var1' => 1));> $url2 = new \moodle_url('index.php', array('var2' => 2, 'var1' => 1));$this->assertTrue($url1->compare($url2, URL_MATCH_BASE)); $this->assertTrue($url1->compare($url2, URL_MATCH_PARAMS)); $this->assertTrue($url1->compare($url2, URL_MATCH_EXACT)); $url1->set_anchor('test'); $this->assertTrue($url1->compare($url2, URL_MATCH_BASE)); $this->assertTrue($url1->compare($url2, URL_MATCH_PARAMS)); $this->assertFalse($url1->compare($url2, URL_MATCH_EXACT)); $url2->set_anchor('test'); $this->assertTrue($url1->compare($url2, URL_MATCH_BASE)); $this->assertTrue($url1->compare($url2, URL_MATCH_PARAMS)); $this->assertTrue($url1->compare($url2, URL_MATCH_EXACT)); } public function test_out_as_local_url() { global $CFG; // Test http url.< $url1 = new moodle_url('/lib/tests/weblib_test.php');> $url1 = new \moodle_url('/lib/tests/weblib_test.php');$this->assertSame('/lib/tests/weblib_test.php', $url1->out_as_local_url()); // Test https url. $httpswwwroot = str_replace("http://", "https://", $CFG->wwwroot);< $url2 = new moodle_url($httpswwwroot.'/login/profile.php');> $url2 = new \moodle_url($httpswwwroot.'/login/profile.php');$this->assertSame('/login/profile.php', $url2->out_as_local_url()); // Test http url matching wwwroot.< $url3 = new moodle_url($CFG->wwwroot);> $url3 = new \moodle_url($CFG->wwwroot);$this->assertSame('', $url3->out_as_local_url()); // Test http url matching wwwroot ending with slash (/).< $url3 = new moodle_url($CFG->wwwroot.'/');> $url3 = new \moodle_url($CFG->wwwroot.'/');$this->assertSame('/', $url3->out_as_local_url()); }< /** < * @expectedException coding_exception < * @return void < */public function test_out_as_local_url_error() {< $url2 = new moodle_url('http://www.google.com/lib/tests/weblib_test.php');> $url2 = new \moodle_url('http://www.google.com/lib/tests/weblib_test.php'); > $this->expectException(\coding_exception::class);$url2->out_as_local_url(); } /** * You should get error with modified url< * < * @expectedException coding_exception < * @return void*/ public function test_modified_url_out_as_local_url_error() { global $CFG; $modifiedurl = $CFG->wwwroot.'1';< $url3 = new moodle_url($modifiedurl.'/login/profile.php');> $url3 = new \moodle_url($modifiedurl.'/login/profile.php'); > $this->expectException(\coding_exception::class);$url3->out_as_local_url(); } /** * Try get local url from external https url and you should get error< * < * @expectedException coding_exception*/ public function test_https_out_as_local_url_error() {< $url4 = new moodle_url('https://www.google.com/lib/tests/weblib_test.php');> $url4 = new \moodle_url('https://www.google.com/lib/tests/weblib_test.php'); > $this->expectException(\coding_exception::class);$url4->out_as_local_url(); } public function test_moodle_url_get_scheme() { // Should return the scheme only.< $url = new moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');> $url = new \moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');$this->assertSame('http', $url->get_scheme()); // Should work for secure URLs.< $url = new moodle_url('https://www.example.org:447/my/file/is/here.txt?really=1');> $url = new \moodle_url('https://www.example.org:447/my/file/is/here.txt?really=1');$this->assertSame('https', $url->get_scheme()); // Should return an empty string if no scheme is specified.< $url = new moodle_url('www.example.org:447/my/file/is/here.txt?really=1');> $url = new \moodle_url('www.example.org:447/my/file/is/here.txt?really=1');$this->assertSame('', $url->get_scheme()); } public function test_moodle_url_get_host() { // Should return the host part only.< $url = new moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');> $url = new \moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');$this->assertSame('www.example.org', $url->get_host()); } public function test_moodle_url_get_port() { // Should return the port if one provided.< $url = new moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');> $url = new \moodle_url('http://www.example.org:447/my/file/is/here.txt?really=1');$this->assertSame(447, $url->get_port()); // Should return an empty string if port not specified.< $url = new moodle_url('http://www.example.org/some/path/here.php');> $url = new \moodle_url('http://www.example.org/some/path/here.php');$this->assertSame('', $url->get_port()); } /**> * Test exporting params for templates. * Test the make_pluginfile_url function. > * * > * @dataProvider moodle_url_export_params_for_template_provider * @dataProvider make_pluginfile_url_provider > * @param string $url URL with params to test. * @param bool $slashargs > * @param array $expected The expected result. * @param array $args Args to be provided to make_pluginfile_url > */ * @param string $expected The expected result > public function test_moodle_url_export_params_for_template(string $url, array $expected) :void { */ > // Should return params in the URL. public function test_make_pluginfile_url($slashargs, $args, $expected) { > $moodleurl = new \moodle_url($url); global $CFG; > $this->assertSame($expected, $moodleurl->export_params_for_template()); > } $this->resetAfterTest(); > > /** $CFG->slasharguments = $slashargs; > * Data provider for moodle_url_export_params_for_template tests. $url = call_user_func_array('moodle_url::make_pluginfile_url', $args); > * $this->assertRegexp($expected, $url->out(true)); > * @return array[] the array of test data. } > */ > public function moodle_url_export_params_for_template_provider() :array { /** > $baseurl = "http://example.com"; * Data provider for make_pluginfile_url tests. > return [ * > 'With indexed array params' => [ * @return array[] > 'url' => "@{$baseurl}/?tags[0]=123&tags[1]=456", */ > 'expected' => [ public function make_pluginfile_url_provider() { > 0 => ['name' => 'tags[0]', 'value' => '123'], $baseurl = "https://www.example.com/moodle/pluginfile.php"; > 1 => ['name' => 'tags[1]', 'value' => '456'] $tokenbaseurl = "https://www.example.com/moodle/tokenpluginfile.php"; > ] return [ > ], 'Standard with slashargs' => [ > 'Without indexed array params' => [ 'slashargs' => true, > 'url' => "@{$baseurl}/?tags[]=123&tags[]=456", 'args' => [ > 'expected' => [ 1, > 0 => ['name' => 'tags[0]', 'value' => '123'], 'mod_forum', > 1 => ['name' => 'tags[1]', 'value' => '456'] 'posts', > ] 422, > ], '/my/location/', > 'with no params' => [ 'file.png', > 'url' => "@{$baseurl}/", ], > 'expected' => [] 'expected' => "@{$baseurl}/1/mod_forum/posts/422/my/location/file.png@", > ], ], > 'with no array params' => [ 'Standard without slashargs' => [ > 'url' => "@{$baseurl}/?param1=1¶m2=2¶m3=3", 'slashargs' => false, > 'expected' => [ 'args' => [ > 0 => ['name' => 'param1', 'value' => '1'], 1, > 1 => ['name' => 'param2', 'value' => '2'], 'mod_forum', > 2 => ['name' => 'param3', 'value' => '3'], 'posts', > ] 422, > ], '/my/location/', > 'array embedded with other params' => [ 'file.png', > 'url' => "@{$baseurl}/?param1=1&tags[0]=123&tags[1]=456¶m2=2¶m3=3", ], > 'expected' => [ 'expected' => "@{$baseurl}\?file=%2F1%2Fmod_forum%2Fposts%2F422%2Fmy%2Flocation%2Ffile.png@", > 0 => ['name' => 'param1', 'value' => '1'], ], > 1 => ['name' => 'tags[0]', 'value' => '123'], 'Token included with slashargs' => [ > 2 => ['name' => 'tags[1]', 'value' => '456'], 'slashargs' => true, > 3 => ['name' => 'param2', 'value' => '2'], 'args' => [ > 4 => ['name' => 'param3', 'value' => '3'], 1, > ] 'mod_forum', > ], 'posts', > 'params with array at the end' => [ 422, > 'url' => "@{$baseurl}/?param1=1&tags[]=123&tags[]=456", '/my/location/', > 'expected' => [ 'file.png', > 0 => ['name' => 'param1', 'value' => '1'], false, > 1 => ['name' => 'tags[0]', 'value' => '123'], true, > 2 => ['name' => 'tags[1]', 'value' => '456'], ], > ] 'expected' => "@{$tokenbaseurl}/[^/]*/1/mod_forum/posts/422/my/location/file.png@", > ], ], > ]; 'Token included without slashargs' => [ > } 'slashargs' => false, > 'args' => [ > /**< $url = call_user_func_array('moodle_url::make_pluginfile_url', $args); < $this->assertRegexp($expected, $url->out(true));> $url = call_user_func_array('\moodle_url::make_pluginfile_url', $args); > $this->assertMatchesRegularExpression($expected, $url->out(true));'posts', 422, '/my/location/', 'file.png', false, true, ], 'expected' => "@{$tokenbaseurl}\?file=%2F1%2Fmod_forum%2Fposts%2F422%2Fmy%2Flocation%2Ffile.png&token=[a-z0-9]*@", ], ]; } }