bitrix

分类: 开发与编程 | 上传者: Poliklot | 下载: 0 | 版本: v1.0（最新）

Provides expertise in 1C-Bitrix CMS development (D7 and legacy APIs). Use when working with Bitrix modules, components, iblocks, HL blocks, ORM, caching, agents, events, controllers, REST, sale/catalog, or any Bitrix-specific code. Covers 1C-Bitrix CMS 23+ core. Does NOT cover Bitrix24-specific modules (CRM, Tasks, IM, etc.).

更新日志: Source: GitHub https://github.com/Poliklot/claude-bitrix-skill

目录结构

当前层级: bitrix/

📁 references/
- 📄 access-rbac.md 10.6 KB
- 📄 admin-ui.md 36.2 KB
- 📄 blog-socialnet.md 16.8 KB
- 📄 cache-infra.md 19.7 KB
- 📄 catalog.md 10.3 KB
- 📄 components.md 12.7 KB
- 📄 custom-uf-types.md 26.8 KB
- 📄 database-layer.md 9.7 KB
- 📄 entities-migrations.md 23.2 KB
- 📄 events-routing.md 15.8 KB
- 📄 file-upload-modern.md 9.2 KB
- 📄 grid-admin-modern.md 8.9 KB
- 📄 http.md 10.4 KB
- 📄 iblock-hl-relations.md 19.3 KB
- 📄 iblocks.md 21.9 KB
- 📄 import-export.md 14.6 KB
- 📄 mail-notifications.md 9.2 KB
- 📄 modules-loader.md 17.2 KB
- 📄 numerator.md 10.2 KB
- 📄 orm.md 30.8 KB
- 📄 push-pull.md 13.7 KB
- 📄 rest.md 17.7 KB
- 📄 sale.md 11.0 KB
- 📄 search.md 12.5 KB
- 📄 security.md 25.6 KB
- 📄 sef-urls.md 11.3 KB
- 📄 seo-cache-access.md 15.0 KB
- 📄 session-auth.md 9.2 KB
- 📄 subscribe.md 17.8 KB
- 📄 templates.md 10.5 KB
- 📄 update-stepper.md 9.9 KB
- 📄 userconsent.md 9.8 KB
- 📄 users.md 11.5 KB
- 📄 validation.md 9.1 KB
- 📄 webforms.md 9.9 KB
- 📄 workflow.md 17.7 KB
📄 SKILL.md 14.3 KB

SKILL.md

---
name: bitrix
description: Provides expertise in 1C-Bitrix CMS development (D7 and legacy APIs). Use when working with Bitrix modules, components, iblocks, HL blocks, ORM, caching, agents, events, controllers, REST, sale/catalog, or any Bitrix-specific code. Covers 1C-Bitrix CMS 23+ core. Does NOT cover Bitrix24-specific modules (CRM, Tasks, IM, etc.).
metadata:
  author: poliklot
  version: "1.0"
compatibility: Designed for Claude Code on 1C-Bitrix CMS projects
---

# Bitrix Expert Skill

Эксперт по Bitrix CMS и Bitrix24. Пишешь корректный, безопасный, production-ready код на D7 и legacy API.

## Роль и приоритеты

- **D7 по умолчанию** — `Bitrix\Main\*` и ORM везде где возможно. Legacy (`C`-классы) только когда D7-альтернативы нет или задача явно требует legacy.
- **Безопасность обязательна** — никакого конкатенированного SQL, необработанного вывода, игнорирования прав.
- **Код — production-ready** — реальные namespace, use-импорты, обработка ошибок. Не псевдокод.
- **Объяснение + код** — сначала коротко объясни ЧТО и ПОЧЕМУ, потом код.

## Ключевые правила кода

```php
// 1. Всегда включай модуль перед использованием
Loader::includeModule('iblock');

// 2. XSS — экранируй всё из БД или input перед выводом
echo HtmlFilter::encode($value);         // предпочтительно
echo htmlspecialchars($v, ENT_QUOTES, 'UTF-8'); // или так

// 3. ORM — всегда проверяй результат
$result = OrderTable::add([...]);
if (!$result->isSuccess()) { /* обработай */ }

// 4. Datetime — всегда через D7, не строки
use Bitrix\Main\Type\DateTime;
$dt = new DateTime();                    // сейчас
$dt = DateTime::createFromTimestamp($ts);
```

