Встановлення та налаштування ExpressionEngine CMS у локальному середовищі ServBay

Огляд

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

ServBay — це локальне веб-середовище, призначене спеціально для macOS. Воно забезпечує комплексне рішення для розробників, об'єднуючи популярні веб-сервери (Nginx, Caddy, Apache), рушії програмування (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), бази даних (MySQL, PostgreSQL, MongoDB, Redis) та інші інструменти (Composer, npm/yarn, phpMyAdmin/Adminer). Завдяки ServBay налаштувати та управляти локальним середовищем розробки стає просто і швидко.

У цьому посібнику докладно описано, як встановити та налаштувати ExpressionEngine у середовищі ServBay, щоб ви могли швидко розпочати роботу над своїм проектом.

Чому обирати встановлення ExpressionEngine у ServBay?

Встановлення ExpressionEngine у локальному середовищі ServBay має такі переваги:

• Інтегроване середовище: ServBay містить усе необхідне для запуску ExpressionEngine — PHP, MySQL, веб-сервер — і вам не потрібно налаштовувати їх окремо.
• Підтримка різних версій: Обирайте і перемикайтеся між різними версіями PHP відповідно до вимог ExpressionEngine напряму з інтерфейсу ServBay.
• Зручне керування базою даних: ServBay має вбудований phpMyAdmin або Adminer для легкого створення й адміністрування баз даних ExpressionEngine.
• Швидке створення сайтів: Графічний інтерфейс ServBay дозволяє швидко додати новий локальний сайт і підключити вашу папку проекту.
• Ізоляція та керування: Для кожного проекту можна створювати окремі конфігурації сайтів, уникаючи конфліктів між різними середовищами.

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

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

1. На вашому macOS встановлено та запущено ServBay. Якщо ще ні, скачайте інструкцію з сайту ServBay.
2. Ви маєте базові навички роботи з терміналом.
3. Ви розумієте основні поняття баз даних (наприклад, база даних, користувач).
4. Ваша стандартна папка сайтів ServBay /Applications/ServBay/www доступна для запису.

Етапи встановлення

Встановлення та налаштування ExpressionEngine у ServBay складається з наступних кроків:

Крок 1: Підготуйте папку проекту та скачайте ExpressionEngine

Спочатку відкрийте термінал. Перейдіть у стандартний каталог сайтів ServBay /Applications/ServBay/www та створіть нову папку проекту (наприклад, servbay-ee-app), після чого зайдіть у неї.

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

Далі завантажте останню версію ExpressionEngine з офіційного сайту за допомогою команди curl. Параметр -L дозволяє переходити за редиректами, -o задає ім'я вихідного файлу.

curl -L https://expressionengine.com/latest -o expressionengine.zip

Крок 2: Розпакування ExpressionEngine

Після завантаження скористайтеся unzip, щоб розпакувати архів expressionengine.zip у поточну директорію проекту, а потім видаліть архів.

unzip expressionengine.zip
rm expressionengine.zip

Структура ExpressionEngine з’явиться у папці servbay-ee-app.

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

Для роботи ExpressionEngine потрібна окрема база даних. У ServBay вже є MySQL та phpMyAdmin, що спрощує цей процес.

