Doctrine Adaptation Library for Elasticsearch.

We can find about how to create an ElasticEntityManager in docs at https://github.com/andsalves/doctrine-elastic/blob/master/docs/creating-an-elastic-entity-manager-instance.md

Just like Doctrine, we need to set some annotations in our entities, here is a example:

<?php
namespace DoctrineElastic\Entity;
use Doctrine\ORM\Mapping as ORM;
use DoctrineElastic\Mapping as ElasticORM;
/**
 * @author Ands
 *
 * @ElasticORM\Type(name="foo_type", index="foo_index")
 * @ORM\Entity
 */
class FooType {
    /**
     * @var string
     *
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="IDENTITY")
     * @ElasticORM\MetaField(name="_id")
     * @ORM\Column(name="_id", type="integer")
     */
    public $_id;
    /**
     * @var int
     *
     * @ElasticORM\Field(name="custom_numeric_field", type="integer")
     */
    private $customNumericField;
    /**
     * @var string
     *
     * @ElasticORM\Field(name="custom_field", type="string")
     */
    private $customField;
    /**
     * @var array
     *
     * @ElasticORM\Field(name="custom_nested_field", type="nested")
     */
    private $customNestedField = [];
    /**
     * @return int
     */
    public function getCustomNumericField() {
        return $this->customNumericField;
    }
    /**
     * @param int $customNumericField
     * @return FooType
     */
    public function setCustomNumericField($customNumericField) {
        $this->customNumericField = $customNumericField;
        return $this;
    }
    /**
     * @return string
     */
    public function getCustomField() {
        return $this->customField;
    }
    /**
     * @param string $customField
     * @return FooType
     */
    public function setCustomField($customField) {
        $this->customField = $customField;
        return $this;
    }
    /**
     * @return array
     */
    public function getCustomNestedField() {
        return $this->customNestedField;
    }
    /**
     * @param array $customNestedField
     * @return FooType
     */
    public function setCustomNestedField($customNestedField) {
        $this->customNestedField = $customNestedField;
        return $this;
    }
}

This entity represents, in Elasticsearch, a type named 'foo_type', that belongs to an index named 'foo_index'. Note the class annotation @ElasticORM\Type with these informations. The property annotation @ElasticORM\Field represents a field from _source of a document into 'foo_type' type. @ElasticORM\MetaField annotation represents a metafield, like _id. @ElasticORM\MetaField _id is required for an entity, and must to be a public property.

Only properties with @ElasticORM\Field annotation will be considered as document fields. In elasticsearch, the document column name will be the 'name' property from @ElasticORM\Field annotation from class property, just like 'type' annotation property.

A more detailed explanation about fields customization and types (just like nested and date types, 'format' annotation property etc), will be available soon.

Now is very simple make CRUD operations through ElasticEntityManager. Assuming you have a ElasticEntityManager instance in variable $elasticEntityManager:

$newFoo = new DoctrineElastic\Entity\FooType(); // Or wherever be your entity
$newFoo->setCustomNumericField(1234);
$newFoo->setCustomField('Test Value');
$newFoo->setCustomNestedField(['some_value' => 'Some Value', 'whatever' => 'Whatever']);

$elasticEntityManager->persist($newFoo); // Persisting entity...
$elasticEntityManager->flush(); // And flushing... Oh God, just like Doctrine!

Index and type will be created automatically, as well as its mappings.

By default, mappings for index analyzable fields will be not_analyzed. DoctrineElastic was made for work this way. However, you can modify this with 'index' @ElasticORM\Field annotation property if you prefer default analized fields. e.g. @ElasticORM\Field(name='mad_field', type='string', index='analyzed'). Attention: Get documents with DoctrineElastic is not guaranteed when you make this, once it's not possible to match exact values always.

DoctrineElastic does not accept TRANSACTIONS (yet). You will find an available 'beginTransaction' method, but it doesn't anything. It is there because ElasticEntityManager implements EntityManagerInterface from Doctrine. This happens with some few other methods.

Just like in Doctrine, after flush, the entity will have the _id field filled. If you persist an entity with _id field non null, DoctrineElastic will search a doc for update, if doesn't exist, creates this one with passed _id.

If you really know Doctrine, this is very easy.

$myFoo = $elasticEntityManager->getRepository(DoctrineElastic\Entity\FooType::class)->findOneBy(['customNumericField' => 1234]);

if (!is_null($myFoo)) {
    print 'Yes, I found it!';
} else {
    print 'Nothing here';
}

You can use findBy and findAll methods too.

It doesn't matter if index and type exists or not in your Elasticsearch. If it not exists, no documents are returned, also no exception is thrown.

To search by _id, use $elasticEntityManager::getReference or $elasticEntityManager::find (they are equivalent in ElasticEntityManager).

$myFoo = $elasticEntityManager->getRepository(DoctrineElastic\Entity\FooType::class)->findOneBy(['customNumericField' => 1234]);


if (!is_null($myFoo)) {
    // Let's delete this one
    $elasticEntityManager->remove($myFoo);
    $elasticEntityManager->flush(); // Deleted :)
} else {
    print 'Nothing to remove';
}

Coming soon... For emergency, please see the tests for this feature, it's a good example: https://github.com/andsalves/doctrine-elastic/blob/master/tests/DoctrineElastic/Tests/ElasticEntityManagerTest.php

Coming soon... For emergency, please see the tests for this feature, it's a good example: https://github.com/andsalves/doctrine-elastic/blob/master/tests/DoctrineElastic/Tests/ParentChildTest.php

You can simulate relational databases relationships, with loss of performance, obsiously. DoctrineElastic has this feature, but it is not recommended to use. A documentation about this is coming soon... For emergency, please contact me.

Coming soon...