A PHP client for elasticsearch.

Fork me on GitHub

Release 3.0.0

Elastica 3.0.0 (download). This release is compatible with elasticsearch 2.0.0.

Elastica 3.0.0 is a major release. It is compatible with elasticsearch 2.0 which means also bringing lots of compatibility break. Switch to Elastica 3.0.0-beta1 does not only mean you have to adapt your code but also migrate to elasticsearch 2.0. For the migration to elasticsearch 2.0 check the following two blog posts:

We tried to make the migration as easy as possible by adding deprecated messages and exceptions for the stuff that was or will be removed. Make sure to test your application with the newest version. For more details also see the 3.0.0-beta1 release.

Backward Compatibility Breaks

  • Revert getError changes in Response object and make it better BC compatible. See comment here.


  • Function score query: corrected the score_method average to avg #975
  • Set json_decode() assoc parameter to true in Elastica\Response #1005
  • Add bigintConversion to keys passed to connection config in Elastica\Client #1005
  • Use POST instead of PUT to send bulk requests #1010


  • Elastica\Query\MultiMatch::setFuzziness now supports being set to AUTO with the const MultiMatch::FUZZINESS_AUTO
  • Elastica\Type\Mapping::send now accepts query string parameters to send along with the mapping request
  • Elastica\Query\BoolQuery::addFilter


  • More info on Elastica\Exception\PartialShardFailureException. Not just number of failed shards.
  • Allow bool in TopHits::setSource function #1012


  • Elastica\Query\Filtered triggers E_USER_DEPRECATED error because filtered query is deprecated since ES 2.0.0-beta1. Use BoolQuery instead.
  • Elastica\QueryBuilder\DSL\Query::filtered() triggers E_USER_DEPRECATED error because filtered query is deprecated since ES 2.0.0-beta1. Use bool() instead.


Project Version Required
Elasticsearch 2.0.0 yes
Elasticsearch mapper attachments plugin 3.0.2 no
Elasticsearch image plugin 1.7.1 no