Установка и настройка 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: Знаете, как управлять пакетами через UI ServBay, добавлять сайты и пользоваться встроенными инструментами (например, phpMyAdmin).
3. PHP и MySQL/MariaDB установлены: ServBay по умолчанию содержит несколько версий PHP и баз данных MySQL или MariaDB. Убедитесь, что нужная вам версия PHP активна и база данных запущена.
4. Composer установлен: Composer встроен в ServBay по умолчанию — это ключевой инструмент для управления зависимостями в современных PHP-проектах. В этом руководстве мы создадим проект Drupal с помощью Composer.

Шаги установки 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 и автоматически загрузит ядро Drupal и все необходимые зависимости. Процесс может занять некоторое время в зависимости от скорости вашего интернет-соединения.

Шаблон drupal/recommended-project размещает все публично доступные файлы (например, index.php, CSS, JS) в поддиректории web. Это стандартная современная структура для проектов Drupal, обеспечивающая дополнительную безопасность.

Шаг 3: Создание базы данных и пользователя

Drupal необходима база данных для хранения контента, настроек и данных пользователей. Для её создания используйте встроенный phpMyAdmin в ServBay.

1. Откройте phpMyAdmin 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: Выберите подходящую версию PHP для вашего Drupal-сайта. Требования см. в документации той версии Drupal, что устанавливается.
   • Корневая директория: Важно! Укажите директорию, где находится файл входа Drupal (index.php). Согласно структуре, созданной Composer на шаге 2, это будет папка web. Значит, полное значение: /Applications/ServBay/www/servbay-drupal-app/web.
5. Сохраните: После заполнения всех полей нажмите «Сохранить» или соответствующую кнопку. ServBay автоматически обновит конфигурацию веб-сервера.

Шаг 5: Запуск установщика Drupal

Теперь можно приступить к установке Drupal через браузер.

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

   Откройте браузер и введите адрес локального сайта с путём /core/install.php:
   https://servbay-drupal.local/core/install.php

   Должна открыться страница мастера установки Drupal.

2. Выберите язык

   Укажите язык, который будет использоваться по умолчанию, затем нажмите «Сохранить и продолжить».

3. Выберите профиль установки

   Обычно выбирают профиль «Стандартный», чтобы получить сайт с базовыми модулями. Нажмите «Сохранить и продолжить».

4. Настройте подключение к базе данных

   Введите данные для подключения к БД, созданной на шаге 3:

   • Тип базы данных: Выберите MySQL, MariaDB, Percona Server или эквивалент.
   • Имя базы данных: Введите drupal_user (имя базы, которое вы указали).
   • Имя пользователя: Введите drupal_user (имя пользователя БД).
   • Пароль: Введите ваш пароль, заданный ранее.
   • Хост базы данных: localhost.
   • Дополнительные параметры: Обычно не требуется менять, если только база данных не работает на нестандартном порту или с особыми параметрами.

   Нажмите «Сохранить и продолжить». Установщик Drupal попробует подключиться к базе и импортировать начальные данные.

5. Введите сведения о сайте

   Если подключение прошло успешно, выполните базовую настройку сайта:

   • Название сайта: Укажите название вашего сайта.
   • E-mail сайта: E-mail для уведомлений и обратной связи.
   • Имя администратора: Учётная запись администратора для доступа в админ-панель.
   • Пароль администратора: Придумайте надёжный пароль для администратора.
   • Страна: Выберите страну.
   • Часовой пояс: Укажите подходящий часовой пояс.

   После заполнения нажмите «Сохранить и продолжить». Drupal завершит установку и настройку основной информации.

6. Завершение установки

   После завершения вы автоматически попадёте на главную страницу вашего сайта на Drupal. Поздравляем, установка Drupal в среде ServBay прошла успешно!

Шаг 6: Установка модулей и тем (Знакомство)

Сила Drupal в его экосистеме модулей и тем. Сразу после установки вы можете расширять и настраивать сайт под свои задачи.

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

Дальнейшая настройка и работа после установки

После успешной установки вы можете приступить к наполнению сайта и дальнейшей индивидуальной настройке.

Создание типов содержания и контента

В основе Drupal лежат типы содержания — шаблоны для разных видов контента (статьи, страницы и др.).

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

Настройка навигационного меню

Меню помогают организовать навигацию по сайту.

1. Создайте меню: Перейдите в «Структура» → «Меню». Вы можете добавить новое меню или отредактировать существующие.
2. Добавьте пункт меню: Внутри меню кликните «Добавить ссылку», укажите текст и адрес (например, /node/1 или внешний URL), затем сохраните.

Персонализация блоков

Блоки — это настраиваемые элементы, которые можно размещать в областях сайта (сайдбар, подвал и др.).

1. Добавьте блок: В разделе «Структура» → «Блочная разметка» увидите схему областей темы. Можно перетаскивать доступные блоки (навигация, пользовательский блок и др.) в нужные области.
2. Настройте блок: Для каждого блока рядом доступна кнопка «Настроить» — укажите заголовок, определите на каких страницах и для каких ролей он будет виден.

Важные замечания и вопросы (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, базами данных и другими сервисами в рамках одной среды.