Поиск по сайту

Найдите нужный материал

Статьи, советы, уроки и обновления Битрикса. Введите хотя бы два символа.

Ищем…

Ничего не найдено

Попробуйте другой запрос или уберите лишние слова.

Показано результатов:

Все результаты Поиск по материалам BXMax
Telegram VK YouTube
main · Главный модуль 26.1100.0 Ломающее

Main 26.1100.0: кеш ответов action и два удалённых polyfill-расширения

1 мин чтения Устаревших API: 3
Узнавайте о ломающих изменениях Битрикса раньше, чем они доедут до прода: свежие разборы — в канале @bxmax_updates

Ломающее обновление

Удалены или изменены публичные API — прикладной код может перестать работать.

В 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 верхнего меню теперь очищает пользовательский кеш левого меню.
  • Список последних адресатов ограничен тысячей строк на тип кода, чтобы один тип не вытеснял остальные.

Устаревшие и удалённые API в этой версии

Символ Статус Чем заменять
BX.Grid.Grid::isIE() Deprecated —
main.polyfill Удалено —
main.polyfill.domrect Удалено —

Новая версия вышла — разбор уже в Telegram

В канале @bxmax_updates публикуем каждый свежий разбор: что сломается, что устарело и что появилось в API. Узнаете до того, как обновите прод.

Подписаться

Читайте дальше

main 26.1000.0 Ломающее Свежее

Main 26.900.0–26.1000.0: агенты без eval, AJAX-контроллеры прячут текст исключений, экспорт только с подписью

Главный модуль приехал двумя версиями сразу, 26.900.0 и 26.1000.0 (прошлую, 26.800.0, мы разбирали [здесь](/bitrix-updates/main/main-26-800-0)). В 26.900.0 агенты уходят с `eval` на `Callback`, в `bitrix.php` появляются команды `main:*`, в `main.core` — клиент `HttpClient`, а Tokenizer стал обязател…

1 мин
main 26.800.0 Безопасность

Main 26.800.0: закрыт SSRF через ftp://, а translit и выбор SMTP-отправителя работают иначе

Main 26.800.0 закрывает SSRF в `CFile::MakeFileArray()` через ссылки `ftp://` и в RSS-гаджете, а заодно чистит ввод при инлайн-редактировании в `CAdminUiList` и в `menu_edit.php`. Сильнее по проектам ударят изменения поведения: `CUtil::translit()` оставляет на конце `_`, почта по-другому выбирает SM…

1 мин
main 26.750.0 Заметное

Main 26.750.0: точка в имени плейсхолдера больше не ломает почтовые шаблоны

Main 26.750.0 меняет три файла ядра, +16/−5 строк, и заметная правка среди них одна (вторая, в лицензионном `ActivationSystem`, служебная). Но сидит она в месте, где из почтового шаблона генерируется PHP-код, так что посмотреть на неё стоит всем, у кого в шаблонах есть плейсхолдеры с точкой в имени,…

5 мин
main 26.700.0 Заметное

Main 26.700.0: в ядре появились фича-флаги

Битрикс выкатил main 26.700.0 — и это тот редкий случай, когда в ядре появляется целая новая подсистема: фича-флаги `Bitrix\Main\Config\Feature` с двумя таблицами в БД. Плюс несколько тихих поведенческих изменений, которые стоит проверить, если у вас не-UTF-8 сайт, кастомные фильтры пользователей ил…

4 мин
Мы используем файлы cookie для улучшения работы сайта. Продолжая использовать сайт, вы соглашаетесь с нашей политикой конфиденциальности.
AI Домовой

AI Домовой История

на связи

пишет…

Можно закрыть чат и перейти на другую страницу. Когда ответ будет готов, на кнопке Домового появится отметка.

Нет истории чатов
AI Домовой

Нужна авторизация

Войдите, чтобы задавать вопросы AI Домовому.

Войти