Informações para instalar esta extensão PECL podem ser encontradas no capítulo Instalação de Extensões PECL do manual. Informações adicionais, como novas versões, downloads, arquivos fontes, informações do mantenedor e um CHANGELOG, podem ser encontradas aqui: » https://pecl.php.net/package/mongodb
Usuários de Linux, Unix e macOS podem executar o seguinte comando para instalar a extensão:
$ sudo pecl install mongodb
Em sistemas com múltiplas versões de PHP instaladas (por exemplo, macOS padrão, Homebrew, » XAMPP), cada versão do PHP terá seu próprio comando pecl e arquivo php.ini. Além disso, cada ambiente PHP (por exemplo, CLI, web) podem usar arquivos php.ini separados.
A partir da versão de extensão 1.17.0, o PECL solicitará várias opções
de configure
. Para instalar a extensão com opções padrão
em um script não interativo, a entrada de string vazia pode ser canalizada para
pecl install
usando o comando yes
:
$ yes '' | sudo pecl install mongodb
Uma lista completa de opções configure
suportadas pode ser
encontrada no arquivo package.xml
incluído no pacote PECL.
Para instalar a extensão com opções configure
específicas
em um script não interativo, a
opção --configureoptions
para
pecl install
pode ser usada:
$ sudo pecl install --configureoptions='with-mongodb-system-libs="yes" enable-mongodb-developer-flags="no"' mongodb
Por padrão, a instalação da extensão via PECL usará versões agrupadas de » libbson, » libmongoc e » libmongocrypt e tentará configurá-los automaticamente.
Nota: Se o processo de construção não conseguir encontrar uma biblioteca SSL, verifique se os pacotes de desenvolvimento (por exemplo,
libssl-dev
) e » pkg-config estão ambos instalados. Se isso não resolver o problema, considere usar o processo de instalação manual.
Finalmente, adicione a seguinte linha ao arquivo php.ini para cada ambiente que precisará usar a extensão:
extension=mongodb.so
» Homebrew 1.5.0 descontinuou o » Homebrew/php tap e fórmulas removidas para extensões PHP individuais. A partir de agora, os usuários do macOS são aconselhados a instalar a fórmula » php e seguir a fórmula padrão Instruções de instalação do PECL usando o comando pecl fornecido pela instalação do Homebrew PHP.
Os binários pré-compilados são anexados às » versões do Github do projeto. Os arquivos são publicados para várias combinações de versão PHP, segurança de thread (TS ou NTS) e arquitetura (x86 ou x64). Determinar o arquivo correto para o ambiente PHP e extrair o arquivo php_mongodb.dll para o diretório de extensão ("ext" por padrão).
Adicione a seguinte linha ao arquivo php.ini para cada ambiente que precisará usar a extensão:
extension=php_mongodb.dll
A falha ao selecionar o binário correto resultará em um erro ao tentar carregar a DLL de extensão em tempo de execução:
PHP Warning: PHP Startup: Unable to load dynamic library 'mongodb'
Certifique-se de que a DLL baixada corresponda às seguintes propriedades de tempo de execução do PHP:
PHP_VERSION
)PHP_ZTS
)PHP_INT_SIZE
)Além das constantes mencionadas acima, essas propriedades também podem ser inferidas de phpinfo(). Se um sistema tiver vários runtimes de execução PHP instalados, verifique novamente se a saída phpinfo() é para o ambiente correto.
Nota: Dependências adicionais de DLL para usuários do Windows
Para que esta extensão funcione, existem arquivos DLL que devem estar disponíveis no PATH do sistema Windows. Para saber como fazer isso, veja a FAQ intitulada "Como eu adiciono o meu diretório PHP ao PATH do Windows". Embora copiar arquivos DLL da pasta do PHP para o diretório system do Windows também funcione (porque o diretório system está, por padrão, no PATH do sistema), isso não é recomendado. Esta extensão requer que os seguintes arquivos estejam no PATH: libsasl.dll
Para desenvolvedores e usuários interessados nas correções de bugs mais recentes, a extensão pode ser compilada a partir do código-fonte mais recente no » Github. Execute os seguintes comandos para clonar e construir o projeto:
$ git clone https://github.com/mongodb/mongo-php-driver.git $ cd mongo-php-driver $ git submodule update --init $ phpize $ ./configure $ make all $ sudo make install
Em sistemas com múltiplas versões de PHP instaladas (por exemplo, macOS padrão, Homebrew, » XAMPP), cada versão do PHP terá seu próprio comando phpize e arquivo php.ini. Além disso, cada ambiente PHP (por exemplo, CLI, web) pode usar um arquivo php.ini separado.
Por padrão, a extensão usará versões agrupadas de
» libbson,
» libmongoc e
» libmongocrypt e
tentar configurá-los automaticamente. Se essas bibliotecas já estiverem
instaladas como bibliotecas de sistema, a extensão poderá utilizá-las
especificando --with-mongodb-system-libs=yes
como uma opção para
configure
.
Para obter uma lista completa de opções de configure
, execute
configure --help.
Ao usar versões empacotadas de libmongoc e libmongocrypt, a extensão
também tentará selecionar uma biblioteca SSL de acordo com a
opção --with-mongodb-ssl
configure
.
A partir da versão de extensão 1.17.0, o OpenSSL é sempre preferido por padrão.
Anteriormente, o Secure Transport era o padrão no macOS e o OpenSSL era o
padrão em todas as outras plataformas.
Nota:
Se o processo de construção não conseguir encontrar uma biblioteca SSL, verifique se os pacotes de desenvolvimento (por exemplo,
libssl-dev
) e » pkg-config estão ambos instalados.Ao usar o Homebrew no macOS, é comum que um sistema tenha várias versões do OpenSSL instaladas. Para garantir que a versão desejada do OpenSSL seja selecionada, a variável de ambiente
PKG_CONFIG_PATH
pode ser usada para controlar o caminho de pesquisa parapkg-config
.
A etapa final de compilação, make install, reportará onde mongodb.so foi instalado, semelhante a:
Installing shared extensions: /usr/lib/php/extensions/debug-non-zts-20220829/
Certifique-se de que a opção extension_dir no php.ini aponta para o diretório onde mongodb.so foi instalado. A opção pode ser consultada executando:
$ php -i | grep extension_dir extension_dir => /usr/lib/php/extensions/debug-non-zts-20220829 => /usr/lib/php/extensions/debug-non-zts-20220829
Se os diretórios forem diferentes, altere extension_dir no php.ini ou mova manualmente mongodb.so para o diretório correto.
Finalmente, adicione a seguinte linha ao arquivo php.ini para cada ambiente que precisará usar a extensão:
extension=mongodb.so