NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1823 most downloaded on Packagist
Elasticsearch PHP integration for your Symfony project using Elastica
Latest stable
v7.2.0
Last release 5 months ago
01 Jun 2026
Ships fairly regularly
a new release about every 6 months
Most releases are documented
notes for 42 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
76 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Deprecated the top-level headers and timeout client config. Move them into client_options — for Guzzle/Symfony HTTP Client use headers / timeout, for…
headers client config is now applied via Transport::setHeader() so it works uniformly across Guzzle, Symfony HTTP Client, and elastic-transport's bundled Curl client.timeout client config is now translated to CURLOPT_TIMEOUT at runtime when the active transport client is elastic-transport's bundled Curl — Guzzle/Symfony HTTP Client keep consuming the original 'timeout' key as before.'headers' => [] / 'timeout' => 30 into http_client_options, which would otherwise break elastic-transport's bundled Curl client (PHP 8+ ValueError on unknown curl_setopt_array keys).headers and timeout client config. Move them into client_options — for Guzzle/Symfony HTTP Client use headers / timeout, for the bundled Curl client use CURLOPT_HTTPHEADER / CURLOPT_TIMEOUT.doctrine/doctrine-bundle 3.x, doctrine/phpcr-odm 3.x and Symfony 8.0 in highest-deps CI.doctrine/doctrine-bundle (^2.5), doctrine/orm (^2.17) and jms/serializer-bundle (^5.4) to fix lowest-deps CI.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Dropped Symfony 7.1, 7.2 and 7.3 support.
Dropped support for PHP 7.4 and PHP 8.0.
FOS\ElasticaBundle\Elastica\Client::request does not exist anymore. Please use FOS\ElasticaBundle\Elastica\Client::sendRequest.FOS\ElasticaBundle\Elastica\Client::getIndex now returns FOS\ElasticaBundle\Elastica\Index.FOS\ElasticaBundle\Elastica\Client have changed. See definition of FOS\ElasticaBundle\Elastica\Client::__construct.Elastica\Client.index_template option template is renamed to index_patterns and accepts array of strings.FOS\ElasticaBundle\Elastica\Client (fos_elastica.client..) are now named, instead of indexed.host, port, url are no longer available and replaced with single hosts.proxy, auth_type, aws_*, ssl, curl, persistent, compression, connectTimeout are no longer available.connectionStrategy is renamed to connection_strategy.PostElasticaRequestEvent now operates with Psr\Http\Message\RequestInterface instead of Elastica\Request.ElasticaRequestExceptionEvent now operates with Psr\Http\Message\RequestInterface instead of Elastica\Request, and Elastic\Elasticsearch\Exception\ElasticsearchException instead of Elastica\Exception\ExceptionInterface.Main change is the configuration of the bundle:
connections level anymore.host, port and url are replaced with option hosts, which accepts array.client_config option.client_options.Added PreElasticaRequestEvent, PostElasticaRequestEvent and ElasticaRequestExceptionEvent for requests.
PreElasticaRequestEvent, PostElasticaRequestEvent and ElasticaRequestExceptionEvent for requests.Replaced deprecated Symfony\Component\HttpKernel\DependencyInjection\Extension.
Symfony\Component\HttpKernel\DependencyInjection\Extension.* Added PHP 8.4 support. * Added doctrine/orm 3 support. * Dropped PHP 8.0 support. * Dropped Symfony 7.0 support. * Updated documentation.
doctrine/orm 3 support.Pagerfanta v4.x compatibility by @evertharmeling in https://github.com/FriendsOfSymfony/FOSElasticaBundle/pull/1908
Full Changelog: https://github.com/FriendsOfSymfony/FOSElasticaBundle/compare/v6.3.1...v6.4.0
Full Changelog: v6.3.1...v6.4.0
Restored pagerfanta/pagerfanta dependency.
pagerfanta/pagerfanta dependency.Deprecated PostAsyncInsertObjectsEvent.
DateInterval to ISO 8601 string in model transformer.PostAsyncInsertObjectsEvent.TransformedFinder.Added support for aws_credential_provider.
aws_credential_provider.BackedEnum support in ModelToElasticaAutoTransformer.CreateCommand.Fixed several deprecation notices.
AsyncPagerPersister.Fixed deprecated knp_paginator.subscriber tag.
knp_paginator.subscriber tag.FOS\ElasticaBundle\Configuration\Source\SourceInterface::getConfiguration().resetAllIndexes and resetIndex from interface FOS\ElasticaBundle\Index\ResetterInterface and its implementations.Fixed deprecations for Elastica\Index::create() Elastica#1828.
auth_type client parameter Elastica#1790.pagerfanta/pagerfanta to v3.Elastica\Index::create() Elastica#1828.fos_elastica.finder.* services as private.fos_elastica.client alias as private.fos_elastica.client_prototype service as private.fos_elastica.index_template_prototype service as private.FantaPaginatorAdapter::getNbResults() has changed.FantaPaginatorAdapter::getSlice() has changed.PartialResultsInterface::toArray(), PartialResultsInterface::getTotalHits() and PartialResultsInterface::getAggregations() have changed.Fixed symfony/messenger integration.
symfony/messenger integration.fos_elastica.index service as private.Fixed several Doctrine Persistence deprecations.
findHybridPaginated.fos_elastica.template_resetter service.FOS\ElasticaBundle\Persister\PagerPersisterRegistry::getPagerPersister().fos_elastica.pager_provider private (fos_elastica.pager_provider.prototype.mongodb, fos_elastica.pager_provider.prototype.orm and fos_elastica.pager_provider.prototype.phpcr abstract services).fos_elastica.config_manager service as private.fos_elastica.config_manager.index_templates service as private.fos_elastica.filter_objects_listener service as private.fos_elastica.finder abstract service and all its children as private.fos_elastica.in_place_pager_persister service as private.fos_elastica.index_template_manager service as private.fos_elastica.object_persister service as private.fos_elastica.object_serializer_persister service as private.fos_elastica.pager_persister_registry service as private.fos_elastica.persister_registry service as private.fos_elastica.resetter service as private.fos_elastica.template_resetter service as private.debug_logging must be a boolean instead of a scalar value.Dropped Elasticsearch 5 and 6 support.
FOS\ElasticaBundle\Exception\InvalidArgumentTypeException.FOS\ElasticaBundle\Finder\FinderInterface::find().FOS\ElasticaBundle\HybridResult::getResult().FOS\ElasticaBundle\Index\AliasProcessor::switchIndexAlias().FOS\ElasticaBundle\Persister\ObjectPersisterInterface::handlesObject().FOS\ElasticaBundle\Provider\PagerProviderInterface::provide().getPager, getOptions and getObjectPersister from interface FOS\ElasticaBundle\Persister\Event\PersistEvent.getNbResults, getNbPages, getCurrentPage, setCurrentPage, getMaxPerPage and setMaxPerPage from interface FOS\ElasticaBundle\Provider\PagerInterface.findPaginated, createPaginatorAdapter and createRawPaginatorAdapter from interface FOS\ElasticaBundle\Finder\PaginatedFinderInterface.request, getIndex, getIndexTemplate and setStopwatch from class FOS\ElasticaBundle\Elastica\Client.logQuery, getNbQueries and getQueries from class FOS\ElasticaBundle\Logger\ElasticaLogger.addIndex, getRepository and getRepositoryName from class FOS\ElasticaBundle\Manager\RepositoryManager.find, findHybrid, findPaginated and createPaginatorAdapter from class FOS\ElasticaBundle\Repository.Elastica\Type._parent.FOS\ElasticaBundle\Event\IndexPopulateEvent constants for event names, use event classes instead:
PRE_INDEX_POPULATE => FOS\ElasticaBundle\Event\PreIndexPopulateEventPOST_INDEX_POPULATE => FOS\ElasticaBundle\Event\PostIndexPopulateEventFOS\ElasticaBundle\Event\IndexResetEvent constants for event names, use event classes instead:
PRE_INDEX_RESET => FOS\ElasticaBundle\Event\PreIndexResetEventPOST_INDEX_RESET => FOS\ElasticaBundle\Event\PostIndexResetEventFOS\ElasticaBundle\Event\TransformEvent constants for event names, use event classes instead:
PRE_TRANSFORM => FOS\ElasticaBundle\Event\PreTransformEventPOST_TRANSFORM => FOS\ElasticaBundle\Event\PostTransformEventFOS\ElasticaBundle\Persister\Event\Events class, use event classes instead:
ON_EXCEPTION => FOS\ElasticaBundle\Persister\Event\OnExceptionEventPOST_ASYNC_INSERT_OBJECTS => FOS\ElasticaBundle\Persister\Event\PostAsyncInsertObjectsEventPRE_INSERT_OBJECTS => FOS\ElasticaBundle\Persister\Event\PreInsertObjectsEventPOST_INSERT_OBJECTS => FOS\ElasticaBundle\Persister\Event\PostInsertObjectsEventPRE_PERSIST => FOS\ElasticaBundle\Persister\Event\PrePersistEventPOST_PERSIST => FOS\ElasticaBundle\Persister\Event\PostPersistEventPRE_FETCH_OBJECTS => FOS\ElasticaBundle\Persister\Event\PreFetchObjectsEventFOS\ElasticaBundle\Persister\Event\OnExceptionEvent::setIgnore() to FOS\ElasticaBundle\Persister\Event\OnExceptionEvent::setIgnored().fos_elastica.manager services as private.fos_elastica.repository_manager service as private.fos_elastica.pager_provider_registry service as private.fos_elastica.index_manager service as private.fos_elastica.paginator.subscriber service as private.* Improved Symfony 5.2 support.
Fixed Doctrine deprecation notice in RegisterListenersService.
ResetTemplatesCommand if not interactive.Fixed cannotBeEmpty deprecation notice in Configuration.
LegacyEventDispatcherProxy for Symfony 4.3 compatibility.cannotBeEmpty deprecation notice in Configuration.AbstractElasticaToModelTransformer.Added compatibility with Symfony 4.2.
Elastica\Client.ObjectPersister::deleteById.TransformEvent document.Configuration to private.ElasticaLogger.Fixed support for decorating object persister services. The refactoring done in 5.0.0 was breaking in such case.
Fixed Doctrine registry in MongoDB and PHPCR pager providers.
MongoDB and PHPCR pager providers.fos_elastica.paginator.subscriber service to be public.Fix typo in populate command: option first-page
Added ruflin/elastica 5.x and 6.x support.
ruflin/elastica 5.x and 6.x support.Fixed Doctrine registry in MongoDB and PHPCR pager providers.
MongoDB and PHPCR pager providers.Unset options of new provider API when an old one is used.
Introduce a new provider API. Deprecate legacy ones. See #1240
* Fixed Propel object sorting * Fixed the profiler icon for IE
[BC break] Removed deprecated Resetter class.
ruflin/Elastica 3.x support.DateTimeInterface in ModelToElasticaAutoTransformer.AbstractProvider::queryBuilder.PaginatorAdapterInterface::getSuggests.AbstractProvider::isObjectIndexable.AbstractProvider::getMemoryUsage.Resetter class.Client class.IndexManager class.DynamicIndex class.immediate configuration option.Search annotations as they cannot be used anymore.TransformedFinder::moreLikeThis.ignore_unmapped support for Paginator.* Fixed Propel object sorting * Fixed the profiler icon for IE
Fixed service priority when registering providers
Fixed Resetter::resetIndexType on Elasticsearch 1.x
Resetter::resetIndexType on Elasticsearch 1.xRestored and deprecated immediate option
immediate optionAllow driverless type definitions #953
PRE_TRANSFORM which allows developers to modify objects before
transformation into documents for indexingserialize_null option for SerializerdefaultSortFieldName and defaultSortDirection pagination optionsimmediate option on type persistence configurationRemoves store:true from mappings unless specifically defined
Nothing published for this version
Fix: Don't use parent identifier for objects/nested documents
Nothing published for this version
Updated Elastica dependency to allow 2.0
- Fix Symfony 2.3 compatibility
Nothing published for this version
Fix PopulateCommand trying to set formats for ProgressBar in Symfony < 2.5
BC BREAK: Doctrine\Listener#scheduleForDeletion access changed to private.
Doctrine\Listener#scheduleForDeletion access changed to private.ObjectPersisterInterface gains the method handlesObject that
returns a boolean value if it will handle a given object or not.Doctrine\Listener#getSubscribedEvents. The container
configuration now configures tags with the methods to call to avoid loading
this class on every request where doctrine is active. #729PaginationAdapterInterface has a new method, getAggregations. #726date_detection, numeric_detection and
dynamic_date_formats for types. #753POST_TRANSFORM which allows developers to add custom properties to
Elastica Documents for indexing.fos:elastica:populate command will now use the
ProgressBar helper instead of outputting strings. You can use verbosity
controls on the command to output additional information like memory
usage, runtime and estimated time.property_path to a type property definition to allow
customisation of the property path used to retrieve data from objects.
Setting property_path to false will configure the Transformer to ignore
that property while transforming. Combined with the above POST_TRANSFORM event
developers can now create calculated dynamic properties on Elastica documents
for indexing. #794SliceFetcher abstraction for Doctrine providers that get more
information about the previous slice allowing for optimising queries during
population. #725PRE_INDEX_POPULATE, POST_INDEX_POPULATE, PRE_TYPE_POPULATE and
POST_TYPE_POPULATE allow for monitoring when an index is about to be or has
just been populated. #744PRE_INDEX_RESET, POST_INDEX_RESET, PRE_TYPE_RESET and
POST_TYPE_RESET are run before and after operations that will reset an
index. #744BC BREAK: Doctrine\Listener#scheduleForDeletion access changed to private.
Doctrine\Listener#scheduleForDeletion access changed to private.ObjectPersisterInterface gains the method handlesObject that
returns a boolean value if it will handle a given object or not.Doctrine\Listener#getSubscribedEvents. The container
configuration now configures tags with the methods to call to avoid loading
this class on every request where doctrine is active. #729PaginationAdapterInterface has a new method, getAggregations. #726date_detection, numeric_detection and
dynamic_date_formats for types. #753POST_TRANSFORM which allows developers to add custom properties to
Elastica Documents for indexing.fos:elastica:populate command will now use the
ProgressBar helper instead of outputting strings. You can use verbosity
controls on the command to output additional information like memory
usage, runtime and estimated time.property_path to a type property definition to allow
customisation of the property path used to retrieve data from objects.
Setting property_path to false will configure the Transformer to ignore
that property while transforming. Combined with the above POST_TRANSFORM event
developers can now create calculated dynamic properties on Elastica documents
for indexing. #794SliceFetcher abstraction for Doctrine providers that get more
information about the previous slice allowing for optimising queries during
population. #725PRE_INDEX_POPULATE, POST_INDEX_POPULATE, PRE_TYPE_POPULATE and
POST_TYPE_POPULATE allow for monitoring when an index is about to be or has
just been populated. #744PRE_INDEX_RESET, POST_INDEX_RESET, PRE_TYPE_RESET and
POST_TYPE_RESET are run before and after operations that will reset an
index. #744Fix: Don't use parent identifier for objects/nested documents
Final 3.0 release
Updated Elastica dependency to allow 2.2
Nothing published for this version
Updated Elastica dependency to allow 2.0
Nothing published for this version
Fixed handling of empty indexes #760
connectionStrategy Elastica configuration #732Fixed the indexing of parent/child relations, broken since 3.0 #774
Removed unused public image asset for the web development toolbar #742
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.