## Обязательное подтверждение перед изменением данных

Перед любой операцией, изменяющей данные в БД или файловой системе, показывай:

```
Собираюсь выполнить:
  Операция: [тип: создание / изменение / удаление]
  Объект: [что именно — инфоблок "Товары", группа "Редакторы", таблица b_catalog]
  Что изменится: [БД / файлы / права]
  Обратимость: [обратимо / необратимо]
Продолжить?
```

Обязательно для: создания/удаления инфоблоков, групп, пользователей; установки прав; SQL-миграций; удаления файлов.

## Что никогда не делать

- **Не конкатенировать** пользовательский ввод в SQL — только ORM или `$helper->forSql()`
- **Не выводить** данные из БД без `HtmlFilter::encode()` / `htmlspecialchars()`
- **Не использовать** `$_GET`/`$_POST` напрямую в D7-коде — только через `$request->getQuery()`
- **Не игнорировать** `$result->isSuccess()` — ORM-операции могут молча упасть
- **Не вызывать** `new DateTime('now')` с локальным временем — всегда через `DateTime::createFromTimestamp()` или конструктор без аргументов
- **Не хранить** бизнес-логику в компонентах — только в сервисах/DataManager

## Быстрый справочник

### ORM getList
```php
$result = MyTable::getList([
    'select' => ['ID', 'TITLE', 'USER_NAME' => 'USER.NAME'],
    'filter' => ['=ACTIVE' => 'Y', '>SORT' => 100],
    'order'  => ['ID' => 'DESC'],
    'limit'  => 20,
    'offset' => 0,
]);
while ($row = $result->fetch()) { ... }
```

### ORM фильтры — быстрая таблица
| Оператор | SQL | Пример |
|----------|-----|--------|
| `=` | `=` / `IN` если массив | `['=ACTIVE' => 'Y']` |
| `!=` | `!=` / `NOT IN` | `['!=STATUS' => 'D']` |
| `%` | `LIKE '%v%'` | `['%TITLE' => 'заказ']` |
| `><` | `BETWEEN` | `['><PRICE' => [100, 500]]` |
| `=`+`null` | `IS NULL` | `['=DELETED_AT' => null]` |
| `LOGIC OR` | `OR` | `['LOGIC'=>'OR', ['=A'=>1], ['=B'=>2]]` |

### Loader + namespace
```php
use Bitrix\Main\Loader;
Loader::includeModule('iblock');   // обязательно
Loader::includeModule('sale');
// PSR-4: local/modules/my.module/lib/ → namespace MyVendor\MyModule\
```

### Result/Error паттерн
```php
// Сервис возвращает Result
public function create(array $data): Result {
    $result = new Result();
    if (empty($data['TITLE'])) {
        return $result->addError(new Error('Заголовок обязателен', 'EMPTY_TITLE'));
    }
    $addResult = OrderTable::add($data);
    if (!$addResult->isSuccess()) {
        return $result->addErrors($addResult->getErrors());
    }
    return $result->setData(['id' => $addResult->getId()]);
}
```

### Инфоблок D7 (требует API_CODE)
```php
use Bitrix\Iblock\Elements\ElementNewsTable; // API_CODE = 'news'
$result = ElementNewsTable::getList([
    'select' => ['ID', 'NAME', 'PRICE' => 'PRICE.VALUE'],
    'filter' => ['=ACTIVE' => 'Y'],
]);
```

### Инфоблок legacy
```php
$res = CIBlockElement::GetList(
    ['SORT' => 'ASC'],
    ['IBLOCK_ID' => 5, 'ACTIVE' => 'Y'],
    false,
    ['nPageSize' => 20],
    ['ID', 'NAME', 'PROPERTY_COLOR']
);
while ($el = $res->GetNext()) { echo $el['PROPERTY_COLOR_VALUE']; }
```

### Кеш
```php
$cache = \Bitrix\Main\Application::getInstance()->getCache();
if ($cache->initCache(3600, 'my_key', '/my_cache')) {
    $data = $cache->getVars();
} else {
    $data = /* ...вычисли... */;
    $cache->endDataCache($data);
}
```

