Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is 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/>.

declare(strict_types=1);

namespace core_reportbuilder\local\helpers;

use advanced_testcase;
use coding_exception;
use core_user;

/**
 * Unit tests for the database helper class
 *
 * @package     core_reportbuilder
 * @covers      \core_reportbuilder\local\helpers\database
 * @copyright   2020 Paul Holden <paulh@moodle.com>
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class database_test extends advanced_testcase {

    /**
< * Test generating table alias and parameter names
> * Test generating alias
*/
< public function test_generate_alias_params(): void { < global $DB; < < $admin = core_user::get_user_by_username('admin');
> public function test_generate_alias(): void { > $this->assertMatchesRegularExpression('/^rbalias(\d+)$/', database::generate_alias()); > }
< $usertablealias = database::generate_alias(); < $usertablealiasjoin = database::generate_alias(); < $useridalias = database::generate_alias();
> /** > * Test generating multiple aliases > */ > public function test_generate_aliases(): void { > $aliases = database::generate_aliases(3);
< $paramuserid = database::generate_param_name(); < $paramuserdeleted = database::generate_param_name();
> $this->assertCount(3, $aliases); > [$aliasone, $aliastwo, $aliasthree] = $aliases;
// Ensure they are different.
< $this->assertNotEquals($usertablealias, $usertablealiasjoin); < $this->assertNotEquals($paramuserid, $paramuserdeleted);
> $this->assertNotEquals($aliasone, $aliastwo); > $this->assertNotEquals($aliasone, $aliasthree); > $this->assertNotEquals($aliastwo, $aliasthree); > }
< $sql = "SELECT {$usertablealias}.id AS {$useridalias} < FROM {user} {$usertablealias} < JOIN {user} {$usertablealiasjoin} ON {$usertablealiasjoin}.id = {$usertablealias}.id < WHERE {$usertablealias}.id = :{$paramuserid} AND {$usertablealias}.deleted = :{$paramuserdeleted}"; < $params = [$paramuserid => $admin->id, $paramuserdeleted => 0];
> /** > * Test generating parameter name > */ > public function test_generate_param_name(): void { > $this->assertMatchesRegularExpression('/^rbparam(\d+)$/', database::generate_param_name()); > }
< $validated = database::validate_params($params); < $this->assertTrue($validated);
> /** > * Test generating multiple parameter names > */ > public function test_generate_param_names(): void { > $params = database::generate_param_names(3);
< $record = $DB->get_record_sql($sql, $params); < $this->assertEquals($admin->id, $record->{$useridalias});
> $this->assertCount(3, $params); > [$paramone, $paramtwo, $paramthree] = $params; > > // Ensure they are different. > $this->assertNotEquals($paramone, $paramtwo); > $this->assertNotEquals($paramone, $paramthree); > $this->assertNotEquals($paramtwo, $paramthree);
} /** * Test parameter validation */ public function test_validate_params(): void {
> [$paramone, $paramtwo] = database::generate_param_names(2); $params = [ > database::generate_param_name() => 1, > $params = [ 'invalidfoo' => 2, > $paramone => 1, 'invalidbar' => 4, > $paramtwo => 2, ]; > ]; > $this->expectException(coding_exception::class); > $this->assertTrue(database::validate_params($params)); $this->expectExceptionMessage('Invalid parameter names (invalidfoo, invalidbar)'); > } database::validate_params($params); > } > /** > * Test parameter validation for invalid parameters /** > */ * Test replacement of parameter names within SQL statements > public function test_validate_params_invalid(): void {
*/
> } public function test_sql_replace_parameter_names(): void { > global $DB; > /** > * Generate aliases and parameters and confirm they can be used within a query // Predefine parameter names, to ensure they don't overwrite each other. > */ [$param0, $param1, $param10] = ['rbparam0', 'rbparam1', 'rbparam10']; > public function test_generated_data_in_query(): void { > global $DB; $sql = "SELECT :{$param0} AS field0, :{$param1} AS field1, :{$param10} AS field10" . $DB->sql_null_from_clause(); > $sql = database::sql_replace_parameter_names($sql, [$param0, $param1, $param10], static function(string $param): string { > // Unique aliases. return "prefix_{$param}"; > [ }); > $usertablealias, > $userfieldalias, $record = $DB->get_record_sql($sql, [ > ] = database::generate_aliases(2); "prefix_{$param0}" => 'Zero', > "prefix_{$param1}" => 'One', > // Unique parameters. "prefix_{$param10}" => 'Ten', > [ ]); > $paramuserid, > $paramuserdeleted, $this->assertEquals((object) [ > ] = database::generate_param_names(2); 'field0' => 'Zero', > 'field1' => 'One', > // Simple query to retrieve the admin user. 'field10' => 'Ten', > $sql = "SELECT {$usertablealias}.id AS {$userfieldalias} ], $record); > FROM {user} {$usertablealias} } > WHERE {$usertablealias}.id = :{$paramuserid} } > AND {$usertablealias}.deleted = :{$paramuserdeleted}"; > > $admin = core_user::get_user_by_username('admin'); > > $params = [ > $paramuserid => $admin->id, > $paramuserdeleted => 0, > ]; > > $record = $DB->get_record_sql($sql, $params); > $this->assertEquals($admin->id, $record->{$userfieldalias});