Установка и обновление TYPO3¶

Об этом документе¶

Это руководство должно помочь в установке и обновлении локальной установкиTYPO3. Оно предназначено для начинающих вTYPO3, работающих администраторами проектов.

Надеемся, что руководство окажется полезным. При нахождении ошибок, опечаток или ошибочных, по Вашему мнению, сведений, сообщайте на http://forge.typo3.org/projects/typo3v4-doc_guide_install/issues . Заранее благодарим!

Нововведения¶

Обновление шаблона руководства и использование изображений дляTYPO3 версии4.5.

Составители¶

Изначально руководство было написаноKasper Skårhøj и на данный момент сохраняется в актуальном состоянии усилиями команды по документации.

Обратная связь¶

По общим вопросам о документации, пишите на documentation@typo3.org .

Если найдена ошибка в этом руководстве, опишите проблему по данному руководству в системе отслеживания ошибок: http://forge.typo3.org/projects/typo3v4-doc_guide_install/issues

Поддержка качественной документации является тяжелой работой, и команде по документации всегда нужны добровольцы. Если Вы желаете помочь, присоединяйтесь к списку рассылок (typo3.projects.documentation на lists.typo3.org).

1-2-3¶

Скачайте подходящий под требования пакет с http://typo3.org/download/packages/ (если не знаете, какой пакет нужно использовать, обратитесь к разделу“Выбор пакета и формата файлов" данного руководства).

Загрузите содержимое скачанного пакета на свой веб сервер.

Совет

в пакете находятся тысячи файлов, поэтомулучшераспаковать пакет непосредственно на сервере!

