| public load ( mixed $langfile, string $idiom = '', boolean $return = FALSE, boolean $add_suffix = TRUE, string $alt_path = '' ) : void | string[] | ||
| $langfile | mixed | Language file name |
| $idiom | string | Language name (english, etc.) |
| $return | boolean | Whether to return the loaded array of translations |
| $add_suffix | boolean | Whether to add suffix to $langfile |
| $alt_path | string | Alternative path to look for the language file |
| return | void | string[] | Array containing translations, if $return is set to TRUE |
public function load($langfile, $idiom = '', $return = FALSE, $add_suffix = TRUE, $alt_path = '')
{
if (is_array($langfile)) {
foreach ($langfile as $value) {
$this->load($value, $idiom, $return, $add_suffix, $alt_path);
}
return;
}
$langfile = str_replace('.php', '', $langfile);
if ($add_suffix === TRUE) {
$langfile = preg_replace('/_lang$/', '', $langfile) . '_lang';
}
$langfile .= '.php';
if (empty($idiom) or !preg_match('/^[a-z_-]+$/i', $idiom)) {
$config =& get_config();
$idiom = empty($config['language']) ? 'english' : $config['language'];
}
if ($return === FALSE && isset($this->is_loaded[$langfile]) && $this->is_loaded[$langfile] === $idiom) {
return;
}
// Load the base file, so any others found can override it
$basepath = BASEPATH . 'language/' . $idiom . '/' . $langfile;
if (($found = file_exists($basepath)) === TRUE) {
include $basepath;
}
// Do we have an alternative path to look in?
if ($alt_path !== '') {
$alt_path .= 'language/' . $idiom . '/' . $langfile;
if (file_exists($alt_path)) {
include $alt_path;
$found = TRUE;
}
} else {
foreach (get_instance()->load->get_package_paths(TRUE) as $package_path) {
$package_path .= 'language/' . $idiom . '/' . $langfile;
if ($basepath !== $package_path && file_exists($package_path)) {
include $package_path;
$found = TRUE;
break;
}
}
}
if ($found !== TRUE) {
show_error('Unable to load the requested language file: language/' . $idiom . '/' . $langfile);
}
if (!isset($lang) or !is_array($lang)) {
log_message('error', 'Language file contains no data: language/' . $idiom . '/' . $langfile);
if ($return === TRUE) {
return array();
}
return;
}
if ($return === TRUE) {
return $lang;
}
$this->is_loaded[$langfile] = $idiom;
$this->language = array_merge($this->language, $lang);
log_message('info', 'Language file loaded: language/' . $idiom . '/' . $langfile);
return TRUE;
} public function load($langfile, $lang = '', $return = FALSE, $_module = NULL)
{
if (is_array($langfile)) {
return $this->load_many($langfile);
}
$deft_lang = CI::$APP->config->item('language');
$idiom = $lang == '' ? $deft_lang : $lang;
if (in_array($langfile . '_lang', $this->is_loaded, TRUE)) {
return $this->language;
}
$_module or $_module = CI::$APP->router->fetch_module();
list($path, $_langfile) = Modules::find($langfile . '_lang', $_module, 'language/' . $idiom . '/');
// Falls back to a default language if the current language file is missing.
if ($path === FALSE && FALLBACK_LANGUAGE) {
list($path, $_langfile) = Modules::find($langfile . '_lang', $_module, 'language/' . FALLBACK_LANGUAGE . '/');
}
if ($path === FALSE) {
if ($lang = parent::load($langfile, $lang, $return)) {
return $lang;
}
} else {
if ($lang = Modules::load_file($_langfile, $path, 'lang')) {
if ($return) {
return $lang;
}
$this->language = array_merge($this->language, $lang);
$this->is_loaded[] = $langfile . '_lang';
unset($lang);
}
}
return $this->language;
}
