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

Огляд

OctoberCMS — це сучасна система управління контентом із відкритим кодом, розроблена на потужному фреймворку Laravel. Вона цінується за простоту, гнучкість та зручність для розробників. У цьому документі наведено покрокову інструкцію з встановлення та налаштування OctoberCMS у ServBay — комплексному локальному середовищі розробки для macOS, щоб ви швидко запустили власний проект на базі OctoberCMS.

Що таке OctoberCMS?

OctoberCMS пропонує інтуїтивну панель адміністратора та потужні можливості для фронтенд-розробки. Розробники можуть використовувати знайомі концепції Laravel, як-от Eloquent ORM та шаблонізатор Blade, для створення різних типів сайтів — від особистих блогів до складних корпоративних застосунків.

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

Перш ніж почати встановлення OctoberCMS, переконайтеся, що виконані такі умови:

1. На вашому Mac вже встановлено та працює ServBay.
2. У ServBay активовані та працюють пакети PHP (рекомендується версія 7.4 або новіша) та MySQL/MariaDB.
3. У ServBay активований пакет Composer.
4. Маєте базові навички роботи з командним рядком.

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

Нижче наведено детальні кроки для встановлення та налаштування OctoberCMS у середовищі ServBay:

Крок 1: Створіть директорію проекту

Спочатку перейдіть у рекомендовану root-директорію сайтів ServBay /Applications/ServBay/www та створіть нову папку для проекту OctoberCMS.

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

Крок 2: Встановіть OctoberCMS через Composer

Composer вже входить до складу ServBay. Переконайтеся в активації пакета Composer у панелі управління ServBay. У створеній директорії проекту виконайте команду для завантаження і встановлення ядра OctoberCMS:

composer create-project october/october .

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

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

OctoberCMS зберігає основну інформацію у базі даних (контент, користувачі, налаштування тощо). Ми скористаємося phpMyAdmin у складі ServBay для її створення.

1. Відкрийте phpMyAdmin, що постачається із ServBay

   Відкрийте браузер та зайдіть до локальної панелі керування ServBay: https://servbay.host/. Перейдіть за лінком до phpMyAdmin, зазвичай це https://servbay.host/phpmyadmin/.

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

   Рекомендується створювати окремого користувача та базу даних для кожного застосунку з міркувань безпеки та ізольованості.

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

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

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

      Натисніть «Add User Account» / «Додати користувача». Вкажіть наступні параметри:

      • Ім'я користувача: задайте ім'я для користувача бази, наприклад october_user.
      • Хост: оберіть localhost або 127.0.0.1 для підвищення безпеки (доступ лише з локальної машини).
      • Пароль: вкажіть надійний та унікальний пароль. Не використовуйте демонстраційні паролі на кшталт password123 на production!
      • Повторіть пароль: введіть пароль ще раз.
      • У секції про створення бази даних для користувача оберіть «Create database with same name and grant all privileges» / «Створити базу даних з іменем користувача і надати всі права». Так буде створено базу october_user, а самому користувачу надано необхідні права.
      • Перевірте, що у секції «Global privileges» встановлена опція «Grant all privileges».
      • Натисніть «Go» / «Виконати» для завершення створення користувача з базою.

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

Щоб отримати доступ до вашої програми OctoberCMS через браузер, потрібно додати сайт у сервісі ServBay.

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

   Запустіть панель керування ServBay, відкрийте вкладку «Сайти» (у деяких версіях — «Хости»). Натисніть кнопку «Додати сайт».

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

   • Назва: вкажіть зручну для ідентифікації, наприклад My OctoberCMS Site.
   • Домен: задайте бажане локальне доменне ім'я, наприклад servbay-octobercms.local. Радимо використовувати .local для уникнення конфліктів із реальними доменами.
   • Тип сайту: оберіть PHP.
   • Версія PHP: виберіть сумісну з OctoberCMS версію PHP — таку, як ви активували у ServBay.
   • Коренева директорія: виберіть каталог проекту, створений у Кроці 1: /Applications/ServBay/www/servbay-octobercms-app.

2. Збережіть зміни і перезапустіть ServBay

   Після заповнення даних натисніть зберегти. ServBay попередить про необхідність застосування змін — зазвичай це перезапуск відповідного пакета (Caddy чи Nginx) і самого ServBay. Дотримуйтесь інструкцій, щоб налаштування набрали чинності. ServBay автоматично направить домен servbay-octobercms.local на локальну адресу 127.0.0.1.

Крок 5: Налаштування змінних середовища OctoberCMS

OctoberCMS (як і Laravel) використовує файл .env для керування змінними середовища, зокрема параметрами підключення до бази, ключами безпеки тощо.

