Встановлення та перенесення сайту

Перед початком

Для публічного сервера використовуйте підтримувану версію PHP 8.3 або новішу, MySQL чи сумісну MariaDB з InnoDB і utf8mb4, HTTPS та вебсервер із правильно налаштованою маршрутизацією. Потрібні розширення pdo_mysql, json, mbstring, fileinfo і zip. PHP має записувати лише в робочі каталоги storage, content та uploads; доступ до інших каталогів обмежуйте.

Розміри upload_max_filesize і post_max_size мають перевищувати розмір архіву, який ви плануєте відновлювати.

Чисте встановлення

1. Завантажте чистий дистрибутив FoxCoreCMS у корінь сайту.
2. Створіть порожню базу даних та окремого користувача з правами лише на неї.
3. Відкрийте /install/ через HTTPS і перевірте вимоги.
4. Укажіть параметри MySQL, адресу й назву сайту.
5. Створіть першого адміністратора з унікальним паролем від 12 символів.
6. Завершіть майстер і ввійдіть у /admin/.

Інсталятор застосовує міграції та створює storage/private/installed.lock. Не видаляйте цей файл для повторного запуску: після встановлення майстер має бути недоступний.

Перенесення на інший сервер

У майстрі можна вибрати переносимий ZIP-архів FoxCoreCMS. Перед відновленням перевіряються формат і контрольні суми. Архів переносить дизайн, контент, завантаження, модулі, структуру сторінок і базу даних; реквізити нової бази та адміністратора задаються в майстрі.

Після перенесення перевірте адресу сайту, кожну активну мову, форми, пошту та інтеграції. Зробіть нову резервну копію вже на цільовому сервері. Для чинної установки користуйтеся відновленням в адмінці, а не повторним запуском інсталятора.

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

• Немає zip: увімкніть розширення PHP ZipArchive.
• Немає з’єднання з MySQL: перевірте хост, порт, базу, користувача та пароль.
• Не вдається записати файли: надайте вебкористувачу права тільки на робочі каталоги.
• Архів завеликий: перевірте ліміти PHP і вебсервера.

Точні вимоги й результат встановлення

PHP 7.4 є технічним мінімумом, але для публічного сервера використовуйте підтримувану версію 8.3 або новішу. Потрібні Apache з дозволеним .htaccess або налаштований вручну nginx, MySQL 5.7/8.x чи сумісна MariaDB, таблиці InnoDB і кодування utf8mb4. Під час чистого встановлення без архіву майстер створює нейтральний design/starter, головну сторінку, сторінку 404 і порожній стан модулів — дані демонстраційного чи раніше перенесеного сайту не підмішуються.

Після вибору архіву майстер спочатку створює базову структуру БД, перевіряє формат і контрольні суми ZIP, відновлює дизайн, контент, медіатеку, модулі, структуру та MySQL. Реквізити нової БД, адресу сайту і першого адміністратора він бере з поточної форми встановлення. Після створення installed.lock повторний запуск має повертати HTTP 403.

Права доступу

Не надавайте запис на весь сайт і не застосовуйте 777. Для постійної роботи PHP потрібен запис у storage/ (налаштування, сесії, кеш, копії, дані модулів), uploads/ та content/. Якщо шаблони змінюються з адмінпанелі, додатково дозвольте запис у design/ і modules/*/templates/.

Типова схема для Linux: storage/, uploads/ і content/ — 775; storage/private/ — 770. design/ та modules/*/templates/ можуть мати 775 лише за потреби редагування шаблонів у панелі. Звичайні файли в записуваних каталогах можуть мати 664, приватні — 660. Власник або група мають відповідати користувачу PHP. Каталоги admin, src, install, database й кореневі PHP-файли повинні бути доступні вебсерверу лише для читання.

Якщо інсталятор повідомляє, що система вже встановлена, не видаляйте lock-файл: використовуйте відновлення з адмінпанелі. Після перенесення створіть нову копію на цільовому сервері й перевірте, що storage/private недоступний з вебу.