Manuals
RU EN

Старт · 03

Установка скрипта

Старт 6 мин чтения

Ставите скрипт Microscript так же, как любой нормальный PHP/MySQL-проект: файлы в document root, пустая база, доступы в установщик или в конфиг. Красивых «мастеров в один клик» у хостеров под наши архивы обычно нет — и это нормально. Если ждать кнопку «установить скрипт» в панели Beget или Timeweb, можно потерять вечер.

Ниже — рабочий порядок, которым пользуемся при разборе тикетов. Не теория из учебника. Скрипт у вас уже скачан, архив распакован, PHP 8 на сервере есть (если нет — сначала требования PHP и MySQL).

Куда класть файлы

Корень сайта — это то, что веб-сервер отдаёт как /. На shared часто это public_html, www или httpdocs. В ISPmanager смотрите поле «корневая директория» у домена. На VDS с Nginx/Apache — путь из root / DocumentRoot.

Локально в MicroServer проще: папка домена лежит в D:\MicroServer\www, имя папки совпадает с хостом. Для board.loc файлы идут в D:\MicroServer\www\board.loc. Отдельный vhost руками писать не нужно — см. виртуальный хост *.loc.

Не кладите скрипт в подпапку «на всякий случай», если потом хотите открывать сайт с корня. Тогда все ссылки поедут, а в базе иногда уже зашит URL. Если архив внутри себя содержит каталог вроде upload/ или public/ — читайте readme из комплекта. У большинства наших продуктов document root = корень распакованного архива.

База MySQL до установщика

Создайте пустую базу в кодировке utf8mb4. Collation — utf8mb4_unicode_ci или utf8mb4_general_ci, оба живые. Старый utf8 без mb4 лучше не брать: эмодзи и часть символов потом всплывут кракозябрами.

  • Пользователь базы — с правами только на эту базу. Не «все привилегии на *.*», если панель это предлагает по умолчанию для root-клона.
  • Хост БД: локально почти всегда 127.0.0.1 или localhost. На shared — смотрите карточку БД в панели; иногда это не localhost, а что-то вроде localhost:/tmp/mysql.sock или отдельный hostname.
  • Пароль копируйте без пробела в конце. Access denied из-за лишнего пробела встречается чаще, чем хочется признавать.

Локально базу удобно завести через phpMyAdmin. На проде — через панель хостинга или CLI. Пока база пустая и пользователь не привязан, установщик честно упадёт на шаге подключения — это не баг скрипта.

Права на каталоги

Перед первым открытием сайта проверьте, что веб-сервер может писать в каталоги загрузок, кэша и временных файлов. Типичная схема: каталоги 755, файлы 644. На shared иногда выручает 775 на upload, если владелец файлов не совпадает с php-fpm. Подробнее — права chmod.

Конфиг с паролем БД не выставляйте в 777. Если после распаковки «всё в 777» — это не ускорение, это приглашение.

Первый запуск установщика

  1. Откройте домен в браузере. Должен открыться установщик или редирект на него. Если видите листинг каталога — нет index.php в корне или document root смотрит не туда.
  2. Введите хост, имя базы, логин и пароль. Сохраните эти же данные — они же потом окажутся в конфиге.
  3. Задайте логин и пароль администратора. Не оставляйте admin/admin «на потом».
  4. Если скрипт просит удалить или переименовать папку install / файл установщика — сделайте это сразу. Иначе через неделю вспомните, когда бот снова найдёт форму.

Если на шаге базы вылезло SQLSTATE[HY000] [1045] Access denied или Unknown database — не крутите установщик по кругу. Идите в ошибку подключения MySQL и сверьте хост/логин/права.

Белый экран или HTTP 500 на первом же запросе — смотрите error_log, версию PHP и .htaccess. Чеклист: ошибка 500.

Что проверить сразу после входа в админку

Зашли — не закрывайте вкладку «и так сойдёт». Пройдитесь по живому:

  • Открывается ли публичная главная без ошибки соединения с БД.
  • Есть ли разделы каталога / объявлений / товаров — в зависимости от продукта.
  • Загрузка одной картинки в админке: файл появился на диске, в карточке отображается.
  • Смена пароля администратора и выход/вход заново.

