Многоязычная поддержка в CodeIgniter

Многоязычная поддержка, также известная как интернационализация, является ключевой особенностью современных веб-приложений. Большинство полнофункциональных PHP-фреймворков поставляются с многоязыковой поддержкой, которая позволяет нам динамически представлять интерфейс нашего приложения на разных языках без дублирования существующего исходного кода для каждого языка. Сегодня мы обсудим, как мы можем включить несколько языков с помощью CodeIgniter, а также несколько трюков для настройки основных функций.

Настройка многоязычной поддержки

Сначала нам нужно настроить необходимые файлы, прежде чем мы сможем начать использовать языковую поддержку. Файл конфигурации CodeIgniter, расположенный в каталоге application/config , содержит опцию language, которая определяет язык приложения по умолчанию.

 <?php $config['language'] = 'english'; 

Нам также необходимо создать фактические файлы, которые содержат наши сообщения на разных языках. Эти файлы должны быть помещены в каталог application/language с отдельным каталогом для каждого языка. Например, файлы на английском языке должны находиться в каталоге application/language/english , а файлы на французском языке должны находиться в application/language/french .

Давайте создадим несколько языковых файлов, которые содержат сообщения об ошибках для примера приложения. Создайте файл english/message_lang.php (важно, чтобы все языковые файлы имели суффикс _lang.php ). Следующий код содержит несколько примеров записей для содержимого нашего языкового файла:

 <?php $lang["msg_first_name"] = "First Name"; $lang["msg_last_name"] = "Last Name"; $lang["msg_dob"] = "Date of Birth"; $lang["msg_address"] = "Address"; 

Конечно, вы можете иметь несколько языковых файлов внутри одного языкового каталога. Рекомендуется группировать ваши сообщения в разные файлы в зависимости от их контекста и предназначения, а также для префиксов ключей сообщений использовать ключевое слово для конкретного файла.

Другой способ — создать отдельные файлы сообщений для каждого контроллера. Преимущество этого метода заключается в том, что вместо целого языкового файла загружаются только необходимые сообщения, что может привести к определенному снижению производительности.

Загрузка языковых файлов

Даже если мы создаем языковые файлы, они не работают, пока мы не загрузим их внутри контроллеров. Следующий код показывает, как мы можем загрузить файлы внутри контроллера:

 <?php class TestLanguage extends CI_Controller { public function __construct() { parent::__construct(); $this->lang->load("message","english"); } function index() { $data["language_msg"] = $this->lang->line("msg_hello_english"); $this->load->view('language_view', $data); } } 

Мы обычно работаем с языковыми файлами внутри контроллеров и представлений (использование языковых файлов внутри моделей не такая уж хорошая вещь). Здесь мы использовали конструктор контроллера для загрузки языкового файла, чтобы его можно было использовать во всем классе, а затем мы ссылаемся на него в методе index() класса.

Первым параметром метода lang-> load () будет имя файла языка без суффикса _lang. Вторым необязательным параметром является языковой каталог. Он будет указывать на язык по умолчанию в вашей конфигурации, если он не указан здесь.

Мы можем напрямую ссылаться на записи языкового файла, используя метод lang->line() и назначить его возврат для данных, передаваемых в шаблоны представления. Внутри представления мы можем использовать вышеуказанное языковое сообщение как $language_msg .

Может быть случай, когда нам нужно загрузить языковые файлы непосредственно из представлений. Например, использование языковых элементов для меток форм может считаться хорошей причиной для прямой загрузки и доступа к сообщениям внутри представлений. Для этих файлов можно использовать тот же метод доступа, что и внутри контроллеров.

 <?php $this->lang->line("msg_hello_english"); 

Несмотря на то, что он работает отлично, может быть странно иметь $this когда наш код шаблона представления не является реальным классом. Мы также можем использовать следующий код с поддержкой языкового помощника для загрузки записей языка внутри представлений, что дает нам более чистый код.

 <?php lang("msg_view_english"); 

Это в основном все, что вам нужно знать, чтобы начать работать с языковыми файлами CodeIgniter. Но даже несмотря на то, что это достаточно просто, нет необходимости в дублировании усилий для загрузки необходимых языковых файлов в каждый из контроллеров, особенно если ваш проект содержит сотни классов. К счастью, мы можем использовать хуки CodeIgniter для создания быстрого и эффективного решения для автоматической загрузки языковых файлов для каждого контроллера.

Назначение ответственности за загрузку языка для хуков

CodeIgniter вызывает несколько встроенных хуков как часть своего процесса исполнения. Вы можете найти полный список хуков в руководстве пользователя. Мы будем использовать post_controller_constructor которая вызывается сразу после создания нашего контроллера и перед любыми другими вызовами методов.

 <?php $config['enable_hooks'] = TRUE; 

 <?php $hook['post_controller_constructor'] = array( 'class' => 'LanguageLoader', 'function' => 'initialize', 'filename' => 'LanguageLoader.php', 'filepath' => 'hooks' ); 

 <?php class LanguageLoader { function initialize() { $ci =& get_instance(); $ci->load->helper('language'); $ci->lang->load('message','english'); } } 

 <?php class LangSwitch extends CI_Controller { public function __construct() { parent::__construct(); $this->load->helper('url'); } function switchLanguage($language = "") { $language = ($language != "") ? $language : "english"; $this->session->set_userdata('site_lang', $language); redirect(base_url()); } } 

 <a href='<?php echo $base_url; ?>langswitch/switchLanguage/english'>English</a> <a href='<?php echo $base_url; ?>langswitch/switchLanguage/french'>French</a> 

 <?php class LanguageLoader { function initialize() { $ci =& get_instance(); $ci->load->helper('language'); $site_lang = $ci->session->userdata('site_lang'); if ($site_lang) { $ci->lang->load('message',$ci->session->userdata('site_lang')); } else { $ci->lang->load('message','english'); } } }