Содержание:
- Вступление
- Концепция новой версии
- Первая установка
- Включение модулей
- Создание проекта
- Использование базы данных
- Резюме
Вступление
Пятого мая 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 шестой версии на самом деле довольно просто.
- Включите необходимые вам модули.
- Создайте папку для сайта.
- Задайте в файле
папка_сайта\.osp\project.ini
минимальную конфигурацию для сайта.
А для более продвинутого использования можно ознакомится с документацией, Например, вы можете легко создавать структуру для проектов на Laravel и в пару кликов открывать консоль со всем необходимым окружением для выполнения artisan-команд. Или хранить проекты отдельно от установки OSPanel, указав собственный домашний каталог для сайтов.
Не пугайтесь нового, приятной разработки!
Комментарии (30)
Для новичков это полный бред, сейчас если выходит обновление на какой либо продукт, это не облегчает а только усложняет, у разработчиков уже нет такого понимания как легко и просто, сейчас в приоритете сложно и не понятно.
Отличный гайд. сделал все по инструкции. https://example.local/ - не отображается https://full-example.local/ тоже https://mysite.local Не удается получить доступ к сайту в прошлой версии эти манипуляции занимали минуты 3 с распаковкой WP Ну что же, разбираться лень, вернусь в прошлую версию. Спасибо
Да этим товарищам бесполезно объяснять. Они предали свою аудиторию и придумали у себя в головах некую аудиторию "профессионалов". Только вот профики работают на работе на конкретных стеках, дома подключаются удаленно к рабочим машинам и не делают сайты на Wordpress. В общем, uninstall
какой ужас, придется остаться на 5.4.3
Причина одна - не включён соответствующий модуль php. А значит вы не всё сделали по инструкции. Для работы доменов
example.local
иfull-example.local
необходимо включить модуль PHP-8.1. Для работы сайтаmysite.local
нужно включить тот модуль, который вы назначили для данного домена.Я не понял, зачем нужна 6 версия в таком виде, если есть докер. Какие профессионалы будут пользоваться OSPanel? Они не знают о существовании других девопсовских решений? Если лень настраивать проект на докере, тянуть и настраивать весь стек и хочется быстро накидать прототип приложения - в 6-й версии теперь это просто невозможно, раньше лично я использовал OSPanel именно для таких случаев. Предполагаю, что разработчики столкнутся с тем, что сумма донатов заметно снизится, ибо пользовалась продуктом в массе своей именно та аудитория, которая не умеет в докер и ручную настройку стека. Эту аудиторию разработчики попросту кинули, значит, когда эти пользователи увидят, ЧТО они скачали, этот донат станет их последним в адрес разрабов. Мертворожденный продукт, на мой взгляд, пользоваться не буду - неперспективно тратить время. Вплоть до 5 версии основной запрос был - быстрый старт и юзер-френдли на кнопочках. Теперь этого всего просто нет. Теперь проще Portainer накатить или стартовыми сборками под докер пользоваться.
Я всегда выбирал Openserver за простоту запуска и удобство включение выключение различных модулей. Но сейчас в новой версии 6 все стало очень сложно. Печально(.
Для меня было сложно разобраться, изначально было страшно и непонятно зачем скачал данную версию, но после данной документации все ясно и понятно + phpMyAdmin установил. Как раз учусь работать с серверами и консолью, шестая версия в этом поможет)
Вы точно статью до конца прочитали? Вся сложность заключается в создании файла
.osp\project.ini
. Не могу поверить, что создать файл - очень сложное действие.Спасибо! В этой версии чета намудрили непонятно. по этой инструкции смог запустить свои сайты. Всеравно панели не хаватает как в старом оперсервере
У меня настройка сервера в ручную столько же времени занимает, сколько здесь создание одного проекта...И зачем мне это.
Это время на чтение статьи и понимание работы нового 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 и тут же кастомные на фреймверках. Теперь это бесполезная дичь - проще нативные юзать
В статье как раз и описан вариант для Laravel/Symfony. Корень проекта - в
home/my_first_site
, а корень сайта смотрит вhome/my_first_site/public
. Прочитайте, пожалуйста внимательнее.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)
протрахался пол дня так и не завелось.. Видимо теперь только докер.
Боюсь, вы не осилите докер, если с такой простой вещью не справились.
Благодарю. Этот гайд надо на страницу скачивания OSPanel.
Для старых версий было полно гайдов в ютубе и на форумах. Сейчас я открыл, потыкал, ужаснулся. Пытаюсь разобраться и не понимаю, для чего вообще надо было так усложнять.
Я сначала пытался найти PHPmtadmin, пока я не понял, что его вообще нет. Зачем его надо было убирать?
Прежде всего прочитайте официальную документацию. Там вполне доходчиво описаны причины отсутствия PMA в комплекте.
Статья норм, все сделал, а вот с алиасами я не разобрался, хотелось бы дополнить статью
Вы можете оставить комментарий: