Прохождение веб-установщика

FeedbackPulse SaaS включает красивый браузерный установщик. Командная строка не нужна (после первоначальной загрузки файлов и composer install).

Запуск установщика

Перейдите по адресу:

https://yourdomain.com/install

Установщик не отображается? Убедитесь, что:

Ваш веб-сервер указывает на директорию public/

Apache mod_rewrite включён (или Nginx настроен с правильным try_files)

Файл storage/installed.lock отсутствует (он блокирует установщик после первой установки)

Шаг 1: Приветствие и лицензия

Первый экран приветствует вас и запрашивает код покупки Envato/CodeCanyon.

Где найти код покупки:

Войдите на CodeCanyon
Перейдите в Downloads → найдите FeedbackPulse SaaS
Нажмите Download → License certificate and purchase code
Код покупки выглядит так: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Что происходит:

Проверяет вашу лицензию через API Envato
Подтверждает наличие легитимной копии
Разблокирует остальную часть установщика

Шаг 2: Проверка требований

Установщик автоматически сканирует ваш сервер и проверяет:

Версию PHP

Требуется PHP 8.4 или выше
Показывает вашу текущую версию PHP

Зависимости Vendor

Проверяет наличие vendor/autoload.php (зависимости Composer должны быть установлены или загружены)

Расширения PHP

Проверяются следующие:

pdo_mysql — подключение к базе данных
mbstring — обработка строк
openssl — шифрование
tokenizer — парсинг кода
xml — обработка XML
ctype — валидация символов
json — работа с JSON
bcmath — математические операции
fileinfo — определение типа файла
curl — API-вызовы

Права доступа к директориям

storage/ — должна быть доступна для записи
bootstrap/cache/ — должна быть доступна для записи

Отображение результатов

Зелёные галочки = требование выполнено
Красные крестики = требование НЕ выполнено (необходимо исправить перед продолжением)

Исправление неудачных проверок:

# Установить отсутствующие расширения PHP (Ubuntu)
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath php8.4-curl php8.4-gd php8.4-zip

# Исправить права доступа
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

# Перезапустить PHP
sudo systemctl restart php8.4-fpm

Шаг 3: Конфигурация базы данных

Введите данные подключения к MySQL/MariaDB:

Поле	Пример	Примечания
Хост базы данных	`127.0.0.1`	Используйте `127.0.0.1` вместо `localhost` для надёжности
Порт базы данных	`3306`	Порт MySQL по умолчанию
Имя базы данных	`feedbackpulse`	База данных должна уже существовать!
Имя пользователя	`feedbackpulse_user`	С полными привилегиями на базу данных
Пароль	`your_secure_password`	Пароль пользователя

Перед этим шагом

Необходимо сначала создать базу данных:

-- Войти в MySQL
mysql -u root -p

-- Создать базу данных
CREATE DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Создать выделенного пользователя (рекомендуется)
CREATE USER 'feedbackpulse_user'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'feedbackpulse_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Что происходит при нажатии «Setup Database»

Установщик проверяет соединение
Сохраняет учётные данные базы данных в файл .env
Запускает все миграции базы данных (создаёт ~30 таблиц)
Засевает данные по умолчанию:
- 3 стандартных плана подписки (Starter, Growth, Pro)
- Настройки платформы по умолчанию
Показывает сообщение об успехе

Примечание: Во время установки драйверы сессий и кэша остаются file для стабильности. Они автоматически переключаются на database на шаге завершения.

Этот шаг может занять 10–30 секунд в зависимости от вашего сервера.

Шаг 4: Аккаунт администратора

Создайте аккаунт суперадмина:

Поле	Пример	Примечания
Полное имя	Иван Иванов	Ваше отображаемое имя
Адрес email	[email protected]	Используется для входа и уведомлений
Пароль	(надёжный пароль)	Минимум 8 символов. Используйте надёжный пароль!
Подтверждение пароля	(должно совпадать)	Должно совпадать

Что происходит

Создаётся ваш аккаунт с role = superadmin
Это единственный аккаунт суперадмина, создаваемый автоматически
С ним вы будете входить по адресу /login и получать доступ к /admin/dashboard

Совет по безопасности: Используйте уникальный, надёжный пароль. Позже вы можете включить 2FA в Настройках.

Шаг 5: Конфигурация email

