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

40307dfafed213bfdf35aa5dd241d833b358c87a
Коротко объясняю как быстро начать работу с Open Server Panel v.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 файлы вашего сайта и продолжить над ним работу.

Не обязательно создавать папку public, файлы сайта вполне можно располагать в корне проекта (home\my_first_site). В этом случае вам не нужно указывать в конфигурации параметр public_dir.

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

osp on mysql-8.0

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

Резюме.

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

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

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

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

Комментарии (15)

Прохожий

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

Прохожий

Отличный гайд. сделал все по инструкции. https://example.local/ - не отображается https://full-example.local/ тоже https://mysite.local Не удается получить доступ к сайту в прошлой версии эти манипуляции занимали минуты 3 с распаковкой WP Ну что же, разбираться лень, вернусь в прошлую версию. Спасибо

Прохожий

Да этим товарищам бесполезно объяснять. Они предали свою аудиторию и придумали у себя в головах некую аудиторию "профессионалов". Только вот профики работают на работе на конкретных стеках, дома подключаются удаленно к рабочим машинам и не делают сайты на Wordpress. В общем, uninstall

Прохожий

какой ужас, придется остаться на 5.4.3

delphinpro

https://example.local/ - не отображается
https://mysite.local Не удается получить доступ к сайту

Причина одна - не включён соответствующий модуль php. А значит вы не всё сделали по инструкции. Для работы доменов example.local и full-example.local необходимо включить модуль PHP-8.1. Для работы сайта mysite.local нужно включить тот модуль, который вы назначили для данного домена.

Прохожий

Я не понял, зачем нужна 6 версия в таком виде, если есть докер. Какие профессионалы будут пользоваться OSPanel? Они не знают о существовании других девопсовских решений? Если лень настраивать проект на докере, тянуть и настраивать весь стек и хочется быстро накидать прототип приложения - в 6-й версии теперь это просто невозможно, раньше лично я использовал OSPanel именно для таких случаев. Предполагаю, что разработчики столкнутся с тем, что сумма донатов заметно снизится, ибо пользовалась продуктом в массе своей именно та аудитория, которая не умеет в докер и ручную настройку стека. Эту аудиторию разработчики попросту кинули, значит, когда эти пользователи увидят, ЧТО они скачали, этот донат станет их последним в адрес разрабов. Мертворожденный продукт, на мой взгляд, пользоваться не буду - неперспективно тратить время. Вплоть до 5 версии основной запрос был - быстрый старт и юзер-френдли на кнопочках. Теперь этого всего просто нет. Теперь проще Portainer накатить или стартовыми сборками под докер пользоваться.

Прохожий

Я всегда выбирал Openserver за простоту запуска и удобство включение выключение различных модулей. Но сейчас в новой версии 6 все стало очень сложно. Печально(.

Прохожий

Для меня было сложно разобраться, изначально было страшно и непонятно зачем скачал данную версию, но после данной документации все ясно и понятно + phpMyAdmin установил. Как раз учусь работать с серверами и консолью, шестая версия в этом поможет)

delphinpro

Но сейчас в новой версии 6 все стало очень сложно. Печально(.

Вы точно статью до конца прочитали? Вся сложность заключается в создании файла .osp\project.ini. Не могу поверить, что создать файл - очень сложное действие.

Прохожий

Спасибо! В этой версии чета намудрили непонятно. по этой инструкции смог запустить свои сайты. Всеравно панели не хаватает как в старом оперсервере

Прохожий

У меня настройка сервера в ручную столько же времени занимает, сколько здесь создание одного проекта...И зачем мне это.

delphinpro

У меня настройка сервера в ручную столько же времени занимает, сколько здесь создание одного проекта...И зачем мне это.

Это время на чтение статьи и понимание работы нового OSP. Одноразовая процедура. Потом, когда вы будете всё это знать и понимать, для создания одного проекта вам достаточно будет создать один файл. Сколько времени это займет вместе с перезагрузкой сервера? Ну секунд 30, не более. Не верю, что вы настраиваете сервер вручную за 30 секунд.

Прохожий

Да нормально всё. Система Windows7-x64. Ну, почти всё. Пришлось "попрыгать" с файлом HOSTS - при запуске инструмента подготовки системы хоть из установки, хоть отдельно - возникала ошибка доступа к HOSTS. Пришлось пропустить. Но без неё модули не запускаются - красные треугольники вместо зелёных кубиков. Потом потыкалась и изменила права доступа к изменению файла HOSTS для "Всех" ручками, в свойствах файла (вкладка безопасность). Сервер заработал. Как изменить - подробно здесь https://youtu.be/Z_i0VgIcP8Q?si=0xTh-9_tuw8Wrksb (даже излишне подробно).

Прохожий

Честно говоря почитал все эти инструкции и осознал, что развернуть все тоже самое на докере у меня займёт примерно столько же времени. По сути скачал Open Server по старой памяти потому что хотел быстро развернуть на новом ноутбуке локальную версию сайта. Но видимо время пришло привыкать работать в Докере в том числе и на домашнем windows ноутбуке.

Прохожий

Usually I don't read article on blogs, however I would like to say that this write-up very forced me to check out and do it! Your writing taste has been surprised me. Thank you, very nice article.

Вы можете оставить комментарий:

Поддерживается разметка markdown

Комментарий будет опубликован после модерации