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

Обратите внимание, что в OSPanel v6 для подключения к базе данных в качестве имени хоста следует использовать имя модуля вашей БД. Например 

HOST=MySQL-8.0

Важно! Никогда не используйте localhost в качестве имени хоста в OSPanel v6.

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

Резюме.

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

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

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

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

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

Прохожий

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

Прохожий

Отличный гайд. сделал все по инструкции. 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.

Прохожий

В топку теперь этот Open Server. Чтобы развернуть свой старый проект на динамических поддоменах без толку потратил 3 часа, OS упорно мне выдает "Как вы здесь оказались?", хотя все конфиги настроены верно, включая dns, nginx и т.д. Зачем-то полезли конкурировать с докером, а получилось всё как всегда.

Прохожий

Раньше в интерфейсе можно было где угодно организовать корень проекта - как сейчас сделать так что бы все смотрело в /public/index.php для symfony Нахрена мне какие-то костыли - проще тогда на локали symfony запустить без этого новорожденного говна. Раньше было удобно юзать на локали для разных проектов - тут тебе на wp, opencart и тут же кастомные на фреймверках. Теперь это бесполезная дичь - проще нативные юзать

delphinpro

как сейчас сделать так что бы все смотрело в /public/index.php для symfony

В статье как раз и описан вариант для Laravel/Symfony. Корень проекта - в home/my_first_site, а корень сайта смотрит в home/my_first_site/public. Прочитайте, пожалуйста внимательнее.

delphinpro

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

C динамическими поддоменами, действительно, проблема. И я не знаю как её решать. Разработчик OSP говорит о том, что звездочку в винде нельзя использовать в домене и советует использовать dns сервер - bind или unbound. Но у меня в этом вопросе нет компетенции.

Прохожий

Работать можно. 1 Но надо было оставить цветные иконки, так легче ориентироваться. 2 Phpmyadmin установить 3 При переносе проектов с 5 на 6 версию надо предупреждать, в конфигурации вашего проекта изменить в database host с localhost на то, что у вас будет подключено, например 'MySQL-5.6' Иначе база данных не запустится. Не знаю как у других, но в моём случае только так заработало.

Прохожий

Собственно, зачем мне сейчас понадобился openserver... Добавить несколько сайтов со ссылками на домашний компьютер - для мамы, для папы, для кошки, для собаки, для тараканов. Тараканы ходят на свои тараканьи ресурсы, папа - на папьи и т.п. Я могу это сделать на версии 6, но тараканы не понимают, что нужно делать, если у них нет кнопочки - Открыть все тараканьи ресурсы. Работа в командной строке это интересно, но утомляет.

Прохожий

Сразу видно в коммах одни новички да бездари, я тоже слегка удивился когда поставив новую версию не увидел привычного gui, пошел погуглить как дружить с новой версией и покопавшись полчаса пришел к выводу что это намного удобнее чем было в прошлой версии, полный контроль над системой, для каждого домена свой конфиг это не сомненый плюс, плюс ssl из коробки, в общем пока что очень доволен новой версией, теперь не нужно при необходимости как овощ менять профили с конфигом php/nginx/mysql на каждый чих, создал домен, добавил конфиг и сразу указал нужные параметры и все

Прохожий

Те кто пишет о сложности настройки видимо настолько ленивые, что не решились даже изучить инструкцию. Всё настраивается очень просто. У меня настройка заняла от силы 10 минут (установка Open Server + установка phpMyAdmin)

Прохожий

протрахался пол дня так и не завелось.. Видимо теперь только докер.

delphinpro

протрахался пол дня так и не завелось.. Видимо теперь только докер.

Боюсь, вы не осилите докер, если с такой простой вещью не справились.

Прохожий

Благодарю. Этот гайд надо на страницу скачивания OSPanel.

Прохожий

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

Прохожий

Я сначала пытался найти PHPmtadmin, пока я не понял, что его вообще нет. Зачем его надо было убирать?

delphinpro

Я сначала пытался найти PHPmtadmin, пока я не понял, что его вообще нет. Зачем его надо было убирать?

Прежде всего прочитайте официальную документацию. Там вполне доходчиво описаны причины отсутствия PMA в комплекте.

Прохожий

Статья норм, все сделал, а вот с алиасами я не разобрался, хотелось бы дополнить статью

delphinpro

Народ, здесь обсуждается содержимое статьи, а не OpenServer.

Прохожий

во дают :)

https://www.php.net/manual/ru/features.commandline.webserver.php

Прохожий

Подскажите, пожалуйста подробно, как подключит к проекту на WordPress модуль сервера Redis. Нигде конкретно об этом не говорится.

delphinpro

Так же, как MySQL, Redis к проектам не подключается. Наоборот, ваши скрипты/cms/фреймворки подключаются к Redis. Вам нужно лишь включить необходимый модуль редиса и указать параметры подключения к нему в вашем скрипте. Параметры подключения описаны в документации.

Прохожий

Извини, в документации нет ничего. Не надо все сваливать на документацию. По поводу подключения Redis - я вчера, вечером, подключил и все работает.

  1. Подключается к проектам так же как и PHP: через файл project - redis_engine = redis-7.2;
  2. Устанавливается плагин: redis-cache.2.5.3;
  3. В файл wp-config.php добавляется запись: define( 'WP_REDIS_HOST', '127.127.126.48' ); define( 'WP_REDIS_PORT', 6379 ); define( 'WP_REDISPREFIX', 'sit-info.ru'); define( 'WP_REDIS_DATABASE', 0 ); // 0-15 define( 'WP_REDIS_TIMEOUT', 1 ); define( 'WP_REDIS_READ_TIMEOUT', 1 );

IP добавляется с настроек, взятых с Redis. В PREFIX добавляешь домен своего сайта.

Прохожий

Извини, но форматирование в комментариях не позволило правильно вставить код. Вот ссылка: https://github.com/rhubarbgroup/redis-cache/blob/develop/INSTALL.md

Прохожий

Подскажите как добавить ionecube на Window 10 pro 64 bit (Openserver 6) php 7.4 не понимаю какую версию ionecube скачивать Windows VC11 (64 bits) , Windows VC11 (Non-TS) (64 bits) , Windows VC14 (64 bits) , Windows VC14 (Non-TS) (64 bits) , Windows VC15 (64 bits) , Windows VC15 (Non-TS) (64 bits) , Windows VC16 (64 bits) , Windows VC16 (Non-TS) (64 bits)/ Я запутался не понимаю, какую выбрать версию под свою конфигурацию

delphinpro

Извини, в документации нет ничего. Не надо все сваливать на документацию.

Вот это вот redis_engine = redis-7.2; - никакого эффекта не даёт.

А параметры подключения в доке есть. В разделе "Подключение к модулям".

https://github.com/OSPanel/OpenServerPanel/wiki/Документация

delphinpro

Ioncube кто-то устанавливал и описывал на форуме. Там посмотрите. Я этим расширением не пользуюсь.

Прохожий

А мне все нравится. Инструкцию прочитал потыкался и все понял. Очень круто.

Прохожий

Пытаюсь по вашей инструкции включить модуль php-8.1, чтобы заработали сайты-примеры. Пишу в консоли: osp on php-8.1. Получаю ответ:

ERROR Command: osp on PHP-8.1 Message: Failed to execute command

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

delphinpro

Консоль нужно открывать через меню в трее.

Как вариант, нужный модуль можно включить через то же меню, без консоли.

Прохожий

Разобрался. Проблема была в программе Proxifier. Как только вырубил ее, все заработало. Извините за беспокойство и спасибо за статью!

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

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

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