← Документація
Розробникам і інтеграторам

Структура файлів проєкту

Які каталоги можна змінювати, а які файли захищені.

Перевірено для версії: FoxCoreCMS 1.1.1Оновлено: 26.09.2026

Захищені службові файли

Файл storage/private/settings.json містить загальні налаштування без пароля MySQL. storage/private/secrets.json містить сам пароль. У pages.json лежать сторінки, переклади та прив'язки міток; module-instances.json описує екземпляри, а modules.json — стан встановлення модулів. installed.lock забороняє повторно запускати інсталятор. Не редагуйте ці файли вручну на робочому сайті, особливо secrets.json та дані сесій.

Файли .htaccess відповідають за маршрутизацію й заборону доступу до приватних каталогів в Apache. .user.ini задає безпечні параметри PHP. Якщо сайт працює на nginx, відповідні правила захисту потрібно відтворити в його конфігурації.

Дані перенесеного сайту розташовуються в storage/imports/<джерело>. Назва джерела береться з налаштувань проєкту, а не зашита в ядро. Сумісний шар читає їх окремо; нові екземпляри ніколи не записуються в імпортовані JSON. Їхні власні JSON лежать у storage/modules/<модуль>/instances, а зображення — в uploads/media/modules.

FoxCoreCMS відокремлює ядро, дизайн, модулі, публічний контент і приватні дані. Цей поділ важливий для оновлень та резервного копіювання.

Основні каталоги

Шлях Призначення
admin/ Панель керування та її ресурси
content/ Контент, керований системою
database/migrations/ Міграції бази даних
design/ Дизайни й шаблони сторінок
docs/ Документація проєкту
install/ Встановлення системи
modules/ Пакети модулів та їхні файлові шаблони
src/ Класи ядра
storage/ Налаштування, приватні дані, копії та імпорт
uploads/ Завантажені публічні файли
bootstrap.php, index.php Завантаження та публічний маршрутизатор

Що змінювати

Дизайн сайту розміщуйте у design/<назва>/, а шаблони конкретного модуля — у modules/<модуль>/templates/. Контент і зображення редагуйте через адмінпанель. Зміни ядра у src/ перевіряйте окремо перед оновленням.

Не редагуйте вручну storage/private/secrets.json, файли сесій та installed.lock. Дані імпорту з попередньої CMS зберігаються у storage/imports/<джерело>; нові екземпляри модулів — у storage/modules/<модуль>/instances/, а їхні зображення — в uploads/media/modules/.

Для перенесення сайту зберігайте файли, налаштування, медіатеку й базу даних разом. Після відновлення перевірте права запису та приватність storage/.