Установка TYPO3 с помощью DDEV

Это пошаговое руководство, в котором подробно описана установка TYPO3 с помощью DDEV, Docker и Composer.

DDEV используется только для локальных разработок.

Сценарии, используемые в данном руководстве, устанавливают TYPO3 v12.0, являющуюся последней версией CMS. Если необходимо установить версию TYPO3 с долгосрочной поддержкой (LTS), посетите сайт TYPO3 v11 Installation instructions.

Контрольный перечень работ перед установкой

Установка Docker - Посетите сайт docker.com, чтобы загрузить и установить рекомендуемую версию Docker для вашей операционной системы.
Установка DDEV - Для установки DDEV следуйте руководству DDEV installation guide.

Перед установкой TYPO3 на локальной машине необходимо установить DDEV и Docker. Если вам нужна помощь в установке DDEV, поддержку можно получить на сервере DDEV Discord.

Создание каталога установки

Создайте пустой каталог для установки TYPO3, а затем перейдите в этот каталог:

mkdir t3example
cd t3example

Создание нового проекта DDEV

Команда ddev config запросит информацию о вашем проекте. TYPO3 находится в списке предварительно сконфигурированных проектов.

ddev config --php-version 8.1

# Give the following answers when prompted:

Project name (t3example):

Docroot Location (current directory): public

Create docroot at /home/myuser/projects/t3/t3example/public? [Y/n] (yes): Y

Project Type [php, typo3, ...] (php): typo3

project-type: Должен быть всегда "typo3"
docroot: Это папка, в которой хранятся все файлы, до которых должен добраться браузер. Эта папка обычно называется public.
create-docroot: Поскольку каталог еще не существует, можно позволить DDEV создать его за вас.

В качестве альтернативы можно пропустить приглашение, указав все необходимые параметры в одной команде:

ddev config  --project-type=typo3 --docroot=public --create-docroot --php-version 8.1

Запуск проекта

ddev start

Веб-сервер теперь работает, но TYPO3 не установлен.

Установка TYPO3

ddev composer create "typo3/cms-base-distribution:^12"

Так как мы только что создали проект и у нас его фактически еще нет, ответьте "да" на вопрос о том, можно ли перезаписывать файлы в этом каталоге.

Теперь у вас есть установка TYPO3 на базе Composer.

Запустите программу настройки установки Installation Setup Tool

Настройка TYPO3 в консоли

New in version 12.1

Начиная с версии TYPO3 12.1 в качестве альтернативы существующему веб-инсталлятору с графическим интерфейсом введена новая команда CLI setup.

Интерактивная / управляемая установка (вопросы/ответы):

ddev exec ./vendor/bin/typo3 setup

Установка TYPO3 с помощью 1,2,3 Install Tool в браузере

Создайте файл с названием FIRST_INSTALL в корне вашего сайта

ddev exec touch public/FIRST_INSTALL

Откройте программу установки

ddev launch typo3/install.php

Перейдите во внутренний интерфейс TYPO3:

ddev launch typo3

И войдите в систему, используя только что предоставленные учетные данные.

Управление базой данных

При вызове команды ddev config DDEV автоматически создал для вас базу данных. DDEV также создал файл config/system/additional.php, в котором сохранил учетные данные базы данных.

В процессе установки TYPO3 создала все необходимые таблицы. Если вы хотите взглянуть на базу данных, то можно выполнить следующую команду:

ddev launch -p

Отправка E-Mail

DDEV создает config/system/additional.php для имитации отправки писем. Посмотреть отправленные письма можно здесь:

ddev launch -m

Остановка экземпляра DDEV

Если необходимо остановить выполнение всех проектов, можно вызвать команду:

ddev poweroff

Проекты останутся настроенными, а базы данных сохранены.

Удаление экземпляра DDEV

Если вы решите удалить только что созданный проект, можно выполнить следующую команду в корневой папке нового проекта:

ddev delete --omit-snapshot

При этом из проекта будут удалены все контейнеры и удалена база данных.

После этого можно смело удалять корневую папку проекта.