/ /

Biblioteca PHP

MongoDB\Collection

Página inicial do Docs

Bibliotecas do cliente

PHP

Biblioteca PHP

MongoDB\Collection

MongoDB\Collection::countDocuments()

Novidade na versão 1.4.

Definição

MongoDB\Collection::countDocuments()

Conte o número de documentos que correspondem aos critérios de filtro.

function countDocuments(array|object $filter = [], array $options = []): integer

Parâmetros

$filter : array|object

Os critérios de filtro que especificam os documentos a serem contados.

$options : array

Uma array especificando as opções desejadas.

Nome	Tipo	Descrição
agrupamento	array\|object	A colocação permite que os usuários especifiquem regras específicas do idioma para comparação de string , como regras para letras maiúsculas e marcas de acento. Ao especificar agrupamento, o campo `locale` é obrigatório; todos os outros campos de agrupamento são opcionais. Para obter descrições dos campos, consulte Documento de agrupamento. Se o agrupamento não for especificado, mas a coleção tiver um agrupamento padrão, a operação usará o agrupamento especificado para a coleção. Se nenhum agrupamento for especificado para a coleção nem para a operação, o MongoDB usará a comparação binária simples usada nas versões anteriores para comparações de strings.
comment	misto	Permite ao usuário especificar um comentário arbitrário para ajudar a rastrear a operação por meio do profiler de banco de dados, da saída currentOp e dos registros. O comentário pode ser qualquer tipo de BSON válido a partir de MongoDB 4.4. As versões anteriores do servidor suportam apenas valores de string.
dica	string\|array\|objeto	O índice a ser utilizado. Especifique o nome do índice como uma string ou o padrão da chave do índice como um documento. Se especificado, o sistema de query considerará apenas os planos usando o índice sugerido.
limit	inteiro	O número máximo de documentos correspondentes a serem devolvidos.
maxTimeMS	inteiro	O limite de tempo cumulativo em milésimos de segundo para operações de processamento no cursor. O MongoDB aborta a operação o mais cedo possível após o ponto de interrupção.
readConcern	MongoDB\Driver\ReadConcern	Preocupação de leitura a ser usada para a operação. O padrão é a preocupação de leitura da coleção. Não é possível especificar uma questão de leitura para operações individuais como parte de uma transação. Em vez disso, defina a opção `readConcern` ao iniciar a transação.
readPreference	MongoDB\Driver\ReadPreference	Preferência de leitura a ser usada na operação. O padrão é a preferência de leitura da coleção.
session	MongoDB\Driver\Session	Sessão do cliente a ser associada à operação.
ignorar	inteiro	O número de documentos correspondentes a ignorar antes de retornar os resultados.

Return Values

O número de documentos que correspondem aos critérios de filtro.

Erros/exceções

MongoDB\Exception\UnexpectedValueException se a resposta do comando do servidor estiver malformada.

MongoDB\Exception\UnsupportedException se as opções forem usadas e não aceitas pelo servidor selecionado (p. ex., collation, readConcern, writeConcern).

MongoDB\Exception\InvalidArgumentException para erros relacionados à análise de parâmetros ou opções.

MongoDB\Driver\Exception\RuntimeException para outros erros no nível da extensão (por exemplo erros de conexão).

Comportamento

Internamente, esse método usa o operador de pipeline de agregação $group para obter o resultado. Se um parâmetro filter for fornecido, ele será convertido em um operador de pipeline $match . Os estágios $skip e $limit opcionais são adicionados entre $match e group , se presentes nas opções.

Observação

Esse método conta documentos no lado do servidor. Para obter um número total aproximado de documentos sem filtros, o método MongoDB\Collection::estimatedDocumentCount() pode ser usado. Esse método estima o número de documentos com base nos metadados da coleção, sacrificando a precisão pelo desempenho.

Como esse método usa um aggregation pipeline, alguns operadores de query aceitos em um MongoDB\Collection::count() filter não podem ser usados. Considere as seguintes alternativas a esses operadores restritos:

Restrito	Sintaxe alternativa
`$near`	`$geoWithin` com `$center`
`$nearSphere`	`$geoWithin` com `$centerSphere`
`$where`	`$expr`

Ao avaliar critérios de query, o MongoDB compara tipos e valores de acordo com suas próprias regras de comparação para tipos BSON, o que difere das regras de comparação e malabarismo de tipos do PHP. Ao corresponder a um tipo BSON especial, os critérios de query devem usar a respectiva classe BSON na extensão (por exemplo use MongoDB\BSON\ObjectId para corresponder a um ObjectId).

Veja também

MongoDB\Collection::estimatedDocumentCount()

Voltar

count()

createIndex()