Полезное

Отладка на боевом сервере, где нельзя просто остановить выполнение в точке останова, требует своих инструментов. Разберём AddMessage2Log — штатный способ логирования Битрикса — и настройку Xdebug для полноценной пошаговой отладки на локальном окружении. Базовое использование AddMessage2Log <?php AddMessage2Log(‘Начало обработки заказа #’ . $orderId, ‘my.module’); AddMessage2Log([‘ORDER_ID’ => $orderId, ‘SUM’ => $sum], ‘my.module’); Второй параметр — модуль или произвольная метка, по которой…

Создание собственного модуля — способ оформить бизнес-логику проекта так, чтобы она не зависела от конкретного шаблона сайта и переживала его смену. Разберём минимальную структуру модуля, обязательные файлы установки и типичные ошибки при первом самостоятельном модуле. Минимальная структура каталога /local/modules/vendor.module/ ├── include.php ├── install/ │ ├── index.php │ └── db/ │ └── install.php └── lib/ └── TaskTable.php Имя модуля традиционно состоит…

«Я поменял данные, а на сайте всё по-старому» — самая частая жалоба на форумах о Битрикс, и почти всегда причина в кеше. Проблема в том, что кешей в системе несколько разных, и способ сброса зависит от того, какой именно кеш держит старые данные. Виды кеша в Битрикс Вид кеша Что хранит Кеш компонентов Результат работы отдельных компонентов на страницах Управляемый…

Часть рутинных задач на проекте 1С-Битрикс решается быстрее и надёжнее через консоль, чем через веб-интерфейс административной панели, особенно на объёмах данных, где браузер и ограничение времени выполнения PHP-скрипта становятся помехой. Разберём подборку полезных консольных команд и подходов для повседневной работы. Запуск PHP-скрипта с прологом Битрикса из консоли php -r ‘ require_once «/var/www/site/bitrix/modules/main/include/prolog_before.php»; echo «Bitrix version: » . SM_VERSION . «\n»;…

Файловая структура 1С-Битрикс на первый взгляд выглядит запутанной — сотни каталогов внутри bitrix/, дублирующиеся по смыслу названия. Разберём практические способы быстро находить нужный файл: конкретный шаблон компонента, обработчик события, место, где формируется определённый вывод на странице. Поиск по тексту через grep grep -r «PROPERTY_VALUES» /var/www/site/local/ —include=»*.php» -l Поиск по конкретной строке кода, известной подстроке текста или названию функции — самый…

Административная панель 1С-Битрикс за годы работы обрастает скрытыми удобствами, о которых редко узнают из документации, — быстрые способы навигации, недокументированные параметры URL, полезные разделы, спрятанные в неочевидных местах меню. Разберём подборку таких находок для тех, кто проводит в админке много времени. Быстрый поиск по административной панели Верхняя панель админки содержит поле поиска, ищущее не только по контенту, но и по…

Агенты в 1С-Битрикс — механизм отложенного и периодического выполнения кода, встроенный в ядро с самого начала. Разберём CAgent: как зарегистрировать агент, какие требования предъявляются к функции-обработчику и почему агент, забытый после отладки, может годами незаметно грузить сервер. Регистрация агента <?php CAgent::AddAgent( ‘syncStockBalances();’, // вызываемая функция как строка ‘my.module’, // модуль, к которому привязан агент ‘N’, // периодичность: N — по…

Ядро Битрикса и его особенности файловой структуры плохо сочетаются с наивным «положить весь проект в Git» — часть каталогов должна версионироваться, часть категорически нет. Разберём, что реально стоит включать в репозиторий проекта на 1С-Битрикс, а что исключить. Что не версионировать: ядро системы Каталог bitrix/modules/ с ядром системы и штатными модулями не стоит версионировать в проектном репозитории — он обновляется собственным…

Мобильное приложение, внешняя интеграция или SPA-фронтенд, работающий с данными сайта, — всем им нужен API. Разберём, как реализовать собственный REST-эндпоинт на 1С-Битрикс через штатный механизм контроллеров D7, а не через самописную маршрутизацию с нуля. Контроллер как основа REST-эндпоинта <?php namespace Vendor\Module\Controller; use Bitrix\Main\Engine\Controller; use Bitrix\Main\Engine\ActionFilter; class Product extends Controller { public function configureActions(): array { return [ ‘list’ => […