WB 2.08.x

<?php

/**

 * @package      WebsiteBaker_Core

 * @license      http://www.gnu.org/licenses/gpl.html

 * @filesource   $HeadURL$

 */

class ModLanguage {

	private $_sSystemLanguage    = 'EN';

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

	private $_sDefaultLanguage   = '';

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

	private $_aLanguageTable     = array();

// @array list of all loaded/merged languages

	private $_aLoadedLanguages   = array();

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

	private static $_oInstance   = null;

/**

 */

	final protected function  __construct() { }

/**

 *  prevent from cloning existing instance

 */

	final private function __clone() {}

/**

 * @return object

 */

            $c = __CLASS__;

            self::$_oInstance = new $c;

		}

		return self::$_oInstance;

	}

/**

 * @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 $sDirectory full path to the language files

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

 * @throws SecDirectoryTraversalException [global exception]

 * @throws TranslationException [private exception]

		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))) {

				$msg .= '"'.str_replace($sBasePath, '', $this->_sLanguageDirectory).'"';

				throw new TranslationException($msg);

			}

		}else {

			throw new SecDirectoryTraversalException($sLangDir);

	}

/**

 * @param string $sLangDir

 * @param string $sLanguage

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

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

			$this->_aLoadedLanguages[] = $sLanguage;

		}

/**

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

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

		$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;

			}

		}

/**

 * import key-values from language file

 * @return array of language definitions

		$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;

			}

		}

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

			// and import all found translations

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

		}

} // end class Translate

/**

 *  Exception class for Translation

 */

class TranslationException extends AppException {}