* @version 1.0.0 (January 01, 2006)
* @package AutoIndex
*/
class Language
{
/**
* @var ConfigData Contains the translation data from the language file
*/
private $translation_data;
/**
* Returns a list of all files in $path that match the filename format
* of language files.
*
* There are two valid formats for the filename of a language file. The
* standard way is the language code then the .txt extension. You can
* also use the language code followed by an underscore then the
* country code. The second format would be used for dialects of
* languages. For example pt.txt would be Portuguese, and pt_BR.txt
* would be Brazilian Portuguese. The filenames are case insensitive.
*
* @param string $path The directory to read from
* @return array The list of valid language files (based on filename)
*/
public static function get_all_langs($path)
{
if (($hndl = @opendir($path)) === false)
{
return false;
}
$list = array();
while (($file = readdir($hndl)) !== false)
{
if (@is_file($path . $file) && preg_match('/^[a-z]{2}(_[a-z]{2})?'
. preg_quote(LANGUAGE_FILE_EXT, '/') . '$/i', $file))
{
$list[] = $file;
}
}
closedir($hndl);
for ($i = 0; $i < count($list); $i++)
{
//remove the file extention from each language code
$list[$i] = substr($list[$i], 0, -strlen(LANGUAGE_FILE_EXT));
}
return $list;
}
/**
* @return string The code for the language to load
*
* First tries to use the default of the user's browser, and then tries
* the default in the config file.
*/
private function get_current_lang()
{
//try to detect the default language of the user's browser
if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE']))
//e.g. "en-us,en;q=0.5"
{
$available_langs = self::get_all_langs(PATH_TO_LANGUAGES);
if ($available_langs !== false)
{
$pref = array(); //user's preferred languages
foreach (explode(',', $_SERVER['HTTP_ACCEPT_LANGUAGE']) as $lang)
{
$lang_array = explode(';q=', trim($lang));
$q = (isset($lang_array[1]) ? trim($lang_array[1]) : 1); //preference value
$pref[trim($lang_array[0])] = (float)$q;
}
arsort($pref);
//find the first match that is available:
foreach ($pref as $lang => $q)
{
if (in_array($lang, $available_langs))
{
return $lang;
}
}
}
}
//the browser has no preferences set, so use the config's default
global $config;
return $config -> __get('language');
}
/**
* Creates a new language object. First tries to use the default of
* the user's browser, and then tries the default in the config file.
*/
public function __construct()
{
$lang_file = PATH_TO_LANGUAGES . $this -> get_current_lang()
. LANGUAGE_FILE_EXT;
if (!@is_readable($lang_file))
{
throw new ExceptionFatal('Cannot read from language file: '
. Url::html_output($lang_file) . '');
}
//load the file as a tab-separated object
$this -> translation_data = new ConfigData($lang_file);
}
/**
* @param string $name The word to look for
* @return bool True if $name is set in the translation file
*/
public function is_set($name)
{
return $translation_data -> is_set($name);
}
/**
* @param string $var The key to look for (the keyword)
* @return string The value $name points to (its translation)
*/
public function __get($var)
{
if ($this -> translation_data -> is_set($var))
{
return $this -> translation_data -> __get($var);
}
throw new ExceptionDisplay('Variable ' . Url::html_output($var)
. ' not set in Language file.');
}
}
?>