Установка и настройка Contao CMS в среде ServBay

Contao — это мощная система управления контентом (CMS) с открытым исходным кодом, идеально подходящая для создания веб-сайтов малого и среднего бизнеса, порталов и сложных веб-приложений. В этом руководстве подробно описано, как установить и настроить Contao в удобной локальной среде разработки ServBay для macOS, чтобы вы смогли быстро приступить к работе с вашим проектом на Contao.

ServBay предоставляет комплексную среду с интегрированными PHP, Composer, сервисами баз данных (такими как MySQL/MariaDB или PostgreSQL), а также веб-серверами (Caddy, Nginx, Apache), что значительно упрощает настройку локального окружения. Используя ServBay, вы с легкостью обеспечите все системные требования Contao.

Что такое Contao?

Contao — это open source CMS на основе PHP, известная своим удобным интерфейсом, высокой гибкостью и мощной административной панелью. Среди ее возможностей — тонкая система управления правами доступа, контроль версий, поддержка мультиязычности, обработка адаптивных изображений и модульная архитектура с возможностью расширения функциональности через дополнения. Основной принцип Contao — дать разработчикам и дизайнерам прочную основу для создания кастомизированных сайтов без необходимости начинать с нуля.

Предварительные требования

Перед установкой Contao убедитесь, что выполнены следующие условия:

1. ServBay установлен и запущен: Необходимо установить ServBay на свой macOS. Убедитесь, что приложение ServBay работает, необходимая версия PHP (требования к версиям смотрите в официальной документации Contao) и необходимый сервис баз данных (MySQL или MariaDB) включены в ServBay.
2. Composer: Composer уже встроен в ServBay, отдельно устанавливать не нужно.
3. Доступ к терминалу: Для выполнения команд Composer потребуется использовать терминал.

Этапы установки Contao

В этом разделе шаг за шагом объясняется, как установить и настроить Contao в ServBay.

Шаг 1: Создание директории проекта

Сначала перейдите в корневую директорию сайтов ServBay /Applications/ServBay/www и создайте новую подпапку для проекта Contao.

cd /Applications/ServBay/www
mkdir servbay-contao-app
cd servbay-contao-app

Contao будет устанавливаться в директорию servbay-contao-app.

Шаг 2: Создание проекта Contao с помощью Composer

Contao рекомендует использовать Composer для установки и управления зависимостями. Поскольку Composer уже встроен в ServBay, выполните следующую команду в директории проекта для создания нового проекта Contao:

composer create-project contao/managed-edition .

Эта команда загрузит последнюю версию Contao Managed Edition и все необходимые зависимости в текущую директорию (.). Загрузка может занять некоторое время в зависимости от скорости интернета.

Что такое Contao Managed Edition: contao/managed-edition — это официальный дистрибутив Contao, включающий ядро CMS, все рекомендуемые зависимости и стандартную структуру проекта. Важно: при установке через managed-edition корневая директория сайта будет располагаться в подпапке web вашего проекта.

Шаг 3: Создание базы данных и пользователя

Contao требует отдельную базу данных для хранения контента и настроек. ServBay предоставляет удобные инструменты управления базами данных, например phpMyAdmin или Adminer. В данном руководстве используем phpMyAdmin:

1. Откройте phpMyAdmin, входящий в состав ServBay

   Зайдите на локальный адрес ServBay: https://servbay.host/. На открывшейся странице найдите ссылку и войдите в phpMyAdmin.

2. Создайте пользователя базы данных

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

   a. Перейдите на страницу пользователей

   На главной странице phpMyAdmin кликните на вкладку «Пользовательские аккаунты» в верхнем меню.
   

   b. Добавьте нового пользователя

   Нажмите «Добавить пользователя». Заполните поля:
   
   *   **Имя пользователя:** Введите желаемое имя для соединения с базой данных Contao, например `contao_user`.
   *   **Имя хоста:** Выберите `localhost` (локальное подключение повышает безопасность).
   *   **Пароль:** Введите **сильный пароль** (не используйте простые пароли, как `password123`, это лишь пример; используйте генератор паролей для реальных проектов).
   *   **Подтверждение:** Повторите пароль.
   
   В разделе «Создать базу данных с тем же именем и выдать пользователю все права» обычно достаточно выбрать этот вариант — это создаст базу данных с тем же именем, что и пользователь (`contao_user`), и даст ему нужные права.
   
   *   Проверьте, что стоит галочка «Предоставить все права».
   *   Нажмите «Вперед» (или «Выполнить») внизу страницы для завершения создания пользователя и базы.
   

Шаг 4: Настройка сайта в ServBay

Теперь необходимо создать сайт в ServBay, указывающий на только что созданную директорию проекта Contao.

1. Откройте ServBay и добавьте новый сайт

   Запустите ServBay и перейдите на вкладку «Сайты» в левой панели. Нажмите «Добавить» для новой конфигурации сайта.