1. Відкрийте phpMyAdmin у ServBay

   Запустіть браузер, перейдіть за адресою: https://servbay.host/. Знайдіть та натисніть посилання «phpMyAdmin» — відкриється сторінка входу. Використайте стандартний логін/пароль для бази даних ServBay (часто доступ без пароля, якщо база локальна).

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

   Після входу виконайте наступні дії для створення окремого користувача та бази даних для ExpressionEngine:

   • Перейдіть у "Облікові записи користувачів": У верхньому меню phpMyAdmin оберіть "Облікові записи користувачів".
   • Додайте нового користувача: Натисніть "Додати обліковий запис користувача".
   • Заповніть дані користувача й бази:
     • Ім'я користувача: Вкажіть ім’я, напр. ee_user.
     • Хост: Оберіть localhost для підсилення безпеки.
     • Пароль: Введіть надійний пароль для з’єднання з БД (наприклад, password123 для демонстрації, але для реального проекту оберіть складний пароль).
     • Ще раз пароль: Повторіть пароль.
     • База даних для користувача: Поставте позначку «Створити базу даних з таким самим ім’ям та надати усі права».
   • Перевірте права користувача: В глобальних правах не потрібно додаткових відміток — всі права будуть надані на рівні нової БД.
   • Збережіть зміни: Натисніть "ОК" або "Підтвердити" для завершення створення.

   Тепер у вас створена база даних ee_user та користувач ee_user з повними правами на цю БД.

Крок 4: Налаштування сайту у ServBay

Далі потрібно налаштувати сервіс, аби ваш проект відкривався за окремим локальним доменом (наприклад, servbay-ee.local) та був прив’язаний до створеної директорії проекту.

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

   Відкрийте додаток ServBay. У лівому меню виберіть "Сайти". Потім натисніть «+» або «Додати», щоб створити нову конфігурацію сайту.

   • Назва (Name): Вкажіть легко впізнавану назву, наприклад My ExpressionEngine Site.
   • Домен (Domain): Вкажіть бажане доменне ім’я для локального доступу, наприклад, servbay-ee.local. ServBay автоматично додасть його до файлу hosts і спрямує на localhost (127.0.0.1).
   • Тип сайту (Type): Виберіть PHP.
   • Версія PHP (PHP Version): Оберіть потрібну версію PHP відповідно до вимог ExpressionEngine.
   • Коренева папка сайту (Document Root): Вкажіть шлях до папки проекту (/Applications/ServBay/www/servbay-ee-app).
   • Веб-сервер (Web Server): Можете обрати будь-який сервер (Nginx, Caddy, Apache) — для більшості випадків підійде стандартний.

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

   Після заповнення форми натисніть «Зберегти» або «Застосувати». ServBay, можливо, запропонує перезапустити веб-сервер — погодьтесь і зачекайте завершення процесу.

   Тепер, відкривши у браузері https://servbay-ee.local/, ви переходите на ваш новостворений локальний сайт.

Крок 5: Запустіть веб-інсталятор ExpressionEngine

ExpressionEngine має вбудований веб-інсталятор, який допоможе завершити налаштування.

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

   У браузері відкрийте адресу у вигляді https://servbay-ee.local/admin.php (файл входу до інсталятора розташований за цією адресою за замовчуванням).

   Має з’явитися вітальна сторінка ExpressionEngine або майстер встановлення.

2. Пройдіть покрокове налаштування

   В процесі інсталяції вкажіть такі ключові дані:

   • Параметри підключення до БД:
     • Хост БД: localhost
     • Ім’я БД: ee_user (як ви створили вище)
     • Ім'я користувача: ee_user
     • Пароль: той, який ви задали для ee_user
   • Дані адміністратора: Задайте ім’я, пароль та email для облікового запису адміна (використовуйте складний пароль!).
   • Основні параметри сайту: Назва, URL та інше.

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

   Перевірте всі дані та натисніть «Встановити» чи відповідну кнопку завершення. ExpressionEngine створить потрібні таблиці у БД та виконає всі початкові налаштування.

   Після цього зазвичай ви автоматично перейдете на сторінку входу або в адмін-панель.

Крок 6: Початкове налаштування після встановлення

Після інсталяції ExpressionEngine можна додавати плагіни, налаштовувати шаблони та виконувати інші базові кроки.

1. Вхід у адмінку ExpressionEngine

   Використайте дані адміністратора, які ви створили на попередньому кроці, щоб увійти через https://servbay-ee.local/admin.php.

2. Додайте плагіни

   В адмін-панелі перейдіть до меню: «Розробка (Developer)» → «Додатки (Add-Ons)» → «Плагіни (Plugins)». Тут можна переглядати, встановлювати та активувати необхідні доповнення.

