NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #5516 most downloaded on Packagist
Locale module
Latest stable
4.16.1
Last release 1 months ago
13 Oct 2026
Release timing varies
gaps range from 9 days to 5 months
Nearly every release is documented
notes for 47 of 47 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
49 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Included commits: https://github.com/spryker/locale/compare/4.16.0...4.16.1
Included commits: https://github.com/spryker/locale/compare/4.16.0...4.16.1
CustomerResponse.customerTransfer transfer field.CustomerResponse.isSuccess transfer field.CustomerResponse.errors transfer field.Included commits: https://github.com/spryker/locale/compare/4.15.1...4.16.0
Included commits: https://github.com/spryker/locale/compare/4.15.1...4.16.0
LocaleDataHelper::getCurrentLocale() to expose the locale a request without an explicit one resolves to, so a fixture only has to be written for that locale.Included commits: https://github.com/spryker/locale/compare/4.15.0...4.15.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Included commits: https://github.com/spryker/locale/compare/4.15.0...4.15.1
Included commits: https://github.com/spryker/locale/compare/4.14.1...4.15.0
Included commits: https://github.com/spryker/locale/compare/4.14.1...4.15.0
LocaleCustomerValidatorPlugin to reject a customer whose assigned locale does not exist, supporting customer validation for the back-office customers endpoint.CustomerTransfer, CustomerErrorTransfer and CustomerResponseTransfer transfers.Included commits: https://github.com/spryker/locale/compare/4.14.0...4.14.1
Included commits: https://github.com/spryker/locale/compare/4.14.0...4.14.1
spryker/application to require-dev to correctly declare test namespace dependencies resolved by dev:dependency:find.Included commits: https://github.com/spryker/locale/compare/4.13.0...4.14.0
Included commits: https://github.com/spryker/locale/compare/4.13.0...4.14.0
LocaleReader to reduce duplicate database requests when retrieving locale data within a single request lifecycle.LocaleReaderInterface::clearMemoryCache() to ensure the in-memory cache is invalidated before write operations such as creating or deleting locales and updating store locales.Included commits: https://github.com/spryker/locale/compare/4.12.0...4.13.0
Included commits: https://github.com/spryker/locale/compare/4.12.0...4.13.0
StoreExpander to use full locale names (e.g., en_US, en_GB) as keys instead of short language codes to support multiple locales with the same language prefix (e.g., en_*) per store.Included commits: https://github.com/spryker/locale/compare/4.11.0...4.12.0
Included commits: https://github.com/spryker/locale/compare/4.11.0...4.12.0
Included commits: https://github.com/spryker/locale/compare/4.10.0...4.11.0
Included commits: https://github.com/spryker/locale/compare/4.10.0...4.11.0
Included commits: https://github.com/spryker/locale/compare/4.9.1...4.10.0
Included commits: https://github.com/spryker/locale/compare/4.9.1...4.10.0
Spryker\Yves\Locale\Plugin\Application\ConsoleLocaleApplicationPlugin to provide a locale service for Yves console application.Spryker\Yves\Locale\LocaleConfig::getConsoleDefaultLocale().Included commits: https://github.com/spryker/locale/compare/4.9.0...4.9.1
Included commits: https://github.com/spryker/locale/compare/4.9.0...4.9.1
LocaleLocalePlugin::getLocaleTransfer() so now it supports parsing locale codes with a delimiter of -.Included commits: https://github.com/spryker/locale/compare/4.8.0...4.9.0
Included commits: https://github.com/spryker/locale/compare/4.8.0...4.9.0
LocaleConstants::IS_STORE_ROUTING_ENABLED.LocaleConfig::isStoreRoutingEnabled() method to return true if the store routing is enabled.LocaleConfig::getLocaleCodeIndex() method to return the index of the locale code in the URL.LocaleLocalePlugin::getLocaleTransfer() so now it uses the config method LocaleConfig::getLocaleCodeIndex() for extracting locale code from URL.Included commits: https://github.com/spryker/locale/compare/4.7.0...4.8.0
Included commits: https://github.com/spryker/locale/compare/4.7.0...4.8.0
LocaleFacade::expandStoreTransfersWithLocales() to index available locales by short name before adding them into StoreTransfer to have the same structure in Dynamic Multistore OFF and ON modes.Included commits: https://github.com/spryker/locale/compare/4.6.0...4.7.0
Included commits: https://github.com/spryker/locale/compare/4.6.0...4.7.0
DefaultLocaleStorePostCreatePlugin, DefaultLocaleStorePostUpdatePlugin, LocaleFacade::expandStoreTransfersWithLocales() and LocaleFacade::updateStoreLocales() to fix Dynamic Multistore ON/OFF inconsistencies.Included commits: https://github.com/spryker/locale/compare/4.5.1...4.6.0
Included commits: https://github.com/spryker/locale/compare/4.5.1...4.6.0
1.10.* support.Included commits: https://github.com/spryker/locale/compare/4.5.0...4.5.1
Included commits: https://github.com/spryker/locale/compare/4.5.0...4.5.1
Included commits: https://github.com/spryker/locale/compare/4.4.0...4.5.0
Included commits: https://github.com/spryker/locale/compare/4.4.0...4.5.0
LocaleApplicationPlugin to negotiate language iso code if the default locale based on the current store is not available.Included commits: https://github.com/spryker/locale/compare/4.3.0...4.4.0
Included commits: https://github.com/spryker/locale/compare/4.3.0...4.4.0
LocaleApplicationPlugin::provide() so it sets the default locale based on the current store default locale when accept-language header is not provided.StoreClientInterface::getCurrentStore() to dependencies.Included commits: https://github.com/spryker/locale/compare/4.2.0...4.3.0
Included commits: https://github.com/spryker/locale/compare/4.2.0...4.3.0
LocaleFacade::getCurrentLocaleName() so now it returns the locale name for the first store from DB if the current store is not provided.Included commits: https://github.com/spryker/locale/compare/4.1.0...4.2.0
Included commits: https://github.com/spryker/locale/compare/4.1.0...4.2.0
LocaleServiceInterface::getAcceptLanguage() to negotiated language ISO code based on the specified accept language and priorities.AcceptLanguage transfer.LocaleApplicationPlugin to negotiate language iso code based on Accept-Language header.LocaleToLanguageNegotiatorInterface::getAcceptLanguage() to dependencies to provide functionality to get negotiated language iso code based on Accept-Language header.WilldurandNegotiation module to dependencies.Transfer module version dependency.LocaleToStoreClientInterface::getCurrentStore() from dependencies.Included commits: https://github.com/spryker/locale/compare/4.0.1...4.1.0
Included commits: https://github.com/spryker/locale/compare/4.0.1...4.1.0
LocaleApplicationPlugin so it sets current locale name to the Store.Included commits: https://github.com/spryker/locale/compare/4.0.0...4.0.1
Included commits: https://github.com/spryker/locale/compare/4.0.0...4.0.1
LocaleDataHelper to reset locale cache class manually if a locale exists so if a locale is created and deleted during the same test run, then the same locale is created again, and the new identifier is retrieved from the code cache.Deprecated LocaleFacadeInterface::setCurrentLocale().
Included commits: https://github.com/spryker/locale/compare/3.9.0...4.0.0
Breaking Changes
LocaleFacadeInterface::getLocaleByCode().LocaleQueryContainerInterface.LocaleQueryContainer.spy_locale_store table.spy_store.fk_locale column and index-spy_store-fk_locale index.LocaleClientInterface::getAllowedLanguages().LocaleClientInterface::getCurrentLocale(), LocaleClientInterface::getLocales() to make them Dynamic Store compatible.LocaleMetaDataProviderPlugin.Glue\LocaleApplicationPlugin.Yves\LocaleApplicationPlugin to make it Dynamic Store compatible.LocaleLocalePlugin so it does not depend on the current locale.LocaleFacadeInterface::getLocaleCollection(), LocaleFacadeInterface::expandStoreTransfersWithLocales(), LocaleFacadeInterface::updateStoreDefaultLocale(), LocaleFacadeInterface::validateStoreLocale() and LocaleFacadeInterface::updateStoreLocales().LocaleFacadeInterface::getAvailableLocales, LocaleFacadeInterface::getCurrentLocaleName() and LocaleFacadeInterface::getSupportedLocaleCodes() to make them Dynamic Store compatible.ConsoleLocaleApplicationPlugin.LocaleBackendGatewayApplicationPlugin.LocaleStoreAclEntityConfigurationExpanderPlugin.DefaultLocaleStorePostCreatePlugin, DefaultLocaleStorePostUpdatePlugin, DefaultLocaleStorePreCreateValidationPlugin, DefaultLocaleStorePreUpdateValidationPlugin, LocaleStoreCollectionExpanderPlugin, LocaleStorePostCreatePlugin and LocaleStorePostUpdatePlugin.LocaleConfig::getBackofficeUILocales(), LocaleConfig::getConsoleDefaultLocale().LocaleCriteria, LocaleConditions, StoreResponse, Store, Message transfers.LocaleDependencyHelper.LocaleFacadeInterface::install() so it uses LocaleRepository and LocaleEntityManager instead of LocaleQueryContainerInterface to interact with Locale table.StoreClientInterface to dependencies.StoreFacadeInterface to dependencies.LocaleConfig::getLocaleFile() so it throws the exception of file with locales does not exist.Store, StoreExtension, ZedRequestExtension modules to dependencies.LocaleFacadeInterface::setCurrentLocale().Included commits: https://github.com/spryker/locale/compare/3.9.0...3.10.0
Included commits: https://github.com/spryker/locale/compare/3.9.0...3.10.0
LocaleServiceInterface::getAcceptLanguage() to negotiated language ISO code based on the specified accept language and priorities.AcceptLanguage transfer.LocaleToLanguageNegotiatorInterface::getAcceptLanguage() to dependencies to provide functionality to get negotiated language iso code based on Accept-Language header.WilldurandNegotiation module to dependencies.Transfer module version dependency.Included commits: https://github.com/spryker/locale/compare/3.8.2...3.9.0
Included commits: https://github.com/spryker/locale/compare/3.8.2...3.9.0
LocaleAclEntityConfigurationExpanderPlugin plugin to expand provided AclEntityMetadataConfig transfer object with locale composite data.LocaleMerchantAclEntityRuleExpanderPlugin plugin to expand set of AclEntityRule transfer object with locale composite data.AclEntityMetadataConfig transfer.AclEntityMetadata transfer.AclEntityMetadataCollection transfer.AclEntityRule transfer.Included commits: https://github.com/spryker/locale/compare/3.8.1...3.8.2
Included commits: https://github.com/spryker/locale/compare/3.8.1...3.8.2
locale.databuilder.xml in order to fix CI errors.Included commits: https://github.com/spryker/locale/compare/3.8.0...3.8.1
Included commits: https://github.com/spryker/locale/compare/3.8.0...3.8.1
LocaleFacade::getLocaleCollection() in order to merge only indexed locales.Included commits: https://github.com/spryker/locale/compare/3.7.0...3.8.0
Included commits: https://github.com/spryker/locale/compare/3.7.0...3.8.0
LocaleClientInterface::getCurrentLanguage() which returns current language based on the current locale.LocaleClientInterface::getLocales() which returns list of locales for current store.Included commits: https://github.com/spryker/locale/compare/3.6.1...3.7.0
Included commits: https://github.com/spryker/locale/compare/3.6.1...3.7.0
LocaleFacade::getLocaleById() in order to get locale via repository.Included commits: https://github.com/spryker/locale/compare/3.6.0...3.6.1
Included commits: https://github.com/spryker/locale/compare/3.6.0...3.6.1
symfony/http-kernel.Included commits: https://github.com/spryker/locale/compare/3.5.1...3.6.0
Included commits: https://github.com/spryker/locale/compare/3.5.1...3.6.0
\SprykerTest\Yves\Locale\Helper\LocaleHelper.Included commits: https://github.com/spryker/locale/compare/3.5.0...3.5.1
Included commits: https://github.com/spryker/locale/compare/3.5.0...3.5.1
LocaleLocalePlugin to properly parse locale name from the URL.Included commits: https://github.com/spryker/locale/compare/3.4.0...3.5.0
Included commits: https://github.com/spryker/locale/compare/3.4.0...3.5.0
Included commits: https://github.com/spryker/locale/compare/3.3.0...3.4.0
Included commits: https://github.com/spryker/locale/compare/3.3.0...3.4.0
LocaleFacade::install() facade method to rollback the transaction in a case when Exception is thrown during the execution of it.LocaleInstallerPlugin plugin with facade changes.Included commits: https://github.com/spryker/locale/compare/3.2.3...3.3.0
Included commits: https://github.com/spryker/locale/compare/3.2.3...3.3.0
Spryker\Zed\Locale\Business\LocaleFacadeInterface::getSupportedLocaleCodes() that returns a string array of ISO codes for supported locales from the configuration.Included commits: https://github.com/spryker/locale/compare/3.2.2...3.2.3
Included commits: https://github.com/spryker/locale/compare/3.2.2...3.2.3
LocaleFacade::getLocaleCollection().Included commits: https://github.com/spryker/locale/compare/3.2.1...3.2.2
Included commits: https://github.com/spryker/locale/compare/3.2.1...3.2.2
LocaleFacadeInterface::getLocaleCollection() to get available locales in bulk.LocaleRepositoryInterface dependency to LocaleManager.Included commits: https://github.com/spryker/locale/compare/3.2.0...3.2.1
Included commits: https://github.com/spryker/locale/compare/3.2.0...3.2.1
Provided Spryker\Yves\Locale\Plugin\Application\LocaleApplicationPlugin instead of locale related functionality provided by deprecated SprykerShop\Yve…
Included commits: https://github.com/spryker/locale/compare/3.1.0...3.2.0
Spryker\Yves\Locale\Plugin\Application\LocaleApplicationPlugin instead of locale related functionality provided by deprecated SprykerShop\Yves\ShopApplication\Plugin\Provider\ShopApplicationServiceProvider similar plugin provided for Zed.Spryker\Yves\Locale\Plugin\EventDispatcher\LocaleEventDispatcherPlugin similar plugin provided for Zed.Spryker\Yves\Locale\Plugin\Locale\LocaleLocalePlugin that implements Spryker\Shared\LocaleExtension\Dependency\Plugin\LocalePluginInterface from spryker/locale-extension similar plugin provided for Zed.Spryker\Zed\Locale\Communication\Plugin\Locale\LocaleLocalePlugin that implements Spryker\Shared\LocaleExtension\Dependency\Plugin\LocalePluginInterface from spryker/locale-extension similar plugin provided for Zed.setCurrentLocale().Included commits: https://github.com/spryker/Locale/compare/3.0.0...3.1.0
Included commits: https://github.com/spryker/Locale/compare/3.0.0...3.1.0
Add a new test helper for generating and persisting locales
Included commits: https://github.com/spryker/Locale/compare/2.2.0...3.0.0
Included commits: https://github.com/spryker/Locale/compare/2.2.0...3.0.0
Included commits: https://github.com/spryker/Locale/compare/2.1.1...2.2.0
Included commits: https://github.com/spryker/Locale/compare/2.1.1...2.2.0
LocaleFacade::getLocaleById()method.Included commits: https://github.com/spryker/Locale/compare/2.1.0...2.1.1
Included commits: https://github.com/spryker/Locale/compare/2.1.0...2.1.1
Deprecated getLocaleByCode(), use getLocale() instead.
Included commits: https://github.com/spryker/Locale/compare/2.0.0...2.1.0
Release Locale bundle with version 2.0.0
Release Locale bundle with version 2.0.0
Release Locale bundle with version 2.0.0-RC2
Release Locale bundle with version 2.0.0-RC2
Release Locale bundle with version 2.0.0-RC1
Release Locale bundle with version 2.0.0-RC1
Release Locale bundle with version 1.0.0
Release Locale bundle with version 1.0.0
Release Locale bundle with version 0.20.0
Release Locale bundle with version 0.20.0
One column per quarter.