Download the PHP package codezero/browser-locale without Composer
On this page you can find all versions of the php package codezero/browser-locale. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package browser-locale
BrowserLocale
Get the most preferred locales from your visitor's browser.
Every browser has a setting for preferred website locales.
This can be read by PHP, usually with the $_SERVER["HTTP_ACCEPT_LANGUAGE"]
variable.
$_SERVER["HTTP_ACCEPT_LANGUAGE"]
will return a comma separated list of language codes. Each language code MAY have a "relative quality factor" attached ("nl;q=0.8") which determines the order of preference. For example:nl-NL,nl;q=0.8,en-US;q=0.6,en;q=0.4
. If no relative quality factor is present, the value is by default1.0
.
BrowserLocale parses this string and lets you access the preferred locales quickly and easily.
Requirements
- PHP >= 7.0
Install
Instantiate
For vanilla PHP:
For Laravel:
Laravel >= 5.5 will automatically register the ServiceProvider so you can get BrowserLocale
from the IOC container.
Get Primary Locale
This will return an instance of \CodeZero\BrowserLocale\Locale
or null
if no locale exists.
Get All Locales
This will return an array of \CodeZero\BrowserLocale\Locale
instances, sorted by weight in descending order.
So the first array item is the most preferred locale.
If no locales exist, an empty array will be returned.
Filter Locale Info
You can get a flattened array with only specific Locale information.
These arrays will always be sorted by weight in descending order.
There will be no duplicate values! (e.g. en
and en-US
are both the language en
)
LocaleFilter
Returns an array of every locale found in the input string.
CombinedFilter
Returns an array of every locale found in the input string, while making sure the 2-letter language version of the locale is always present.
LanguageFilter
Returns an array of only the 2-letter language codes found in the input string. Language codes are also extracted from full locales and added to the results array.
CountryFilter
Returns an array of only the 2-letter country codes found in the input string. Locales that only contain a 2-letter language code will be skipped.
WeightFilter
Returns an array of all relative quality factors found in the input string. The default of 1.0
is also included.
You can create your own filters by implementing the \CodeZero\BrowserLocale\Filters\Filter
interface.
Testing
Security
If you discover any security related issues, please e-mail me instead of using the issue tracker.
Changelog
A complete list of all notable changes to this package can be found on the releases page.
License
The MIT License (MIT). Please see License File for more information.