JetBrains PHPverse 2026

    A classe MongoDB\Driver\ReadPreference

    (mongodb >=1.0.0)

    Introdução

    Resumo da classe

    final class MongoDB\Driver\ReadPreference implements MongoDB\BSON\Serializable, Serializable {
    /* Propriedades */
    public readonly string $mode;
    public readonly ?array $tags;
    public readonly int $maxStalenessSeconds;
    public readonly ?object $hedge;
    /* Constantes */
    const string PRIMARY = primary;
    const string PRIMARY_PREFERRED = primaryPreferred;
    const string SECONDARY = secondary;
    const string SECONDARY_PREFERRED = secondaryPreferred;
    const string NEAREST = nearest;
    const int NO_MAX_STALENESS = -1;
    const int SMALLEST_MAX_STALENESS_SECONDS = 90;
    /* Métodos */
    final public bsonSerialize(): stdClass
    final public __construct(string $mode, ?array $tagSets = null, ?array $options = null)
    final public getHedge(): ?object
    final public getMaxStalenessSeconds(): int
    final public getMode(): int
    final public getModeString(): string
    final public getTagSets(): array
    }

    Propriedades

    mode
    O modo de preferência de leitura como uma string (por exemplo, "primary", "secondary").
    tags
    A lista de conjuntos de tags usada pela preferência de leitura, ou null se nenhum conjunto de tags foi especificado.
    maxStalenessSeconds
    O tempo máximo de defasagem em segundos para leituras, ou MongoDB\Driver\ReadPreference::NO_MAX_STALENESS se nenhum tempo máximo de defasagem foi especificado.
    hedge
    Um documento que especifica as opções de hedge para a preferência de leitura, ou null se nenhuma opção de hedge foi especificada.
    Aviso

    Esta propriedade foi descontinuada, pois as leituras protegidas estão obsoletas no MongoDB 8.0.

    Constantes predefinidas

    MongoDB\Driver\ReadPreference::PRIMARY
    Todas as operações são lidas do conjunto de réplicas primário atual. Esta é a preferência de leitura padrão do MongoDB.
    MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED
    Na maioria das situações, as operações são lidas a partir dos membros primários, mas se não estiver disponível, as operações são lidas a partir dos membros secundários.
    MongoDB\Driver\ReadPreference::SECONDARY
    Todas as operações são lidas nos membros secundários do conjunto de réplicas.
    MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED
    Na maioria das situações, as operações são lidas a partir de membros secundários, mas se nenhum membro secundário estiver disponível, as operações são lidas a partir do primário.
    MongoDB\Driver\ReadPreference::NEAREST
    Operações lidas do membro do conjunto de réplicas com a menor latência de rede, independentemente do tipo do membro.
    MongoDB\Driver\ReadPreference::NO_MAX_STALENESS
    O valor padrão para a opção "maxStalenessSeconds" é não especificar nenhum limite de inatividade máxima, o que significa que o driver não considerará o atraso de um secundário ao escolher para onde direcionar uma operação de leitura.
    MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS
    O valor mínimo para a opção "maxStalenessSeconds" é 90 segundos. O driver estima a inatividade dos secundários verificando periodicamente a data de gravação mais recente de cada membro do conjunto de réplicas. Como essas verificações são pouco frequentes, a estimativa de inatividade é grosseira. Assim, o driver não pode impor um valor máximo de inatividade inferior a 90 segundos.

    Registro de Alterações

    Versão Descrição
    PECL mongodb 2.3.0 Adicionadas propriedades públicas readonly.
    PECL mongodb 2.0.0 Removidas as constantes MongoDB\Driver\ReadPreference::RP_PRIMARY, MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED, MongoDB\Driver\ReadPreference::RP_SECONDARY, MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED e MongoDB\Driver\ReadPreference::RP_NEAREST. O método getMode() também foi removido.
    PECL mongodb 1.20.0 As constantes MongoDB\Driver\ReadPreference::RP_PRIMARY, MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED, MongoDB\Driver\ReadPreference::RP_SECONDARY, MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED, e MongoDB\Driver\ReadPreference::RP_NEAREST foram descontinuadas.
    PECL mongodb 1.7.0 As constantes MongoDB\Driver\ReadPreference::PRIMARY, MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED, MongoDB\Driver\ReadPreference::SECONDARY, MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED, e MongoDB\Driver\ReadPreference::NEAREST foram adicionadas. Implementa Serializable.
    PECL mongodb 1.2.0 As constantes MongoDB\Driver\ReadPreference::NO_MAX_STALENESS e MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS foram adicionadas. Implementa MongoDB\BSON\Serializable.

    Índice

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicionar nota

    Notas de Usuários

    Não há notas de usuários para esta página.
    To Top