LBFactorySimple.php

Go to the documentation of this file.

<?php
namespace Wikimedia\Rdbms;
 
use InvalidArgumentException;
 
class LBFactorySimple extends LBFactory {
    private $mainLB;
    private $externalLBs = [];
 
    private $loadMonitorConfig;
 
    private $mainServers = [];
    private $externalServersByCluster = [];
 
    public function __construct( array $conf ) {
        parent::__construct( $conf );
 
        $this->mainServers = $conf['servers'] ?? [];
        foreach ( ( $conf['externalClusters'] ?? [] ) as $cluster => $servers ) {
            foreach ( $servers as $index => $server ) {
                $this->externalServersByCluster[$cluster][$index] = $server;
            }
        }
 
        if ( isset( $conf['loadMonitor'] ) ) {
            $this->loadMonitorConfig = $conf['loadMonitor'];
        } elseif ( isset( $conf['loadMonitorClass'] ) ) { // b/c
            $this->loadMonitorConfig = [ 'class' => $conf['loadMonitorClass'] ];
        } else {
            $this->loadMonitorConfig = [ 'class' => LoadMonitor::class ];
        }
    }
 
    public function newMainLB( $domain = false, $owner = null ) {
        return $this->newLoadBalancer( $this->mainServers, $owner );
    }
 
    public function getMainLB( $domain = false ) {
        if ( $this->mainLB === null ) {
            $this->mainLB = $this->newMainLB( $domain, $this->getOwnershipId() );
        }
 
        return $this->mainLB;
    }
 
    public function newExternalLB( $cluster, $owner = null ) {
        if ( !isset( $this->externalServersByCluster[$cluster] ) ) {
            throw new InvalidArgumentException( "Unknown cluster '$cluster'." );
        }
 
        return $this->newLoadBalancer( $this->externalServersByCluster[$cluster], $owner );
    }
 
    public function getExternalLB( $cluster ) {
        if ( !isset( $this->externalLBs[$cluster] ) ) {
            $this->externalLBs[$cluster] = $this->newExternalLB( $cluster, $this->getOwnershipId() );
        }
 
        return $this->externalLBs[$cluster];
    }
 
    public function getAllMainLBs() {
        return [ self::CLUSTER_MAIN_DEFAULT => $this->getMainLB() ];
    }
 
    public function getAllExternalLBs() {
        $lbs = [];
        foreach ( array_keys( $this->externalServersByCluster ) as $cluster ) {
            $lbs[$cluster] = $this->getExternalLB( $cluster );
        }
 
        return $lbs;
    }
 
    private function newLoadBalancer( array $servers, $owner ) {
        $lb = new LoadBalancer( array_merge(
            $this->baseLoadBalancerParams( $owner ),
            [
                'servers' => $servers,
                'loadMonitor' => $this->loadMonitorConfig,
            ]
        ) );
        $this->initLoadBalancer( $lb );
 
        return $lb;
    }
 
    public function forEachLB( $callback, array $params = [] ) {
        if ( $this->mainLB !== null ) {
            $callback( $this->mainLB, ...$params );
        }
        foreach ( $this->externalLBs as $lb ) {
            $callback( $lb, ...$params );
        }
    }
}