Установка PHP фреймворка HLEB на Open Server

Проект Open Server (не путать с одноимённой OS OpenServer) помогает автоматизировать локальное развёртывание проекта. Если возникла необходимость установки именно на нём, то вот краткая инструкция с картинками.

Open Server Panel — это портативная программная среда, созданная специально для веб-разработчиков с учётом их рекомендаций и пожеланий. OSPanel широко используется с целью разработки, отладки и тестирования веб-проектов, а также для предоставления веб-сервисов в локальных сетях.

Настройка проекта

Используемый здесь Open Server (5.4.3) был переустановлен полностью, поэтому настройки по умолчанию везде оригинальные, кроме далее изменяемых: До этого работало на более ранних версиях и принципиально больших различий по установке нет. Сначала направим веб-сервер в публичную папку:

Если у вас веб-проекты хранятся в одной директории, то можно указать её в качестве основной и в дальнейшем пути к проектам будут короче.

Здесь у меня основная папка d:\web, также в этой панели обозначен порт для MySQL, это значение будет в дальнейшем установлено в конфиг фреймворка.

Для HLEB2 поддерживаемые версии PHP от 8.2 и выше.

Сам проект расположен в папке d:\web\test-project, так что осталось указать конкретную папку с публичной директорией, она называется public. Домен для разработки назвал test-project.loc.

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

После этого сервер перезагрузится. Нужно убедиться, что он запущен, иконка в трее должна быть активна, выглядит это так:

На скриншоте видно, что ссылка на проект уже доступна в разделе Мои проекты.

Настройка MySQL

Теперь перейдём к настройке базы данных, в шаблоне фреймворка заданы примеры для подключения различных БД, но подключаются они одинаковым способом. Пример для MySQL (для версии HLEB2 формат отличается):

define ("HLEB_TYPE_DB", "mysql.example");

define("HLEB_PARAMETERS_FOR_DB", [

    "mysql.example" => [
        "mysql:host=localhost",
        "port=3306",
        "dbname=test",
        "charset=utf8",
        "user" => "root",
        "pass" => "",
    ]
]);

Конфигурационный файл БД фреймворка HLEB расположен в файле /database/dbase.config.php. Подробную информацию можно найти в инструкции и примерах конфигурации в самом файле.

Настройка MySQL (HLEB2)

Для версии HLEB2 подключение настраивается в файле "/config/database.php".

return [
// Здесь указывается подключение по умолчанию (по его имени).
  'base.db.type' =>'mysql.name',

// Перечень существующих подключений.
  'db.settings.list' => [
        'mysql.name' => [
            'mysql:host=localhost',  // Хост MySQL
            'port=3306', // Порт MySQL
            'dbname=databasename', // Название конкретной базы данных.
            'charset=utf8', // Кодировка соединения с БД
            'user' => 'username', // Имя пользователя
            'pass' => 'password', // Пароль
        ],
] ];

phpMyAdmin

В примере выше указана БД test, которую нужно создать при отсутствии. Естественно, что название базы данных, как и домена с папкой проекта являются демонстрационными и в своём проекте можете использовать любые возможные. Для просмотра и изменения БД можно воспользоваться предустановленным в Open Server Panel phpMyAdmin.

В этой версии Open Server логин и пароль к phpMyAdmin такие же, как указаны выше к базе данных.Теперь осталось только создать нужную БД.

При изменении модулей в OpenServer (версии PHP, БД etc) нужно иметь ввиду, что их настройки и контент БД нужно будет создавать заново, это совершенно разные окружения.

Консоль Open Server

Панель Open Server позволяет выполнять команды из консоли.

Для данного демонстрационного проекта сначала нужно перейти в папку d:\web\test-project, где он находится. Затем выполнил команду php console --help фреймворка, чтобы пробно вывести список доступных консольных команд.