DatabaseTest.php

Go to the documentation of this file.

<?php

class DatabaseTest extends MediaWikiTestCase {
    protected $db;

    private $functionTest = false;

    protected function setUp() {
        parent::setUp();
        $this->db = wfGetDB( DB_MASTER );
    }

    protected function tearDown() {
        parent::tearDown();
        if ( $this->functionTest ) {
            $this->dropFunctions();
            $this->functionTest = false;
        }
    }
    public function testAddQuotesNull() {
        $check = "NULL";
        if ( $this->db->getType() === 'sqlite' || $this->db->getType() === 'oracle' ) {
            $check = "''";
        }
        $this->assertEquals( $check, $this->db->addQuotes( null ) );
    }

    public function testAddQuotesInt() {
        # returning just "1234" should be ok too, though...
        # maybe
        $this->assertEquals(
            "'1234'",
            $this->db->addQuotes( 1234 ) );
    }

    public function testAddQuotesFloat() {
        # returning just "1234.5678" would be ok too, though
        $this->assertEquals(
            "'1234.5678'",
            $this->db->addQuotes( 1234.5678 ) );
    }

    public function testAddQuotesString() {
        $this->assertEquals(
            "'string'",
            $this->db->addQuotes( 'string' ) );
    }

    public function testAddQuotesStringQuote() {
        $check = "'string''s cause trouble'";
        if ( $this->db->getType() === 'mysql' ) {
            $check = "'string\'s cause trouble'";
        }
        $this->assertEquals(
            $check,
            $this->db->addQuotes( "string's cause trouble" ) );
    }

    private function getSharedTableName( $table, $database, $prefix, $format = 'quoted' ) {
        global $wgSharedDB, $wgSharedTables, $wgSharedPrefix;

        $oldName = $wgSharedDB;
        $oldTables = $wgSharedTables;
        $oldPrefix = $wgSharedPrefix;

        $wgSharedDB = $database;
        $wgSharedTables = [ $table ];
        $wgSharedPrefix = $prefix;

        $ret = $this->db->tableName( $table, $format );

        $wgSharedDB = $oldName;
        $wgSharedTables = $oldTables;
        $wgSharedPrefix = $oldPrefix;

        return $ret;
    }

    private function prefixAndQuote( $table, $database = null, $prefix = null, $format = 'quoted' ) {
        if ( $this->db->getType() === 'sqlite' || $format !== 'quoted' ) {
            $quote = '';
        } elseif ( $this->db->getType() === 'mysql' ) {
            $quote = '`';
        } elseif ( $this->db->getType() === 'oracle' ) {
            $quote = '/*Q*/';
        } else {
            $quote = '"';
        }

        if ( $database !== null ) {
            if ( $this->db->getType() === 'oracle' ) {
                $database = $quote . $database . '.';
            } else {
                $database = $quote . $database . $quote . '.';
            }
        }

        if ( $prefix === null ) {
            $prefix = $this->dbPrefix();
        }

        if ( $this->db->getType() === 'oracle' ) {
            return strtoupper( $database . $quote . $prefix . $table );
        } else {
            return $database . $quote . $prefix . $table . $quote;
        }
    }

    public function testTableNameLocal() {
        $this->assertEquals(
            $this->prefixAndQuote( 'tablename' ),
            $this->db->tableName( 'tablename' )
        );
    }

    public function testTableNameRawLocal() {
        $this->assertEquals(
            $this->prefixAndQuote( 'tablename', null, null, 'raw' ),
            $this->db->tableName( 'tablename', 'raw' )
        );
    }

    public function testTableNameShared() {
        $this->assertEquals(
            $this->prefixAndQuote( 'tablename', 'sharedatabase', 'sh_' ),
            $this->getSharedTableName( 'tablename', 'sharedatabase', 'sh_' )
        );

        $this->assertEquals(
            $this->prefixAndQuote( 'tablename', 'sharedatabase', null ),
            $this->getSharedTableName( 'tablename', 'sharedatabase', null )
        );
    }

    public function testTableNameRawShared() {
        $this->assertEquals(
            $this->prefixAndQuote( 'tablename', 'sharedatabase', 'sh_', 'raw' ),
            $this->getSharedTableName( 'tablename', 'sharedatabase', 'sh_', 'raw' )
        );

        $this->assertEquals(
            $this->prefixAndQuote( 'tablename', 'sharedatabase', null, 'raw' ),
            $this->getSharedTableName( 'tablename', 'sharedatabase', null, 'raw' )
        );
    }

    public function testTableNameForeign() {
        $this->assertEquals(
            $this->prefixAndQuote( 'tablename', 'databasename', '' ),
            $this->db->tableName( 'databasename.tablename' )
        );
    }

    public function testTableNameRawForeign() {
        $this->assertEquals(
            $this->prefixAndQuote( 'tablename', 'databasename', '', 'raw' ),
            $this->db->tableName( 'databasename.tablename', 'raw' )
        );
    }

