- Главная
- Документация
- Файлы
Файлы
Файлы сайта находятся в его файловом репозитории: папке 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 перенаправляет адреса ресайзера правилом из раздела Установка.