Настройте SMTP для отправки транзакционных писем:

Поле	Пример	Примечания
SMTP-хост	`smtp.gmail.com`	SMTP-сервер вашего поставщика email
SMTP-порт	`587`	587 для TLS, 465 для SSL
SMTP-имя пользователя	`[email protected]`	Обычно ваш адрес email
SMTP-пароль	`your_app_password`	Рекомендуется пароль приложения
Шифрование	`tls`	TLS (рекомендуется) или SSL
Адрес отправителя	`[email protected]`	Адрес «от кого» в исходящих письмах
Имя отправителя	`FeedbackPulse`	Имя «от кого» в исходящих письмах

Распространённые SMTP-провайдеры

Провайдер	Хост	Порт	Шифрование	Примечания
Gmail	`smtp.gmail.com`	587	TLS	Требует пароль приложения (не обычный пароль)
Mailgun	`smtp.mailgun.org`	587	TLS	Отлично для транзакционных писем
Amazon SES	`email-smtp.{region}.amazonaws.com`	587	TLS	Экономичен в масштабе
SendGrid	`smtp.sendgrid.net`	587	TLS	Используйте `apikey` в качестве имени пользователя
Postmark	`smtp.postmarkapp.com`	587	TLS	Лучшая доставляемость
Mailtrap	`sandbox.smtp.mailtrap.io`	587	TLS	Только для тестирования!

Нет возможности настроить email сейчас? Вы можете пропустить этот шаг и настроить его позже в Admin → Settings → Email. Платформа будет работать без email, но функции, такие как приглашения, дайджесты и сброс паролей, не будут работать.

Шаг 6: Установка завершена!

Вы увидите страницу успеха с информацией о:

Настроенной и мигрированной базе данных
Созданном аккаунте администратора
Настроенном email
Созданном файле installed.lock
Переключённых драйверах сессий и кэша на database
Автогенерированном CRON_TOKEN для веб-based cron
Уведомлении о shared-хостинге (если символическая ссылка не была создана)

Инструкции по cron-заданию (показаны на странице завершения)

На странице завершения отображаются два варианта настройки cron с командами для копирования:

CLI-команда — для VPS/выделенных серверов:

* * * * * cd /path/to/project && php artisan schedule:run >> /dev/null 2>&1

URL/wget — для shared-хостинга (использует автогенерированный CRON_TOKEN):
```
wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"
```

Сохраните их! Скопируйте cron-команду со страницы завершения перед переходом на другую страницу. Ваш CRON_TOKEN также находится в файле .env.

Файл `installed.lock`

Установщик создаёт файл storage/installed.lock, чтобы предотвратить повторный запуск. Это мера безопасности.

Чтобы перезапустить установщик (например, для чистой установки), удалите этот файл:
rm storage/installed.lock
Затем снова перейдите на /install.

Контрольный список после установки

После завершения установщика:

Настройте cron-задание по инструкциям на странице завершения (смотрите Cron-задания и очереди)
Войдите по адресу https://yourdomain.com/login с учётными данными суперадмина
Перейдите в Admin → Plans — просмотрите и настройте планы подписки
Перейдите в Admin → Settings → Payments — подключите Stripe/PayPal
Перейдите в Admin → Settings → Email — отправьте тестовое письмо
Перейдите в Admin → Landing Page — настройте публичную главную страницу
Настройте SSL (смотрите SSL-сертификаты)
Опционально настройте wildcard DNS (смотрите Настройка Wildcard DNS)

Следующие шаги

Настройка Apache или Настройка Nginx
Переменные окружения — тонкая настройка .env
Cron-задания и очереди — настройка автоматических задач

Запуск установщика​

Шаг 1: Приветствие и лицензия​

Шаг 2: Проверка требований​

Версию PHP​

Зависимости Vendor​

Расширения PHP​

Права доступа к директориям​

Отображение результатов​

Шаг 3: Конфигурация базы данных​

Перед этим шагом​

Что происходит при нажатии «Setup Database»​

Шаг 4: Аккаунт администратора​

Что происходит​

Шаг 5: Конфигурация email​

Распространённые SMTP-провайдеры​

Шаг 6: Установка завершена!​

Инструкции по cron-заданию (показаны на странице завершения)​

Файл installed.lock​

Контрольный список после установки​

Следующие шаги​