LBFactorySimple.php

Go to the documentation of this file.

<?php
namespace Wikimedia\Rdbms;
 
use InvalidArgumentException;
 
class LBFactorySimple extends LBFactory {
    private $mainLB;
    private $externalLBs = [];
 
    private $mainServers = [];
    private $externalServersByCluster = [];
 
    private $loadMonitorClass;
 
    public function __construct( array $conf ) {
        parent::__construct( $conf );
 
        $this->mainServers = $conf['servers'] ?? [];
        foreach ( $this->mainServers as $i => $server ) {
            if ( $i == 0 ) {
                $this->mainServers[$i]['master'] = true;
            } else {
                $this->mainServers[$i]['replica'] = true;
            }
        }
 
        foreach ( ( $conf['externalClusters'] ?? [] ) as $cluster => $servers ) {
            foreach ( $servers as $index => $server ) {
                $this->externalServersByCluster[$cluster][$index] = $server;
            }
        }
 
        $this->loadMonitorClass = $conf['loadMonitorClass'] ?? 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' => [ 'class' => $this->loadMonitorClass ],
            ]
        ) );
        $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 );
        }
    }
}