Esta biblioteca fornece uma abstração de alto nível em torno do driver PHP de nível inferior (extensão mongodb
).
Embora a extensão forneça uma API limitada para executar comandos, consultas e operações de gravação, esta biblioteca implementa uma API completa semelhante à de outros drivers MongoDB. Ele contém abstrações para clientes, bancos de dados e objetos de coleção e fornece métodos para operações CRUD e comandos comuns (por exemplo, gerenciamento de índice e coleção).
Se você estiver desenvolvendo um aplicativo com MongoDB, considere usar esta biblioteca, ou outra abstração de alto nível, em vez da extensão apenas.
Informações adicionais sobre a arquitetura desta biblioteca e a extensão mongodb
podem ser encontradas em Visão Geral da Arquitetura.
O método preferido de instalação desta biblioteca é com o Composer, executando o seguinte na raiz do seu projeto:
$ composer require mongodb/mongodb
Instruções adicionais de instalação podem ser encontradas na documentação da biblioteca.
Como esta biblioteca é uma abstração de alto nível para o driver, ela também requer que a extensão mongodb
esteja instalada:
$ pecl install mongodb
$ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
Instruções adicionais de instalação para a extensão podem ser encontradas na documentação do PHP.net.
Os lançamentos são criados automaticamente e a tag de lançamento resultante é assinada usando a chave GPG da equipe PHP. Para verificar a assinatura da tag, baixe a chave e importe-a usando gpg
:
gpg --import php-driver.asc
Então, em um clone local, verifique a assinatura de uma determinada tag (por exemplo, 1.19.0
):
git show --show-signature 1.19.0
Observação
O Composer não oferece suporte à verificação de assinaturas como parte do processo de instalação.
Problemas relativos à biblioteca devem ser relatados no projeto PHPLIB no JIRA do MongoDB. Questões relacionadas à extensão devem ser relatadas no projeto PHPC.
Para dúvidas gerais e solicitações de suporte, utilize um dos canais de suporte técnico do MongoDB.
Se você identificou uma vulnerabilidade de segurança em um driver ou qualquer outro projeto do MongoDB, relate-a de acordo com as instruções em Criar um relatório de vulnerabilidade.
O desenvolvimento é acompanhado no projeto PHPLIB no JIRA do MongoDB. A documentação para contribuir para este projeto pode ser encontrada em CONTRIBUTING.md.