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

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

Ниже — случаи, которые встречаются чаще всего.

Не открывается ни одна фотография#

Файлы на месте, а вместо товаров пустые рамки. Причин две.

Нет ссылки на хранилище. Диагностика покажет это отдельной строкой. Выполните в папке магазина:

php artisan storage:link

Файлы принадлежат не тому пользователю. Так бывает, когда фотографии загружали на сервер по SSH от имени root: магазин работает от имени веб-сервера и не может ни прочитать оригинал, ни записать уменьшенную копию. Верните владельца папке с фотографиями (имя пользователя зависит от хостинга — обычно www-data или www):

chown -R www-data:www-data storage/app/public

Уменьшенные копии магазин делает не заранее, а при первом обращении к фотографии. Пустой список размеров у только что загруженного товара — это норма, а не поломка.

Не уходят письма покупателям#

Проверьте по очереди:

1. Планировщик. В диагностике есть строка о нём. Письма ставятся в очередь, а очередь разбирает планировщик — нет строки cron, нет писем. См. Обслуживание.
2. Настройки почты. «Настройки» → «Каналы связи» → «Почта». Отправьте пробное письмо оттуда: магазин покажет ответ почтового сервера целиком.
3. Журнал уведомлений. Там видно каждое отправленное сообщение и причину отказа, если сервер письмо не принял.

Отдельный случай: письма значатся отправленными, а получатель их не видит. Почти всегда это почтовый сервер, который принял письмо и отбросил его сам — чаще всего из-за того, что адрес отправителя не подтверждён записями домена (SPF и DKIM).

Задачи копятся и не выполняются#

Диагностика показывает число заданий в очереди. Растёт и не уменьшается — планировщик не запускается: проверьте строку cron в панели хостинга.

Если строка стоит, но задания всё равно не разбираются, посмотрите «Системный» → «Логирование»: там видно, с какой ошибкой падает задание. Частая причина на массовых хостингах — запрет на запуск отдельных программ; магазин это обходит сам, но иногда запрет нужно объявить ему явно строкой CARTIX_SPAWN_PROCESSES=false в файле настроек.

После обновления страница не открывается#

Скорее всего, сервер выполняет прежнюю версию файлов: PHP держит скомпилированный код в памяти (OPcache) и не перечитывает его сам. Перезапустите PHP-FPM в панели хостинга — обычно это кнопка «Перезагрузить» у версии PHP.

Второе по частоте — незавершённое обновление. Магазин пишет об этом прямо: «обновление прервалось, магазин работает на прежней версии». Запустите его ещё раз, предварительно освободив место на диске.

«Страница не найдена» на всех адресах, кроме главной#

Не настроено правило веб-сервера. Для nginx нужно:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Для Apache — проверьте, что файл .htaccess в папке public доехал при загрузке (файловые менеджеры часто прячут файлы, начинающиеся с точки) и что в настройках сайта разрешено его читать.

Магазин просит установку, хотя он уже установлен#

Такое бывает, когда магазин перенесли на другой сервер без файла .env или без базы. Проверьте, что файл на месте и в нём указан доступ к той базе, где лежат товары и заказы. Если и файл, и база на месте, а установщик всё равно открывается — сбросьте сохранённые настройки:

php artisan optimize:clear

Изменения в настройках не применяются#

Магазин запоминает настройки и разметку витрины. После правки файлов на сервере очистите сохранённое: «Системный» → «Обслуживание» → «Очистить кеш» или командой php artisan optimize:clear.

Куда смотреть дальше#

• «Системный» → «Логирование» — журналы магазина, сервера и почты с поиском по тексту. Ошибку удобнее искать здесь, чем в файлах на сервере.
• «Системный» → «Информация о системе» — версии PHP и базы, настройки сервера, свободное место.

Если ничего не помогло, напишите нам на support@cartixx.com и приложите то, что показывает диагностика: с этими сведениями разбор занимает минуты, а без них начинается с вопросов.