В Main 26.1100.0 результат action можно кешировать штатным фильтром, а правила фильтрации — задавать единообразно атрибутами или через configureActions(). Перед обновлением проверьте наследников FieldFileUploaderController и прямую загрузку main.polyfill: сигнатура canUpload() изменилась, два JS-расширения удалены. Ещё обновились пользовательские поля, грид, редактор согласий и загрузчик JS-расширений.
Новое
Кешируйте результат action фильтром
Bitrix\Main\Engine\ActionFilter\CacheResponse сохраняет ответ action и при попадании в кеш пропускает его выполнение через ActionEventResult::skipAction(). TTL по умолчанию — час. Поля запроса и контекста в ключ кеша не входят, пока вы не перечислите их явно.
Для общих данных фильтр можно подключить так:
<?php declare(strict_types=1);
namespace Vendor\Catalog\Controller;
use Bitrix\Main\Engine\ActionFilter;
use Bitrix\Main\Engine\ActionFilter\Attribute\Rule;
use Bitrix\Main\Engine\Controller;
final class Price extends Controller
{
#[Rule\EnableFilter([
new ActionFilter\CacheResponse(
ttl: 300,
cacheKeyRequestFields: ['code'],
),
])]
public function priceAction(string $code): array
{
return ['code' => $code, 'price' => 100];
}
}
Если ответ зависит от пользователя, добавьте пользовательский контекст в cacheKeyContextFields. Иначе одна запись кеша будет общей для action.
Три новых атрибута закрывают остальные сценарии. Filter включает набор сразу как prefilter и postfilter, EnableFilter добавляет фильтры, DisableFilter убирает их. В configureActions() им соответствуют ключи filters, +filters и -filters.
Работайте с полями и гридом без своих обходов
Enum-поле получило режим EnumType::DISPLAY_DIALOG: одиночный и множественный выбор строятся через ui.entity-selector, включая значения по умолчанию. Список пользовательских полей теперь нормально прокручивается по горизонтали, сохраняет размер страницы и стабильнее обрабатывает массовые действия. При превышении лимита колонок, размера строки или индексов контроллер возвращает код MAIN_USER_FIELD_LIMIT_EXCEEDED; прежний feature-флаг больше не блокирует создание поля rich_text.
main.ui.grid принимает HEADERS_CATEGORIES для категорий в настройках колонок. После обновления параметров событие BX.Main.grid:paramsUpdated передаёт сам объект Grid, а reload() сохраняет текущую страницу и читает актуальную сортировку.
Редактор согласий различает контекст CRM-форм, сохраняет его в redirect и передаёт agreementId событию main-user-consent-saved.
Чистите локальные данные штатно
SessionLocalStorageManager::reset() очищает локальное хранилище сессии, сохраняет удаление и сбрасывает коллекцию в памяти. Для истории Entity Selector появились EntityUsageRetention и EntityUsageCleanupAgent: срок хранения по умолчанию равен 180 дням, лимит — 200 записей на тип сущности для пары пользователь/контекст. FinderDestTable::cleanSortCache(int $userId) отдельно сбрасывает кеш последних адресатов пользователя.
Используйте новые контракты разметки и загрузки JS
CTextParser понимает заголовки [h1]—[h6] при HEADINGS=Y и безопасный inline-код [icode]. Публичный LPA::RestorePHPFragments() восстанавливает разрешённые PHP-фрагменты после LPA::Process(); предпросмотр шаблона уже переведён на эту пару методов.
Сервер теперь отмечает подключённые расширения блоком extension/registered, который Runtime разбирает после загрузки скриптов. Неудачный loadExtension() можно повторить без перезагрузки страницы. Runtime.extractAssets() возвращает registrations и сохраняет media у CSS, а main.date получил TypeScript-декларации для DateTimeFormat, DurationFormat и Timezone.
Что сломается
Сверьте сигнатуру наследников загрузчика файлов
FieldFileUploaderController::canUpload() теперь принимает необязательный ?UploadRequest и возвращает CanUploadResult|bool. Прямой вызов без аргумента продолжит работать. Наследник со старой сигнатурой метода станет несовместим с родителем, поэтому добавьте аргумент и совместимый возвращаемый тип.
Уберите прямую загрузку старых полифилов
Конфигурации main.polyfill и main.polyfill.domrect удалены без совместимых алиасов. Вызовы Extension::load('main.polyfill') и Extension::load('main.polyfill.domrect') больше не найдут расширение.
Deprecated
BX.Grid.Grid::isIE() помечен @deprecated и всегда возвращает false. Удалите ветки для IE вместо проверки через этот метод.
БД
В схемы новых установок MySQL и PostgreSQL добавлен индекс ORIGINATOR_ID, ORIGIN_ID, AGREEMENT_ID таблицы b_consent_user_consent. В db.diff отдельной миграции для действующих сайтов нет.
Мелочи и находки
CAllSQLWhereбольше не строитIN ()иNOT IN (): пустой положительный список даёт1=0, отрицательный —1=1.- Изменение
firstPageLinkверхнего меню теперь очищает пользовательский кеш левого меню. - Список последних адресатов ограничен тысячей строк на тип кода, чтобы один тип не вытеснял остальные.