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

Требования к серверу

• PHP 7.4 — технический минимум; для публичного сервера используйте поддерживаемую версию PHP 8.3 или новее.
• Расширения PHP: pdo_mysql, json, mbstring, fileinfo, zip.
• MySQL 5.7/8.x либо совместимая MariaDB, InnoDB, utf8mb4.
• Apache с разрешённым .htaccess либо вручную настроенный nginx.
• HTTPS для публичного сайта и административной панели.
• Права записи для storage/private, storage/backups, storage/modules, content, uploads.

Размеры upload_max_filesize и post_max_size должны быть больше загружаемой резервной копии.

Чистая установка

1. Загрузите чистые файлы FoxCoreCMS в каталог сайта.
2. Создайте пустую базу MySQL и отдельного пользователя.
3. Откройте https://example.com/install/.
4. Проверьте, что все требования отмечены как доступные.
5. Укажите сервер, порт, базу, пользователя и пароль MySQL.
6. Укажите название и адрес сайта.
7. Создайте первого администратора. Минимальная длина пароля — 12 символов.
8. Нажмите «Установить систему».

Инсталлятор применит миграции, создаст администратора и запишет storage/private/installed.lock. Повторный запуск после установки возвращает HTTP 403.

Установка с восстановлением сайта

На четвёртом шаге выберите переносимый ZIP-архив FoxCoreCMS. Инсталлятор:

1. создаст базовую структуру базы;
2. проверит формат и контрольные суммы архива;
3. восстановит дизайн, контент, изображения, модули, структуру и MySQL;
4. сохранит реквизиты новой базы и новый адрес сайта;
5. создаст администратора с логином и паролем из формы установки;
6. заблокирует установщик.

Так переносится любой сайт FoxCoreCMS: чистая система → /install/ → архив → готовый сайт.

Если архив не выбран, установщик создаёт действительно чистый проект: нейтральный design/starter, главную страницу и страницу 404, пустой список экземпляров и пустое состояние установленных модулей. Данные демонстрационных или ранее перенесённых сайтов в чистую структуру не подключаются.

После установки

• Войдите в /admin/.
• Проверьте адрес сайта и отключённый вывод ошибок.
• Откройте все языковые версии.
• Проверьте формы, почту и внешние интеграции, когда они будут подключены.
• Создайте свежую резервную копию уже на новом сервере.
• Не удаляйте installed.lock.

Ошибки установки

• Нет zip — включите PHP ZipArchive.
• Нет подключения к MySQL — проверьте имя базы, пользователя, пароль, host и port.
• Нет прав записи — назначьте веб-пользователю запись только в перечисленные рабочие каталоги.
• Архив слишком большой — увеличьте upload_max_filesize и post_max_size.
• Система уже установлена — используйте восстановление в админке, а не удаляйте lock-файл.

Права на файлы и каталоги

Не выдавайте права записи всему сайту. Для постоянной работы PHP нужна запись только в рабочие каталоги:

• storage/ — настройки, сессии, кеш, резервные копии и данные модулей;
• uploads/ — изображения и другие загруженные файлы;
• content/ — файлы, создаваемые через файловый менеджер.

Если шаблоны редактируются через административную панель, дополнительно разрешите запись в design/ и modules/*/templates/.

Рекомендуемая схема для Linux-хостинга:

storage/              775
storage/private/      770
uploads/              775
content/              775
design/               775  — только при редактировании шаблонов в админке
modules/*/templates/  775  — только при редактировании шаблонов модулей

Обычные файлы в записываемых каталогах могут иметь права 664, приватные файлы — 660. Владелец или группа должны совпадать с пользователем, от которого работает PHP. Не используйте 777: каталоги admin, src, install, database и корневые PHP-файлы должны быть доступны веб-серверу только для чтения.