OSPanel 6: быстрый старт

Содержание:

• Вступление
• Концепция новой версии
• Первая установка
• Включение модулей
• Создание проекта
• Резюме

Вступление

Пятого мая 2024г была выпущена релизная шестая версия популярного пакета OSPanel. Принцип работы с программой кардинально изменился по сравнению с предыдущей, пятой, версией, в связи с чем у многих пользователей возникли затруднения с её использованием. Ситуацию усугубляет тот факт, что на текущий момент программа не имеет привычной панели управления. Попробуем разобраться, как теперь всё работает.

Концепция новой версии

Она кардинально изменилась. По сути, OSPanel 6 – это совершенно новый продукт, предназначеный для тех же самых целей и от того же разработчика, что и OpenServer 5. Это важно. Вам стоит забыть весь опыт использования предыдущего пакета и сосредоточится на новых принципах.

1. Сервер "не работает" из коробки

Первое, что бросается в глаза – сервер "не работает" сразу после установки. Это потому что по умолчанию все модули из комплекта поставки отключены и вам следует их включить. Здесь есть своя логика: в пакете множество версий разных модулей (php, баз данных и т.п), во время установки вы можете установить их все, а можете установить только нужные именно вам. Поэтому незачем навязывать использовать по умолчанию какие-то определенные версии. Всё в ваших руках. Вы установите и включите именно то, что вам нужно.

О включении модулей рассказано ниже в разделе "Включение модулей".

2. Как настроить домены?

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

Теперь вся конфигурация описывается в конфигурационных файлах, которые должны располагаться в специальном каталоге с именем .osp (именно так, с точкой), который создан в директории вашего проекта (сайта). Но не нужно думать, что всё стало мега-сложно. Для большинства будет достаточно базовой конфигурации в единственном файле project.ini. С другой стороны, для более продвинутой настройки домена появились обширные возможности – дополнение или изменение конфигурации apache/nginx, установка переменных окружения, создание крон-задач и другое. И все это персонально для одного домена, не затрагивая остальные.

О базовом конфигурировании сайта написано ниже, в разделе "Создание нового проекта".

3. А где же Apache?

И еще один неочевидный для многих момент – "отсутствие" модулей Apache =). Такого названия нет в списке модулей и пользователи, справедливо полагая что web-сервер (как программа) необходим для работы сайтов, включают дополнительно модуль Nginx. При этом, не знают/забывают что nginx нужно отдельно настроить. Самый частый вопрос - почему не работает ЧПУ? Потому что вы его не настроили. В Apache ЧПУ (mod_rewrite) настраивается в файле .htaccess, этот файл всегда идет в комплекте с CMS или фреймворком и проблем не возникает. В nginx нет аналога такого файла, и все настраивается в основном конфиге nginx.conf. В рамках OSP6 виртуальный хост nginx может быть настроен в конфигурации домена (.osp/nginx/*.conf).

Так а что там с Апачем? Конечно, на самом деле он присутствует, но оформлен как часть модуля PHP-x.x. Если посмотреть на список модулей, то можно увидеть два типа модулей php: PHP-x.x и PHP-x.x-FCGI. Вот первый тип – это и есть php с апачем.

Так что, например, для вордпресса или джумлы просто включите модуль PHP-x.x и не включайте Nginx-x.x (особенно если не умеете его настраивать).

В комплексе еще много разных изменений и нововведений, однако в рамках статьи формата "быстрый старт", думаю этого достаточно. Остальное можно почерпнуть из официальной документации.

Первая установка

Будем полагать, что вы уже скачали и установили новую версию. Запустите программу с помощью ярлыка на рабочем столе, или дважды щелкнув по файлу OSPanel/bin/ospanel.exe. После запуска в трее панели задач появится значок программы.

Важно при первой установке согласится с установкой корневого сертификата (если вы планируете использовать ssl для своих локальных сайтов), а также с запуском инструмента подготовки системы. Если вы по каким-либо причинам этого не сделали, то это можно сделать парой команд в консоли. Выберите в меню программы пункт "Интерфейс командной строки" для открытия консоли и выполните последовательно команды:

osp cacert init
osp sysprep

Первая сгенерирует и установит SSL-сертификат, а вторая выполнит подготовку вашей системы. Что именно выполняет утилита подготовки, вы можете узнать, изучив её репозиторий.

Включение модулей

По умолчанию, после установки в пакете отключены все модули, соответственно, ничего у вас работать не будет, даже сайты-примеры.

К счатью, это легко исправить. Откройте через меню уже знакомую консоль и включите необходимые модули. Например, нам нужны php 8.1 для сайтов-примеров и php 8.2 для своего проекта. Данная версия позволяет одновременно запускать любые версии php, указывая нужную для каждого отдельного сайта. Включим их:

osp on php-8.1
osp on php-8.2

На этом этапе у вас уже заработают сайты-примеры. Перейдите в браузере по адресу https://example.local чтобы убедится в этом.

Как видите, пока всё очень просто, и не нужно часами разбираться, почему Open Server не работает =)).

Создание нового проекта (сайта)

Пройдите в каталог OSPanel/home и создайте там для него директорию. Имя не имеет значения, только не используйте кириллические символы.

Чтобы OSPanel понял, что это директория сайта, в ней нужно создать служебный каталог с именем .osp, и в этом служебном каталоге создать файл project.ini. Также создайте публичный каталог будущего сайта. Это та директория, в которую вы будете распаковывать файлы CMS или размещать собственный index.php:

OSPanel/
`-- home/
    `-- my_first_site/
        |-- .osp/
        |   `-- project.ini
        `-- public/

В файле project.ini задайте минимальную конфигурацию для сайта – укажите имя домена, необходимую версию php и расположение публичного каталога:

[mysite.local]
php_engine = php-8.2
public_dir = {base_dir}\public

Перезагрузите программу для применения изменений.

После перезагрузки можно перейти по адресу https://mysite.local и увидеть что он работает. Осталось только разместить в директории home\my_first_site\public файлы вашего сайта и продолжить над ним работу.

Для ваших сайтов скорее всего потребуется база данных. Включить соответствующий модуль всё так же легко:

osp on mysql-8.0

А если вы привыкли работать с PhpMyAdmin, то у меня для вас есть инструкция по его установке.

Резюме.

Начать использовать OSPanel шестой версии на самом деле довольно просто.

1. Включите необходимые вам модули.
2. Создайте папку для сайта.
3. Задайте в файле папка_сайта\.osp\project.ini минимальную конфигурацию для сайта.

А для более продвинутого использования можно ознакомится с документацией, Например, вы можете легко создавать структуру для проектов на Laravel и в пару кликов открывать консоль со всем необходимым окружением для выполнения artisan-команд. Или хранить проекты отдельно от установки OSPanel, указав собственный домашний каталог для сайтов.

Не пугайтесь нового, приятной разработки!