Перейти к содержимому
SceneCMS

Типовые проблемы

Ошибки, которые стоит знать наизусть, и что каждая означает.

Белая страница или 500

Сначала читайте storage/logs/laravel.log — там названо настоящее исключение.

Две самые частые причины на свежем сервере:

  1. Неверные доступы к базе. В ошибке будет SQLSTATE[HY000] [1045].
  2. Файлы кэша принадлежат другому пользователю. Кэш, собранный от root, недоступен php-fpm, работающему под www-data. Пересоберите от пользователя веб-сервера:
sudo -u www-data php artisan config:cache
sudo -u www-data php artisan route:cache
sudo -u www-data php artisan view:cache

Сайт открывается без стилей

Нет public/build или загрузка оборвалась. Распакуйте релизный архив заново: статика едет готовой, и манифест должен совпадать с файлами.

При бэкапе «mysqldump: command not found»

У веб-сервера другой PATH. Укажите каталог в .env:

DB_DUMP_BINARY_PATH=/usr/bin

Обновление падает с «No update-manifest.json»

Это полный релизный zip, а не пакет обновления. Полные zip нужны для свежей установки; обновления применяются из подписанного *-update-*.zip.

Обновление падает с «already exists»

Предыдущая попытка откатилась, но восстановление не удалило таблицы, созданные пакетом. Восстановите бэкап «до обновления» из Админка → Бэкапы и примените обновление снова. Текущий релиз стирает схему перед импортом, что убирает этот класс отказов; старые билды так не умели.

Загрузка файла падает с 413

nginx отбрасывает тело до того, как его увидит PHP:

client_max_body_size 64M;

Затем перезагрузите nginx.

Картинки загружаются, но не показываются

Не выполнен php artisan storage:link или public/storage указывает не туда. Удалите ссылку и создайте заново:

rm public/storage
php artisan storage:link

Тема активна, но витрина не изменилась

Исправлено в 1.2.0: на новых версиях Laravel view finder не синглтон, поэтому тема могла регистрировать свой путь в объекте, который уже выброшен. Обновитесь до 1.2.0 или новее; повторная активация темы применяет путь сразу.

API отдаёт 500 с ошибкой лимитера

Маршруты закэшированы без регистрации лимитеров. Исправлено в 1.1.1. На старых билдах выполните php artisan route:clear и не кэшируйте маршруты.

Не проходит активация лицензии

См. активация лицензии — там чек-лист про адрес API, исходящий доступ и значение domain_conflict.

Всё медленно под нагрузкой

По порядку: включите OPcache, переведите кэш и сессии в нормальное хранилище, затем смотрите на базу. Площадка с несколькими тысячами билетов в месяц спокойно живёт на 2 ГБ; медленная страница почти всегда неиндексированный запрос или отсутствующий кэш, а не сервер.

Как получить помощь

Напишите на support@scenecms.ru версию из Админка → Система, последние строки storage/logs/laravel.log и что вы делали прямо перед поломкой. Этого хватает, чтобы ответить на большинство обращений одним письмом.

Не нашли ответ?

Напишите на sales@scenecms.ru — отвечаем в течение рабочего дня.

Контакты