Olá galera, a partir de hoje vou fazer uma série de artigos sobre elasticsearch com PHP. Conforme vamos implementando, vou adicionando novos.

A empresa em que trabalho desenvolve sistemas para gestão de saúde (secretarias, assistência social, hospitais entre outros).Recentemente certificamos nosso sistema para secretarias no SBIS (Sociedade Brasileira de Informática em Saúde).

Um dos itens que tivemos que cumprir era poder pesquisar por uma palavra ou nome no sistema e o mesmo ter que retornar todas as ocorrências para o mesmo, por exemplo, se pesquisar por dengue, tem que trazer todos os pacientes com dengue.

Inicialmente, tentamos fazer a busca diretamente como banco relacional (postgres), com poucos dados no banco ficou rápido, porém como temos clientes que tem banco com muitos gigas de dados, ficou extremamente lento.

Foi ai que conhecemos o elasticsearch e depois de algumas pesquisas e leituras, decidimos usá-lo para satisfazer o gargalo do banco de dados relacional.

Dados técnicos da infra:

• PHP ^5.5
• Nginx ou apache
• Postgres 9.4
• Zend Framework 1.12
• Doctrine ORM 2.5

Estou usando a imagem para docker nos testes e para escrever o artigo.

Link: https://hub.docker.com/_/elasticsearch/

Instalando o cliente do elasticsearch

Vou partir do ponto que já temos um sistema em produção, portanto configurações de PHP, framework e afins não serão abordadas.

Instalando o cliente para PHP:

Nesta primeira etapa, vou adicionar a dependência do elasticserach ao composer.json. Dentro da sessão require, após suas dependências, adicione a seguinte string.


Em seguida abra o terminal, navegue até o diretório onde está seu projeto e digite:

# php composer.phar update

Este comando vai fazer o composer atualizar as dependências do projeto e baixar o cliente do elasticsearch.

Obtendo a instância do cliente

Após baixadas as dependências, vou criar uma classe dentro da estrutura do projeto com o objetivo de me devolver a instância do cliente. Vou fazer isso afim de prover um único lugar que instancie o mesmo.

Caso contrário, cada desenvolvedor vai criar a instância como bem entender e vai acabar virando uma bagunça.

Para isso usarei o pattern singleton, a fim de manter a mesma instância para todas as operações.

<?php

namespace CoreElasticsearchClient;

use ElasticsearchClient as ClientElasticsearch;
use ElasticsearchClientBuilder;

class Client
{

    /**
     * Método construtor da classe.
     */
    private function __construct()
    {
        
    }

    /**
     * Método clone do tipo privado previne a clonagem dessa instância da classe
     *
     * @return void
     */
    private function __clone()
    {
        
    }

    /**
     * Método unserialize do tipo privado para prevenir a desserialização da instância dessa classe.
     *
     * @return void
     */
    private function __wakeup()
    {
        
    }

    /**
     * Método responsável por criar a instância.
     * 
     * @return ClientElasticsearch
     */
    public static function getInstance()
    {
        static $instance = null;

        if (null === $instance) {
            // Aqui busco no arquivo de configurações os server que estão rodando elastic.
            // Vou deixar fixo para os testes.
            $hosts = ['172.17.0.1:9200'];

            $clientBuilder = ClientBuilder::create();
            $clientBuilder->setHosts($hosts);
            $instance = $clientBuilder->build();
        }

        return $instance;
    }

}

No próximo artigo, vou abordar o uso de índices e tipos.