Зайдите на свой сайт из браузера и следуйте шагам вInstall Tool ( http://www.example.com/typo3/install/index.php?mode=123&step=1 ).Install Toolпоможет в следующем:

настроить имя пользователя/пароль/базу данныхMySQL,

создать необходимое содержимое базы данных по умолчанию и

проверить соответствие необходимых настроек установленногоPHP. Это описывается далее.

По завершении мастераInstall Tool необходимо серьезно отнестись к защите папкиtypo3install/паролем, либо просто удалить из нее файлENABLE_INSTALL_TOOL.Этот файл автоматиче­ски удаляется спустя один час.

Install Tool (инструмент установки)¶

Install Tool находится в папке'typo3/install/' и автоматиче­ски переходит в режим"1-2-3" с паролем'joh316', если база данных для сайта еще не настроена.

Другими словами, вот что Вы увидите:

Нажмите"Continue".

Введите учетные данные своей базы данных.

Создайте дляTYPO3 новую базу данных или воспользуйтесь существующей пустой базой данных.

Импортируйте таблицы базы данных по умолчанию.

Основная настройка на этом завершена.

По завершении основной процедуры установки, ядроTYPO3 будет работать. Но еще остались не настроенными некоторые параметры. Поэтому мы рекомендуем перейти вinstall tool в обычном режиме для изменения пароля кinstall tool и детальной проверки своей установки. Для этого щелкните по ссылке"Configure TYPO3".

С дополнительной информацией можно ознакомиться в разделе"Установка в деталях", и подразделе"Install Tool" далее.

Выбор пакета и формата файлов¶

TYPO3 доступна в различных "пакетах", каждый из которых доступен в различных форматах.

Описание состава архивов¶

Эффективное использо­вание архивов с пакетами¶

Архивы.tar.gz для пакетаSourceимеют преимущество перед архивами.zip: они сокращают используемое файлами пространство и упрощают обслуживание при правильном использо­вании. Вот, что мы предлагаем:

Извлеките где-либо на сервере файл.tar.gz.

Создайте символическую ссылку из корневой директории своего веб-сайта на папку с ядром системы. Назовите ее'typo3_src':

После чего создайте ссылки на файлindex.php, папкиt3lib/ иtypo3/, как показано выше. Обратите внимание, что это ссылки, использующие созданную до этого ссылкуtypo3_src (в большинстве доступных на текущий момент пакетахDummy, эти символические ссылки уже включены по умол­чанию, остается лишь создать/изменить ссылкуtypo3_src, указав в ней директорию на ядро системы).

Install Tool¶

Новый сайт наTYPO3 можно установить либо используя мастер1-2-3, как было описано выше в разделе"Быстрая установка", либо воспользоваться детальной установкой параметров в расширенном режимеinstall tool. Расширенные параметры описаны здесь.

Сначала перейдите на свой сайт и войдите вinstall tool ( http://www.example.com/typo3/install ).

1: Резервирование¶

Необходимо сделать резервные копии как папок с файлами, так и базы данных. Возможно сначала Вы решите обновить копию своего сайта, если изменений в работе системы было очень много. Обратитесь кChangeLog.

2: Установка нового ядра системы¶

Обновите распространяемые файлы ядра системы их новыми версиями.

• При использовании архивов.tar.gz для файлов ядра системы:просто извлеките пакет на свой веб сервер и переназначьте симлинкtypo3_src.
• При использовании архивов.zip для файлов ядра системы:Загрузите пакетzip ядра системы, извлеките его и скопируйте (с перезаписью) его содержимое в корневую папкусвоей системыTYPO3.

3: Использование мастера обновления (upgrade wizard)¶

Войдите вInstall Tool, дополнив адрес своегоTYPO3сайта строчкой'.../typo3/install/'.

(если появились проблемы с паролем/доступом, обратитесь к разделу этого документа, посвященномуInstall Tool).

Для облегчения обновленияTYPO3 предоставляет мастер обновления (upgrade wizard). Перейдите в раздел“Upgrade Wizard” и просмотрите различные предлагаемые мастера. Начать нужно с мастера“Version Compatibility”, который установит совместимостьTYPO3на новую версию. После чего Вы будете перенаправлены к следующему мастеру. Обратите внимание, что некоторые мастера предлагают не обязательные возможности, по, например, установке системных расширений (simulate static илиopen docs), которые, возможно и не нужны в текущей установке, поэтому внимательно используйте мастеров.

4: Сравнение и обновление базы данных¶

Перейдите к разделу"Database Analyser". Здесь можно проверить настройки базы данных и, при необходимости скорректировать их.

Щелкните"Compare". При этом читаются все файлыext_tables.sql из ядра и расширений и сравниваются с содержимым таблиц и полей текущей базы данных. Будут показаны любые несоответствия и появится возможность выполнить соответствующие запросы, исправляющие любые несоответствия в существующих таблицах требуемой для новой версииTYPO3структуре таблиц.

Внимание

Не забудьте о полях и/или таблицах, добавленных самостоятельно в базу данныхTYPO3 для собственных целей! Такие таблицы и поля будут удалены только если специально отметить их для удаления, конечно же, но будьте начеку и не забывайте о них!

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

Если все изменения внесены вTYPO3, то после щелчка по"Write to database" будет показано следующее сообщение:

5: Установка новых статических таблиц и таблиц описания ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Таблица'static_template' (и некоторые другие таблицы"static_") содержит информацию, которую никогда нельзя изменять самостоятельно. Здесь содержится статическая информация, распространяемая с выпускамиTYPO3. Для обновления информации в упомянутых таблицах воспользуйтесь следующими шагами.

Перейдите в раздел" Database Analyser ".

Щелкните" IMPORT " в строке" Dump static data ":

Затем установите флажок"Import the whole file..." и щелкните"Write to database":

…после чего должно появиться следующее:

6: Очистка кешей, временных файлов и пользовательских настроек ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Всегда нужно очищать кеш таблиц. Перейдите в"Database Analyser" → "Clear tables" и выберете таблицы, начинающиеся с"cache_". Затем нажмите"Write to database".

После обновления на новую основную версию, кроме того нужно удалить временные файлы, которыеTYPO3 сохраняет в папкеtypo3temp/. Перейдите в"Clean up" и сделайте это.

Может также понадобиться очистка настроек внутренних пользователей. Проблемы могут возникнуть, если что-то при обновлении требует этого. Перейдите в"Database Analyser" → "Reset user preferences" и запишите в базу данных.

7: Удаление файлов"temp_CACHED_"¶

Вtypo3conf/ скорее всего будут находится файлы кешаext_localconf.php иext_tables.php. Они также должны быть удалены.

Все файлы в директорииtypo3conf/, имеющие в названии"temp_CACHED_*_ext_localconf.php" или"temp_CACHED_*_ext_tables.php" должны быть удалены"

Проще всего сделать это при помощи ссылки, находящейся в правом верхнем углу внутреннего интер­фейса при авторизации под пользователем администратором. Откройте меню"Очистить кеш" (Clear cache) и щелкните "Очистить кеш настроек" (Clear configuration cache):

Но таким методом будут удалены лишь два файла"temp_CACHED_" изtypo3conf/. Если их больше, то остальные нужно удалить вручную, либо воспользоваться расширением"extdeveval"!

8: ПроверкаChangeLogиNEWS.txt¶

Просмотрите файлыChangeLogиNEWS.txt в корневой папкеTYPO3. Здесь можно почерпнуть идеи о новых интересных функциях.

Особенно внимательно отнеситесь к строкам, начинающимся с"!!!". Это важно, так как они говорят об изменениях, затрагивающих работу некоторых веб сайтов.

Файлы кеша вtypo3conf/¶

В общем нужно знать, чтоTYPO3 формирует временные "кешируемые" сценарии вtypo3conf/. Это выглядит так:

-rw-r--r--   1 www-data   www-data   61555  2011-01-11 16:28   temp_CACHED_ps3f58_ext_localconf.php
-rw-r--r--   1 www-data   www-data   81995  2011-01-11 16:28   temp_CACHED_ps3f58_ext_tables.php
-rw-r--r--   1 www-data   www-data   47098  2011-01-11 16:28   temp_CACHED_FE_ps3f58_ext_localconf.php
-rw-r--r--   1 www-data   www-data   45517  2011-01-11 16:28   temp_CACHED_FE_ps3f58_ext_tables.php

Могут появиться и другие подобные файлы. Это может произойти из-за дублирования путей, симлинков, либо это просто старые файлы.

Эти файлы могут быть удалены в любое время, они будут воссозданы при следующем обращении к системе. Эти файлы просто включают все файлыext_tables.php иext_localconf.php из установленных расширений, объединенных в порядке загрузки. Поэтому, включение одного такого большого файлаPHPравнозначно включению сотен маленьких, но экономит несколько милисекунд системе.

В версии 4.3TYPO3появились файлы"temp_CACHED_FE". Они содержат файлыext_tables.php иext_localconf.php только тех расширений, которые нужны для формирования выводимого во внешний интер­фейс. Поэтому эти файлы меньше, чем файлыtemp_CACHED для всех расширений, это сохраняет еще несколько милисекунд.

Относительно этих файлов нужно знать следующее:

a) Вносить в них изменения не имеет смысла, так как они в любое время могут быть воссозданы из "оригиналов". Вместо этого изменять нужно "оригиналы".

b) Сделав изменения в оригинальных файлах"ext_tables.php" или"ext_localconf.php", необходимо очистить файлы кеша, чтобы изменения были приняты во внимание!

Возможные проблемы с файлами кеша¶

КешиPHP, классы расширений и т.п.¶

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

• Расширение переназначает классы, функции в которых были изменены.Решение: попытайтесь отключить все расширения и подключать их одно за одним, пока проблема не возникнет снова.
• КешPHP имеет ошибки при повторном кешировании сценариев, в частности, если изменения произошли в родительском классе, переназначаемом классом потомком, который не был обновлен.Решение: удалите ВСЕ кешируемые файлыPHP (дляPHP-Accelerator, удалите"/tmp/phpa_*") и перезапуститеApache.

Изменение настроек по обработке изображений¶

При изменении настроек по обработке изображений (в обычно режиме), нужно принять во внимание, что старые изображения все еще могут остаться в папкеtypo3temp/, что может помешать формированию новых файлов! Это особенно важно знать, если Вы впервые настраиваете обработку изображений.

Проблема решается очисткой файлов в папкеtypo3temp/. Также убедитесь, что очищена таблица"cache_pages" в базе данных.