ServBay

Українська

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
ไทย
한국어

Українська

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
ไทย
한국어

Appearance

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

Огляд ​

Цей документ допоможе вам крок за кроком встановити та налаштувати Bedrock у локальному середовищі розробки ServBay. Bedrock надає сучасну структуру проекту WordPress, керує залежностями за допомогою Composer, оптимізує керування конфігураціями та дотримується найкращих практик, що підвищує ефективність і безпечність розробки, розгортання та обслуговування WordPress проектів. Поєднуючи потужні й зручні можливості ServBay для локального управління середовищем, ви швидко розгорнете сучасну платформу на основі Bedrock.

Що таке Bedrock? ​

Bedrock — це структура проекту WordPress, створена командою Roots, покликана покращити досвід розробника WordPress. Вона суттєво відрізняється від класичної структури WordPress і має ключові особливості:

  • Керування залежностями через Composer: Ядро WordPress, теми й плагіни керуються Composer, спрощуючи оновлення та вирішення конфліктів залежностей.
  • Покращене керування конфігураціями: Відповідно до принципів Twelve-Factor App, середовищні змінні визначаються у файлі .env, розділяючи налаштування і код для кращої безпеки й гнучкості.
  • Краще організована структура проекту: Ядро WordPress розташоване у підкаталозі (web/wp), а теми й плагіни — у web/app, що робить структуру зрозумілішою.
  • Підвищена безпека: За замовчуванням Bedrock має заходи для підвищення захищеності, наприклад, приховані шляхи до ядра CMS.

Bedrock — ідеальна основа для створення стійких, легких у підтримці й сучасних WordPress-додатків.

Чому обрати ServBay для розробки з Bedrock? ​

ServBay — це інструмент локального веб-розробки, спеціально для macOS, що інтегрує популярні веб-сервери (Caddy/Nginx/Apache), декілька версій PHP, бази даних (MySQL/PostgreSQL/MongoDB), а також середовища Node.js, Python, Go, Java тощо. Використовуючи ServBay разом із Bedrock, ви отримуєте:

  • Швидке розгортання середовища: ServBay вже містить усе необхідне для Bedrock — PHP, Composer та бази даних, без додаткової ручної інсталяції й налаштування компонентів.
  • Легке перемикання версій: Змініть версію PHP в декілька кліків для тестування сумісності Bedrock із різними варіантами PHP.
  • Вбудоване керування базами даних: Через phpMyAdmin або Adminer ви легко створите та керуватимете базами даних прямо у ServBay.
  • Просту конфігурацію сайту: Завдяки графічному інтерфейсу ви швидко створите сайт (віртуальний хост) для проекту й вкажете правильний кореневий каталог.
  • Єдине управління: Керуйте всіма пакетами та сайтами локальної розробки у рамках одного застосунку.

Передумови ​

Перед початком переконайтеся, що:

  • Ви вже встановили й запустили ServBay на macOS.
  • Маєте базові навички роботи з командним рядком.
  • Маєте початкове розуміння Composer (хоча в цьому гайді будуть готові приклади команд).

Покрокова інструкція з встановлення Bedrock ​

Далі наведено деталі інсталяції й налаштування Bedrock у середовищі ServBay.

Крок 1: Створення директорії проекту ​

Спочатку перейдіть до стандартної кореневої директорії сайтів ServBay /Applications/ServBay/www і створіть нову робочу папку. Рекомендуємо назвати її інформативно, наприклад servbay-bedrock-app.

bash
cd /Applications/ServBay/www
mkdir servbay-bedrock-app
cd servbay-bedrock-app

Ця директорія буде коренем для вашого проекту Bedrock.

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

ServBay вже містить Composer, тож ви можете використовувати команду composer напряму в терміналі. У директорії проекту (/Applications/ServBay/www/servbay-bedrock-app) виконайте:

bash
composer create-project roots/bedrock .

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

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

Bedrock та WordPress зберігають вміст і налаштування в базі даних. Для створення БД та користувача скористаємося вбудованим у ServBay phpMyAdmin.

  1. Перейдіть у phpMyAdmin ServBay

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

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

    Для кращої безпеки й зручності бажано для кожного проекту створювати окремого користувача й базу даних.

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

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

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

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

      • Ім'я користувача: Наприклад, bedrock_user.
      • Хост: Оберіть localhost, щоб користувач підключався лише локально.
      • Пароль: Придумайте надійний пароль для користувача й запишіть його. Для локальних тестів підійде password123, у продакшені використовуйте сильний пароль.
      • Підтвердіть пароль: Повторіть пароль.

      У секції «Створити БД з іменем, що збігається з іменем користувача, і надати всі права» встановіть відповідну позначку. Це автоматично створить базу даних bedrock_user і призначить користувача з усіма повноваженнями.

      Обов'язково переконайтесь, що встановлений прапорець «Надати всі права» для цього користувача й нової БД.

      Збережіть зміни натисканням «Виконати» внизу сторінки.

