Установка и настройка 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 для локальной установки ExpressionEngine даёт следующие преимущества:

• Интегрированная среда: ServBay поставляется с необходимыми для ExpressionEngine PHP-окружением, базой данных MySQL и веб-сервером — ничего не нужно устанавливать и конфигурировать отдельно.
• Поддержка разных версий: Вы легко можете выбрать или сменить версию PHP согласно требованиям версии ExpressionEngine.
• Удобное управление базой данных: Встроенные phpMyAdmin или Adminer позволяют быстро создавать и администрировать базу данных для ExpressionEngine.
• Простая настройка сайта: Через графический интерфейс ServBay можно быстро создать локальный сайт и привязать его к каталогу вашего проекта ExpressionEngine.
• Изолированность и управление: ServBay позволяет создавать отдельные конфигурации для каждого проекта, чтобы избежать конфликтов окружения между разными проектами.

Необходимые условия

Перед началом установки убедитесь, что:

1. На вашем Mac установлен и запущен ServBay. Если вы ещё не устанавливали 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

Теперь используем команду curl для загрузки последней версии ExpressionEngine в текущий каталог. Параметр -L включает следование редиректам, -o — имя скачиваемого файла.

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

Шаг 2: Распаковка файлов ExpressionEngine

После скачивания используйте команду unzip для извлечения файлов из expressionengine.zip в ваш каталог servbay-ee-app. После этого zip-архив можно удалить.

unzip expressionengine.zip
rm expressionengine.zip

В результате в папке servbay-ee-app появится файловая структура ExpressionEngine.

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

ExpressionEngine использует базу данных для хранения контента и настроек. ServBay уже содержит MySQL и phpMyAdmin для удобного управления базами данных.

1. Откройте встроенный инструмент управления базой данных (phpMyAdmin)

   Откройте браузер и перейдите по адресу локального хаба ServBay: https://servbay.host/. На странице найдите и кликните по ссылке «phpMyAdmin» — откроется страница входа в phpMyAdmin. Используйте стандартные учётные данные ServBay (обычно локальный доступ не требует пароля, имя пользователя — можно найти в настройках базы данных ServBay, по умолчанию это localhost).

2. Создание пользователя и базы данных

   После входа в phpMyAdmin создадим отдельного пользователя и одноимённую базу данных для ExpressionEngine.

   • Перейдите на страницу "Учетные записи пользователей": На главной странице phpMyAdmin выбирайте пункт меню «Учетные записи пользователей».
   • Добавьте нового пользователя: Кликните «Добавить учетную запись пользователя».
   • Заполните данные пользователя и базы:
     • Имя пользователя: Например, ee_user.
     • Сервер: Выберите localhost (пользователь сможет подключаться только локально — это безопаснее).
     • Пароль: Придумайте надёжный пароль для доступа ExpressionEngine к базе (запомните его!). Для примера можно использовать password123, но в реальной работе обязательно выберите более сложный и безопасный.
     • Подтверждение пароля: Повторите пароль.
     • Создать базу данных с таким же именем…: Поставьте галочку, чтобы создать одноимённую базу и выдать пользователю права на неё.
   • Проверьте права: Убедитесь, что лишние глобальные привилегии не выставлены (на уровне базы автоматически будет выдан полный доступ).
   • Сохраните: Нажмите кнопку «Вперёд» или «Ок» внизу страницы — пользователь и база будут созданы.

Теперь у вас есть база данных и пользователь с именем ee_user, который обладает полным доступом к этой базе.

Шаг 4: Настройка сайта в ServBay

Теперь нужно сообщить ServBay, как обрабатывать запросы к нужному доменному имени (например, servbay-ee.local) и какому каталогу проекта их перенаправлять.

1. Добавление нового сайта в интерфейсе ServBay

   Откройте графический интерфейс ServBay. В левой панели выберите раздел «Сайты» («Websites»). Нажмите «+» или «Добавить» для создания новой конфигурации сайта.

   • Имя (Name): Дайте читаемое название, например, My ExpressionEngine Site.
   • Домен (Domain): Укажите желаемый локальный домен, например, servbay-ee.local. ServBay внесёт запись в файл hosts, чтобы этот адрес указывал на ваш локальный компьютер.
   • Тип сайта (Type): Выберите PHP, поскольку ExpressionEngine работает на PHP.
   • Версия PHP (PHP Version): Выберите версию PHP, совместимую с вашей версией ExpressionEngine.
   • Корневой каталог (Document Root): Укажите путь к каталогу проекта, созданному на шаге 1 — /Applications/ServBay/www/servbay-ee-app.
   • Веб-сервер (Web Server): Можно выбрать любой поддерживаемый сервер (Nginx, Caddy, Apache). ServBay автоматически сгенерирует нужную конфигурацию. Для большинства задач подойдёт настройка "по умолчанию".

2. Сохраните и примените изменения

   После заполнения всех полей нажмите «Сохранить» или «Применить». Возможно, потребуется перезапустить веб-сервер ServBay. Следуйте подсказкам и дождитесь окончания перезагрузки.

   Теперь при обращении к https://servbay-ee.local/ браузер будет направлять запросы в каталог вашего проекта ExpressionEngine.

Шаг 5: Запуск мастера установки ExpressionEngine

ExpressionEngine предоставляет web-мастер установки, который поможет пройти все финальные настройки.

1. Откройте страницу установки

   В браузере перейдите по вашему локальному домену с добавлением файла входа в мастер установки — admin.php. По умолчанию это будет путь /admin.php.

   Адрес: https://servbay-ee.local/admin.php

   Вы должны увидеть приветственную страницу или мастер установки ExpressionEngine.

2. Следуйте шагам мастера

   Мастер попросит ввести ключевые параметры:

   • Данные для подключения к базе данных:
     • Хост базы данных: localhost
     • Имя базы данных: ee_user (имя с шага 3)
     • Имя пользователя: ee_user (как выше)
     • Пароль: ваш пароль с шага 3
   • Учётные данные администратора: Создайте суперпользователя для управления ExpressionEngine — укажите логин, пароль и e-mail (пароль должен быть сложным!).
   • Настройки сайта: Введите название сайта, 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)», заполните имя, группу полей и другие параметры, затем сохраните изменения.
2. Добавление публикации: В разделе «Контент (Content)» → «Публикация (Publish)» выберите ранее созданный канал, заполните заголовок, контент и прочие данные, затем сохраните запись.

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

Меню сайта обычно реализуется через шаблоны.

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

Создание собственных виджетов (Widgets/Sidebars)

Аналогично навигации, секции виджетов и боковых панелей реализуются отдельными шаблонами.

1. Создайте шаблон виджета: Откройте «Дизайн (Design)» → «Шаблоны (Templates)», создайте шаблон для боковой панели, например, site:sidebar.
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, настройка возможна с соответствующими драйверами и конфигом, однако основная работа в ServBay ведётся именно с MySQL/MariaDB. Проверьте официальную документацию ExpressionEngine для получения списка поддерживаемых баз данных.

Заключение

Следуя этой инструкции, вы сможете быстро и без лишних сложностей установить и настроить ExpressionEngine CMS в локальной среде разработки ServBay. ServBay предоставляет удобный инструмент с интеграцией всех необходимых компонентов для эффективной разработки проектов на ExpressionEngine. Теперь вы можете начать создавать собственный сайт или веб-приложение, пользуясь всеми преимуществами ExpressionEngine. Удачной разработки!