Установка и настройка OctoberCMS в среде ServBay

Обзор

OctoberCMS — это популярная система управления контентом (CMS) с открытым исходным кодом, построенная на мощном фреймворке Laravel. Благодаря своей простоте, гибкости и удобству для разработчиков, OctoberCMS пользуется широкой популярностью. Данный документ — это пошаговое руководство по установке и настройке OctoberCMS в ServBay, универсальной среде локальной веб-разработки для macOS, чтобы вы могли быстро приступить к созданию проектов на основе OctoberCMS.

Что такое OctoberCMS?

OctoberCMS предлагает интуитивный интерфейс для управления сайтом и широкие возможности для фронтенд-разработки. Разработчики могут использовать знакомые концепции Laravel (например, Eloquent ORM, шаблонизатор Blade) для создания сайтов любого масштаба — от простых блогов до сложных корпоративных приложений.

Предварительные требования

Перед установкой OctoberCMS убедитесь, что выполнены следующие условия:

1. На вашем компьютере с macOS установлен и запущен ServBay.
2. В ServBay активированы и работают пакеты PHP (рекомендуется версия 7.4 или выше) и MySQL/MariaDB.
3. В ServBay включён пакет Composer.
4. Вы обладаете базовыми навыками работы с командной строкой.

Шаги по установке OctoberCMS

Ниже приведены подробные шаги по установке и настройке OctoberCMS в окружении ServBay:

Шаг 1: Создание директории для проекта

Сначала перейдите в рекомендуемую ServBay корневую папку сайтов /Applications/ServBay/www и создайте в ней отдельную папку для вашего проекта на OctoberCMS.

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

Шаг 2: Установка OctoberCMS через Composer

ServBay уже содержит и настраивает Composer, убедитесь, что пакет Composer включён в панели управления ServBay. Теперь, находясь в созданной вами папке проекта, выполните команду для загрузки и установки основных файлов OctoberCMS:

composer create-project october/october .

Эта команда скачает последнюю версию OctoberCMS из официального репозитория в текущую папку (.).

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

OctoberCMS использует базу данных для хранения контента, пользователей, настроек и прочей информации. Создайте базу данных и пользователя через встроенный в ServBay инструмент phpMyAdmin.

1. Откройте phpMyAdmin, поставляемый с ServBay

   Зайдите в браузер и перейдите на локальную панель ServBay по адресу https://servbay.host/. Найдите и откройте ссылку на phpMyAdmin, обычно это https://servbay.host/phpmyadmin/.

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

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

   1. Перейдите на страницу пользователей

      В главном меню phpMyAdmin выберите вкладку «Пользовательские аккаунты».

   2. Добавьте нового пользователя

      Нажмите «Добавить пользователя». Заполните поля:

      • Имя пользователя: например, october_user.
      • Имя хоста: выберите localhost или 127.0.0.1, чтобы пользователь имел доступ только с локальной машины, что повышает безопасность.
      • Пароль: введите надёжный, уникальный пароль. Не используйте для боевых проектов пример password123.
      • Повторите пароль: введите тот же пароль ещё раз.
      • В разделе «База данных для пользователя» выберите «Создать базу данных с таким же именем и предоставить все права».
      • Проверьте, что также отмечена опция «Предоставить все права» в разделе «Глобальные привилегии» (обычно это делается автоматически при выборе предыдущей опции).
      • Нажмите «ОК» или «Выполнить» внизу страницы для завершения создания пользователя и базы данных.

Шаг 4: Настройка веб-сервера (добавление сайта в ServBay)

Чтобы получить доступ к сайту OctoberCMS через браузер, необходимо добавить сайт в ServBay.

1. Добавьте новый сайт

   Откройте панель управления ServBay и выберите вкладку «Сайты» в боковом меню (в старых версиях может называться «Хосты»). Нажмите «Добавить сайт».

   Заполните поля:

   • Название: укажите понятное имя, например My OctoberCMS Site.
   • Домен: введите желаемое локальное имя, например servbay-octobercms.local. Используйте суффикс .local, чтобы избежать конфликтов с реальными доменами.
   • Тип сайта: выберите PHP.
   • Версия PHP: выберите необходимую версию PHP, которая включена в ServBay и подходит для OctoberCMS.
   • Корневая директория: выберите папку проекта, созданную на шаге 1 (/Applications/ServBay/www/servbay-octobercms-app).

2. Сохраните настройки и перезапустите ServBay

   После заполнения всех данных нажмите кнопку «Сохранить». ServBay предложит применить изменения — потребуется перезапустить соответствующие сервисы (например, Caddy или Nginx) и саму панель ServBay. Следуйте инструкциям на экране, чтобы изменения вступили в силу. ServBay автоматически пропишет домен servbay-octobercms.local на локальный адрес (127.0.0.1).

Шаг 5: Настройка переменных окружения OctoberCMS