Крок 4: Налаштування Bedrock ​

Bedrock використовує для налаштувань змінні середовища, які зазвичай зберігаються у файлі .env у корені проекту.

  1. Скопіюйте файл прикладу та перейменуйте

    Перейдіть у кореневу директорію проекту (/Applications/ServBay/www/servbay-bedrock-app). Тут є зразковий файл .env.example. Скопіюйте та перейменуйте його у .env:

    bash
    cp .env.example .env

    Файл .env слугує для справжніх налаштувань, а .env.example — лише приклад, без чутливих даних.

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

    Відкрийте .env у своєму редакторі (VS Code, Sublime Text, Nano тощо). Знайдіть параметри з'єднання з базою даних та змініть їх відповідно до даних із кроку 3:

    dotenv
    # Database
DB_NAME='bedrock_user' # Назва бази даних, збігається з іменем користувача
DB_USER='bedrock_user' # Користувач БД
DB_PASSWORD='password123' # Пароль
DB_HOST='localhost' # Адреса БД (для ServBay — localhost)
DB_PREFIX='wp_' # Префікс таблиць, залиште як є або змініть

# WordPress Environment
WP_ENV='development' # Поточне середовище: development, staging, production

# Site URLs
WP_HOME='http://servbay-bedrock.local' # Повна URL сайту
WP_SITEURL='${WP_HOME}/wp' # URL ядра WordPress

    Не забудьте змінити DB_PASSWORD на свій пароль, встановлений у phpMyAdmin.

    WP_HOME і WP_SITEURL — це адреси, за якими ви відвідуватимете сайт у браузері. Стандартно рекомендується servbay-bedrock.local, але ви можете задати свій варіант. WP_SITEURL має вказувати на підкаталог (web/wp).

    Також у .env можна налаштовувати додаткові параметри для Bedrock/WordPress (наприклад, константи або надсилання пошти).

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

Щоб вебсервер ServBay обробляв ваш Bedrock-проект, потрібно додати новий сайт (віртуальний хост) у застосунку ServBay.

  1. Створіть новий сайт

    Відкрийте застосунок ServBay, у лівому меню оберіть «Сайти», натисніть «+» або «Додати сайт» для створення нового. Заповніть таке:

    • Назва: Наприклад, My Bedrock Site (лише для вашої зручності).
    • Домен: Вкажіть домен із WP_HOME у .env, наприклад, servbay-bedrock.local. ServBay автоматично додасть його у локальні переймування на 127.0.0.1.
    • Тип сайту: Оберіть PHP.
    • Версія PHP: Вкажіть сумісну з Bedrock версію (рекомендується найновіша стабільна).
    • Кореневий каталог сайту: Дуже важливо! Корінь не співпадає з директорією проекту, а має бути підкаталог web. Вкажіть шлях /Applications/ServBay/www/servbay-bedrock-app/web.

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

    Після внесення даних натисніть «Зберегти». ServBay оновить конфігурацію свого вебсерверу. Якщо система запропонує перезапустити служби — зробіть це.

Крок 6: Завершіть установку WordPress ​

Ваш Bedrock-проект розгорнуто й сайт у ServBay налаштований. Далі завершіть стандартну інсталяцію WordPress через вебінтерфейс.

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

    Відкрийте браузер і перейдіть за адресою вашого сайту з .env та налаштувань ServBay — зазвичай це http://servbay-bedrock.local/wp. Якщо все коректно, з'явиться майстер встановлення WordPress.

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

    Майстер попросить вказати параметри з кроку 3:

    • Назва бази: bedrock_user
    • Ім'я користувача: bedrock_user
    • Пароль: Ваш пароль (наприклад, password123)
    • Сервер БД: localhost
    • Префікс таблиць: wp_ (звичайно не змінюється)

    Натисніть «Відправити» (Submit) — WordPress перевірить підключення.

  3. Вкажіть параметри сайту

    Якщо підключення успішне, система перейде на сторінку налаштування сайту. Заповніть:

    • Назва сайту: Оберіть ім'я для вашого проекту.
    • Ім'я користувача: Створіть адміністраторський обліковий запис.
    • Пароль: Встановіть надійний пароль.
    • E-mail: Вкажіть e-mail адміністратора.
    • Індексація: Для локальної розробки рекомендується заборонити індексацію сайту пошуковиками.

  4. Завершіть установку

    Натисніть «Встановити WordPress». Процес завершиться створенням необхідних таблиць у базі даних. По закінченню ви побачите повідомлення про успішну інсталяцію та отримаєте посилання на вхід у панель адміністрування.

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