    public function testFillPreparedEmpty() {
        $sql = $this->db->fillPrepared(
            'SELECT * FROM interwiki', [] );
        $this->assertEquals(
            "SELECT * FROM interwiki",
            $sql );
    }

    public function testFillPreparedQuestion() {
        $sql = $this->db->fillPrepared(
            'SELECT * FROM cur WHERE cur_namespace=? AND cur_title=?',
            [ 4, "Snicker's_paradox" ] );

        $check = "SELECT * FROM cur WHERE cur_namespace='4' AND cur_title='Snicker''s_paradox'";
        if ( $this->db->getType() === 'mysql' ) {
            $check = "SELECT * FROM cur WHERE cur_namespace='4' AND cur_title='Snicker\'s_paradox'";
        }
        $this->assertEquals( $check, $sql );
    }

    public function testFillPreparedBang() {
        $sql = $this->db->fillPrepared(
            'SELECT user_id FROM ! WHERE user_name=?',
            [ '"user"', "Slash's Dot" ] );

        $check = "SELECT user_id FROM \"user\" WHERE user_name='Slash''s Dot'";
        if ( $this->db->getType() === 'mysql' ) {
            $check = "SELECT user_id FROM \"user\" WHERE user_name='Slash\'s Dot'";
        }
        $this->assertEquals( $check, $sql );
    }

    public function testFillPreparedRaw() {
        $sql = $this->db->fillPrepared(
            "SELECT * FROM cur WHERE cur_title='This_\\&_that,_WTF\\?\\!'",
            [ '"user"', "Slash's Dot" ] );
        $this->assertEquals(
            "SELECT * FROM cur WHERE cur_title='This_&_that,_WTF?!'",
            $sql );
    }

    public function testStoredFunctions() {
        if ( !in_array( wfGetDB( DB_MASTER )->getType(), [ 'mysql', 'postgres' ] ) ) {
            $this->markTestSkipped( 'MySQL or Postgres required' );
        }
        global $IP;
        $this->dropFunctions();
        $this->functionTest = true;
        $this->assertTrue(
            $this->db->sourceFile( "$IP/tests/phpunit/data/db/{$this->db->getType()}/functions.sql" )
        );
        $res = $this->db->query( 'SELECT mw_test_function() AS test', __METHOD__ );
        $this->assertEquals( 42, $res->fetchObject()->test );
    }

    private function dropFunctions() {
        $this->db->query( 'DROP FUNCTION IF EXISTS mw_test_function'
                . ( $this->db->getType() == 'postgres' ? '()' : '' )
        );
    }

    public function testUnknownTableCorruptsResults() {
        $res = $this->db->select( 'page', '*', [ 'page_id' => 1 ] );
        $this->assertFalse( $this->db->tableExists( 'foobarbaz' ) );
        $this->assertInternalType( 'int', $res->numRows() );
    }

    public function testTransactionIdle() {
        $db = $this->db;

        $db->setFlag( DBO_TRX );
        $called = false;
        $flagSet = null;
        $db->onTransactionIdle( function() use ( $db, &$flagSet, &$called ) {
            $called = true;
            $flagSet = $db->getFlag( DBO_TRX );
        } );
        $this->assertFalse( $flagSet, 'DBO_TRX off in callback' );
        $this->assertTrue( $db->getFlag( DBO_TRX ), 'DBO_TRX restored to default' );
        $this->assertTrue( $called, 'Callback reached' );

        $db->clearFlag( DBO_TRX );
        $flagSet = null;
        $db->onTransactionIdle( function() use ( $db, &$flagSet ) {
            $flagSet = $db->getFlag( DBO_TRX );
        } );
        $this->assertFalse( $flagSet, 'DBO_TRX off in callback' );
        $this->assertFalse( $db->getFlag( DBO_TRX ), 'DBO_TRX restored to default' );

        $db->clearFlag( DBO_TRX );
        $db->onTransactionIdle( function() use ( $db ) {
            $db->setFlag( DBO_TRX );
        } );
        $this->assertFalse( $db->getFlag( DBO_TRX ), 'DBO_TRX restored to default' );
    }

    public function testTransactionResolution() {
        $db = $this->db;

        $db->clearFlag( DBO_TRX );
        $db->begin( __METHOD__ );
        $called = false;
        $db->onTransactionResolution( function() use ( $db, &$called ) {
            $called = true;
            $db->setFlag( DBO_TRX );
        } );
        $db->commit( __METHOD__ );
        $this->assertFalse( $db->getFlag( DBO_TRX ), 'DBO_TRX restored to default' );
        $this->assertTrue( $called, 'Callback reached' );

        $db->clearFlag( DBO_TRX );
        $db->begin( __METHOD__ );
        $called = false;
        $db->onTransactionResolution( function() use ( $db, &$called ) {
            $called = true;
            $db->setFlag( DBO_TRX );
        } );
        $db->rollback( __METHOD__ );
        $this->assertFalse( $db->getFlag( DBO_TRX ), 'DBO_TRX restored to default' );
        $this->assertTrue( $called, 'Callback reached' );
    }
}