OctoberCMS (как и Laravel) использует файл .env для хранения переменных окружения: параметров подключения к базе данных, ключа приложения и прочего.

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

   В корне проекта OctoberCMS (/Applications/ServBay/www/servbay-octobercms-app) выполните команду:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. Отредактируйте файл .env

   Откройте новый файл .env в удобном текстовом редакторе. Найдите параметры базы данных и замените их на значения, созданные на шаге 3:

   # ... другие настройки ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # Замените на имя вашей базы данных
   DB_USERNAME=october_user  # Замените на имя вашего пользователя
   DB_PASSWORD=password123   # Замените на ваш установленный пароль
   
   # ... другие настройки ...

   Важно: обязательно замените значения DB_DATABASE, DB_USERNAME и DB_PASSWORD на реальные данные, которые вы указали ранее.

Шаг 6: Запуск установщика OctoberCMS

OctoberCMS предоставляет веб-мастер для финальной настройки: миграции базы данных и создания учётной записи администратора.

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

   В браузере перейдите на ваш локальный домен, добавив путь /install.php. Например:

   https://servbay-octobercms.local/install.php

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

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

   Мастер попросит вас внести параметры подключения к базе данных. Введите их такими же, как в файле .env:

   • Тип базы данных: MySQL
   • Хост базы данных: localhost или 127.0.0.1
   • Имя базы данных: october_user
   • Имя пользователя: october_user
   • Пароль: password123

   (Ещё раз — используйте свои реальные значения пароля!)

3. Укажите данные администратора

   Следуйте подсказкам и заполните форму для создания учётной записи администратора — имя пользователя, пароль, e-mail и т.д.

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

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

Шаг 7: Установка плагинов и тем (опционально)

После установки вы можете войти в административную панель OctoberCMS (https://servbay-octobercms.local/backend).

1. Установка плагинов

   Зайдите в административку, перейдите в «Система» -> «Обновления» -> «Плагины». Используйте поиск для установки нужных расширений из Marketplace.

2. Установка тем

   В разделе «Система» -> «Обновления» -> «Темы» можно найти и установить тему, которая подходит для вашего проекта.

Базовые настройки и использование после установки

После успешной установки OctoberCMS можно приступить к созданию сайта. Вот несколько начальных действий:

• Просмотр сайта: ваш сайт доступен по локальному домену https://servbay-octobercms.local/ — обычно появляется страница с дефолтной темой.
• Доступ в админку: страница входа в административную часть находится по адресу https://servbay-octobercms.local/backend, используйте созданный логин и пароль.
• Создание страниц: в панели управления перейдите в раздел «CMS» -> «Страницы» для создания и редактирования страниц сайта.
• Создание контентных блоков: раздел «CMS» -> «Контент» позволяет добавлять и редактировать многоразовые контентные фрагменты.
• Настройка темы: раздел «CMS» -> «Темы» — здесь можно настраивать параметры текущей темы, макеты, компоненты и прочее.
• Управление пользователями и правами: в разделе «Система» -> «Управление» можно добавлять пользователей и настраивать права доступа.

Часто задаваемые вопросы (FAQ)

• Вопрос: при переходе на servbay-octobercms.local отображается дефолтная страница ServBay или ошибка?
  • Ответ: Проверьте, что сайт servbay-octobercms.local действительно добавлен в панели ServBay, а его корневая папка верно указывает на /Applications/ServBay/www/servbay-octobercms-app. После изменений не забудьте перезапустить ServBay и связанные сервисы. Проверьте, что работают Caddy/Nginx и PHP.
• Вопрос: при открытии https://servbay-octobercms.local/install.php вижу пустую страницу или ошибку?
  • Ответ: Обычно это связано с ошибками PHP. Посмотрите логи ошибок PHP в панели ServBay. Распространённые причины: ошибки прав доступа (каталоги storage, themes, plugins и их содержимое должны быть доступны для записи веб-серверу), несовместимая версия PHP, отсутствие необходимых расширений.
• Вопрос: не удаётся подключиться к базе данных во время установки?
  • Ответ: Внимательно проверьте параметры подключения (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) в файле .env, они должны точно совпадать с теми, что вы создавали в phpMyAdmin. Убедитесь, что MySQL/MariaDB запущены в ServBay.
• Вопрос: команда composer create-project завершается неудачей?
  • Ответ: Проверьте, что в ServBay активированы пакеты Composer и PHP, а версия PHP соответствует требованиям. Убедитесь в наличии интернет-соединения — Composer скачивает файлы из сети.

Заключение

Благодаря удобной среде ServBay вы можете быстро и комфортно развернуть OctoberCMS на macOS. Следуя пошаговому руководству, вы сможете создать мощную и удобную платформу для разработки своего следующего web-проекта. Открывайте для себя возможности OctoberCMS и создавайте впечатляющие сайты!