A PHP client for elasticsearch.

Fork me on GitHub

Release 2.1.0

Elastica 2.1.0 (download). This release is compatible with elasticsearch 1.5.2.

Backward Compatibility Breaks

  • Elastica\ScanAndScroll::$_lastScrollId removed: key() now always returns the next scroll id #842


  • Facets are deprecated. You are encouraged to migrate to aggregations instead. #855
  • Elastica\Query\Builder is deprecated. Use new Elastica\QueryBuilder instead. #855
  • For PHP 7 compatibility Elastica\Query\Bool was renamed to *\BoolQuery, Elastica\Filter\Bool was renamed to BoolFilter, Elastica\Transport\Null was renamed to NullTransport as Null and Bool are reserved phrases in PHP 7. Proxy objects for all three exist to keep backward compatibility. It is recommended to start using the new objects as the proxy classes will be deprecated as soon as PHP 7 is stable. #837


  • Multiple rescore query #820
  • Support for a custom connection timeout through a connectTimeout parameter. #841
  • SignificantTerms Aggregation #847
  • Support for ‘precision_threshold’ and ‘rehash’ options for the Cardinality Aggregation [#851]
  • Support for retrieving id node #852
  • Scroll Iterator #842
  • Gitter Elastica Chat Room add for Elastica discussions: https://gitter.im/ruflin/Elastica
  • Introduce PHP7 compatibility and tests. #837
  • Tool\CrossIndex for reindexing and copying data and mapping between indices #853
  • CONTIRUBTING.md file added for contributor guidelines. #854


  • Introduction of Changelog standard based on http://keepachangelog.com/. changes.txt moved to CHANGELOG.md #844
  • Make host for all tests dynamic to prepare it for a more dynamic test environment #846
  • Node information is retrieved based on id instead of name as multiple nodes can have the same name. #852
  • Guzzle Http dependency updated to 5.3.*
  • Remove NO_DEV builds from travis build matrix to speed up building. All builds include no dev packages.
  • Introduction of benchmark test group to make it easy to run benchmark tests.
  • Make the docker images directly available on the docker registry. This speeds up fetching of the images and automates the build of the images.


Project Version Required
Elasticsearch 1.5.2 yes
Elasticsearch mapper attachments plugin 2.5.0 no
Elasticsearch thrift transport plugin 2.5.0 no
Elasticsearch memcached transport plugin 2.5.0 no
Elasticsearch geocluster facet plugin 0.0.12 no
Elasticsearch image plugin 1.4.0 no