Введение в RealURL, часть 1

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

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

Основы

Для начала необходимо чётко уяснить как работает RealURL.

RealURL приводит ссылки вида http://example.com/index.php?id=123&parameter=456 к виду http://example.com/path/to/page/parameter/whatever/. Параметр id преобразуется в путь до страницы, прочие параметры преобразуются в дополнительные сегменты пути.

После преобразования путь может состоять из нескольких частей:

Всего может быть четыре типа сегментов:

preVars
Эти сегменты идут перед путём к странице. Типичный пример: код языка (/en/)
Page path
Это путь к странице. Он формируется из названий всех страниц в дереве от корневой до текущей страницы
postVar
RealURL даёт возможность преобразовывать параметры страницы в путь. Например, если на странице отображаются новости, то вместо tx_ttnews[tt_news]=123 можно сделать /novosti/nazvanie-novosti.html. Обратите внимание на сегмент novosti. Для каждого параметра postVar создаёт пару: имя и значение.
fixedPostVars
Параметры, находящиеся после пути, но перед postVar. В отличие от postVar отсутствует имя параметра: присутствуют только значения. fixedPostVars обычно используют только на некоторых страницах.

Файл конфигурации

Конфигурация производится через PHP. Хотя существуют разные модули для настройки RealURL, они не обеспечивают гибкости или понимания тонкостей конфигурации, а без этого редко возможно создать оптимальную конфигурацию.

Обычно для конфигурации создаётся отдельный файл. Назовём его realurl_conf.php. Структура файла обычно такова:

$TYPO3_CONF_VARS['EXTCONF']['realurl'] = array(
    'www.domain1.com' => array(
        ...
    ),
    'domain1.com' => 'www.domain1.com',
    'www.domain2.com' => array(
        ...
    ),
    'domain2.com' => 'www.domain2.com'
);

В этом примере описаны четыре домена. Два из них являются самостоятельными, два — ссылками на самостоятельные. Наиболее частая ошибка конфигурации — указание только самостоятельных доменов. Симптом этой ошибки: некоторые ссылки вместо пути показываю номер страницы. Если у вас появляется такой симптом, проверьте, сконфигурировали ли вы домены как с www, так и без него.

Часть, показанная в виде многоточия в примере выше, будем называть конфигурацией домена.

В следующей статье мы расмотрим конфигурацию домена.