Решение проблем

Подборка типовых ситуаций. Проверяйте, что решение относится к вашей установленной версии KaevCMS.

Ошибка 500 после установки

Проверьте: версию PHP (не ниже 8.3 в документированной ветке), наличие vendor, корректность .env, права на storage и bootstrap/cache, фактический Document Root.

На VDS:

php -v
cd /var/www/kaevcms
composer check-platform-reqs --no-dev
php artisan optimize:clear

Если команда artisan недоступна, сначала исправьте расположение файлов и зависимости. Laravel-логи следует смотреть локально на сервере; не публикуйте их целиком.

419 Page Expired при входе

Частая причина — конфликт адреса, протокола и защищённых cookies после переноса сайта.

Проверьте в .env для production HTTPS:

APP_URL=https://example.com
APP_FORCE_HTTPS=true
SESSION_SECURE_COOKIE=true

Для изолированного тестового HTTP окружения эти флаги могут быть false. После правок очистите кэш приложения, а в браузере — cookies этого сайта.

php artisan optimize:clear

Страница установки возвращает 404

Убедитесь, что распакован полный релиз, что Document Root указывает на public (VDS) или на правильный публичный каталог (shared hosting) и что /install/ существует до установки. После успешной установки публичный installer удаляется штатно — повторно открывать его не нужно.

403 или проблемы с загрузкой изображений

Проверьте права каталогов storage, bootstrap/cache и public/uploads; владельца процесса PHP-FPM и правила веб-сервера. Не пытайтесь устранить ошибку через chmod -R 777.

Не подключается игровая база

1. Сравните адрес, порт, имя БД и пользователя в настройках подключения.
2. Проверьте сетевой маршрут и firewall со стороны сервера CMS.
3. Убедитесь, что MySQL разрешает вход этому пользователю с нужного адреса.
4. Запустите диагностику внешней БД в административной панели.
5. Сверьте драйвер, профиль и требуемые таблицы вашей сборки.

Работающий игровой порт не доказывает доступность базы MySQL.

Не отправляется почта

Проверьте SMTP-хост, порт, TLS, пароль, адрес отправителя, затем выполните тест из административной панели. Если почта отправляется через очередь, проверьте queue worker и heartbeat планировщика.

Обновление не принимается

Проверьте текущую версию, диапазон в манифесте ZIP, тип размещения, контрольную сумму и свободное место. Не отключайте проверки обновления и не исправляйте манифест вручную.

Обновление зависло или сайт остался в режиме обслуживания

На VDS при прерванном обновлении или зависшей заявке Update Agent используйте команду восстановления kaevcms:update-recover. Она определит состояние и предложит безопасное восстановление из проверенной резервной копии, отмену незапущенного запроса или выход из режима обслуживания. Запускайте её через SSH от владельца проекта, только если установленная версия содержит изменение c443b62.

Не удалось разобраться?

Откройте обращение на GitHub и укажите версию CMS, тип размещения, действие, ожидаемый и фактический результат, обезличенный текст ошибки и шаги воспроизведения.

Подробный эксплуатационный справочник · Безопасность