Файлы и медиа

Страница галереи сайта на Energine 2.13 с демо-контентом с рядом из четырёх миниатюр изображений
Energine 2.13 с демо-контентом — галерея (интерфейс на русском языке)

Файлы хранятся в файловом репозитории: дереве папок и файлов, записанных в базе данных и в htdocs/uploads/public/, общем для всех сайтов установки.

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

«Файловый репозиторий» (File repository) на панели инструментов страницы открывает его; то же делают файловые поля форм и кнопки вставки изображений, файлов и видео в редакторе. Панель инструментов репозитория: «Открыть» (Open), «Загрузить» (Upload), «Копировать» (Copy), «Создать папку» (Create folder), «Редактировать» (Edit), «Переместить в папку» (Move to folder) и «Удалить» (Delete).

  • Загруженный файл сохраняется под сгенерированным именем <time><number>.<extension> и сохраняет свой заголовок; для изображений фиксируются ширина и высота.
  • Файлы, которые веб-сервер мог бы выполнить, отклоняются — php и его варианты, phtml, phar, cgi, fcgi, pl, py, sh, .htaccess, .htpasswd — с сообщением «Файлы этого типа загружать нельзя: сервер выполнит их как программу» (Files of this type cannot be uploaded: the server would run them as a program).
  • Файл замены должен быть того же типа. Удаление папки удаляет всё её содержимое. Загрузка zip-архивов в версии 2.13 недоступна.
  • Ограничение размера определяется настройками PHP и веб-сервера; в примере конфигурации nginx установлено 64 МБ.
  • Команда php index.php setup syncUploads, запускаемая из htdocs/, регистрирует файлы, скопированные в htdocs/uploads/public/ вручную.

Дополнительные размеры изображения

Секция thumbnails конфигурации задаёт именованные размеры — например, small соответствует 140×107. В форме файла появляется вкладка «Маленькое изображение для:» (Small image for:) с полем загрузки для каждого размера.

Модуль изменения размеров изображений

/resizer/w<width>-h<height>/<path> возвращает уменьшенную копию изображения через TimThumb 2.8.13 (htdocs/resizer/timthumb.php): с сохранением пропорций и добавлением полей, не более 1500×1500 пикселей, из источника размером не более 10 МБ, с кэшированием во временной папке системы. TimThumb также загружает изображения со списка сторонних сайтов; см. Известные риски.

Репозитории

Секция repositories.mapping конфигурации связывает тип репозитория с его классом: repo/local — «Локальный репозиторий» (Local repository) стартового пакета — repo/ftp с настройками подключений в repositories.ftp, а также репозитории только для чтения repo/ftpro и repo/ro. Экрана для добавления репозитория нет: это корневая запись таблицы share_uploads с соответствующей конфигурацией.

Изображения и файлы в текстах

Окно вставки изображения в редакторе, ImageManager, задаёт файл, ширину, высоту, отступы, выравнивание и альтернативный текст изображения. Записи, таблица которых имеет связанную таблицу <table>_uploads — например, новости — поддерживают прикреплённые файлы.