WB 2.08.x

 * @since        Datei vorhanden seit Release 2.8.4

// @var string 2 upercase chars for hardcoded system default language

	private $_sSystemLanguage    = 'EN';

// @var string 2 upercase chars for default fallback language

	private $_sDefaultLanguage   = '';

// @var string 2 upercase chars for current active language

// @var string full directory with trailing slash to search language files in

// @array list to hold the complete resulting translation table

	private $_aLanguageTable     = array();

// @array list of all loaded/merged languages

	private $_aLoadedLanguages   = array();

// @boolean set to TRUE if language is successfully loaded

// @object hold the Singleton instance

	private static $_oInstance   = null;

 *  prevent class from public instancing

 */

	final protected function  __construct() { }

/**

 *  prevent from cloning existing instance

 */

	final private function __clone() {}

/**

 * return requested translation for a key

 * @param string $sLanguageKey 2-uppercase letters language code

 * @return string found translation or empty string

 * @throws TranslationException

 */

	public function __get($sLanguageKey)

	{

		if($this->_bLoaded) {

			$sRetval = (isset($this->_aLanguageTable[$sLanguageKey])

						? $this->_aLanguageTable[$sLanguageKey] : '{missing: '.$sLanguageKey.'}');

			return $sRetval;

		}

		$msg = 'No translation table loaded';

		throw new TranslationException($msg);

	}

/**

 * returns the whoole language array for use in templateengine

 * @return array

 * @throws TranslationException

 */

	public function getLangArray()

	{

		if($this->_bLoaded) {

			return $this->_aLanguageTable;

		}

		$msg = 'No translation table loaded';

		throw new TranslationException($msg);

	}

/**

 * @param string $sLanguage 2 chars current active language code

 * @param string $sDefault 2 chars default fallback language code

 * @throws SecDirectoryTraversalException [global exception]

 * @throws TranslationException [private exception]

	public function setLanguage($sDirectory, $sCurrentLanguage, $sDefaultLanguage = 'EN')

		// sanitize arguments

		$sLangDir  = realpath($sDirectory);

		if(preg_match('/^'.preg_quote($sBasePath, '/').'/', $sLangDir)) {

			$sLangDir  = rtrim(str_replace('\\', '/', $sLangDir), '/').'/';

			$sCurrentLanguage = strtoupper($sCurrentLanguage);

			$sDefaultLanguage = strtoupper($sDefaultLanguage);

			// check if the requested language is not already loaded

			if($this->_sLanguageDirectory != $sLangDir ||

			   $this->_sCurrentLanguage   != $sCurrentLanguage ||

			   $this->_sDefaultLanguage   != $sDefaultLanguage)

			{

			// now load and merge the files in order SYSTEM - DEFAULT - CURRENT

				$this->_aLanguageTable = array();

				// at first search SYSTEM_LANGUAGE

				$this->_loadLanguage($sLangDir, $this->_sSystemLanguage);

				// at second merge DEFAULT_LANGUAGE

				if(!in_array($sDefaultLanguage, $this->_aLoadedLanguages)) {

					$this->_loadLanguage($sLangDir, $sDefaultLanguage);

				}

				// at third merge CURRENT_LANGUAGE

				if(!in_array($sCurrentLanguage, $this->_aLoadedLanguages)) {

					$this->_loadLanguage($sLangDir, $sCurrentLanguage);

				}

				// if no predefined language was fond, search for first available language

				if(sizeof($this->_aLanguageTable) == 0) {

					// if absolutely no language was fond, throw an exception

					if(false !== ($sRandomLanguage = $this->_findFirstLanguage($sLangDir))) {

						$this->_loadLanguage($sLangDir, $sRandomLanguage);

					}

				}

				// remember last settings

				$this->_sLanguageDirectory = $sLangDir;

				$this->_sCurrentLanguage   = $sCurrentLanguage;

				$this->_sDefaultLanguage   = $sDefaultLanguage;

			}

			if(!($this->_bLoaded = (sizeof($this->_aLanguageTable) != 0))) {

			$this->_bLoaded = true;

		}else {

			throw new SecDirectoryTraversalException($sLangDir);

 * load language from given directory

 * @param string $sLangDir

 * @param string $sLanguage

	private function _loadLanguage($sLangDir, $sLanguage)

		if(is_readable($sLangDir.$sLanguage.'.php')) {

			$this->_aLanguageTable = array_merge($this->_aLanguageTable,

			                                    $this->_importArrays($sLangDir.$sLanguage.'.php'));

			$this->_aLoadedLanguages[] = $sLanguage;

		}

 * find first available language in given directory

 * @param  string $sLangDir the directory to scan for language files

 * @return string returns the 2 char language code or FALSE if search fails

	private function _findFirstLanguage($sLangDir)

	// search for first available and readable language file

		$sRetval = false;

		if(is_readable($sLangDir)) {

			$iterator = new DirectoryIterator($sLangDir);

			foreach ($iterator as $fileinfo) {

				if(!preg_match('/^[A-Z]{2}\.php$/', $fileinfo->getBasename())) { continue; }

				$sLanguageFile = $fileinfo->getPathname();

				if(is_readable($sLanguageFile)) {

					$sRetval = basename($sLanguageFile, '.php');

					break;

		return $sRetval;

 * @param  string $sLanguageFile

 * @return array of language definitions

	private function _importArrays($sLanguageFile)

		include($sLanguageFile);

		$aAllVars = get_defined_vars();

		$aLangSections = array();

		$aLanguageTable = array();

		foreach($aAllVars as $key=>$value) {

		// extract the names of arrays from language file

			if(is_array($value)) {

				$aLangSections[] = $key;

			}

		}

		// walk through all arrays

			foreach(${$sSection} as $key => $value) {

			// and import all found translations

				$aLanguageTable[$sSection.'_'.$key] = $value;

		return $aLanguageTable;