Файли

Файли сайту зберігаються у файловому репозиторії: папці web/uploads/public/ та таблиці її файлів і папок.

Файловий репозиторій

Адміністратори відкривають його кнопкою «Файловый репозиторий» на панелі інструментів адмінки, а також через кнопки вставки зображень і файлів у редакторі та поля файлів у формах. У вікні є «Открыть», «Загрузить», «Копировать», «Создать папку», «Редактировать», «Переместить в папку» та «Удалить».

Вибраний файл надсилається одразу і зберігається у uploads/temp/; під час збереження він копіюється до своєї папки під згенерованою назвою, тоді як оригінальна назва залишається як ім'я для завантаження, а заголовком стає ім'я без розширення.

  • Розмір. Власного обмеження немає: вирішують upload_max_filesize і post_max_size у PHP.
  • Типи. Файли, які сервер міг би виконати як програми, відхиляються: php, php3–php8, phps, pht, phtml, phar, cgi, fcgi, pl, py, sh, htaccess і htpasswd. Все інше приймається — включно з HTML і SVG — і обслуговується з власної адреси сайту, тому надавайте повні права лише людям, яким довіряєте.
  • Заміна файлу зберігає його тип: файл іншого типу буде відхилено.
  • Видалення файлу, на який посилаються тексти сторінок, потребує підтвердження і показує перелік сторінок; посилання та зображення на них стануть зламаними. Папка видаляється разом із усім її вмістом.

Ключ конфігурації thumbnails додає іменовані розміри попереднього перегляду, наприклад 'small' => ['width' => 140, 'height' => 107], як поля форми файлу. repositories.quick_upload_path — папка для швидкого завантаження з полів файлів, за замовчуванням uploads/public. Файли, скопійовані до uploads/public/ повз адмінку, потрапляють до репозиторію командою php index.php setup syncUploads.

Зображення та ресайзер

/resizer/w<width>-h<height>/<path> повертає зображення з репозиторію, вписане у вказану рамку. Редактор використовує його, коли ширина або висота зображення змінюється у його вікні; інакше зображення в тексті масштабується браузером до ширини колонки.

  • Ресайзуються лише файли JPEG, PNG, GIF і WebP всередині web/uploads/; для всього іншого повертається 404.
  • Зображення вписується та центрується з білими (JPEG, GIF) або прозорими (PNG, WebP) полями; маленькі зображення збільшуються; максимум 1500 × 1500 пікселів із джерела не більше 40 мегапікселів.
  • Результати кешуються на 30 днів у energine-resizer/ у тимчасовій папці завантажень або системній тимчасовій папці PHP; браузери отримують Cache-Control, ETag і Last-Modified.
  • Ресайзер потребує GD для PHP із підтримкою JPEG, PNG і WebP; setup check повідомляє про відсутність GD як про помилку.

nginx переспрямовує адреси ресайзера до нього за правилом із розділу Встановлення.