LBFactorySimple.php

Go to the documentation of this file.

<?php
class LBFactorySimple extends LBFactory {
    private $mainLB;
    private $extLBs = [];

    private $loadMonitorClass;

    public function __construct( array $conf ) {
        parent::__construct( $conf );

        $this->loadMonitorClass = isset( $conf['loadMonitorClass'] )
            ? $conf['loadMonitorClass']
            : null;
    }

    public function newMainLB( $wiki = false ) {
        global $wgDBservers;

        if ( is_array( $wgDBservers ) ) {
            $servers = $wgDBservers;
            foreach ( $servers as $i => &$server ) {
                if ( $i == 0 ) {
                    $server['master'] = true;
                } else {
                    $server['slave'] = true;
                }
            }
        } else {
            global $wgDBserver, $wgDBuser, $wgDBpassword, $wgDBname, $wgDBtype, $wgDebugDumpSql;
            global $wgDBssl, $wgDBcompress;

            $flags = DBO_DEFAULT;
            if ( $wgDebugDumpSql ) {
                $flags |= DBO_DEBUG;
            }
            if ( $wgDBssl ) {
                $flags |= DBO_SSL;
            }
            if ( $wgDBcompress ) {
                $flags |= DBO_COMPRESS;
            }

            $servers = [ [
                'host' => $wgDBserver,
                'user' => $wgDBuser,
                'password' => $wgDBpassword,
                'dbname' => $wgDBname,
                'type' => $wgDBtype,
                'load' => 1,
                'flags' => $flags,
                'master' => true
            ] ];
        }

        return new LoadBalancer( [
            'servers' => $servers,
            'loadMonitor' => $this->loadMonitorClass,
            'readOnlyReason' => $this->readOnlyReason,
            'trxProfiler' => $this->trxProfiler
        ] );
    }

    public function getMainLB( $wiki = false ) {
        if ( !isset( $this->mainLB ) ) {
            $this->mainLB = $this->newMainLB( $wiki );
            $this->mainLB->parentInfo( [ 'id' => 'main' ] );
            $this->chronProt->initLB( $this->mainLB );
        }

        return $this->mainLB;
    }

    protected function newExternalLB( $cluster, $wiki = false ) {
        global $wgExternalServers;
        if ( !isset( $wgExternalServers[$cluster] ) ) {
            throw new MWException( __METHOD__ . ": Unknown cluster \"$cluster\"" );
        }

        return new LoadBalancer( [
            'servers' => $wgExternalServers[$cluster],
            'loadMonitor' => $this->loadMonitorClass,
            'readOnlyReason' => $this->readOnlyReason,
            'trxProfiler' => $this->trxProfiler
        ] );
    }

    public function &getExternalLB( $cluster, $wiki = false ) {
        if ( !isset( $this->extLBs[$cluster] ) ) {
            $this->extLBs[$cluster] = $this->newExternalLB( $cluster, $wiki );
            $this->extLBs[$cluster]->parentInfo( [ 'id' => "ext-$cluster" ] );
            $this->chronProt->initLB( $this->extLBs[$cluster] );
        }

        return $this->extLBs[$cluster];
    }

    public function forEachLB( $callback, array $params = [] ) {
        if ( isset( $this->mainLB ) ) {
            call_user_func_array( $callback, array_merge( [ $this->mainLB ], $params ) );
        }
        foreach ( $this->extLBs as $lb ) {
            call_user_func_array( $callback, array_merge( [ $lb ], $params ) );
        }
    }

    public function shutdown( $flags = 0 ) {
        if ( !( $flags & self::SHUTDOWN_NO_CHRONPROT ) ) {
            $this->shutdownChronologyProtector( $this->chronProt );
        }
        $this->commitMasterChanges( __METHOD__ ); // sanity
    }
}