andsalves/doctrine-elastic

Elasticsearch Doctrine Adaptation

Saturday, February 3, 2018
by andsalves
Repository
6 Watchers
13 Stars
3,193 Installations

PHP
0 Dependents
0 Suggesters
7 Forks
2 Open issues
46 Versions
11 % Grown

The README.md

Doctrine-Elastic

Custom Doctrine Library for Elasticsearch., _(*1)

, _(*2)

Last stable release: v1.3.1 (Elasticsearch 2.x or 5.x support), _(*3)

Tests on Elasticsearch 2.4.1/5.1/5.5 - PHP 5.6/7.0, _(*4)

This library is not actively maintained anymore, _(*5)

Get Started

Creating a working ElasticEntityManager

Please see https://github.com/andsalves/doctrine-elastic/blob/master/docs/creating-an-elastic-entity-manager-instance.md, _(*6)

Creating a working DoctrineElastic Entity

Just like Doctrine, we need to set some annotations in our entities, here's an example:, _(*7)

<?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
     * 
     * Below: Use 'string' for elasticsearch 2.x and 'keyword' for elasticsearch 5.x+
     * @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 definitions. The property annotation @ElasticORM\Field represents a _source field of a document inside the 'foo_type' type. The @ElasticORM\MetaField annotation represents a metafield, like _id. @ElasticORM\MetaField _id is required for an entity, and must be a public property., _(*8)

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

Inserting Documents

With this library, making CRUD operations through ElasticEntityManager is really simple. Assuming you have an ElasticEntityManager instance in a variable called $elasticEntityManager:, _(*10)

$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!

Note 1:

Index and type will be created automatically, as well as their mappings, if don't exist yet., _(*11)

Note 2:

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

Note 3:

DoctrineElastic does not accept TRANSACTIONS (yet). You will find an available 'beginTransaction' method in ElasticEntityManager, but it does nothing. It is there because ElasticEntityManager implements EntityManagerInterface from Doctrine. That happens with some few other methods., _(*13)

Note 4:

Just like in Doctrine, after flushing, 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 it doesn't exist, it's created with the provided _id., _(*14)

Finding Documents

If you know Doctrine, this is very easy and intuitive:, _(*15)

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

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

Note 1:

You can use findBy and findAll methods too., _(*16)

Note 2:

It doesn't matter if index and type exist or not in your Elasticsearch. If not exist, no documents are returned, also no exception is thrown., _(*17)

Note 3:

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

Removing Documents

$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';
}

Using Query Builder

Please see the tests for this feature as a good example: https://github.com/andsalves/doctrine-elastic/blob/master/tests/DoctrineElastic/Tests/ElasticEntityManagerTest.php, _(*19)

Parent-Child Relationship

Please see the tests for this feature as a good example: https://github.com/andsalves/doctrine-elastic/blob/master/tests/DoctrineElastic/Tests/ParentChildTest.php, _(*20)

Application-side Relationships with DoctrineElastic

You can simulate relational databases relationships, with loss of performance, obviously. DoctrineElastic has this feature as an internal feature development, but it is not recommended to be used - if you need complex relationships, you should use a relational database. If you'd really like to use relationships like that with this library, contact me for help., _(*21)

# #, _(*22)

For questions, please contact me at ands.alves.nunes@gmail.com.

Please feel free to open issues or make pull requests.

# # # #, _(*23)

The Versions

03/02 2018

dev-master

9999999-dev https://packagist.org/packages/andsalves/doctrine-elastic

Elasticsearch Doctrine Adaptation

library doctrine-elastic

Elasticsearch Doctrine Adaptation

andsalves/doctrine-elastic

The README.md

Doctrine-Elastic

Get Started

Creating a working ElasticEntityManager

Creating a working DoctrineElastic Entity

Inserting Documents

Note 1:

Note 2:

Note 3:

Note 4:

Finding Documents

Note 1:

Note 2:

Note 3:

Removing Documents

Using Query Builder

Parent-Child Relationship

Application-side Relationships with DoctrineElastic

For questions, please contact me at ands.alves.nunes@gmail.com.

Please feel free to open issues or make pull requests.

The Versions

dev-master

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.3.4

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.3.3

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.3.2

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.3.1

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.3.0

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.2.6

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.2.5

The Requires

The Development Requires

by Anderson Alves Nunes de Freitas

v1.2.3

The Requires

by Anderson Alves Nunes de Freitas

v1.2.2

The Requires

by Anderson Alves Nunes de Freitas

dev-iuribrindeiro-patch-6

The Requires

by Anderson Alves Nunes de Freitas

dev-ref/verifing-query-key

The Requires

by Anderson Alves Nunes de Freitas

dev-iuribrindeiro-patch-5

The Requires

by Anderson Alves Nunes de Freitas

v1.2.1beta

The Requires

by Anderson Alves Nunes de Freitas

1.2-beta3

The Requires

by Anderson Alves Nunes de Freitas

v0.7.x-dev

The Requires

by Anderson Alves Nunes de Freitas