- Главная
- Документация
- Файлы и медиа
Файлы и медиа

Файлы хранятся в файловом репозитории: дереве папок и файлов, записанных в базе данных и в 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 — например, новости — поддерживают прикреплённые файлы.