cakephp/elastic-search

An Elastic Search datasource and data mapper for CakePHP 3.0

Friday, June 29, 2018
by cakephp
Repository
33 Watchers
63 Stars
52,915 Installations

PHP
3 Dependents
1 Suggesters
44 Forks
17 Open issues
29 Versions
10 % Grown

The README.md

Elasticsearch Datasource for CakePHP

, _(*1)

Use Elastic Search as an alternative ORM backend in CakePHP 5.0+., _(*2)

You can find the documentation for the plugin in the Cake Book., _(*3)

Installing Elasticsearch via composer

You can install Elasticsearch into your project using composer. For existing applications you can add the following to your composer.json file:, _(*4)

"require": {
    "cakephp/elastic-search": "^4.0"
}

And run php composer.phar update, _(*5)

Versions Table

Cake\ElasticSearch	CakePHP	ElasticSearch
1.x	3.0 - 3.5	2.x - 5.x
2.x	3.6+	6.x
>3, <3.4.0	4.0+	6.x
>=3.4.0	4.0+	7.x
4.x	5.0+	7.x

You are seeing the 3.x version., _(*6)

Connecting the Plugin to your Application

After installing, you should tell your application to load the plugin:, _(*7)

use Cake\ElasticSearch\Plugin as ElasticSearchPlugin;

class Application extends BaseApplication
{
    public function bootstrap()
    {
        $this->addPlugin(ElasticSearchPlugin::class);

        // If you want to disable to automatically configure the Elastic model provider
        // and FormHelper do the following:
        // $this->addPlugin(ElasticSearchPlugin::class, [ 'bootstrap' => false ]);
    }
}

Defining a connection

Before you can do any work with Elasticsearch models, you'll need to define a connection:, _(*8)

// in config/app.php
    'Datasources' => [
        // other datasources
        'elastic' => [
            'className' => 'Cake\ElasticSearch\Datasource\Connection',
            'driver' => 'Cake\ElasticSearch\Datasource\Connection',
            'host' => '127.0.0.1',
            'port' => 9200
        ],
    ]

As an alternative you could use a link format if you like to use enviroment variables for example., _(*9)

// in config/app.php
    'Datasources' => [
        // other datasources
        'elastic' => [
            'url' => env('ELASTIC_URL', null)
        ]
    ]

    // and make sure the folowing env variable is available:
    // ELASTIC_URL="Cake\ElasticSearch\Datasource\Connection://127.0.0.1:9200?driver=Cake\ElasticSearch\Datasource\Connection"

You can enable request logging by setting the log config option to true. By default the debug Log profile will be used. You can also define an elasticsearch log profile in Cake\Log\Log to customize where Elasticsearch query logs will go. Query logging is done at a 'debug' level., _(*10)

Getting a Index object

Index objects are the equivalent of ORM\Table instances in elastic search. You can use the IndexRegistry factory to get instances, much like TableRegistry:, _(*11)

use Cake\ElasticSearch\IndexRegistry;

$comments = IndexRegistry::get('Comments');

If you have loaded the plugin with bootstrap enabled you could load indexes using the model factory in your controllers, _(*12)

class SomeController extends AppController
{
    public function initialize()
    {
        $this->loadModel('Comments', 'Elastic');
    }

    public function index()
    {
        $comments = $this->Comments->find();
    }

    ...

Each Index object needs a correspondent Elasticsearch index, just like most of ORM\Table needs a database table., _(*13)

In the above example, if you have defined a class as CommentsIndex and the IndexRegistry can find it, the $comments will receive a initialized object with inner configurations of connection and index. But if you don't have that class, a default one will be initialized and the index name on Elasticsearch mapped to the class., _(*14)

The Index class

You must create your own Index class to define the name of internal index for Elasticsearch, as well as to define the mapping type and define any entity properties you need like virtual properties. As you have to use only one mapping type for each index, you can use the same name for both (the default behavior when type is undefined is use singular version of index name). Index types were removed in ElasticSearch 7., _(*15)

use Cake\ElasticSearch\Index;

class CommentsIndex extends Index
{
    /**
     * The name of index in Elasticsearch
     *
     * @return  string
     */
    public function getName()
    {
        return 'comments';
    }
}

Running tests

We recommend using the included docker-compose.yml for doing local development. The Dockerfile contains the development environment, and an Elasticsearch container will be downloaded and started on port 9200., _(*16)

# Start elasticsearch
docker-compose up -d

# Open an terminal in the development environment
docker-compose run console bash

Once inside the container you can install dependencies and run tests., _(*17)

./composer.phar install
vendor/bin/phpunit

Warning: Please, be very carefully when running tests as the Fixture will create and drop Elasticsearch indexes for its internal structure. Don't run tests in production or development machines where you have important data into your Elasticsearch instance., _(*18)

Assuming you have PHPUnit installed system wide using one of the methods stated here, you can run the tests for CakePHP by doing the following:, _(*19)

Copy phpunit.xml.dist to phpunit.xml
Run phpunit

The Versions

29/06 2018

dev-master

9999999-dev https://github.com/cakephp/elastic-search

An Elastic Search datasource and data mapper for CakePHP 3.0

cakephp-plugin elastic-search

An Elastic Search datasource and data mapper for CakePHP 3.0

cakephp/elastic-search

The README.md

Elasticsearch Datasource for CakePHP

Installing Elasticsearch via composer

Versions Table

Connecting the Plugin to your Application

Defining a connection

Getting a Index object

The Index class

Running tests

The Versions

dev-master

The Requires

The Development Requires

by CakePHP Community

2.0.0-RC2

The Requires

The Development Requires

by CakePHP Community

1.0.x-dev

The Requires

The Development Requires

by CakePHP Community

1.5.2

The Requires

The Development Requires

by CakePHP Community

1.5.1

The Requires

The Development Requires

by CakePHP Community

1.5.0

The Requires

The Development Requires

by CakePHP Community

2.0.0-RC1

The Requires

The Development Requires

by CakePHP Community

2.0.0-beta

The Requires

The Development Requires

by CakePHP Community

dev-sync-1

The Requires

The Development Requires

by CakePHP Community

dev-bump-year

The Requires

The Development Requires

by CakePHP Community

1.0.0

The Requires

The Development Requires

by CakePHP Community

0.5.x-dev

The Requires

The Development Requires

by CakePHP Community

0.5.0

The Requires

The Development Requires

by CakePHP Community

dev-event-listener

The Requires

The Development Requires

by CakePHP Community

dev-codesniffer-update

The Requires

The Development Requires

by CakePHP Community

dev-feature-save-many

The Requires

The Development Requires

by CakePHP Community

dev-use-interface

The Requires

The Development Requires