ruflin/Elastica 8.0.0-alpha1

on GitHub

This is the first 8.0.0 alpha release for Elastica. It is compatible with Elasticsearch 8.0 and contains several breaking changes. We want to get this out in the wild to get as much feedback on it as we can. Any new issues found? Any migration issues? The work of getting us to GA is tracked here: #2185

Big thanks to the community for getting us to this release!

Changelog

Backward Compatibility Breaks

• Dropped support for PHP <8.0 #2131
• Removed deprecated classes in 7.x #2132
  • Elastica\Exception\ElasticsearchException -> use Elastica\Exception\ResponseException::getResponse()::getFullError() instead
  • Elastica\Exception\ResponseException::getElasticsearchException() -> use Elastica\Exception\ResponseException::getResponse()::getFullError() instead
  • Elastica\Processor\Append -> use Elastica\Processor\AppendProcessor instead
  • Elastica\Processor\Attachment -> use Elastica\Processor\AttachmentProcessor instead
  • Elastica\Processor\Convert -> use Elastica\Processor\ConvertProcessor instead
  • Elastica\Processor\Date -> use Elastica\Processor\DateProcessor instead
  • Elastica\Processor\DateIndexName -> use Elastica\Processor\DateIndexNameProcessor instead
  • Elastica\Processor\DotExpander -> use Elastica\Processor\DotExpanderProcessor instead
  • Elastica\Processor\Fail -> use Elastica\Processor\FailProcessor instead
  • Elastica\Processor\Join -> use Elastica\Processor\JoinProcessor instead
  • Elastica\Processor\Json -> use Elastica\Processor\JsonProcessor instead
  • Elastica\Processor\Kv -> use Elastica\Processor\KvProcessor instead
  • Elastica\Processor\Lowercase -> use Elastica\Processor\LowercaseProcessor instead
  • Elastica\Processor\Remove -> use Elastica\Processor\RemoveProcessor instead
  • Elastica\Processor\Rename -> use Elastica\Processor\RenameProcessor instead
  • Elastica\Processor\Set -> use Elastica\Processor\SetProcessor instead
  • Elastica\Processor\Sort -> use Elastica\Processor\SortProcessor instead
  • Elastica\Processor\Split -> use Elastica\Processor\SplitProcessor instead
  • Elastica\Processor\Trim -> use Elastica\Processor\AppendProcessor instead
  • Elastica\Processor\Uppercase -> use Elastica\Processor\UppercaseProcessor instead
  • Elastica\Query\Common -> use Elastica\Query\MatchQuery instead
  • Elastica\QueryBuilder\DSL\Query::common_terms() -> use Elastica\QueryBuilder\DSL\Query::match() instead
  • Elastica\Transport\HttpAdapter -> use Elastica\Transport\Http instead
• Removed deprecated methods #2135
  • Elastica\Aggregation\Range::setKeyedResponse() -> use Elastica\Aggregation\Range::setKeyed() instead
  • Elastica\Bulk::toString() -> use Elastica\Bulk::__toString() or cast to string instead
  • Elastica\Query\MatchQuery::setFieldCutoffFrequency()
  • Elastica\Query\MultiMatch::setCutoffFrequency()
  • Elastica\QueryBuilder\DSL\Aggregation::global_agg() -> use Elastica\QueryBuilder\DSL\Aggregation::global() instead
  • Elastica\Request::toString() -> use Elastica\Request::__toString() or cast to string instead
  • Elastica\Result::getType()
  • Elastica\Suggest\Phrase::addCandidateGenerator() -> use Elastica\Suggest\Phrase::addDirectGenerator() instead
  • Elastica\Util::getParamName()
• Changed following aggregation constructors #2138
  • Elastica\Aggregation\AvgBucket: The second argument $bucketsPath is now mandatory
  • Elastica\Aggregation\BucketScript: The second (array $bucketsPath) and the third (string $script) argument are now mandatory
  • Elastica\Aggregation\BucketSelector: The second (array $bucketsPath) and the third (string $script) argument are now mandatory
  • Elastica\Aggregation\Derivative: The second argument (string $bucketsPath) is now mandatory
  • Elastica\Aggregation\NormalizeAggregation: The second (string $bucketsPath) and the third (string $method) argument are now mandatory
  • Elastica\Aggregation\PercentilesBucket: The second argument (string $bucketsPath) is now mandatory
  • Elastica\Aggregation\SerialDiff: The second argument (string $bucketsPath) is now mandatory
  • Elastica\Aggregation\StatsBucket: The second argument (string $bucketsPath) is now mandatory
  • Elastica\Aggregation\SumBucket: The second argument (string $bucketsPath) is now mandatory
• Changed return type of Elastica\Cluster\Health::getActiveShardsPercentAsNumber() method to float #2144
• Changed $origin and $scale parameter types of Elastica\Query\FunctionScore::addDecayFunction() to allow float|int|string #2144
• Changed $key parameter type of Elastica\Multi\Search::addSearch() to allow int|string|null #2144
• Changed $options parameter type of Elastica\Index::create() to only allow array<string, mixed> #2147
• Changed Elastica\Reindex::setWaitForCompletion() to only allow bool #2151
• Changed Elastica\Search::addIndex(), Elasica\Search::addIndices() and Elastica\Search::hasIndex() parameter type to only allow Elastica\Index #2150
• Changed $options argument to not accept int in the following methods #2148
  • Elastica\SearchableInterface::search()
  • Elastica\SearchableInterface::createSearch()
  • Elastica\Search::search()
  • Elastica\Search::createSearch()
  • Elastica\Search::setOptionsAndQuery()
  • Elastica\Index::search()
  • Elastica\Index::createSearch()
• Removed classes #2188
  • Elastica\Connection
  • Elastica\Connection\ConnectionPool
  • Elastica\Connection\Strategy\CallbackStrategy
  • Elastica\Connection\Strategy\RoundRobin
  • Elastica\Connection\Strategy\Simple
  • Elastica\Connection\Strategy\StrategyFactory
  • Elastica\Connection\Strategy\StrategyInterface
• Removed Elastica\Client::setLogger() method #2148
• Enabled strict_types on all classes #2190
• Changed Elastica\Scroll:clear to use scroll_id body parameter instead of url parameter #2211

Added

• Added support for PHP 8.2 #2136
• Added missing @throws annotations to Client::request and related methods #2152
• Added ElasticSearch 8.x to CI #2123
• Added more versions of ElasticSearch to CI #2155
• If not expicitly set, use retry_on_conflict from Client configuration in Bulk updates (ported from 7.x #2184)
• Added support for the Combined Fields query type #2195

Changed

• Updated php-cs-fixer to 3.13.2 #2143
• Modernize code using match expression #2141
• Updated docker/php/Dockerfile added AllowSymfonyFlexPlugin (false) on docker phpuser context #2194

Removed

• Removed the JSONParseException class, which is replaced by \JsonException
• Removed the JSONParseException test class
• Removed nyholm/dsn as no longer needed.
• Removed symfony/deprecation-contracts as no longer needed.

Fixed

• Fix types order in Elastica\Query to work with psalm & expand the aggs type to include raw arrays

New Contributors

• @sidz made their first contribution in #2131
• @pawelkeska made their first contribution in #2181
• @Jean-Beru made their first contribution in #2178
• @daminuxfork made their first contribution in #2194
• @mparker17 made their first contribution in #2196

Full Changelog: 7.3.2...8.0.0-alpha1