Демо-наполнение можно оставить, пока смотрите интерфейс. Перед показом клиенту — вычистить или скрыть. Название проекта, почту отправителя и часовой пояс лучше прописать в первый же день: иначе письма уйдут с «Site» и кривым временем в логах.

Shared, VDS и локалка

На shared часто хватает PHP 8.x из селектора версии, одной базы и доступа по FTP/SFTP. Cron и почту настраиваете отдельно — см. cron для скрипта и карточку хостинга в подборе хостинга.

На VDS вы сами отвечаете за Nginx/Apache, PHP-FPM и firewall. Это не страшнее, просто другой контур: VDS для PHP, при необходимости Nginx + PHP-FPM.

Локальный стенд под Windows — MicroServer, не старый Денвер на PHP 5. Кратко: локальный сервер, если ищете по запросу «денвер» — замена Денвера.

Если после установки «сайт пустой». Сначала откройте исходный код страницы и error_log. Пустой body при 200 часто значит display_errors выключен, а Fatal Error уже в логе. Не переустанавливайте базу вторым кругом, пока не прочитали одну строку ошибки.

После установки — короткий хвост

Смените пароль админа, если ставили временный. Укажите URL сайта так, как он будет снаружи (со схемой https, если SSL уже есть — SSL на сайте). Проверьте, что почта с форм уходит: на shared часто нужен SMTP хостера, а не голый mail().

Бэкап после удачной установки — не паранойя. Сделайте дамп и архив файлов, пока всё ещё «свежее и чистое». Потом, когда накопятся загрузки и правки, восстанавливаться больнее. Как снимать копию: бэкап PHP и MySQL.

Если что-то встало на середине и в письме в поддержку пишете «не ставится» — приложите продукт, домен, шаг установщика и текст ошибки без пароля. Шаблон обращения: поддержка и обновления.

Типичные грабли первого дня

  • Архив распакован во вложенную папку — установщик по адресу /subdir/, а вы открываете корень.
  • База создана в latin1 — потом боль с кодировкой.
  • На shared выбран PHP 7.4 «по умолчанию».
  • После установки не удалили install — лишний риск.
  • Забыли cron — «VIP не снимается» через неделю.

Cron: мануал. PHP-версия: требования. Права на upload: chmod.

SSL сразу или потом

Можно поставить скрипт по http и включить SSL следом. Тогда сразу поправьте URL в настройках на https. Или выпустите сертификат до установки — тоже нормально. Главное не получить петлю редиректов. Боевой SSL: SSL, локально: HTTPS на .loc.

Несколько продуктов на одном сервере

Отдельный хост (или поддомен) и отдельная база на каждый скрипт. Общий «склад» файлов без изоляции заканчивается чужим document root и чужим конфигом. На VDS — разные vhost: Nginx, VDS. На локалке — разные *.loc: виртуальный хост.

Когда писать в поддержку на этапе установки

Есть текст ошибки из лога, PHP 8 уже включён, база создана, права на upload выданы, а установщик всё равно падает на конкретном шаге — тогда да. До этого пройдите ошибку базы и 500. Ожидания по срокам ответа: SLA.

Частые вопросы

Как установить php скрипт на хостинг?

Куда класть файлы, как создать базу и что проверить сразу после первого входа.

Сколько времени занимает «Установка скрипта»?

Ориентир по тексту мануала — около 6 мин. На практике зависит от хостинга и подготовки базы.

Нужен ли отдельный сервер?

Для большинства скриптов достаточно хостинга или VDS с PHP и MySQL. Подбор сервера — в разделе VDS и требованиях к PHP/MySQL.

Требования php mysql для скрипта?

Разбор рядом в мануале по этому запросу. требования php mysql для скрипта

Ошибка подключения к базе при установке скрипта?

Разбор рядом в мануале по этому запросу. ошибка подключения к базе при установке скрипта

Раздел
Установка PHP-скрипта

От требований к серверу до SSL и cron — все мануалы по запуску готового PHP-скрипта.