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

Загальний огляд

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

ServBay — це локальне середовище для веб-розробки, створене спеціально для macOS. Воно інтегрує популярні веб-сервери (Caddy, Nginx), підтримує різні середовища виконання для мов програмування (PHP, Node.js, Python, Go, Java та інші), бази даних (MySQL, PostgreSQL, MongoDB, Redis), а також такі інструменти, як Composer та npm. Встановлення Drupal у середовищі ServBay забезпечує стабільну, зручну та комплексно налаштовану платформу для локальної розробки.

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

Передумови

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

1. ServBay встановлено та запущено: Упевніться, що ви успішно інсталювали ServBay на macOS і він працює коректно.
2. Базові знання роботи з ServBay: Розумієте, як керувати пакетами, додавати сайти та працювати з вбудованими інструментами (наприклад, phpMyAdmin) через інтерфейс ServBay.
3. Встановлені PHP і MySQL/MariaDB: ServBay за замовчуванням містить декілька версій PHP та СУБД MySQL або MariaDB. Переконайтеся, що вибрана вами версія PHP активна, а сервіс бази даних запущено.
4. Встановлений Composer: Composer інтегровано до ServBay за замовчуванням; це ключовий інструмент для керування залежностями сучасних PHP-проєктів. Ми використаємо Composer для створення проекту Drupal.

Покрокове встановлення Drupal

Ось детальні кроки з встановлення та налаштування Drupal у середовищі ServBay:

Крок 1: Створення каталогу проекту

Спочатку створіть окрему папку для вашого проєкту Drupal у кореневій директорії сайтів ServBay /Applications/ServBay/www.

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

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

Це створить нову папку servbay-drupal-app у /Applications/ServBay/www і переключить вас у неї.

Крок 2: Створення проекту Drupal за допомогою Composer

Composer вже інтегровано в ServBay — нічого додатково інсталювати не потрібно. Офіційна рекомендація Drupal — створювати проєкти та керувати залежностями через Composer.

У нещодавно створеному каталозі servbay-drupal-app запустіть:

composer create-project drupal/recommended-project .

Ця команда створить новий проєкт Drupal у поточній папці ( . ) з використанням шаблону drupal/recommended-project. Composer автоматично завантажить ядро Drupal і необхідні залежності. Тривалість залежить від швидкості інтернету.

Зауважте, що шаблон drupal/recommended-project розміщує всі файли, до яких має бути доступ із мережі (наприклад, index.php, CSS, JavaScript тощо), у підкаталозі web. Така структура — сучасний стандарт для проєктів Drupal, що підвищує безпеку.

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

Для зберігання контенту, налаштувань та даних користувачів Drupal потребує базу даних. Ми скористаємося phpMyAdmin із пакету ServBay, щоб створити базу й обліковий запис користувача.

1. Доступ до phpMyAdmin у ServBay

   Відкрийте браузер і перейдіть на стандартну адресу панелі ServBay: https://servbay.host/. На панелі знайдіть та натисність посилання «phpMyAdmin» (зазвичай це розділ «Інструменти» або «Бази даних»), щоб увійти в інтерфейс phpMyAdmin.

   servbay.host — спеціальний домен для локальної роботи з ServBay, що веде до адміністративного інтерфейсу.

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

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

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

   Тепер у вас є база даних drupal_user та обліковий запис drupal_user з повним доступом до цієї бази.

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

Тепер потрібно додати сайт у ServBay і пов’язати локальний домен із каталогом web вашого проєкту Drupal.

1. Відкрийте інтерфейс ServBay: Запустіть програму ServBay.
2. Додайте новий сайт: Оберіть вкладку «Сайти» у лівому меню.
3. Натисність кнопку додавання: На сторінці списку сайтів натисніть «+» або іншу відповідну кнопку додати новий сайт.
4. Заповніть налаштування:
   • Назва: Наприклад, My Drupal Site.
   • Домен: Наприклад, servbay-drupal.local. ServBay підтримує домени з суфіксом .local без необхідності редагувати hosts-файл.
   • Тип сайту: Оберіть PHP.
   • Версія PHP: Виберіть необхідну версію залежно від вимог вашої версії Drupal (дивіться офіційну документацію Drupal щодо підтримки PHP).
   • Корінь сайту: Важливо! Вкажіть як кореневу папку підкаталог, що містить вхідний файл Drupal (index.php). Для нових проєктів, створених через Composer, це каталог web, тобто: /Applications/ServBay/www/servbay-drupal-app/web.
5. Збережіть сайт: Після заповнення всіх полів збережіть налаштування (кнопка «Зберегти» або аналогічна). ServBay автоматично оновить конфігурацію веб-сервера.

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

Тепер можна через браузер запустити майстер встановлення Drupal, використовуючи вказаний локальний домен.

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

   Відкрийте браузер і перейдіть за адресою: https://servbay-drupal.local/core/install.php

   Ви повинні побачити початкову сторінку інсталятора Drupal.

2. Оберіть мову інтерфейсу

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

3. Оберіть тип інсталяції

   Зазвичай обирають «Стандартна» (Standard), щоби отримати базову конфігурацію із популярними модулями. Натисніть «Зберегти й продовжити».

