Установка и настройка 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 убедитесь, что выполнены следующие условия:
- ServBay установлен и запущен: Убедитесь, что вы успешно установили ServBay на macOS и он работает.
- Базовые знания по ServBay: Знаете, как управлять пакетами через UI ServBay, добавлять сайты и пользоваться встроенными инструментами (например, phpMyAdmin).
- PHP и MySQL/MariaDB установлены: ServBay по умолчанию содержит несколько версий PHP и баз данных MySQL или MariaDB. Убедитесь, что нужная вам версия PHP активна и база данных запущена.
- Composer установлен: Composer встроен в ServBay по умолчанию — это ключевой инструмент для управления зависимостями в современных PHP-проектах. В этом руководстве мы создадим проект Drupal с помощью Composer.
Шаги установки Drupal
Следующие шаги подробно описывают процесс установки и настройки Drupal в среде ServBay:
Шаг 1: Создание директории проекта
Сначала создайте отдельную папку для вашего проекта Drupal в корневой директории сайтов ServBay, расположенной по пути /Applications/ServBay/www
.
Откройте приложение «Терминал» и выполните команды:
bash
cd /Applications/ServBay/www
mkdir servbay-drupal-app
cd servbay-drupal-app
1
2
3
2
3
Эти команды создадут новую папку servbay-drupal-app
в директории /Applications/ServBay/www
и перейдут в неё.
Шаг 2: Создание проекта Drupal с помощью Composer
Composer уже интегрирован в ServBay, дополнительная установка не требуется. Официально рекомендуемый способ установки Drupal — через Composer.
Находясь в директории servbay-drupal-app
, выполните команду:
bash
composer create-project drupal/recommended-project .
1
Эта команда создаст новый проект Drupal в текущей папке на основе шаблона drupal/recommended-project
и автоматически загрузит ядро Drupal и все необходимые зависимости. Процесс может занять некоторое время в зависимости от скорости вашего интернет-соединения.
Шаблон drupal/recommended-project
размещает все публично доступные файлы (например, index.php
, CSS, JS) в поддиректории web
. Это стандартная современная структура для проектов Drupal, обеспечивающая дополнительную безопасность.
Шаг 3: Создание базы данных и пользователя
Drupal необходима база данных для хранения контента, настроек и данных пользователей. Для её создания используйте встроенный phpMyAdmin в ServBay.
Откройте phpMyAdmin ServBay
Перейдите в браузере по адресу:
https://servbay.host/
. На дашборде найдите и кликните по ссылке «phpMyAdmin» (обычно она находится в разделах "Инструменты" или "Базы данных"). Вы попадёте в интерфейс phpMyAdmin.servbay.host
— это специальное локальное доменное имя для внутреннего интерфейса ServBay.Создайте пользователя базы данных
Для безопасного доступа рекомендуется создать отдельного пользователя для проекта Drupal.
- Перейдите на страницу пользователей: В верхнем меню phpMyAdmin нажмите «Пользовательские аккаунты».
- Добавьте нового пользователя: Кликните «Добавить пользователя».
- Заполните данные:
- Имя пользователя: Например,
drupal_user
. - Имя хоста: Выберите или введите
localhost
(это ограничит соединения только с локальной машины — безопаснее). - Пароль: Придумайте надежный пароль. Не используйте простые пароли вроде
password123
(это только пример для иллюстрации). На практике используйте генератор сложных паролей. - Повторите пароль: Введите ещё раз придуманный вами пароль.
- Имя пользователя: Например,
- Права базы данных: В разделе «Создать базу данных с таким же именем и предоставить все права» — отметьте соответствующий параметр. Это автоматически создаст базу данных с таким же именем, что и пользователь (
drupal_user
), и предоставит ему все права на свою базу. - Глобальные права: Не включайте глобальные права «Предоставить все права» (если только вы не знаете, зачем это нужно). Требуются только права в пределах своей базы.
- Подтвердите: Проверьте введённые данные и нажмите «Вперёд» (или аналогичную кнопку).
Теперь вы создали пользователя
drupal_user
и базу данных с таким же именем, у пользователя есть все права на эту базу.
Шаг 4: Настройка веб-сервера (добавление сайта в ServBay)
Теперь добавьте сайт в ServBay, чтобы указать доменное имя, ведущее на директорию web
вашего проекта Drupal.
- Откройте интерфейс ServBay: Запустите приложение ServBay.
- Добавьте новый сайт: Перейдите во вкладку «Сайты» в левой панели.
- Нажмите кнопку добавления: На странице списка сайтов нажмите «+» или аналогичную кнопку для создания нового сайта.
- Заполните информацию:
- Имя: Укажите понятное название, например,
My Drupal Site
. - Домен: Впишите желаемое локальное доменное имя, например,
servbay-drupal.local
. ServBay поддерживает домены с окончанием.local
, при этом не требуется изменять файл hosts. - Тип сайта: Выберите
PHP
. - Версия PHP: Выберите подходящую версию PHP для вашего Drupal-сайта. Требования см. в документации той версии Drupal, что устанавливается.
- Корневая директория: Важно! Укажите директорию, где находится файл входа Drupal (
index.php
). Согласно структуре, созданной Composer на шаге 2, это будет папкаweb
. Значит, полное значение:/Applications/ServBay/www/servbay-drupal-app/web
.
- Имя: Укажите понятное название, например,
- Сохраните: После заполнения всех полей нажмите «Сохранить» или соответствующую кнопку. ServBay автоматически обновит конфигурацию веб-сервера.
Шаг 5: Запуск установщика Drupal
Теперь можно приступить к установке Drupal через браузер.
Перейдите к установке
Откройте браузер и введите адрес локального сайта с путём
/core/install.php
:https://servbay-drupal.local/core/install.php
Должна открыться страница мастера установки Drupal.
Выберите язык
Укажите язык, который будет использоваться по умолчанию, затем нажмите «Сохранить и продолжить».
Выберите профиль установки
Обычно выбирают профиль «Стандартный», чтобы получить сайт с базовыми модулями. Нажмите «Сохранить и продолжить».
Настройте подключение к базе данных
Введите данные для подключения к БД, созданной на шаге 3:
- Тип базы данных: Выберите
MySQL, MariaDB, Percona Server или эквивалент
. - Имя базы данных: Введите
drupal_user
(имя базы, которое вы указали). - Имя пользователя: Введите
drupal_user
(имя пользователя БД). - Пароль: Введите ваш пароль, заданный ранее.
- Хост базы данных:
localhost
. - Дополнительные параметры: Обычно не требуется менять, если только база данных не работает на нестандартном порту или с особыми параметрами.
Нажмите «Сохранить и продолжить». Установщик Drupal попробует подключиться к базе и импортировать начальные данные.
- Тип базы данных: Выберите
Введите сведения о сайте
Если подключение прошло успешно, выполните базовую настройку сайта:
- Название сайта: Укажите название вашего сайта.
- E-mail сайта: E-mail для уведомлений и обратной связи.
- Имя администратора: Учётная запись администратора для доступа в админ-панель.
- Пароль администратора: Придумайте надёжный пароль для администратора.
- Страна: Выберите страну.
- Часовой пояс: Укажите подходящий часовой пояс.
После заполнения нажмите «Сохранить и продолжить». Drupal завершит установку и настройку основной информации.
Завершение установки
После завершения вы автоматически попадёте на главную страницу вашего сайта на Drupal. Поздравляем, установка Drupal в среде ServBay прошла успешно!
Шаг 6: Установка модулей и тем (Знакомство)
Сила Drupal в его экосистеме модулей и тем. Сразу после установки вы можете расширять и настраивать сайт под свои задачи.
- Вход в административную панель: Перейдите по адресу
https://servbay-drupal.local/user
илиhttps://servbay-drupal.local/admin
и войдите, используя данные администратора, указанные на шаге 5. - Установка модулей: После входа откройте меню «Расширения» (Extend) — вы сможете просматривать и подключать новые модули для добавления функционала.
- Установка тем: Перейдите в раздел «Оформление» (Appearance), где можно добавить или сменить тему для изменения внешнего вида сайта.
Дальнейшая настройка и работа после установки
После успешной установки вы можете приступить к наполнению сайта и дальнейшей индивидуальной настройке.
Создание типов содержания и контента
В основе Drupal лежат типы содержания — шаблоны для разных видов контента (статьи, страницы и др.).
- Создайте тип содержания: В админ-панели Drupal перейдите в «Структура» → «Типы содержания». Здесь можно отредактировать существующие или добавить новый тип с нужными полями (заголовок, текст, изображение и др.).
- Добавьте контент: В разделе «Содержание» → «Добавить содержимое» выберите тип содержимого, заполните поля и сохраните публикацию.
Настройка навигационного меню
Меню помогают организовать навигацию по сайту.
- Создайте меню: Перейдите в «Структура» → «Меню». Вы можете добавить новое меню или отредактировать существующие.
- Добавьте пункт меню: Внутри меню кликните «Добавить ссылку», укажите текст и адрес (например,
/node/1
или внешний URL), затем сохраните.
Персонализация блоков
Блоки — это настраиваемые элементы, которые можно размещать в областях сайта (сайдбар, подвал и др.).
- Добавьте блок: В разделе «Структура» → «Блочная разметка» увидите схему областей темы. Можно перетаскивать доступные блоки (навигация, пользовательский блок и др.) в нужные области.
- Настройте блок: Для каждого блока рядом доступна кнопка «Настроить» — укажите заголовок, определите на каких страницах и для каких ролей он будет виден.
Важные замечания и вопросы (FAQ)
- Как изменить настройки PHP? Если нужно включить расширения или увеличить лимит памяти (
memory_limit
), откройте вкладку «Пакеты» в ServBay UI, выберите нужную версию PHP и нажмите на кнопку настройки для редактированияphp.ini
. После изменений перезапустите PHP (ServBay обычно предложит это автоматически). - Почему сайт недоступен?
- Проверьте, запущен ли ServBay.
- Проверьте настройки сайта в ServBay — особенно домен и корневую директорию (
.../servbay-drupal-app/web
). - Убедитесь, что активен веб-сервер (Caddy или Nginx).
- Откройте сайт по адресу
https://servbay-drupal.local
(для установки —https://servbay-drupal.local/core/install.php
).
- Ошибка подключения к базе данных?
- Перепроверьте имя базы, пользователя и пароль, указанные при установке Drupal, — они должны совпадать с созданными в phpMyAdmin.
- Убедитесь, что хост базы —
localhost
. - Проверьте, работает ли служба MySQL/MariaDB в ServBay.
- Ошибка при установке зависимостей Composer? Проверьте интернет-соединение, убедитесь, что Composer может получить доступ к packagist.org. Иногда помогает очистка кеша или обновление самого Composer (ServBay регулярно обновляет встроенную версию).
- Проблемы с правами на файлы и папки? Для корректной работы Drupal нужны права на запись в некоторые каталоги (
web/sites/default/files
иweb/sites/default/settings.php
). ServBay обычно запускает процессы от имени активного пользователя macOS, что предотвращает проблемы, но если они возникли — проверьте права доступа к этим директориям.
Заключение
Следуя этому руководству, вы успешно установили и настроили Drupal в локальной среде ServBay. ServBay обеспечивает быструю, удобную и интегрированную платформу с необходимыми компонентами для работы с Drupal. Теперь вы можете использовать всю мощь Drupal для разработки сайтов, тестирования и локального отладки. По мере роста ваших проектов гибкость ServBay позволит легко управлять разными версиями PHP, базами данных и другими сервисами в рамках одной среды.