Menu Docs

Comece com a Biblioteca PHP

A Biblioteca PHP do MongoDB é uma abstração de alto nível para a extensão MongoDB PHP, que você pode usar para se conectar ao MongoDB e interagir com dados armazenados em sua implantação. Este guia mostra como criar um aplicação que usa a biblioteca PHP do MongoDB para se conectar a um cluster MongoDB hospedado no MongoDB Atlas e consultar dados em seu cluster.

Dica

O MongoDB Atlas é um serviço de banco de dados em nuvem totalmente gerenciado que hospeda seu Implantações do MongoDB. Você pode criar sua própria implantação do MongoDB Atlas gratuita (nenhum cartão de crédito exigido) seguindo as etapas deste guia.

Siga este guia para conectar um aplicação PHP de amostra a uma implantação do MongoDB Atlas . Se você preferir se conectar ao MongoDB usando um driver ou uma linguagem de programação diferente, consulte nossa lista de drivers oficiais.

1

Antes de começar a desenvolver, verifique se você tem as seguintes dependências instaladas em sua máquina local:

2

Execute o seguinte comando para instalar a extensão PHP do mongodb :

sudo pecl install mongodb
3

Para habilitar a extensão mongodb em seu arquivo de configuração PHP, adicione a seguinte linha ao topo do seu arquivo php.ini :

extension=mongodb.so

Dica

Você pode localizar seu arquivo php.ini executando o seguinte comando em sua shell:

php --ini
4

A partir do seu diretório raiz, execute o seguinte comando na sua shell para criar um diretório chamado php-quickstart para este projeto:

mkdir php-quickstart

Selecione a aba correspondente ao seu sistema operacional e execute os seguintes comandos para criar um arquivo de aplicação quickstart.php no diretório php-quickstart :

cd php-quickstart
touch quickstart.php
cd php-quickstart
type nul > quickstart.php
5

Para instalar a biblioteca PHP do MongoDB , execute o seguinte comando em seu diretório php-quickstart :

composer require mongodb/mongodb

Depois de instalar a biblioteca, inclua o arquivo autoload.php do Composer adicionando o seguinte código ao topo do seu arquivo quickstart.php :

<?php
require_once __DIR__ . '/vendor/autoload.php';

Depois de concluir estas etapas, você tem um novo diretório de projeto , um novo arquivo de aplicação e as dependências da biblioteca instaladas.

Você pode criar uma implantação MongoDB de camada gratuita no MongoDB Atlas para armazenar e gerenciar seus dados. O MongoDB Atlas hospeda e gerencia seu banco de dados MongoDB na nuvem.

1

Complete o guia Iniciar com Atlas para configurar uma nova conta Atlas e carregar dados de amostra em uma nova implantação MongoDB de camada gratuita.

2

Depois de criar o usuário do banco de dados, salve o nome de usuário e a senha desse usuário em um local seguro para uso em uma próxima etapa.

Após concluir estas etapas, você terá uma nova implantação de camada grátis do MongoDB no Atlas, credenciais de trigger de banco de dados e dados de exemplo carregados no seu reconhecimento de data center.

Você pode se conectar à sua implantação do MongoDB fornecendo um URI de conexão, também chamado de connection string, que instrui o driver sobre como se conectar a uma implantação do MongoDB e como se comportar enquanto estiver conectado.

A cadeia de conexão inclui o nome do host ou endereço IP e porta de sua implantação, o mecanismo de autenticação, as credenciais do usuário quando aplicável, e opções de conexão.

1

Para recuperar a string de conexão da implantação criada na etapa anterior, faça login na sua conta do Atlas e navegue até a seção Database e clique no botão Connect para a nova implantação.

O botão de conexão na seção de clusters da UI do Atlas

Em seguida, selecione seu usuário no menu de seleção Select database user . Selecione "PHP" no menu de seleção Driver e a versão que melhor corresponde à versão instalada no menu de seleção Version .

Selecione a aba String na etapa Add connection string into your application code para visualizar somente a string de conexão.

2

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

O botão copiar ao lado da string de conexão na UI do Atlas
3

Cole esta connection string em um arquivo no editor de texto de sua preferência e substitua os placeholders <username> e <password> pelo seu nome de usuário e senha de utilizador de banco de dados.

Salve este arquivo em um local seguro para uso na próxima etapa.

Após concluir estas etapas, você tem uma string de conexão que corresponde ao seu agrupamento do Atlas .

Depois de recuperar a string de conexão para sua implantação do MongoDB Atlas , você pode se conectar à implantação do seu aplicação PHP e consultar os conjuntos de dados de amostra do Atlas .

1

Copie e cole o seguinte código no arquivo quickstart.php , que consulta a coleção movies no banco de banco de dados sample_mflix :

<?php
require __DIR__ . '/../vendor/autoload.php';
use MongoDB\Client;
$uri = getenv('MONGODB_URI') ?: throw new RuntimeException(
'Set the MONGODB_URI environment variable to your Atlas URI'
);
$client = new MongoDB\Client($uri);
$collection = $client->sample_mflix->movies;
$filter = ['title' => 'The Shawshank Redemption'];
$result = $collection->findOne($filter);
if ($result) {
echo json_encode($result, JSON_PRETTY_PRINT);
} else {
echo 'Document not found';
}
2

Atribua a variável de ambiente MONGODB_URI à string de conexão que você copiou da etapa Criar uma string de conexão deste guia. Você pode atribuir essa variável executando um comando shell ou criando um arquivo .env em seu aplicação, conforme mostrado nas abas a seguir:

export MONGODB_URI=<connection string>
MONGODB_URI=<connection string>
3

No diretório do projeto , execute o seguinte comando shell para iniciar o aplicação:

php quickstart.php

A saída da linha de comando contém detalhes sobre o documento de filme recuperado:

{
"_id": {
"$oid": "..."
},
...
"rated": "R",
"metacritic": 80,
"title": "The Shawshank Redemption",
...
}

Se você encontrar um erro ou não vir nenhuma saída, certifique-se de atribuir a string de conexão adequada à variável de ambiente MONGODB_URI e de que carregou os dados de amostra.

Depois de concluir essas etapas, você tem um aplicação PHP que se conecta à implementação do MongoDB , executa uma query nos dados de amostra e retorna um documento correspondente.

Parabéns por concluir o tutorial de início rápido!

Observação

Se você tiver problemas neste tutorial, peça ajuda nos fóruns da MongoDB Community ou envie feedback usando a guia Rate this page no lado direito ou inferior direito desta página.

Neste tutorial, você criou um aplicação PHP que se conecta a um MongoDB hospedado no MongoDB Atlas e recupera um documento que corresponde a uma query.

Saiba mais sobre a biblioteca PHP do MongoDB nos seguintes recursos: