Встановлення та налаштування Contao CMS у середовищі ServBay

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

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

Що таке Contao?

Contao — це сучасна, PHP-орієнтована система керування контентом (CMS) з відкритим кодом, відома своєю зручністю, гнучкістю й потужною адміністративною панеллю. Вона підтримує розширене керування правами, версіонування, багатомовність, адаптивну обробку зображень та модульну архітектуру, що дає змогу легко розширювати функціонал через додатки. Головна ідея Contao — забезпечити міцну основу для розробників і дизайнерів, щоб створювати унікальні сайти без необхідності починати з нуля.

Необхідні передумови

Перед початком встановлення Contao перевірте такі умови:

1. Встановлений і запущений ServBay: На вашому macOS має бути встановлено ServBay. Переконайтеся, що додаток запущений, увімкнано необхідну версію PHP (див. офіційну документацію Contao щодо версій) та одну з баз даних (наприклад, MySQL або MariaDB).
2. Composer: У ServBay Composer уже інтегровано — додатково нічого встановлювати не потрібно.
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, у каталозі проєкту виконайте:

composer create-project contao/managed-edition .

Ця команда завантажить останню версію Contao Managed Edition з усіма залежностями до поточної теки (.). Процес може тривати певний час залежно від швидкості інтернету.

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

Крок 3: Створення бази даних і користувача

Contao зберігає свій контент і налаштування у базі даних. У ServBay для її керування вбудовано інструменти, як-от phpMyAdmin або Adminer. Розглянемо приклад із phpMyAdmin:

1. Відкрийте phpMyAdmin, що йде у комплекті з ServBay

   У браузері перейдіть за адресою https://servbay.host/ та виберіть посилання на phpMyAdmin.

2. Створення користувача БД

   Для безпеки рекомендується створити окремого користувача для Contao.

   a. Перейдіть на сторінку облікових записів користувачів

   На головній сторінці phpMyAdmin оберіть вкладку «Користувачі».
   

   b. Додайте нового користувача

   Натисніть «Додати користувача». Заповніть наступні поля:
   
   *   **Ім'я користувача:** Введіть бажаний логін, наприклад `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: Виберіть сумісну з вимогами Contao (деталі — у документації Contao).
   • Кореневий каталог сайту: Дуже важливий момент! Для проєктів, створених через contao/managed-edition, публічний каталог — це web усередині вашого проєкту. Вкажіть повний шлях: /Applications/ServBay/www/servbay-contao-app/web.

3. Збережіть налаштування

   Після заповнення натисніть «Зберегти» внизу вікна ServBay і дочекайтеся застосування змін.

Крок 5: Запуск веб-установника Contao

Сайт налаштований, тож тепер можна запускати установку Contao через браузер.

1. Відкрийте сторінку установника

   У браузері зайдіть на вказаний при конфігурації домен із шляхом /contao/install. Наприклад: https://servbay-contao.local/contao/install.

   Якщо все зроблено правильно, з’явиться сторінка установника Contao.

2. Введіть дані доступу до БД

   На відповідному кроці введіть такі дані, створені раніше:

   • Сервер бази даних: localhost
   • Ім'я бази даних: contao_user (якщо ви так назвали БД)
   • Ім'я користувача: contao_user
   • Пароль: Пароль, вказаний для contao_user

3. Налаштуйте обліковий запис адміністратора

   Дотримуйтесь підказок майстра — задайте логін, пароль і email для адміністратора бекенду. Використовуйте складний пароль!

4. Завершіть інсталяцію

   Виконайте всі подальші кроки установника, зокрема створення структури таблиць у БД. Натискайте відповідні кнопки («Встановити», «Готово» тощо) для завершення процесу.

Крок 6: Перевірка інсталяції та вхід до адмінки

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

1. Доступ до головної сторінки

   У браузері відкрийте налаштований домен, наприклад https://servbay-contao.local/. Має відобразитися стандартна привітальна сторінка Contao або порожній шаблон (залежить від стандартної конфігурації), що означає правильну роботу сервера та доступність фронтенду.

2. Доступ до адміністративної панелі Contao

   Перейдіть на сторінку входу адміністрування зазвичай за адресою https://servbay-contao.local/contao.

   Увійдіть із даними адміністратора, вказаними на попередньому кроці. Після успішного входу ви потрапите до бекенду Contao, де зможете створювати контент, встановлювати розширення та налаштовувати сайт.

Поширені питання (FAQ)

Q: Що робити, якщо при доступі до https://servbay-contao.local/ чи https://servbay-contao.local/contao/install виникає помилка?

A:

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

Q: Відмовляє з'єднання з базою даних — що робити?

A:

• Переконайтеся, що база даних працює: Перевірте статус MySQL/MariaDB або PostgreSQL у ServBay.
• Перевірте налаштовані дані: Введіть у Contao ті самі параметри (хост, назва БД, користувач, пароль), які були задані у phpMyAdmin.
• Перевірте права користувача: Користувач БД має мати всі необхідні привілеї на доступ до бази даних Contao.

Q: Під час встановлення виникають помилки з правами доступу — як вирішити?

A: Установник 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.