Transformer 26.0.0 проверяет, что загруженный результат принадлежит текущей команде и одному из запрошенных форматов. Интеграторам надо обновить вызовы FileUploader::getUploadInfo(), multipart-загрузку частей файла и обработку ответа finish=y.
Новое
Проверяйте, нужен ли порталу результат
Command::isResultExpected() возвращает true для команд в статусе CREATE или SEND с действующим deadline. Контроллер может отправить check_result_expected=y до загрузки, а портал объявляет поддержку проверки через capability resultExpectationCheck.
Для отказа появились два кода: ERROR_CONTROLLER_RESULT_NO_LONGER_EXPECTED и ERROR_CONTROLLER_RESULT_EXPECTATION_CHECK_FAILED. Оба предлагают контроллеру повторить операцию позже.
Привязывайте файл к команде
Портал принимает только формат, который запрошен командой. Локальный файл должен лежать под временным корнем и называться <GUID команды>.<формат> в каталоге transformer. Проверка нормализует путь и вызывает realpath для существующей части, поэтому .. и симлинк не выводят загрузку за пределы временного каталога.
Облачное имя тоже должно принадлежать временному хранилищу команды. Перед callback портал разрешает каждый результат заново и передаёт только подходящие локальные или облачные файлы. После обработки они удаляются.
FileUploader::getUploadInfo() возвращает отказ через Bitrix\Main\Result, если формат не запрошен или имя файла не проходит проверку.
Что сломается
FileUploader::getUploadInfo() теперь принимает Command $command, mixed $format, int $fileSize вместо $commandId, $fileKey, $fileSize. Метод возвращает Bitrix\Main\Result вместо массива. Прямые вызовы со старой сигнатурой и чтение ключей результата как массива надо переписать.
Обработчик результата читает часть файла только из multipart-upload через HttpRequest::getFile(). Fallback на строку из POST удалён. Временный файл должен пройти is_uploaded_file(), существовать и читаться. Собственный контроллер с другим протоколом загрузки получит ошибку.
Завершение и ошибка команды запускают callback фоновым заданием. При finish=y контроллер сразу получает success: OK и не узнает об ошибке callback из HTTP-ответа. Lock освобождается после callback и очистки файлов, поэтому интеграции не должны считать синхронный ответ итогом обработки.
БД
Таблица b_transformer_command, её первичный ключ и индексы перенесены из SQL-файлов MySQL и PostgreSQL в install/migrations/tables.php. InstallDB() и UnInstallDB() теперь вызывают installMigrations() и uninstallMigrations().
Регистрация CommandTable::deleteOldAgent() и ExpiredCommandAgent::run() лежит в install/migrations/agents.php. migration_config.json связывает таблицу, компоненты и tools с декларативной установкой.
Мелочи и находки
- При ошибке команды обработчик удаляет только файлы, которые прошли проверку принадлежности. При успехе те же файлы передаются callback абсолютными путями и удаляются в
finally. capabilitiesпередаётся как JSON-объект с флагомresultExpectationCheck. Перед расчётомBX_HASHPHP-массивы в$postпревращаются в строкуArray; значениеcapabilitiesне меняется.