Файлы

Файлы сайта находятся в его файловом репозитории: папке web/uploads/public/ и таблице его файлов и папок.

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

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

Выбранный файл отправляется сразу и сохраняется в uploads/temp/; при сохранении он копируется в свою папку под сгенерированным именем, тогда как исходное имя остаётся именем для скачивания, а названием становится имя без расширения.

  • Размер. Собственного ограничения нет: всё определяют директивы PHP upload_max_filesize и post_max_size.
  • Типы. Файлы, которые сервер мог бы выполнить как программы, отклоняются: 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 перенаправляет адреса ресайзера правилом из раздела Установка.