SlmLocale is a Zend Framework 2 module to automatically detect a locale for your application. It uses a variety of pluggable strategies to search for a valid locale. SlmLocale has support for a default locale, a set of supported locales and locale aliases.
SlmLocale supports out of the box several strategies to search for a locale. Through interfaces, other strategies could be created. The set of default stragies is:
- Use domain name (subdomain or TLD)
- Use first segment of the path of an uri
- Use a cookie
- Use the HTTP Accept-Language header
SlmLocale will also provide an optional integration with ZfcUser, to make it possible to set a default locale in a user "profile".
The strategies are triggered via an event manager. This gives the option to have strategies look very early and others as late as possible. For example, you might first want to search for a cookie, then for a domain name and as last option in the HTTP Accept-Language header.
The strategies can also be called when a locale is found. This is useful for example to write a cookie with the locale when the locale is found through the HTTP Accept-Language header. Or you might want to perform a redirect to the correct domain when a user stated it preferred a certain locale.
The detector has a few options to tune the detection mechanism. First, there is a default locale. When every strategy sought for a locale, but did not find any, the default locale will be set. There is also a list of supported locales. Your application will probably not support every available locale, so you could define a set and SlmLocale tries to identify the best match. Aliases are possible to transform language codes into full locales. For example you can say if the code "en" is matched, the locale "en-US" will be used.
SlmLocale is available through composer. Add "slm/locale" to your composer.json list. During development of SlmLocale, you can specify the latest available version:
"slm/locale": "dev-master"
In the vendor/slm/locale/config directory you can find a slmlocale.global.php.dist file. You can copy that file to config/autoload/slmlocale.global.php (note you have to omit the .dist extension now). In that file you can tune every option from the detector and attach some strategies. To enable SlmLocale, mind to add "SlmLocale" to your application.config.php modules list.
Open the configuration file (at config/autoload/slmlocale.global.php) and there the complete behaviour of SlmLocale can be tuned. Here below every value will be addressed.
If you remove the // before the 'default' line, you are able to set the default locale for your application
'default' => 'en-US'
If you only want to have a specified set of locales your application supports, you can remove the // before the 'supported'. In the array you can specify the list you want to support. Keep in mind the order of the list is important. If a strategy can detect multiple locales (like with the HTTP Accept-Language header) the first match in the list will be chosen.
'supported' => array('en-US', 'en-GB', 'en');
[tbd]
[tbd]
SlmLocale is at this moment under development and it is not recommended to use SlmLocale in a production environment. All new features of SlmLocale are made with test driven development and continuous integration from Travis-CI.
If you notice any bugs in SlmLocale, please create an issue in the tracker. At this moment, the Detector class is finished. The supplied strategies are all not finished yet:
- Http Accept-Language strategy: under development
- Cookie strategy: not started
- Domain name strategy: under development
- UtiPathStrategy: not started