1. Скопіюйте файл зразка конфігурації

   У кореневій папці проекту (/Applications/ServBay/www/servbay-octobercms-app) скопіюйте .env.example у .env:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. Відредагуйте .env

   Відкрийте файл .env у редакторі. Знайдіть налаштування підключення до бази й вкажіть свої дані, створені у Кроці 3:

   # ... інші параметри ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # Замініть на ім'я вашої БД
   DB_USERNAME=october_user  # Замініть на ім'я користувача
   DB_PASSWORD=password123   # Замініть на встановлений пароль
   
   # ... інші параметри ...

   Важливо: переконайтесь, що DB_DATABASE, DB_USERNAME та DB_PASSWORD містять фактичні значення із Кроку 3.

Крок 6: Запуск інсталятора OctoberCMS

OctoberCMS містить веб-установник для фінального налаштування, який також створює адміністратора.

1. Перейдіть на сторінку інсталяції

   Відкрийте у браузері налаштований домен із Кроку 4 додавши /install.php, наприклад:

   https://servbay-octobercms.local/install.php

   Ви побачите майстра встановлення OctoberCMS.

2. Введіть дані бази даних

   Використайте параметри, зазначені у файлі .env:

   • Тип БД: MySQL
   • Сервер БД: localhost або 127.0.0.1
   • Ім'я БД: october_user
   • Користувач: october_user
   • Пароль: password123

   (Знову: використовуйте актуальний пароль!)

3. Надання даних адміністратора

   Далі майстер попросить створити обліковий запис адміністратора для входу в адмін-панель — задайте бажаний логін, пароль, e-mail тощо.

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

   Натисніть «Встановити» чи подібну кнопку. Програма-установник виконає міграції БД, створить ключі безпеки та завершить налаштування.

Крок 7: Встановлення плагінів і тем (необов'язково)

Після встановлення ви можете увійти в адміністративну панель OctoberCMS: https://servbay-octobercms.local/backend.

1. Встановлення плагінів

   У бекенді перейдіть у розділ «Система» -> «Оновлення» -> «Плагіни», щоб переглянути та встановити додаткові плагіни з ринку OctoberCMS.

2. Встановлення теми

   В «Система» -> «Оновлення» -> «Теми» ви зможете обрати та встановити відповідну тему для свого проекту.

Початкова конфігурація та використання після встановлення

Ви успішно встановили OctoberCMS і можете одразу приступати до розробки сайту! Ось декілька початкових кроків:

• Перегляд головної сторінки: відкрийте у браузері https://servbay-octobercms.local/ — побачите стандартну вітальну сторінку (з типовою темою).
• Вхід у бекенд: перейдіть за адресою https://servbay-octobercms.local/backend та увійдіть зі своїми адміністративними даними.
• Створення сторінок: в бекенді через меню «CMS» -> «Сторінки» можна створювати й редагувати сторінки сайту.
• Створення контент-блоків: у меню «CMS» -> «Контент» можна додавати багаторазові блоки для сайтів.
• Налаштування теми: у «CMS» -> «Теми» налаштовуйте дизайн, макети й шаблони.
• Керування користувачами й правами: у «Система» -> «Керування» додавайте нових адміністраторів і керуйте їх правами доступу.

Часті питання (FAQ)

• Питання: При відкритті servbay-octobercms.local показується стандартна сторінка ServBay чи помилка?
  • Відповідь: Перевірте у панелі ServBay, що сайт servbay-octobercms.local доданий і коренева директорія вказує на /Applications/ServBay/www/servbay-octobercms-app. Після змін переконайтесь у перезапуску ServBay. Також перевірте, чи працюють пакети Caddy/Nginx і PHP.
• Питання: При доступі до https://servbay-octobercms.local/install.php сторінка порожня або з помилкою?
  • Відповідь: Це може бути помилкою PHP. Перевірте журнал помилок PHP у панелі ServBay. Найпоширеніші причини: неправильні права для папок (storage, themes, plugins мають бути доступні для запису веб-сервером), несумісна версія PHP або відсутність деяких розширень.
• Питання: Помилка з’єднання із базою даних під час встановлення?
  • Відповідь: Переконайтесь, що дані підключення у файлі .env (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) повністю збігаються з тими, що створені у phpMyAdmin. Перевірте, чи запущено MySQL/MariaDB у ServBay.
• Питання: Помилка при виконанні команди composer create-project?
  • Відповідь: Переконайтесь в активації пакета Composer та коректній версії PHP у ServBay. Також перевірте підключення до Інтернету — Composer завантажує файли з мережі.

Висновок

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