4. Вкажіть дані для підключення до бази

   Інсталятор запропонує ввести таку інформацію:

   • Тип бази даних: MySQL, MariaDB, Percona Server, or equivalent.
   • Ім'я бази: drupal_user (як ви створили раніше).
   • Користувач бази: drupal_user.
   • Пароль: пароль, який ви задали користувачу.
   • Хост: localhost.
   • Додаткові параметри: Зазвичай не потрібні, якщо не використовуєте нетипові порти чи інші особливі налаштування.

   Після введення всіх полів натисніть «Зберегти й продовжити». Drupal під’єднається до бази та розгорне початкові дані.

5. Налаштуйте базову інформацію про сайт

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

   • Назва сайту: Заголовок вашого сайту.
   • Email сайту: Адреса пошти для системних сповіщень.
   • Логін адміністратора: Ім’я користувача для входу в адмінку.
   • Пароль адміністратора: Достатньо складний пароль для облікового запису адміністратора.
   • Країна: Ваш регіон.
   • Часовий пояс: Ваш часовий пояс.

   Натисніть «Зберегти й продовжити». Drupal завершить генерацію конфігурації й установку.

6. Завершення встановлення

   Після завершення інсталяції ви будете перенаправлені на головну сторінку новоствореного сайту. Вітаємо — Drupal успішно інстальовано на ServBay!

Крок 6: Встановлення модулів і тем (ознайомлення)

Одна з головних переваг Drupal — багата екосистема модулів і тем. Після встановлення ви можете розширювати функціонал та змінювати зовнішній вигляд сайту відповідно до ваших потреб.

1. Увійдіть до адмін-панелі Drupal: Перейдіть на https://servbay-drupal.local/user або https://servbay-drupal.local/admin і використайте створені на попередньому кроці логін та пароль.
2. Встановлення модулів: Після входу відкрийте розділ «Розширення» (Extend), знайдіть, перегляньте та активуйте нові модулі для додавання функціональності.
3. Встановлення тем: У розділі «Оформлення» (Appearance) додавайте й налаштовуйте теми для зміни дизайну сайту.

Наступні кроки після встановлення

Після успішного встановлення Drupal можна відразу почати будувати сайт. Ось основні дії, з яких зазвичай починають:

Створення типів контенту та матеріалів

Серце Drupal — це типи контенту, які визначають структуру для різних матеріалів (наприклад, статті, сторінки тощо).

1. Створення типу контенту: В адмінці Drupal перейдіть у «Структура» → «Типи матеріалів». Ви можете редагувати існуючі чи натиснути «Додати тип контенту», щоб створити власний, визначивши поля (заголовок, тіло, зображення тощо).
2. Створіть матеріал: Перейдіть у «Контент» → «Додати матеріал», оберіть потрібний тип та заповніть дані, після чого збережіть.

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

Меню дозволяють організувати структуру навігації по сайту.

1. Створення меню: В адмінці Drupal відкрити «Структура» → «Меню». Можна додати нове меню чи редагувати наявне.
2. Додавання пунктів меню: Редагуйте обране меню, натисніть «Додати посилання», вкажіть текст і шлях (наприклад, /node/1 або зовнішню адресу), збережіть зміни.

Керування блоками та макетом сайту

Блоки — це гнучкі контентні елементи, які можна виводити в різних частинах сторінки (сайдбар, підвал тощо).

1. Додавання блоку: В адмінці Drupal відкрийте «Структура» → «Макет блоків». Тут відображено всі області для поточної теми. Перетягніть доступні блоки (навігація, користувацький HTML тощо) у бажану зону.
2. Налаштування блоку: У блоці, розміщеному в обраній області, натисніть «Налаштувати», де можна задати заголовок, сторінки показу, права доступу тощо.

Корисні поради та відповіді на часті питання (FAQ)

• Як змінити налаштування PHP? Якщо потрібно підключити певне PHP-розширення чи збільшити ліміт пам’яті (memory_limit), у ServBay відкрийте вкладку «Пакети», знайдіть вибрану версію PHP, і через кнопку налаштувань редагуйте файл php.ini. Перезапустіть PHP-сервіс (ServBay зазвичай підкаже чи зробить це автоматично).
• Чому сайт не відкривається?
  • Переконайтеся, що ServBay запущений.
  • Перевірте коректність налаштувань доданого сайту, зокрема доменне ім’я та правильний шлях до кореневого каталогу (.../servbay-drupal-app/web).
  • Перевірте, що веб-сервери (Caddy або Nginx) у ServBay працюють.
  • Спробуйте відкрити https://servbay-drupal.local або безпосередню сторінку встановлення https://servbay-drupal.local/core/install.php.
• Проблеми з підключенням до бази даних:
  • Перевірте, що ім'я БД, користувач і пароль у інсталяторі Drupal відповідають налаштуванням у phpMyAdmin.
  • Переконайтеся, що база розміщена на localhost.
  • Перевірте, чи сервіс MySQL/MariaDB у ServBay працює.
• Помилки під час встановлення залежностей Composer: Перевірте з’єднання з інтернетом та доступ до packagist.org. Іноді варто очистити кеш Composer або оновити його (у ServBay Composer оновлюється регулярно).
• Проблеми з правами на файли: Drupal потребує прав на запис у певні каталоги, наприклад, web/sites/default/files, web/sites/default/settings.php. Зазвичай ServBay запускає сервіси від імені поточного користувача macOS і проблем із правами не виникає, але якщо вони з’явились — скоригуйте права доступу.

Підсумок

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