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

Огляд

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

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

Цей посібник детально описує, як встановити та налаштувати проект Craft CMS у ServBay.

Передумови

Перед початком роботи переконайтеся, що у вас виконані такі умови:

1. Встановлений та запущений ServBay: Переконайтеся, що ви успішно встановили ServBay на macOS, і потрібна версія PHP (Craft CMS має вимоги до версії — перегляньте офіційну документацію Craft CMS) та СУБД (зазвичай MySQL або PostgreSQL) вже активовані. ServBay підтримує кілька версій PHP і баз даних, які легко перемикати й налаштовувати згідно потреб Craft CMS.
2. Базові навички командного рядка: Вам потрібно буде використовувати термінал для виконання деяких команд, наприклад, створення директорій та запуску Composer.
3. Знання Composer: Craft CMS керує залежностями через Composer. У ServBay Composer вже встановлений, вам лише потрібно вміти виконувати команду composer create-project.

Кроки встановлення Craft CMS

Ось детальна інструкція, як встановити та налаштувати Craft CMS у середовищі ServBay.

Крок 1: Створення теки проекту

Спочатку створіть нову теку для проекту в типовому кореневому каталозі сайтів ServBay /Applications/ServBay/www. ServBay налаштовує цю директорію як кореневу для роботи веб-сервера, тож ви зручно будете мати доступ до проекту.

Відкрийте термінал і виконайте команди:

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

Цим ви створите нову папку servbay-craft-app у /Applications/ServBay/www та перейдете до неї.

Крок 2: Створення проекту Craft CMS через Composer

У ServBay вже встановлено Composer, тому ви можете одразу використати його для створення проекту Craft CMS у папці проекту. Розробники Craft рекомендують саме цей метод встановлення.

У каталозі servbay-craft-app виконайте команду:

composer create-project craftcms/craft .

Ця команда завантажить останню версію Craft CMS і всі залежності у поточну директорію (.). Дочекайтеся завершення процесу завантаження та встановлення.

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

Craft CMS потребує базу даних для збереження контенту та налаштувань. Для створення бази даних і користувача скористайтеся phpMyAdmin або Adminer, що встановлені з ServBay. Далі — приклад роботи з phpMyAdmin.

1. Відкрийте панель керування базою даних (phpMyAdmin)

   Відкрийте браузер та перейдіть у локальну панель розробника ServBay: https://servbay.host/. Знайдіть у ній посилання на «phpMyAdmin» і відкрийте цей інструмент керування базами даних.

   Порада: Типовий користувач для доступу в phpMyAdmin у ServBay — root, а стандартний пароль — ServBay.dev. Для безпеки одразу змініть пароль root або створіть нового адміністратора.

2. Створіть окремого користувача для бази даних

   Використання root для підключення Craft CMS не рекомендується через міркування безпеки; краще для кожної програми заводити окремий користувацький обліковий запис.

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

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

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

      Натисніть «Додати користувача» та заповніть такі поля:

      • Ім'я користувача: Наприклад, craft_user для підключення Craft CMS.
      • Хост: Виберіть localhost (або «локально»), щоб обліковий запис працював тільки з локальних підключень.
      • Пароль: Вигадайте надійний пароль. Не використовуйте показаний у прикладі password123, навіть для локального розроблення; хоч у тестовому середовищі можна спрощувати, пам'ятайте про базову безпеку.
      • Підтвердження пароля: Введіть його повторно.
      • У секції «Призначити базу даних для користувача» виберіть «Створити базу даних із тим же ім'ям та надати всі привілеї». Це створює БД craft_user та надає користувачу craft_user повний доступ до неї.
      • Переконайтеся, що обрано «Надати всі привілеї».
      • Внизу натисніть «Виконати».

   Тепер у вас є користувач бази даних з ім'ям craft_user та база craft_user із відповідними правами.

Крок 4: Налаштування веб-сервера (Додавання сайту в ServBay)

Щоб веб-сервер (Caddy або Nginx), який використовує ServBay, обслуговував ваш Craft CMS проект, необхідно додати сайт у налаштуваннях ServBay.

1. Запустіть застосунок ServBay

   Відкрийте додаток ServBay.

2. Додайте новий сайт

   В навігації зліва оберіть вкладку «Сайти» (у старих версіях — «Хости»), далі натисніть кнопку «+» або «Додати сайт».

   Заповніть такі поля:

   • Назва (Name): Дайте вашому сайту зручну назву, наприклад My Craft Site.
   • Домен (Domains): Придумайте локальний домен для сайту, наприклад servbay-craft.local. ServBay автоматично налаштує локальний DNS.
   • Тип сайту (Type): Виберіть PHP.
   • Версія PHP (PHP Version): Оберіть версію PHP, яку ви обрали відповідно до вимог Craft CMS. ServBay підтримує одночасну роботу кількох версій PHP.
   • Корінь сайта (Website Root): ВАЖЛИВО: публічно доступні файли Craft CMS (наприклад, index.php) знаходяться у підкаталозі web проекту. Для безпеки вкажіть саме цю теку як корінь, а не всю папку проекту. Вкажіть: /Applications/ServBay/www/servbay-craft-app/web Обов’язково переконайтеся у правильності вказаної директори та шляху до web, яку створили на Кроці 1.

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

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

