Конфигурация и адаптеры

Параметры по умолчанию находятся в src/Config/app.php и устанавливаются в config/plugin/triangle/media/app.php. Установка копирует только отсутствующие файлы: проверяйте конфигурацию вручную после обновления.

Настройки

КлючПо умолчаниюНазначение
enabletrueФлаг конфигурации плагина.
project_registrationfalseРазрешает GET и POST на маршруте регистрации проекта.
image_urihttps://example.ru/media/Публичный базовый URL; должен завершаться /.
image_pathpublic_path() . '/media/upload/'Каталог преобразованных файлов; должен быть доступен на запись.
max_file_size15 MiBМаксимальный размер исходного файла или скачанного body.
max_image_pixels40,000,000Суммарный лимит пикселей на все кадры. Также ограничивает размеры результата фильтров.
max_image_frames50Максимум кадров в исходном изображении. Проверяется при загрузке и обработке уже сохранённых изображений.
max_image_memory256 MiBЛимит ресурсов ImageMagick MEMORY и MAP.
max_image_disk512 MiBЛимит дискового ресурса ImageMagick.
max_image_time10 sЛимит времени ImageMagick.
target_type / target_extimage/png / pngMIME-тип ответа и расширение сохранённого изображения.
mime_typesJPEG, PNG, GIF, BMP, TIFFСписок допустимых MIME-типов источника. Сверяется с содержимым, а не с заголовком браузера.
database.images / database.projectsMedia_Images / Media_ProjectsИмена таблиц или коллекций в адаптере базы данных.
rate_limiter.enablefalseВключает встроенный ограничитель запросов.
rate_limiter.quota / cycle3 / 60Число запросов за период в секундах.

Лимиты должны соответствовать памяти, диску и ожиданиям конкретного приложения. Увеличение лимита не заменяет ограничения ImageMagick на уровне системы.

Контракт адаптеров

Плагин вызывает следующий интерфейс базы данных:

db()->insert($table, $record);
$project = db()->where('token', $token)->getOne($projectsTable);
$duplicate = db()->where('hash', $hash)->getOne($imagesTable);

Запись проекта содержит name, description, email и token. Поиск проекта должен вернуть поле id, которое использует контроллер загрузки. Запись изображения содержит author, filepath, width, height, color, mime, size, hash и projectId.

Сервис хранения должен поддерживать:

storage()->get($key);
storage()->set($key, $value, $ttl); // rate limiter
storage()->increment($key);

Для кэша обработанных изображений пакет также вызывает storage()->set($requestUri, $imageBytes) без TTL. Срок жизни такого кэша определяется адаптером или политикой приложения. Rate limiter выполняет последовательность read/set/increment; проверьте, подходит ли семантика вашего storage для ожидаемой конкурентности.

Установка представлений

Контроллеры вызывают view('index'), view('form') и view('image', $variables). Пакет не включает файлы шаблонов. Добавьте их в приложение или замените эти маршруты собственными контроллерами. Для страницы изображения шаблон image получает imageURL.