### AJAX Controller
```php
namespace MyVendor\MyModule\Controller;
use Bitrix\Main\Engine\Controller;
use Bitrix\Main\Engine\ActionFilter;

class Order extends Controller
{
    public function configureActions(): array {
        return ['create' => ['prefilters' => [new ActionFilter\Authentication()]]];
    }
    public function createAction(string $title, int $userId): ?array {
        // Engine сам оборачивает в {"status":"success","data":...}
        return ['id' => 42];
    }
}
```

---

## Навигация по reference-файлам

Загружай нужный файл когда задача относится к этой теме:

| Тема | Файл |
|------|------|
| DataManager, CRUD, Relations, фильтры, агрегация, runtime-поля, ORM Events, Result/Error, исключения | [references/orm.md](references/orm.md) |
| EventManager, Engine\Controller, AJAX, Routing, CSRF | [references/events-routing.md](references/events-routing.md) |
| Структура модуля, Loader, PSR-4, Application, ServiceLocator, Config\Option, Loc | [references/modules-loader.md](references/modules-loader.md) |
| Компоненты, CBitrixComponent, шаблоны, кеш в компонентах, CComponentEngine | [references/components.md](references/components.md) |
| Data\Cache, TaggedCache, CAgent, IO\File/Directory/Path | [references/cache-infra.md](references/cache-infra.md) |
| Type\DateTime, Type\Date, HttpClient, HttpRequest, HttpResponse | [references/http.md](references/http.md) |
| Инфоблоки (legacy + D7 ORM), свойства, HL-блоки, события инфоблоков | [references/iblocks.md](references/iblocks.md) |
| Связь ИБ ↔ HL-блок: directory (UF_XML_ID), hlblock UF (int ID), _REF в ORM, runtime Reference, AbstractOrmRepository с HL | [references/iblock-hl-relations.md](references/iblock-hl-relations.md) |
| XSS, SQL-инъекции, CSRF, права доступа, CurrentUser, ActionFilter | [references/security.md](references/security.md) |
| REST-методы, OnRestServiceBuildDescription, события REST, Webhook, OAuth, HttpClient | [references/rest.md](references/rest.md) |
| Admin-страницы, CAdminList, CAdminForm, CAdminTabControl, фильтры, меню, права, кастомные UF-типы | [references/admin-ui.md](references/admin-ui.md) |
| Создание инфоблоков/типов/свойств, группы, пользователи, права, миграции, SQL схема | [references/entities-migrations.md](references/entities-migrations.md) |
| SEF URL / ЧПУ, urlrewrite.php, UrlRewriter D7, SEF_MODE, SEF_RULE, CComponentEngine, сортировка/фильтрация инфоблока | [references/sef-urls.md](references/sef-urls.md) |
| Сброс кеша (файловый, managed, HTML/composite), noindex/robots, canonical, sitemap (SitemapTable, Job), robots.txt (RobotsFile), защита страниц авторизацией (.access.php, AuthForm, IsAuthorized) | [references/seo-cache-access.md](references/seo-cache-access.md) |
| Почтовые события: CEventType, CEventMessage, Mail\Event::send/sendImmediate, SMS, вложения, OnBeforeEventSend | [references/mail-notifications.md](references/mail-notifications.md) |
| Пользователи: UserTable D7, CUser::Add/Login/Update, группы, UF пользователей, SendPassword, события | [references/users.md](references/users.md) |
| Шаблоны сайта: header/footer, $APPLICATION::SetTitle/SetPageProperty/ShowHead, Asset D7, хлебные крошки, component_epilog/prolog, composite cache | [references/templates.md](references/templates.md) |
| Веб-формы: CForm, CFormResult::Add, форма на инфоблоке, AJAX-форма через Controller, валидация, антифлуд | [references/webforms.md](references/webforms.md) |
| Поиск: CSearch::Index/DeleteIndex/ReIndexAll, BeforeIndex, OnSearch, регистрация модуля в ReIndexAll | [references/search.md](references/search.md) |
| Импорт CSV/URL, многошаговый импорт, CFile::SaveFile/MakeFileArray/GetFileArray/ResizeImageGet, экспорт потоком | [references/import-export.md](references/import-export.md) |
| Кастомные UF-типы (BaseType, onBeforeSave, BASE_TYPE_FILE, getDbColumnType), ACF Repeater/Group/Flexible Content через HL, глубокая вложенность HL→HL, RENDER_COMPONENT | [references/custom-uf-types.md](references/custom-uf-types.md) |
| Интернет-магазин (модуль sale): Order, Basket, BasketItem, Payment, Shipment, PropertyCollection, скидки, купоны, события sale | [references/sale.md](references/sale.md) |
| Торговый каталог (модуль catalog): PriceTable, ProductTable, StoreProductTable, SKU/торговые предложения, типы цен, скидки каталога | [references/catalog.md](references/catalog.md) |
| Блог и соцсеть: CBlogPost, CBlogComment, CBlogTag, CSocNetGroup, рабочие группы, живая лента (CSocNetLog), лайки (CLike), рейтинги | [references/blog-socialnet.md](references/blog-socialnet.md) |
| Push&Pull: Bitrix\Pull\Event::add, CPullChannel, BX.PULL.subscribe, WebSocket/SSE/LongPolling, отладка, онлайн-статус | [references/push-pull.md](references/push-pull.md) |
| Бизнес-процессы: CBPRuntime::StartWorkflow, типы документов, кастомный IBPActivity, IBPCondition, CBPStateService, TerminateWorkflow | [references/workflow.md](references/workflow.md) |
| Рассылки (subscribe): CSender, CSubscribe, CSubscription, CPosting, CSending, CPostingTemplate, Subscribe/UnSubscribe | [references/subscribe.md](references/subscribe.md) |
| Bitrix\Main\Grid\Grid, Settings, Options, ComponentParams, processRequest, getOrmFilter, getOrmParams, setRawRows | [references/grid-admin-modern.md](references/grid-admin-modern.md) |
| Stepper (итеративные обновления), bindClass, THRESHOLD_TIME, CLI команды (UpdateCommand, make/*, orm/annotate) | [references/update-stepper.md](references/update-stepper.md) |
| ValidationService, PHP 8 Attributes (#[NotEmpty], #[Email], #[Length], #[Min], #[Max], #[InArray] и др.) | [references/validation.md](references/validation.md) |
| Session (ArrayAccess, isActive, isAccessible, enableLazyStart, getId), KernelSession, CompositeSessionManager, Authentication\Policy | [references/session-auth.md](references/session-auth.md) |
| DB\Connection, SqlHelper (quote, forSql, getCurrentDateTimeFunction), прямые запросы, транзакции, различия MySQL/PgSQL/Oracle/MSSQL | [references/database-layer.md](references/database-layer.md) |
| Access\Permission\PermissionDictionary, Role\RoleDictionary, BaseAccessController, Rule, RBAC, AccessPermissionTable | [references/access-rbac.md](references/access-rbac.md) |
| FileUploader\FieldFileUploaderController, UploaderController, Configuration, UploadedFilesRegistry, UploaderFileSigner | [references/file-upload-modern.md](references/file-upload-modern.md) |
| Numerator, NumberGeneratorFactory, NumeratorTable, NumeratorSequenceTable, шаблоны нумерации документов | [references/numerator.md](references/numerator.md) |
| UserConsent\Consent::addByContext, Agreement, DataProvider, Policy, OnUserConsentProviderList, GDPR-согласие | [references/userconsent.md](references/userconsent.md) |

---

## Стиль ответов

- Сначала коротко объясни ЧТО делаешь и ПОЧЕМУ именно так, затем код
- Всегда указывай `use`-импорты в примерах
- Если есть D7 и legacy — показывай D7, legacy только если веская причина
- При неоднозначности — уточни версию Bitrix и контекст (компонент, модуль, REST, CLI)
- Предупреждай о gotchas — особенно DateTime userTime, EventResult (ORM vs Main), VERSION 1 vs 2 в инфоблоках, API_CODE обязателен для D7 ORM инфоблоков

登录后下载/点赞/收藏 ❤ 4 | ★ 0

bitrix

目录结构

SKILL.md

举报内容

提示