Bedrock рекомендує, щоб теми й плагіни встановлювались через Composer, а не через адмінку WordPress.

  1. Знайдіть назву Composer-пакета

    Більшість популярних шаблонів і плагінів доступні на Packagist (packagist.org) або WordPress Packagist (wpackagist.org). Зазвичай ім’я пакета має формат vendor/package-name, наприклад: wpackagist-theme/twentytwentyone або wpackagist-plugin/wordpress-seo.

  2. Встановіть через Composer

    Перейдіть у корінь проекту (/Applications/ServBay/www/servbay-bedrock-app) та виконайте одну з команд:

    Встановити тему:

    bash
    composer require wpackagist-theme/your-theme-name

    Встановити плагін:

    bash
    composer require wpackagist-plugin/your-plugin-name

    Замініть your-theme-name і your-plugin-name на актуальні назви. Composer автоматично скопіює теми у web/app/themes, а плагіни у web/app/plugins.

  3. Активуйте в адмінці WordPress

    Увійдіть в адмінку WordPress (http://servbay-bedrock.local/wp/wp-admin/), далі:

    • Для тем: меню «Зовнішній вигляд» -> «Теми», знайдіть і активуйте обрану тему.
    • Для плагінів: «Плагіни» -> «Встановлені», знайдіть і активуйте необхідний.

    Хоч Bedrock підтримує й звичайну установку тем/плагінів через завантаження .zip, рекомендована й сучасна практика — саме через Composer.

Розробка сайту на Bedrock ​

Ви успішно встановили й налаштували Bedrock у ServBay! Далі можете створювати сайт так, як у звичайному WordPress, але з усіма сучасними перевагами.

  • Створення сторінок і публікацій: Увійдіть до адмінки й додавайте контент через розділи «Сторінки» та «Записи», як завжди.
  • Налаштування меню: У «Зовнішній вигляд» -> «Меню» керуйте навігацією сайту.
  • Віджети: В «Зовнішній вигляд» -> «Віджети» керуйте бічними панелями.
  • Розробка своїх тем і плагінів: Розробляйте у директоріях web/app/themes та web/app/plugins.
  • Управління конфігураціями: Через .env зручно розділяти налаштування для різних середовищ (розробка, staging, продакшн).

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

  • Питання: При спробі зайти на http://servbay-bedrock.local з'являється помилка 404 — що робити?
    • Перевірте, чи домен у налаштуваннях ServBay тотожний адресі, яку ви вводите.
    • Переконайтеся, що кореневий каталог сайту у ServBay вказує на /Applications/ServBay/www/servbay-bedrock-app/web.
    • Перевірте, чи запущено вебсервер у ServBay.
    • Звірте значення WP_HOME в .env.
  • Питання: На http://servbay-bedrock.local/wp виникає помилка підключення до бази — що робити?
    • Звірте в .env значення DB_NAME, DB_USER, DB_PASSWORD, DB_HOST із налаштуваннями БД у phpMyAdmin.
    • Переконайтеся, що служба MySQL або обрана БД у ServBay активна.
    • Переконайтеся, що у phpMyAdmin користувач має всі права на вказану БД.
  • Питання: Чому після встановлення теми/плагіна через Composer вони не з’являються в адмінці WordPress?
    • Перевірте, чи виконали команди composer install або composer require і вони спрацювали вдало у корні проекту (/Applications/ServBay/www/servbay-bedrock-app).
    • Знайдіть скопійовані файли тем у web/app/themes, а плагінів у web/app/plugins.
    • Перейдіть у WordPress: «Зовнішній вигляд» -> «Теми» чи «Плагіни» -> «Встановлені» та активуйте їх.
  • Питання: Як оновити Bedrock, ядро WordPress, тему чи плагін?
    • Оскільки все управляється Composer, виконайте у кореневій папці команду composer update для оновлення всіх залежностей або composer update vendor/package-name для вибраного пакета. Після оновлення виконайте міграції в адмінці WP, якщо це буде запропоновано.

Висновок ​

Виконавши ці кроки, ви змогли швидко підготувати сучасний проект Bedrock у локальному середовищі ServBay. Поєднуючи зручне адміністрування від ServBay і сучасні потоки розробки з Bedrock, ви отримуєте ефективну й захищену платформу для створення і обслуговування WordPress-проектів. Тепер ви можете з користю застосувати інструменти Bedrock для свого наступного WordPress-сайту!