Памятка для новичка: переходим с Open Server Panel 5.x на 6.x

[OSPanel]

Если вы привыкли к пятой версии, шестая поначалу собьёт с толку — и это нормально, потому что в ней изменилась сама логика работы. Разберём всё спокойно и по порядку.

Главное, что нужно понять

Раньше Open Server работал как один большой выключатель: вы нажимали «Запустить», и поднимались все сайты на одних и тех же версиях PHP, MySQL и веб-сервера.

В шестой версии этого общего выключателя больше нет. Теперь вы настраиваете каждый сайт по отдельности. У каждого проекта свой набор модулей (своя версия PHP, своя база данных, свой веб-сервер), и эти модули можно включать и выключать независимо.

Запомните новую формулу работы: создал проект → выбрал для него модули → включил эти модули. Держите её в голове, и всё остальное встанет на свои места.

Подготовка системы

Во время установки Open Server Panel 6.x важно не пропустить запуск утилиты System Preparation Tool. Она подготавливает Windows к корректной работе OSPanel: выполняет необходимые системные настройки и устраняет типичные ограничения.

Если не запустить System Preparation Tool, Open Server Panel может работать некорректно: проекты и модули могут не запускаться, сайты могут не открываться, подключение к базам данных может длится более 1 сек и т.д.

Утилиту нужно запустить один раз во время установки с правами администратора не отключая предложенные опции. При этом саму Open Server Panel в дальнейшем запускать от имени администратора не рекомендуется.

Как теперь запускается сайт

Понятия «сервер запущен / остановлен» больше нет.
Вы управляете не программой целиком, а отдельными проектами. Один сайт может работать на старом PHP, а другой одновременно — на новом, и они не мешают друг другу. Несколько версий одного и того же модуля (например, MySQL 5.7 и MySQL 8.0) тоже могут работать параллельно.

Все модули по умолчанию выключены.
Это важный момент: после установки ничего не работает «само». Для каждого проекта нужно сначала выбрать модули (как минимум веб-сервер и PHP), а затем их включить.

После выбора модули нужно обязательно включить.
Это самый частый промах новичков. Указать версии в настройках — это ещё не всё. Чтобы сайт ожил, откройте: Меню → Проект → Включить модули проекта. Пока вы этого не сделаете, проект работать не будет.

Как вообще создаётся проект.
В папке home Open Server создаётся каталог проекта, например home\example.local. Внутри него — папка .osp (там лежат настройки, главный файл — project.ini) и обычно папка public (туда кладутся файлы сайта). После создания папок перезапустите Open Server Panel — программа сама обнаружит проект и создаст в .osp базовые файлы настроек. После этого выберите версии движков (PHP / веб-сервер / Node) через меню и включите модули проекта.

Пример:

C:\OSPanel\
└── home\
    └── example.local\          ← корневой каталог проекта (имя = домен сайта)
        ├── .osp\               ← служебная папка с настройками проекта
        │   └── project.ini     ← главный файл настроек (версии PHP/веб-сервера и т.д.)
        └── public\             ← сюда кладутся файлы вашего сайта
            └── index.php       ← стартовая страница (http://example.local)

Имя проекта не может быть auto.
Это служебное имя, зарезервированное программой. Также не давайте проекту имя localhost и имена, совпадающие с названиями модулей.

Что изменилось с базами данных

Адрес localhost для базы данных больше не работает.
В пятёрке вы почти наверняка подключались к базе через localhost и не задумывались об этом. В шестёрке так нельзя.

Хостом базы данных теперь служит имя модуля.
Например, для MySQL версии 5.7 это будет MySQL-5.7 (регистр не важен, можно mysql-5.7). Если приложение требует «доменное» имя, можно добавить .local — получится mysql-5.7.local. Остальные параметры подключения при этом остаются стандартными:

• порт — обычный для этой СУБД (для MySQL это 3306, для PostgreSQL — 5432);
• пользователь — стандартный (root для MySQL, postgres для PostgreSQL);
• пароль — по умолчанию пустой.

Небольшая оговорка про другие сервисы.
Не все модули используют имя модуля как хост — например, почтовые (SMTP) и DNS-модули работают через localhost. Но для обычной работы с MySQL / MariaDB / PostgreSQL запомните главное правило: хост = имя модуля. Точные значения всегда есть в документации в разделе «Подключение к модулям».

При переносе старого сайта проверьте настройки подключения.
В конфиге вашего сайта (часто это config.php или .env) найдите host, port, имя базы, логин и пароль — и поправьте как минимум host (он больше не localhost).

Если что-то пошло не так

Сайт не открывается? Проверьте по списку.
Раньше вы бы спросили: «А запущен ли Open Server?». Теперь вопросы другие:

• тот ли проект выбран;
• назначены ли ему веб-сервер и PHP;
• включены ли модули проекта.

Сайт переехал, но выдаёт ошибки? Проверьте версии.
Частая причина в том, что проекту назначена неподходящая версия PHP, базы данных или веб-сервера. Кстати: если указанный для домена модуль PHP или веб-сервера не установлен, проект будет просто проигнорирован.

Что полезно знать заранее

Когда нужен перезапуск, а когда нет.
Это удобная деталь, которой не было раньше. Перезапуск всей программы нужен, когда вы создаёте новый проект, правите файл project.ini или меняете настройки модулей. А вот смена версии PHP, веб-сервера или Node через меню перезапуска не требует — программа всё делает автоматически.

Расширения PHP по умолчанию выключены.
Их больше 115-ти, и включать их «про запас» не нужно — это замедляет работу и может вызвать конфликты. Чтобы включить нужное (например, xdebug или imagick), раскомментируйте строку в шаблоне config\<версия PHP>\default\templates\php.ini и перезапустите модуль PHP.

Настройки модулей правьте в шаблонах, а не во временных файлах.
Рабочие конфиги пересоздаются программой при каждом запуске, так что менять их бессмысленно. Редактируйте файлы в каталоге config\<имя_модуля>\<профиль>\templates, а затем перезапустите модуль.

Не запускайте Open Server Panel от имени администратора.
Это прямо не рекомендуется в документации (угроза безопасности и не нужно для работы). Исключение — утилита подготовки системы (System Preparation Tool), которую при установке нужно запустить с правами администратора один раз.

PowerShell не поддерживается.
Для работы с командами osp используйте обычную командную строку (CMD) или Windows Terminal с профилем «Командная строка», а не «Windows PowerShell».

Для HTTPS-сайтов в некоторых браузерах нужно вручную добавить сертификат.
Браузеры, которые не используют хранилище сертификатов Windows (например, Firefox), будут ругаться на самоподписанный сертификат. Импортируйте корневой сертификат data\ssl\root\cert.crt в браузер. Повторять это придётся каждый раз после команды osp cacert init.

Главный совет

Забудьте привычки из пятёрки и пройдите один проект целиком.
Обязательно прочитайте официальную документацию — логика версии 6 принципиально другая, и попытки действовать «как в пятёрке» приведут к путанице.

Подход «нажал кнопку — всё заработало» здесь только мешает. Самый надёжный способ освоиться — собрать один пробный проект от начала до конца: создать папки → перезапустить программу → выбрать модули → включить их → подключиться к базе. После этого все остальные сайты вы будете настраивать почти на автомате.