3. Налаштуйте шаблони

   В меню «Дизайн (Design)» → «Шаблони (Templates)» створюйте шаблонні групи, окремі шаблони, пишіть HTML/CSS/EE код для відображення контенту.

Створення сайту на ExpressionEngine

Тепер ви успішно підняли ExpressionEngine під керуванням ServBay і можете почати розбудову свого сайту. Ось типові перші кроки:

Створення каналів і записів

У центрі архітектури ExpressionEngine лежать "канали" та "записи". Канали визначають структуру контенту, а записи — це окремі матеріали.

1. Створіть канал: В адмінці оберіть «Структура контенту (Content Structure)» → «Керування каналами (Channels)». Натисніть "Створити новий канал (Create New Channel)", заповніть форму — назва, група полів тощо, і натисніть "Зберегти канал (Save Channel)".
2. Створіть запис: Перейдіть у «Контент (Content)» → «Публікація (Publish)». Виберіть створений канал, заповніть заголовок, контент та інші поля й натисніть "Зберегти (Save)".

Налаштування меню навігації

Меню зазвичай створюється через шаблони.

1. Створіть або відредагуйте шаблон: У «Дизайн (Design)» → «Шаблони (Templates)» знайдіть або створіть потрібний шаблон для навігації (наприклад, site:nav у групі site).
2. Додайте код: Використайте теги ExpressionEngine у шаблоні для вибірки каналів/сторінок та створення HTML-структури меню.
3. Включіть меню в лейаут: В основному шаблоні сайту використовуйте {% include 'site:nav' %} або відповідний тег для вставки меню.

Власні віджети (сайдбари)

Віджети чи бокові панелі також створюють через шаблони.

1. Створіть шаблон віджета: У «Дизайн (Design)» → «Шаблони (Templates)» створіть шаблон для відображення, наприклад, останніх записів або категорій.
2. Додайте код: Запрограмуйте відображення потрібного контенту у цьому шаблоні.
3. Додавайте віджети у лейаут: Вставляйте шаблон у потрібне місце на сторінці.

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

• Питання: При переході на https://servbay-ee.local/ з’являється помилка доступу. Що робити?
  • Відповідь: Перевірте права доступу до папки проекту (/Applications/ServBay/www/servbay-ee-app) та її підпапок/файлів. Користувач, під яким запускається ServBay (зазвичай це ваш акаунт), повинен мати права читання та запису. Можливо, треба скористатися командами chmod чи chown, наприклад: sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app.
• Питання: Чому майстер установки ExpressionEngine не підключається до бази даних?
  • Відповідь: Уважно перевірте дані для підключення до бази (хост, ім'я БД, користувач, пароль) — вони повинні точно відповідати створеним у phpMyAdmin. Переконайтесь, що сервіси MySQL/MariaDB у ServBay увімкнено.
• Питання: Чи можна використовувати у ServBay інші бази даних (наприклад, PostgreSQL)?
  • Відповідь: ExpressionEngine офіційно підтримує лише MySQL/MariaDB. Якщо з’явиться офіційна підтримка PostgreSQL, і ви налаштуєте потрібні драйвери, можна використати й цю БД, але її працездатність залежатиме від підтримки ExpressionEngine. Дивіться документацію ExpressionEngine щодо сумісних типів баз даних.

Висновок

Дотримуючись цієї інструкції, ви зможете швидко та без труднощів розгорнути ExpressionEngine CMS у локальному середовищі розробки ServBay на macOS. ServBay створює максимально зручне та ефективне середовище для локальної розробки сайтів на ExpressionEngine, бо вже містить всі потрібні компоненти. Перед вами відкриті широкі можливості — використовуйте потужний функціонал ExpressionEngine для створення сучасного вебсайту або вебзастосунку. Успіхів у розробці!