Установка и первый запуск
Последний опубликованный тег Media — v1.1.0, он требует Engine ^8.1. Эта инструкция описывает подготовку 2.0.0 под Engine 9. Не устанавливайте старый опубликованный пакет в приложение Engine 9.
Требования
- PHP 8.1 или новее.
- Triangle Engine 9; разрешённая им версия Localzet Server 7 должна быть согласована в lock-файле приложения.
- PHP-расширения
curl,fileinfoиimagick. - Записываемый каталог для итоговых изображений.
- Адаптер приложения с методами базы данных и хранения, описанными в настройках.
Установка пакета
Для текущего опубликованного релиза v1.1.0 на Engine 8:
composer require triangle/media:^1.1
После публикации 2.0.0 для Engine 9:
composer require triangle/media:^2.0
Проверьте фактически выбранные версии:
composer show triangle/media triangle/engine localzet/server
Плагин использует view() для HTML-маршрутов. Если они нужны, установите компонент triangle/view и добавьте шаблоны index, form и image. Если приложение отдаёт JSON или собственную страницу, замените эти контроллеры либо не открывайте соответствующие маршруты.
Установите конфигурацию
Вызовите Triangle\Media\Install::install() в поддерживаемом lifecycle установки плагинов приложения. Он копирует отсутствующие файлы из src/Config в config/plugin/triangle/media и не перезаписывает уже существующие настройки.
Для первого запуска проверьте:
image_pathуказывает на доступный для записи каталог.image_uri— публичный базовый URL с завершающим/.database.imagesиdatabase.projectsсовпадают с именами таблиц/коллекций вашего адаптера.project_registrationоставленfalse, если приложению не нужна открытая регистрация.- Адаптеры
db()иstorage()соответствуют контрактам плагина.
Подключите маршруты
Engine регистрирует контроллеры через Composer autoload. По умолчанию префикс плагинов — /app; проверьте app.plugin_uri в конфигурации приложения и настройте reverse proxy так, чтобы upload endpoint был доступен только через требуемую политику приложения.
Встроенные HTML-маршруты требуют шаблоны представлений. Сам пакет не создаёт шаблоны, не настраивает веб-сервер и не публикует каталог хранения автоматически.
Проверьте запуск
В каталоге пакета выполните локальные проверки:
composer validate --strict --no-check-publish --no-interaction
composer run check --no-interaction
composer audit --locked --no-interaction
В тестовой среде должны быть доступны расширения из composer.json, включая imagick. Локальная проверка пакета не проверяет реальные маршруты, права каталога, базу данных, кэш и шаблоны вашего приложения.