Крок 5: Запуск майстра встановлення Craft CMS

Тепер ви можете запустити майстер встановлення Craft CMS через браузер, перейшовши на налаштований домен.

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

   У браузері введіть адресу https://servbay-craft.local/. Craft CMS визначить відсутність встановлення і автоматично переадресує вас на сторінку інсталяції, зазвичай це https://servbay-craft.local/index.php?p=admin/install.

2. Заповніть дані для підключення до бази даних

   На цьому кроці введіть актуальні дані:

   • Сервер бази даних (Database Server): localhost
   • Ім'я бази даних (Database Name): craft_user (або ту, яку ви створили на Кроці 3)
   • Ім'я користувача (Username): craft_user (або відповідного користувача)
   • Пароль (Password): пароль, заданий для користувача на Кроці 3.

   Натисніть «Продовжити». Якщо підключення успішне, ви перейдете до наступного етапу.

3. Створіть обліковий запис адміністратора

   Дотримуйтеся підказок на сторінці: задайте ім’я користувача, безпечний пароль та e-mail для адміністраторського облікового запису.

   Натисніть «Продовжити».

4. Налаштування сайту

   Заповніть назву сайту та іншу базову інформацію.

   Натисніть кнопку «Завершити встановлення (Finish Up)». Craft CMS завершить усі необхідні операції — створить таблиці БД, налаштує файли конфігурації.

   Після завершення ви автоматично потрапите на сторінку авторизації в адмін-розділ Craft CMS.

Крок 6: Початкове налаштування та вивчення можливостей

Після входу в адмін-панель Craft CMS можна виконати початкове налаштування та ознайомитися з системою:

1. Перевірте файл .env: Craft CMS зберігає налаштування середовища (зокрема підключення до БД) у файлі .env. Він автоматично створюється під час встановлення та знаходиться у корені проекту (servbay-craft-app/). Тут можна, наприклад, виставити змінну CRAFT_ENVIRONMENT у значення dev.
2. Встановіть потрібні плагіни: В адмінці, у розділі «Плагіни (Plugins)», можна переглядати, встановлювати та керувати розширеннями Craft CMS для розширення функціоналу.
3. Створіть структуру контенту: У розділі «Налаштування (Settings)» налаштовуйте поля, секції (Sections), категорії (Categories), теги (Tags) та інші структури.
4. Налаштуйте відправку пошти: Якщо потрібно тестувати відправку листів локально, налаштуйте Craft CMS на використання вбудованих у ServBay Mailpit або Mailhog. У файлі .env або розділі поштових налаштувань Craft вкажіть спосіб надсилання — SMTP; сервер localhost, а порт відправки шукайте у панелі ServBay.

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

• Питання: Що робити, якщо виникає помилка підключення до бази даних під час встановлення?
  • Відповідь: Переконайтеся, що дані підключення (адреса localhost, назва бази, ім'я користувача та пароль) точно збігаються з тими, що ви створили у phpMyAdmin. Перевірте, чи запущено в ServBay службу бази (MySQL або PostgreSQL).
• Питання: Чому при переході на servbay-craft.local з'являється 404 або порожня сторінка?
  • Відповідь:
    • Перевірте, що в налаштуваннях нового сайту корінь вказано точно як /Applications/ServBay/www/servbay-craft-app/web — це найчастіша помилка.
    • Переконайтеся, що служби веб-сервера (Caddy або Nginx) та PHP працюють у ServBay.
    • Перевірте, що сайт з доменом servbay-craft.local у ServBay активний.
• Питання: Композер дуже повільно або не встановлює Craft CMS — що робити?
  • Відповідь: Ймовірно, є проблеми з мережею або дзеркалом Composer. Спробуйте перемкнути Composer на альтернативне дзеркало, наприклад, Alibaba чи Packagist China.
• Питання: Після встановлення на адмін-або фронт-енд сторінках відсутній стиль чи не відображаються зображення?
  • Відповідь: Це зазвичай пов’язано із правами на файли. Перевірте, що користувач, під яким працює ServBay, має права запису у storage і web/cpresources. ServBay зазвичай сам коректно налаштовує права, але якщо ні, вручну виправте це або скиньте права.

Підсумок

Дотримуючись вищенаведених інструкцій, ви успішно встановите та налаштуєте Craft CMS у середовищі локальної розробки ServBay. Завдяки інтегрованому підходу ServBay керування версіями PHP, налаштуванням бази й веб-серверу значно спрощується, тож ви можете зосередитися на розробці саме під Craft CMS. Тепер можна сповна використовувати всі переваги Craft CMS для створення власного сайту чи додатку!