Locale::acceptFromHttp

locale_accept_from_http

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Locale::acceptFromHttp -- locale_accept_from_http — 最もあてはまるロケールを HTTP "Accept-Language" ヘッダにもとづいて探す

説明

オブジェクト指向型

public static Locale::acceptFromHttp(string $header): string|false

手続き型

locale_accept_from_http(string $header): string|false

HTTP "Accept-Language" ヘッダが要求する言語リストを満たすロケールを探します。

パラメータ

header: "Accept-Language" ヘッダを含む文字列。RFC 2616 形式。

戻り値

対応するロケール ID を返します。

header の長さが INTL_MAX_LOCALE_LEN を超えた場合、false を返します。

例

例1 locale_accept_from_http() の例

<?php
$locale = locale_accept_from_http($_SERVER['HTTP_ACCEPT_LANGUAGE']);
echo $locale;
?>

例2 オブジェクト指向の例

<?php
$locale = Locale::acceptFromHttp($_SERVER['HTTP_ACCEPT_LANGUAGE']);
echo $locale;
?>

上の例の出力は以下となります。

en_US

参考

locale_lookup() - その言語にマッチする言語タグの一覧を検索する

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 5 notes

down

Adam Lange ¶

12 years ago

It's good to mention that if user browser will not send HTTP_ACCEPT_LANGUAGE, the output from:

 Locale::acceptFromHttp($_SERVER['HTTP_ACCEPT_LANGUAGE']);

Will be null. 

So remember to set up a fail over scenario!

down

rasmus at mindplay dot dk ¶

6 years ago

If you're struggling to figure out how to use this function in a project that only supports certain languages, move along.

Unfortunately, this function doesn't let you specify languages supported by your project - and since the internal header parsing and negotiation logic isn't exposed in any other way, you'll most likely want to ditch this function and go for a custom implementation of the same thing:

https://github.com/willdurand/Negotiation

down

mollasadra at g dot com ¶

6 years ago

Didn't see this being documented anywhere and the bug hasn't been addressed yet, so to save headache for otherS, this method does a little weird thing with these different locales:

php > echo locale_accept_from_http("zh_TW");
zh
php > echo locale_accept_from_http("zh_CN");
zh

down

bill at m$ dot com ¶

1 year ago

A nice way to detect humans. Bots usually dont have this HTTP_ACCEPT_LANGUAGE set.

down

bohwaz ¶

2 years ago

Please note that this method can throw IntlException in some cases when the passed header string is invalid AND you have enabled exceptions.  For example:

<?php

ini_set('intl.use_exceptions', 1);

$header = 'fr-FR,fr;q=0.9,fr;q=0.9;q=0.8,en-gb;q=0.8;q=0.7,en;q=0.6,en;q=0.7;q=0.5,*;q=0.5;q=0.4';
var_dump(locale_accept_from_http($header));

?>

Returns:

PHP Warning:  Uncaught IntlException: locale_accept_from_http: failed to find acceptable locale in ...

＋add a note