Тестовий файл

Якщо ви читаєте це, то генерація каталогу на сервері відбулося без помилок і не потребує додаткових дій. В подальшому, цю сторінку можна втдалити, вона створюється лише за відсутності інших .php файлів у папці pages.

Пояснення роботи сканера

Проєкт автоматично генерує файли, необхідні для розгортання у будь-якій папці сервера з PHP версій 7.* та вище. Роутінг підтримує використання коротких і красивих URL, що відповідає базовим умовам Readable Permanent URLs. Наприклад, замість /index.php?page=test користувач може перейти за коротким і зрозумілим шляхом /test.

Захист, дозволи і перенаправлення на ресурси прописані у .htaccess, який автооновлюється для безпеки. Карта сайту sitemap.xml генерується на льоту із файла кешу.

Обов'язковий формат метаданих

Для захисту від прямого доступу до сторінки, необхідно додавати на початку кожного скрипта строку: defined('APP_ACCESS') or die('Direct access prohibited');
Metadata (приклад поточної сторінки):

/**
  title: Тестова сторінка
  description: Згенеровано автоматично при розгортанні проєкту.
  slug: test
  layout: head
**/

Наявність slug обов’язкова для всіх сторінок, він має бути унікальним серед усіх файлів, а в разі конфлікту імен буде викликаний перший за алфавітом. Якщо layout відсутній, або пустий, то використовується шаблон assets/layaut/head.php по замовчанню.

Структура каталогу

root/
├── assets/
│   ├── layout/
│   │   ├── head.php        # Шаблон основний (HTML, CSS, JS)
│   │   ├── header.php      # Шаблон заголовока, навігація
│   │   └── footer.php      # Шаблон нижньої частини сторінки
│   │
│   ├── css/
│	│	└── styles.css  	# Додатковий стиль для темної теми
│	│
│   ├── js/
│   │   ├── scrollToTop.js  # Плаваюча кнопка перехіду наверх
│   │   └── setTheme.js		# Перемикач темної/світлої теми
│	│
│   └── img/				# Загальні фони і зображення
│		
├── pages/
│   └──  test.php           # Приклад сторінки з метаданими
│
├── cache/
│   └── routes.json         # Результат парсингу структури, кеш
│
├── bin/
│   └── routes.php          # Скрипт генерації кешу routes.json
│
├── index.php               # Головна сторінка зі списком сторінок
├── view.php                # Скрипт для відображення сторінок
├── 404.html				# Сторінка сповіщення про помилку в URL
└── .htaccess               # Налаштування URL і безпеки