2. Заполните настройки сайта

   • Название: Придумайте понятное название, например My Contao Site.
   • Домен: Укажите локальный домен для разработки. Рекомендуется использовать окончания .local или .servbay.demo, например servbay-contao.local (ServBay автоматически настроит его для локальной работы).
   • Тип сайта: Выберите PHP.
   • Версия PHP: Укажите версию PHP, соответствующую требованиям Contao (см. документацию Contao).
   • Корневая директория сайта: Это очень важно! Для проектов, установленных через contao/managed-edition (Composer), публичные файлы (включая index.php) располагаются в подпапке web проекта. Здесь укажите полный путь до этой папки: /Applications/ServBay/www/servbay-contao-app/web.

3. Сохраните настройки

   После заполнения всех полей нажмите «Сохранить» в нижней части окна ServBay. Применится новая конфигурация сайта.

Шаг 5: Запуск веб-установщика Contao

После настройки сайта можно запустить веб-установщик Contao, воспользовавшись браузером.

1. Перейдите на страницу установки

   В браузере откройте домен, заданный в настройках сайта, добавив к нему /contao/install. Например: https://servbay-contao.local/contao/install.

   При правильной настройке откроется страница инсталляции Contao.

2. Внесите данные для подключения к базе данных

   Установщик попросит вас ввести параметры для соединения с базой данных, созданные ранее на шаге 3:

   • Хост базы данных: localhost
   • Имя базы данных: contao_user (если был выбран вариант «Создать БД с именем пользователя»)
   • Имя пользователя: contao_user
   • Пароль: тот, что был установлен ранее для пользователя contao_user.

3. Задайте данные администратора

   Следуя указаниям установщика, создайте учетные данные администратора Contao: логин, пароль, email и пр. Обязательно используйте сложный пароль.

4. Завершите установку

   Выполните оставшиеся шаги установщика (создание структуры БД и пр.). Нажимайте соответствующие кнопки («Установить», «Завершить»), чтобы закончить установку.

Шаг 6: Проверка установки и вход в административную панель

После завершения установки проверьте работу Contao и попробуйте войти в административную панель.

1. Проверьте главную страницу сайта

   Перейдите в браузере по вашему локальному домену, например: https://servbay-contao.local/. Вы должны увидеть приветственную страницу Contao либо пустую страницу (зависит от конфигурации по умолчанию). Это показывает, что сервер и Contao работают корректно.

2. Войдите в административную панель Contao

   Страница входа в админку чаще всего расположена по адресу: https://servbay-contao.local/contao.

   Авторизуйтесь, используя логин и пароль администратора, заданные на шаге 5. После входа вы попадете в административный интерфейс Contao, где сможете управлять контентом, устанавливать расширения и настраивать сайт.

Часто задаваемые вопросы (FAQ)

Вопрос: Что делать, если при переходе на https://servbay-contao.local/ или https://servbay-contao.local/contao/install возникает ошибка?

Ответ:

• Проверьте, запущен ли ServBay: Убедитесь, что приложение ServBay работает, а необходимые сервисы PHP и веб-сервер (Caddy или Nginx) активны.
• Перепроверьте настройки сайта в ServBay: Убедитесь, что правильно указаны домен, тип сайта, выбранная версия PHP и, особенно, корневая директория сайта (для contao/managed-edition это папка web в проекте).
• Проверьте работу доменного имени: ServBay автоматически настраивает домены типа .local. Если используется другой суффикс либо возникают проблемы, попробуйте перезапустить ServBay или проверьте файл hosts вашей системы (обычно ServBay управляет этим автоматически).
• Посмотрите логи веб-сервера: В ServBay доступны логи Caddy или Nginx — они могут содержать подробную информацию об ошибках.

Вопрос: Что делать при ошибке подключения к базе данных?

Ответ:

• Проверьте, работает ли служба базы данных: Убедитесь, что MySQL/MariaDB или PostgreSQL-экземпляр в ServBay активен.
• Проверьте правильность введенных данных: Проверьте, что хост (localhost), имя базы, пользователь и пароль введены верно (как создавались в phpMyAdmin).
• Проверьте права пользователя базы: Убедитесь, что у вашего пользователя есть все нужные права для работы с созданной базой Contao.

Вопрос: Как поступить, если при установке появляются ошибки доступа (прав) к папкам?

Ответ: Для работы установщик Contao требует права на запись в определенные директории. Обычно стандартные настройки ServBay подходят, но если появляются ошибки, выполните следующее в терминале в папке проекта:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # Замените your_username на свой логин macOS
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Для некоторых папок Contao нужны права на запись

Используйте chmod 777 с осторожностью! В продакшене это небезопасно, но для локальной разработки — распространенное решение проблем с доступом.

Заключение

Следуя этому руководству, вы успешно установите и настроите Contao CMS в вашей локальной среде ServBay. Интегрированная среда ServBay упрощает работу с Composer, настройку базы данных и конфигурацию веб-сервера, позволяя сконцентрироваться на разработке самого сайта на Contao. Теперь вы можете входить в админку Contao, создавать контент, проектировать страницы, устанавливать расширения и темы — и строить свой сайт.

Для более глубокого изучения работы и возможностей Contao обратитесь к официальной документации Contao.