Многоязычность субдоменов и URL-правила

Это руководство предназначено для более-менее продвинутых пользователей. Если вы только что начали работу с Yii Framework-ом, вам стоит вернутся на эту страницу позднее :-)

Некоторые размышления

В Yii мы обычно определяем статические правила маршрутизации (url-rules) в основном конфигурационном файле. В настоящее время в Yii нет встроенной поддержки субдоменов и динамических маршрутов. При разработке многоязычного приложения, вы обычно определяете url-правила на английском языке, независимо от языка клиента. Это хорошо работает, но для профессиональных сайтов и порталов — вы можете использовать совершенно другой подход!

Давайте представим что мы создаем сайт на двух языках (английском и немецком). Правила для страницы «контакты» скорее всего выглядело бы следующим образом:

<?php
...
 
'components' => array(
  'urlManager' => array(
    'rules' => array(
      'contact' => 'site/contact',
    ),
  ),
),
 
...
?>

Доступ к странице мы могли бы получить по ссылке:

http://www.example.com/contact

Теперь подумаем как сделать вот так:

http://en.example.com/contact  
http://de.example.com/kontakt

Как вы видите, мы используем субдомен — как определитель языка пользователя (EN – для английскойго, DE – для немецкого) и слово «Контакт» как url-правило. Как я уже говорил ранее, такой подход Yii не поддерживает.

Прежде чем я покажу вам решение — ознакомтесь со всеми недостатками и приемуществами. Оцените самостоятельно стоит ли использовать данный подход для ваших приложений.

Недостатки

• Если вы используете субдомены для размещения основной информации на них, это скорее всего приведет к падению вашего PageRank основного домена. (например example.com вероятно пострадает)
• Google заявляет что лучше использовать домен верхнего уровня вместо субдоменов. Так что если вы являетесь владельцем example.com , example.de – тогда вы не должны использовать данный подход. Но вы конечно можете переписать часть кода под работы с доменами верхнего уровня, вместо субдоменов.

• Для небольших сайтов нет смысла использовать данный подход. Реальное приемущество вы получите на веб-сайтах с посещаемостью не меньше чем 10 000 уникалов в сутки.

Приемущества

• Вы можете развить ваш сайт в реальный многоязычный портал, как например YouTube, и проверять статистику с одно аккаунта Google Analytics для разных субдоменов.
• Google будет отображать ссылки (http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=47334) для каждого языка. Это правильнее с точки зрения SEO
• Пользователи будут счастливы :)

Решение

Создадим новый компонент, который будет включать в себя все необходимые свойства и функции:

<?php
 
class I18n extends CApplicationComponent
{
 
    public $supportedLanguages;
    public $urlRulesPath;
    public $activeLanguage;
 
    public function init()
    {
 
        if (true === (bool)preg_match("/^(?<protocol>(http|https):\/\/)(((?<languageCode>[a-z]{2})\.)*)((.*\.)*(?<domain>.+\.[a-z]+))$/", Yii::app()->request->hostInfo, $matches))
        {
 
            if (2 !== strlen($matches['languageCode']) && false !== ($language = $this->isSupportedLanguage($matches['languageCode'])))
            {
                $this->activeLanguage = $language;  
            }
            else
            {
 
                $this->activeLanguage = $this->guessClientLanguage();
 
                $redirectUrl = "{$matches['protocol']}{$this->activeLanguage['code']}.{$matches['domain']}";
 
            }
 
        }
        else
        {
            throw new CException("Unable to parse host info - please request this page with a domain (eg http://example.com/) instead of an ip-address!");
        }
 
        Yii::app()->setLanguage($this->activeLanguage['code']);
 
        Yii::app()->urlManager->rules = include("{$this->urlRulesPath}/{$this->activeLanguage['code']}.php");
 
        if (false !== Yii::app()->urlManager->cacheID && null !== ($cache = Yii::app()->getComponent(Yii::app()->urlManager->cacheID)))
        {
            $keyPrefix = $cache->keyPrefix;
            $cache->keyPrefix = "{$keyPrefix}.{$this->activeLanguage['code']}";
            Yii::app()->urlManager->init();
            $cache->keyPrefix = $keyPrefix;                 
        }
        else
        {
            Yii::app()->urlManager->init();
        }
 
        if (true === isset($redirectUrl))
        {
            Yii::app()->request->redirect($redirectUrl);
        }
 
    }
 
    public function guessClientLanguage()
    {
 
        if (false === isset($_SERVER['HTTP_ACCEPT_LANGUAGE']) || false === (bool)preg_match("/([a-z]{2}+)[-_][A-z]{2}+/", $_SERVER['HTTP_ACCEPT_LANGUAGE'], $match) || false === ($language = $this->isSupportedLanguage($match[1])))
        {
            if (false === ($language = $this->getFallbackLanguage()))
            {
                throw new CException("Unable to return the fallback language - please set it in config!");
            }
        }
 
        return $language;
 
    }
 
    public function getFallbackLanguage()
    {
 
        foreach ($this->supportedLanguages as $supportedLanguage)
        {
            if (true === isset($supportedLanguage['fallback']) && true === $supportedLanguage['fallback'])
            {
                return $supportedLanguage;
            }
        }
 
        return false;
 
    }
 
    public function isSupportedLanguage($languageCode)
    {
 
        foreach ($this->supportedLanguages as $supportedLanguage)
        {
            if ($supportedLanguage['code'] === $languageCode)
            {
                return $supportedLanguage;
            }
        }
 
        return false;
 
    }
 
}
 
?>

В основной конфигурации мы добавим этот компонент в массив предварительной загрузки:

<?php
...
 
preload => array('log', 'i18n'),
 
...
?>

Еще нам требуется добавить компонент в тело конфигурационнго файла, с описанием основных параметров работы:

<?php
...
 
'components' => array(
  'i18n' => array(
    'class' => 'I18n',
    'urlRulesPath' => dirname(__FILE__) . '/i18n/urlRules',
    'supportedLanguages' => array(
      array('code' => 'en', 'name' => 'english', 'fallback' => true),
      array('code' => 'de', 'name' => 'german'),
    ),
  ),
),
 
...
?>

Файлы правил маршрутизации (protected/i18n/urlRules/*.php ) должны иметь примерно следующий формат:

<?php
 
/* ../protected/i18n/urlRules/de.php */
 
return array(
  'kontakt' => 'site/contact',
)

Вывод

Не стесняйтесь поделиться своими мыслями и замечаниями! Спасибо.

• Оригинал "I18n subdomains and url-rules" [англ]