It's horrible to see what is happening now in Ukraine, as Russian army is bombarding houses, hospitals and kindergartens.
Please check out supportukrainenow.org for the ways how you can help people there. Spread the word.
And if you are from Russia and you are against this war, please express your protest in some way. I know you can get punished for this, but you are one of the hopes of those innocent people.
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.
- PHP >= 7.0
composer require codezero/browser-locale
$browser = new \CodeZero\BrowserLocale\BrowserLocale($_SERVER["HTTP_ACCEPT_LANGUAGE"]);
Laravel >= 5.5 will automatically register the ServiceProvider so you can get BrowserLocale
from the IOC container.
$browser = \App::make(\CodeZero\BrowserLocale\BrowserLocale::class);
$locale = $browser->getLocale();
This will return an instance of \CodeZero\BrowserLocale\Locale
or null
if no locale exists.
if ($locale !== null) {
$full = $locale->locale; // Example: "en-US"
$language = $locale->language; // Example: "en"
$country = $locale->country; // Example: "US"
$weight = $locale->weight; // Example: 1.0
}
$locales = $browser->getLocales();
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.
foreach ($locales as $locale) {
$full = $locale->locale; // Example: "en-US"
$language = $locale->language; // Example: "en"
$country = $locale->country; // Example: "US"
$weight = $locale->weight; // Example: 1.0
}
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
)
Returns an array of every locale found in the input string.
$browser = new \CodeZero\BrowserLocale\BrowserLocale('en-US,en;q=0.8,nl-NL;q=0.6');
$filter = \CodeZero\BrowserLocale\Filters\LocaleFilter;
$locales = $browser->filter($filter);
//=> Result: ['en-US', 'en', 'nl-BE']
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.
$browser = new \CodeZero\BrowserLocale\BrowserLocale('en-US,nl;q=0.8');
$filter = \CodeZero\BrowserLocale\Filters\CombinedFilter;
$locales = $browser->filter($filter);
//=> Result: ['en-US', 'en', 'nl']
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.
$browser = new \CodeZero\BrowserLocale\BrowserLocale('en-US,en;q=0.8,nl-NL;q=0.6');
$filter = \CodeZero\BrowserLocale\Filters\LanguageFilter;
$languages = $browser->filter($filter);
//=> Result: ['en', 'nl']
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.
$browser = new \CodeZero\BrowserLocale\BrowserLocale('en-US,en;q=0.8,nl-NL;q=0.6,nl;q=0.4');
$filter = \CodeZero\BrowserLocale\Filters\CountryFilter;
$countries = $browser->filter($filter);
//=> Result: ['US', 'BE']
Returns an array of all relative quality factors found in the input string. The default of 1.0
is also included.
$browser = new \CodeZero\BrowserLocale\BrowserLocale('en-US,en;q=0.8,nl-NL;q=0.6,nl;q=0.4');
$filter = \CodeZero\BrowserLocale\Filters\WeightFilter;
$weights = $browser->filter($filter);
//=> Result: [1.0, 0.8, 0.6, 0.4]
You can create your own filters by implementing the \CodeZero\BrowserLocale\Filters\Filter
interface.
composer test
If you discover any security related issues, please e-mail me instead of using the issue tracker.
A complete list of all notable changes to this package can be found on the releases page.
The MIT License (MIT). Please see License File for more information.