Программирование на языке PHP в CMS 1С-Битрикс

Расширенные примеры использования API Битрикс

ORM: выборка с связями и агрегацией

Пример: получить список элементов инфоблока с названием раздела и количеством просмотров из таблицы статистики (предположим, есть таблица statistics с полями ELEMENT_ID, VIEWS).

use Bitrix\Main\Data\DataManager;
use Bitrix\Main\ORM\Query\Join;
use Bitrix\Main\ORM\Fields\Relations\Reference;
use Bitrix\Main\ORM\Fields\ExpressionField;

class ElementTable extends DataManager {
    public static function getTableName() { return 'b_iblock_element'; }
    public static function getMap() {
        return [
            new IntegerField('ID', ['primary' => true]),
            new StringField('NAME'),
            new IntegerField('IBLOCK_SECTION_ID'),
            (new Reference('SECTION', SectionTable::class, Join::on('this.IBLOCK_SECTION_ID', 'ref.ID')))->configureJoinType('left'),
        ];
    }
}

class SectionTable extends DataManager {
    public static function getTableName() { return 'b_iblock_section'; }
    public static function getMap() {
        return [
            new IntegerField('ID', ['primary' => true]),
            new StringField('NAME'),
        ];
    }
}

// Запрос
$result = ElementTable::getList([
    'select' => ['ID', 'NAME', 'SECTION_NAME' => 'SECTION.NAME'],
    'filter' => ['=IBLOCK_ID' => 2],
    'limit' => 10,
]);
while ($row = $result->fetch()) {
    echo $row['ID'] . ' - ' . $row['NAME'] . ' - ' . $row['SECTION_NAME'] . "\n";
}

Результат:

1 - Товар1 - Раздел А
2 - Товар2 - Раздел Б
...

Пояснение: используется Reference для связи с разделом. Выборка включает поле из связанной таблицы.

Агент для массовой очистки старых логов

Пример: агент удаляет записи из таблицы логов старше 30 дней.

function cleanOldLogs() {
    $connection = \Bitrix\Main\Application::getConnection();
    $sql = "DELETE FROM b_event_log WHERE TIMESTAMP_X < DATE_SUB(NOW(), INTERVAL 30 DAY)";
    $connection->queryExecute($sql);
    return "cleanOldLogs();";
}

// Регистрация
\CAgent::AddAgent("cleanOldLogs();", "", "N", 86400);

Результат: запуск агента каждый день удаляет старые логи.

REST: обновление пользовательского поля лида

Пример: установить значение пользовательского поля UF_CRM_5_IS_IMPORTANT у лида.

$webhook = 'https://site.bitrix24.ru/rest/1/xxx/';
$method = 'crm.lead.update';
$params = [
    'id' => 123,
    'fields' => [
        'UF_CRM_5_IS_IMPORTANT' => 1,
    ],
];
$url = $webhook . $method . '.json';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
if ($result['result']) {
    echo 'Обновлено успешно';
} else {
    print_r($result['error']);
}

Результат: возвращается true при успехе.

Событие: отправка email при добавлении элемента

Пример: подписка на OnAfterIBlockElementAdd и отправка письма.

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'iblock',
    'OnAfterIBlockElementAdd',
    'sendNewElementNotification'
);

function sendNewElementNotification(\Bitrix\Main\Event $event) {
    $parameters = $event->getParameters();
    $elementId = $parameters['ID'];
    $iblockId = $parameters['IBLOCK_ID'];
    // Получить данные элемента
    $element = \CIBlockElement::GetByID($elementId)->GetNext();
    $name = $element['NAME'];
    // Отправить email
    \CEvent::Send('NEW_ELEMENT', SITE_ID, [
        'ELEMENT_NAME' => $name,
        'ELEMENT_ID' => $elementId,
    ]);
}

Пояснение: событие передает ID и другие параметры. Используется CEvent::Send для шаблона почтового события.