O Firestore é um banco de dados de documentos NoSQL criado para fornecer escalonamento automático, alto desempenho e facilidade no desenvolvimento de aplicativos. O Firestore é a mais nova versão do Datastore e apresenta várias melhorias em relação a ele.
Como o Firestore no modo Datastore é otimizado para casos de uso do servidor e para o App Engine, recomendamos o uso do Firestore no modo Datastore para bancos de dados que serão usados principalmente por aplicativos do App Engine. O Firestore no modo nativo é mais útil para casos de uso de notificações móveis e em tempo real. Para mais informações sobre os modos do Firestore, consulte Como escolher entre o modo nativo e o modo Datastore.
Neste documento, descrevemos como usar a biblioteca de cliente do Google Cloud para armazenar e recuperar dados em um banco de dados no modo Datastore.
Pré-requisitos e configuração
Siga as instruções em "Hello, World!" para PHP no App Engine para configurar o ambiente e o projeto, além de compreender como aplicativos PHP são estruturados no App Engine. Anote e salve o ID do projeto. Você precisará dele para executar o aplicativo de amostra descrito neste documento.
Clonar o repositório
Faça o download ou clone da amostra:
git clone https://github.com/GoogleCloudPlatform/php-docs-samples
cd php-docs-samples/appengine/flexible/datastore
Editar a configuração do projeto e definir as dependências
Instale as dependências usando o Composer:
composer install
Código do aplicativo
O aplicativo de amostra registra, recupera e exibe IPs de visitantes.
Primeiro, o aplicativo instancia um cliente no modo Datastore:
Cada visita é uma entidade com campos para o endereço IP do visitante e um carimbo de data/hora. Ela é salva no Cloud Datastore usando o comando insert:
As dez visitas mais recentes são recuperadas em ordem decrescente usando o comando query:
Como usar arquivos index.yaml
O app de exemplo faz consultas simples. Consultas mais elaboradas do modo Datastore exigem um ou mais índices, que você precisa especificar em um arquivo index.yaml
enviado com o aplicativo. Esse arquivo pode ser criado ou gerado automaticamente ao testar seu aplicativo localmente.
Teste local
Se precisar desenvolver e testar seu aplicativo localmente, é possível usar o emulador de modo Datastore.
Para saber mais
Para informações completas sobre o modo Datastore, incluindo otimizações e conceitos, veja a documentação do Cloud Firestore no modo Datastore.