PHPackages                             sliva-name/bitrix24-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. sliva-name/bitrix24-laravel

ActiveLibrary[Authentication & Authorization](/categories/authentication)

sliva-name/bitrix24-laravel
===========================

Laravel integration package for Bitrix24 CRM with OAuth and Webhook support

v1.0.0(6mo ago)454MITPHPPHP ^8.2

Since Oct 23Pushed 6mo agoCompare

[ Source](https://github.com/sliva-name/bitrix24-laravel)[ Packagist](https://packagist.org/packages/sliva-name/bitrix24-laravel)[ RSS](/packages/sliva-name-bitrix24-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (6)Versions (2)Used By (0)

🚀 Laravel Bitrix24 Integration
==============================

[](#-laravel-bitrix24-integration)

[![Latest Version](https://camo.githubusercontent.com/e5966de90d7705c3578b2cbee80c88db6262dcc5b611c18c9f4a02880760e48f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736c6976612d6e616d652f62697472697832342d6c61726176656c2e737667)](https://packagist.org/packages/sliva-name/bitrix24-laravel)[![License](https://camo.githubusercontent.com/46b98218a67e058a9936fada3e344131fb7f8da0e0e1ac45bc5772e47ddca993/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f736c6976612d6e616d652f62697472697832342d6c61726176656c2e737667)](LICENSE)[![PHP Version](https://camo.githubusercontent.com/c721660128bfdb53f543ee70425beefa23d69466455a52d241b8a95522f5d496/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f736c6976612d6e616d652f62697472697832342d6c61726176656c2e737667)](https://packagist.org/packages/sliva-name/bitrix24-laravel)[![Laravel Version](https://camo.githubusercontent.com/73692ab0f1fac2901149539199fa738ac249d6cd2387048e8063666cfab3d736/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302e7825323025374325323031312e7825323025374325323031322e782d7265642e737667)](https://laravel.com)[![Downloads](https://camo.githubusercontent.com/086fbf5f045df673eaf34cb80c31b1e96e4f472db8e5e3793cb3cdb0bd4f0205/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736c6976612d6e616d652f62697472697832342d6c61726176656c2e737667)](https://packagist.org/packages/sliva-name/bitrix24-laravel)

**Полнофункциональный, гибкий и расширяемый пакет для интеграции Laravel с Bitrix24 CRM.**

Поддерживает OAuth и Webhook аутентификацию, предоставляет чистый API для работы с CRM, задачами, пользователями и кастомными списками. Спроектирован с учетом принципов SOLID и максимальной расширяемости.

---

📋 Содержание
------------

[](#-содержание)

- [Возможности](#-%D0%B2%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE%D1%81%D1%82%D0%B8)
- [Требования](#-%D1%82%D1%80%D0%B5%D0%B1%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F)
- [Установка](#-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0)
- [Быстрый старт](#-%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82)
- [Конфигурация](#-%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F)
- [Базовое использование](#-%D0%B1%D0%B0%D0%B7%D0%BE%D0%B2%D0%BE%D0%B5-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
- [Продвинутые возможности](#-%D0%BF%D1%80%D0%BE%D0%B4%D0%B2%D0%B8%D0%BD%D1%83%D1%82%D1%8B%D0%B5-%D0%B2%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE%D1%81%D1%82%D0%B8)
- [Расширение пакета](#-%D1%80%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D0%B0%D0%BA%D0%B5%D1%82%D0%B0)
- [API Reference](#-api-reference)
- [События](#-%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F)
- [Middleware](#-middleware)
- [Тестирование](#-%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
- [Миграция](#-%D0%BC%D0%B8%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F)
- [FAQ](#-faq)
- [Поддержка](#-%D0%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0)

---

✨ Возможности
-------------

[](#-возможности)

### 🔐 Аутентификация

[](#-аутентификация)

- ✅ **OAuth 2.0** с автоматическим обновлением токенов
- ✅ **Webhook** для серверных интеграций
- ✅ Управление токенами с поддержкой мультитенантности
- ✅ Кеширование токенов для производительности

### 🎯 CRM клиенты

[](#-crm-клиенты)

- ✅ **Лиды** (Leads)
- ✅ **Сделки** (Deals)
- ✅ **Контакты** (Contacts)
- ✅ **Компании** (Companies)
- ✅ **Задачи** (Tasks)
- ✅ **Пользователи** (Users)
- ✅ **Пользовательские списки** (Lists)
- ✅ Универсальный CRM клиент для любых сущностей

### 🔧 Расширяемость

[](#-расширяемость)

- ✅ **Макросы (Macroable)** - динамическое добавление методов
- ✅ **События (Events)** - перехват API вызовов
- ✅ **Traits** - кеширование и rate limiting из коробки
- ✅ **Интерфейсы** - для всех клиентов (DI ready)
- ✅ **Регистрация клиентов** - переопределение и создание новых
- ✅ **Batch операции** - пакетные запросы к API

### 🏗️ Архитектура

[](#️-архитектура)

- ✅ **SOLID принципы** - чистая архитектура
- ✅ **Repository Pattern** - абстракция работы с данными
- ✅ **Service Layer** - инкапсуляция бизнес-логики
- ✅ **PSR-12** - стандарты кодирования
- ✅ **Type Safety** - строгая типизация PHP 8.2+
- ✅ Полная поддержка **Dependency Injection**

### 📦 Дополнительно

[](#-дополнительно)

- ✅ Готовые контроллеры и маршруты
- ✅ Middleware для защиты роутов
- ✅ API Resources для JSON responses
- ✅ Логирование всех операций
- ✅ Обработка ошибок и retry logic
- ✅ Подробная документация с примерами

---

📋 Требования
------------

[](#-требования)

- **PHP:** 8.2 или выше
- **Laravel:** 10.x, 11.x или 12.x
- **База данных:** PostgreSQL (рекомендуется), MySQL, SQLite
- **Extensions:** `ext-json`, `ext-curl`

---

📦 Установка
-----------

[](#-установка)

### Шаг 1: Установка через Composer

[](#шаг-1-установка-через-composer)

```
composer require sliva-name/bitrix24-laravel
```

### Шаг 2: Публикация ресурсов

[](#шаг-2-публикация-ресурсов)

```
# Публикация конфигурации
php artisan vendor:publish --tag=bitrix24-config

# Публикация миграций
php artisan vendor:publish --tag=bitrix24-migrations
```

### Шаг 3: Запуск миграций

[](#шаг-3-запуск-миграций)

```
php artisan migrate
```

### Шаг 4: Настройка окружения

[](#шаг-4-настройка-окружения)

Добавьте переменные в файл `.env`:

#### Для OAuth:

[](#для-oauth)

```
BITRIX24_AUTH_TYPE=oauth
BITRIX24_DOMAIN=your-domain.bitrix24.ru
BITRIX24_CLIENT_ID=local.xxxxxxxx.yyyyyyyy
BITRIX24_CLIENT_SECRET=your_client_secret
BITRIX24_REDIRECT_URI=${APP_URL}/api/bitrix24/auth/callback
```

#### Для Webhook:

[](#для-webhook)

```
BITRIX24_AUTH_TYPE=webhook
BITRIX24_WEBHOOK_URL=https://your-domain.bitrix24.ru/rest/123/your_webhook_key/
```

---

🚀 Быстрый старт
---------------

[](#-быстрый-старт)

### OAuth аутентификация

[](#oauth-аутентификация)

```
use Leko\Bitrix24\Facades\Bitrix24;

// 1. Получить URL для авторизации
$authUrl = Bitrix24::getAuthorizationUrl();
return redirect($authUrl);

// 2. Обработать callback после авторизации
Route::get('/bitrix24/callback', function (Request $request) {
    $result = Bitrix24::handleCallback($request->input('code'));

    return response()->json([
        'success' => true,
        'token_id' => $result['token_id'],
    ]);
});

// 3. Использовать API
$leads = Bitrix24::leads()->list();
```

### Работа с лидами

[](#работа-с-лидами)

```
use Leko\Bitrix24\Facades\Bitrix24;

// Получить все лиды
$leads = Bitrix24::leads()->list();

// Фильтрация и сортировка
$hotLeads = Bitrix24::leads()->list(
    filter: ['STATUS_ID' => 'NEW', 'OPPORTUNITY' => ['>=', 100000]],
    select: ['ID', 'TITLE', 'NAME', 'OPPORTUNITY'],
    order: ['OPPORTUNITY' => 'DESC']
);

// Создать лид
$leadId = Bitrix24::leads()->add([
    'TITLE' => 'Новый клиент',
    'NAME' => 'Иван',
    'LAST_NAME' => 'Иванов',
    'EMAIL' => [['VALUE' => 'ivan@example.com', 'VALUE_TYPE' => 'WORK']],
    'PHONE' => [['VALUE' => '+79001234567', 'VALUE_TYPE' => 'MOBILE']],
    'OPPORTUNITY' => 50000,
]);

// Обновить лид
Bitrix24::leads()->update($leadId, [
    'STATUS_ID' => 'IN_PROCESS',
    'ASSIGNED_BY_ID' => 1,
]);

// Удалить лид
Bitrix24::leads()->delete($leadId);
```

---

⚙️ Конфигурация
---------------

[](#️-конфигурация)

### Файл конфигурации

[](#файл-конфигурации)

После публикации, файл `config/bitrix24.php` содержит все настройки:

```
return [
    // Тип аутентификации: 'oauth' или 'webhook'
    'default_connection' => env('BITRIX24_DEFAULT_CONNECTION', 'main'),

    'connections' => [
        'main' => [
            'type' => env('BITRIX24_AUTH_TYPE', 'oauth'),
            'domain' => env('BITRIX24_DOMAIN'),

            // OAuth настройки
            'client_id' => env('BITRIX24_CLIENT_ID'),
            'client_secret' => env('BITRIX24_CLIENT_SECRET'),
            'redirect_uri' => env('BITRIX24_REDIRECT_URI'),

            // Webhook настройки
            'webhook_url' => env('BITRIX24_WEBHOOK_URL'),
        ],

        // Дополнительные подключения
        'secondary' => [
            // ...
        ],
    ],

    // Хранение токенов
    'token_storage' => env('BITRIX24_TOKEN_STORAGE', 'database'),

    // Кеширование
    'cache' => [
        'enabled' => env('BITRIX24_CACHE_ENABLED', true),
        'store' => env('BITRIX24_CACHE_STORE', 'redis'),
        'ttl' => env('BITRIX24_CACHE_TTL', 3600),
    ],

    // Логирование
    'logging' => [
        'enabled' => env('BITRIX24_LOGGING_ENABLED', false),
        'channel' => env('BITRIX24_LOG_CHANNEL', 'daily'),
    ],

    // Таймауты и retry
    'api' => [
        'timeout' => env('BITRIX24_API_TIMEOUT', 30),
        'retry_times' => env('BITRIX24_RETRY_TIMES', 3),
        'retry_sleep' => env('BITRIX24_RETRY_SLEEP', 1000),
    ],
];
```

### Мультитенантность

[](#мультитенантность)

```
// Разные подключения для разных клиентов
$leads1 = Bitrix24::setConnection('tenant_1')->leads()->list();
$leads2 = Bitrix24::setConnection('tenant_2')->leads()->list();

// Работа с токенами конкретного пользователя
$leads = Bitrix24::setUserId(auth()->id())->leads()->list();
```

---

💻 Базовое использование
-----------------------

[](#-базовое-использование)

### Работа с CRM

[](#работа-с-crm)

#### Лиды (Leads)

[](#лиды-leads)

```
// Список с пагинацией
$leads = Bitrix24::leads()->list(
    filter: ['STATUS_ID' => 'NEW'],
    select: ['ID', 'TITLE', 'NAME'],
    order: ['ID' => 'DESC'],
    start: 0
);

// Получить по ID
$lead = Bitrix24::leads()->get(123);

// CRUD операции
$id = Bitrix24::leads()->add([...]);
$success = Bitrix24::leads()->update($id, [...]);
$deleted = Bitrix24::leads()->delete($id);

// Получить доступные поля
$fields = Bitrix24::leads()->fields();
```

#### Сделки (Deals)

[](#сделки-deals)

```
$deals = Bitrix24::deals()->list([
    'STAGE_ID' => 'NEW',
    'OPPORTUNITY' => ['>=', 10000],
]);

$deal = Bitrix24::deals()->add([
    'TITLE' => 'Крупная сделка',
    'OPPORTUNITY' => 500000,
    'CURRENCY_ID' => 'RUB',
    'CONTACT_ID' => 123,
    'COMPANY_ID' => 456,
]);
```

#### Контакты (Contacts)

[](#контакты-contacts)

```
$contacts = Bitrix24::contacts()->list();

$contact = Bitrix24::contacts()->add([
    'NAME' => 'Иван',
    'LAST_NAME' => 'Петров',
    'EMAIL' => [['VALUE' => 'ivan@example.com', 'VALUE_TYPE' => 'WORK']],
    'PHONE' => [['VALUE' => '+79001234567', 'VALUE_TYPE' => 'MOBILE']],
]);
```

#### Компании (Companies)

[](#компании-companies)

```
$companies = Bitrix24::companies()->list();

$company = Bitrix24::companies()->add([
    'TITLE' => 'ООО "Рога и Копыта"',
    'COMPANY_TYPE' => 'CUSTOMER',
    'INDUSTRY' => 'IT',
]);
```

### Работа с задачами

[](#работа-с-задачами)

```
// Получить все задачи
$tasks = Bitrix24::tasks()->list();

// Создать задачу
$taskId = Bitrix24::tasks()->add([
    'TITLE' => 'Позвонить клиенту',
    'DESCRIPTION' => 'Обсудить условия сделки',
    'RESPONSIBLE_ID' => 1,
    'DEADLINE' => now()->addDays(3)->toDateTimeString(),
]);

// Обновить задачу
Bitrix24::tasks()->update($taskId, [
    'STATUS' => 5, // Завершена
]);
```

### Работа с пользователями

[](#работа-с-пользователями)

```
// Получить всех пользователей
$users = Bitrix24::users()->list();

// Текущий пользователь
$currentUser = Bitrix24::users()->current();

// Поиск пользователей
$found = Bitrix24::users()->search('Иван');
```

### Работа с пользовательскими списками

[](#работа-с-пользовательскими-списками)

```
$lists = Bitrix24::lists();

// Получить все списки
$allLists = $lists->getAllLists();

// Получить элементы списка
$items = $lists->list($listId, [
    'PROPERTY_STATUS' => 'active'
]);

// Добавить элемент
$elementId = $lists->add($listId, [
    'NAME' => 'Новый элемент',
    'PROPERTY_VALUE' => 'test',
]);
```

### Универсальный CRM клиент

[](#универсальный-crm-клиент)

```
$crm = Bitrix24::crm();

// Работа с любой сущностью
$items = $crm->getList('lead', ['STATUS_ID' => 'NEW']);
$fields = $crm->getFields('deal');
$id = $crm->add('contact', [...]);
```

---

🔥 Продвинутые возможности
-------------------------

[](#-продвинутые-возможности)

### 1. Макросы (Macroable)

[](#1-макросы-macroable)

Добавляйте методы динамически без наследования:

```
use Leko\Bitrix24\Clients\LeadClient;

// В AppServiceProvider::boot()
LeadClient::macro('getHotLeads', function () {
    return $this->list([
        'OPPORTUNITY' => ['>=', 100000],
        'STATUS_ID' => 'NEW',
    ]);
});

// Использование
$hotLeads = Bitrix24::leads()->getHotLeads();
```

#### Mixin - добавление класса методов

[](#mixin---добавление-класса-методов)

```
class LeadAnalyticsMixin
{
    public function calculateConversion()
    {
        return function () {
            $all = count($this->list());
            $converted = count($this->list(['STATUS_ID' => 'CONVERTED']));
            return $all > 0 ? ($converted / $all * 100) : 0;
        };
    }
}

LeadClient::mixin(new LeadAnalyticsMixin());
$conversion = Bitrix24::leads()->calculateConversion();
```

### 2. События (Events)

[](#2-события-events)

Перехватывайте и обрабатывайте API вызовы:

```
use Leko\Bitrix24\Events\ApiCallEvent;
use Leko\Bitrix24\Events\ApiCallFailedEvent;

// В EventServiceProvider
protected $listen = [
    ApiCallEvent::class => [
        LogBitrix24ApiCall::class,
    ],
    ApiCallFailedEvent::class => [
        NotifyOnBitrix24ApiFailure::class,
    ],
];

// Listener
class LogBitrix24ApiCall
{
    public function handle(ApiCallEvent $event): void
    {
        Log::info('Bitrix24 API Call', [
            'method' => $event->method,
            'duration' => $event->duration,
            'is_webhook' => $event->isWebhook,
        ]);
    }
}
```

### 3. Traits для расширения

[](#3-traits-для-расширения)

#### HasCaching - кеширование запросов

[](#hascaching---кеширование-запросов)

```
use Leko\Bitrix24\Clients\LeadClient;
use Leko\Bitrix24\Support\Traits\HasCaching;

class CachedLeadClient extends LeadClient
{
    use HasCaching;

    public function listCached(array $filter = []): array
    {
        $key = 'leads:' . md5(json_encode($filter));

        return $this->cached($key, function () use ($filter) {
            return $this->list($filter);
        }, 600); // 10 минут
    }
}
```

#### HasRateLimiting - защита от лимитов

[](#hasratelimiting---защита-от-лимитов)

```
use Leko\Bitrix24\Support\Traits\HasRateLimiting;

class RateLimitedDealClient extends DealClient
{
    use HasRateLimiting;

    public function __construct($serviceBuilder)
    {
        parent::__construct($serviceBuilder);
        $this->rateLimit(50, 60); // 50 запросов в минуту
    }

    public function list(...): array
    {
        return $this->rateLimited('deals:list', function () {
            return parent::list(...);
        });
    }
}
```

### 4. Batch операции

[](#4-batch-операции)

```
use Leko\Bitrix24\Support\BatchRequest;

$batch = new BatchRequest(Bitrix24::leads());

$batch
    ->add('lead1', 'crm.lead.add', ['fields' => ['TITLE' => 'Лид 1']])
    ->add('lead2', 'crm.lead.add', ['fields' => ['TITLE' => 'Лид 2']])
    ->add('lead3', 'crm.lead.add', ['fields' => ['TITLE' => 'Лид 3']]);

$results = $batch->execute();
```

### 5. Dependency Injection

[](#5-dependency-injection)

Все клиенты имеют интерфейсы для внедрения зависимостей:

```
use Leko\Bitrix24\Contracts\LeadClientInterface;
use Leko\Bitrix24\Contracts\DealClientInterface;

class SalesService
{
    public function __construct(
        private LeadClientInterface $leads,
        private DealClientInterface $deals
    ) {}

    public function convertLeadToDeal(int $leadId): ?int
    {
        $lead = $this->leads->get($leadId);

        return $this->deals->add([
            'TITLE' => $lead['TITLE'],
            'CONTACT_ID' => $lead['CONTACT_ID'],
        ]);
    }
}

// Laravel автоматически внедрит зависимости
$service = app(SalesService::class);
```

---

🎨 Расширение пакета
-------------------

[](#-расширение-пакета)

### Создание кастомного клиента

[](#создание-кастомного-клиента)

```
namespace App\Services\Bitrix24;

use Leko\Bitrix24\Clients\BaseClient;

class AnalyticsClient extends BaseClient
{
    public function getSalesReport(string $period): array
    {
        return $this->callMethod('crm.analytics.report', [
            'period' => $period,
        ]) ?? [];
    }
}
```

### Регистрация клиента

[](#регистрация-клиента)

```
// В AppServiceProvider
use Leko\Bitrix24\Bitrix24Service;

public function boot(): void
{
    // Регистрация нового клиента
    Bitrix24Service::registerClient('analytics', AnalyticsClient::class);

    // Переопределение существующего
    Bitrix24Service::registerClient('leads', MyCustomLeadClient::class);
}

// Использование
$report = Bitrix24::client('analytics')->getSalesReport('month');
$leads = Bitrix24::leads(); // Вернёт MyCustomLeadClient
```

📖 **Подробнее:** [EXTENSIBILITY.md](EXTENSIBILITY.md), [ADVANCED\_USAGE.md](ADVANCED_USAGE.md)

---

📚 API Reference
---------------

[](#-api-reference)

### Bitrix24 Facade

[](#bitrix24-facade)

```
Bitrix24::leads()      // LeadClientInterface
Bitrix24::deals()      // DealClientInterface
Bitrix24::contacts()   // ContactClientInterface
Bitrix24::companies()  // CompanyClientInterface
Bitrix24::tasks()      // TaskClientInterface
Bitrix24::users()      // UserClientInterface
Bitrix24::lists()      // ListClientInterface
Bitrix24::crm()        // CrmClientInterface

// Утилиты
Bitrix24::setConnection(string $name)
Bitrix24::setUserId(?int $id)
Bitrix24::getAuthorizationUrl(array $scopes = [])
Bitrix24::handleCallback(string $code)
Bitrix24::hasValidToken(?int $userId = null)
Bitrix24::client(string $name) // Кастомный клиент
```

### Методы клиентов

[](#методы-клиентов)

Все CRM клиенты (Leads, Deals, Contacts, Companies) имеют одинаковый интерфейс:

```
list(array $filter = [], array $select = ['*'], array $order = ['ID' => 'DESC'], int $start = 0): array
get(int $id): mixed
add(array $fields): ?int
update(int $id, array $fields): bool
delete(int $id): bool
fields(): array
```

---

📡 События
---------

[](#-события)

Пакет генерирует следующие события:

### ApiCallEvent

[](#apicallevent)

Вызывается при успешном API запросе:

```
public readonly string $method;      // Метод API
public readonly array $params;       // Параметры запроса
public readonly mixed $result;       // Результат
public readonly float $duration;     // Длительность в секундах
public readonly bool $isWebhook;     // Webhook или OAuth
```

### ApiCallFailedEvent

[](#apicallfailedevent)

Вызывается при ошибке API запроса:

```
public readonly string $method;      // Метод API
public readonly array $params;       // Параметры запроса
public readonly Throwable $exception;// Исключение
public readonly float $duration;     // Длительность в секундах
```

---

🛡️ Middleware
-------------

[](#️-middleware)

### EnsureBitrix24Token

[](#ensurebitrix24token)

Проверяет наличие валидного токена:

```
Route::middleware(['auth', 'bitrix24.token'])->group(function () {
    Route::get('/leads', [LeadController::class, 'index']);
});
```

Регистрация в `app/Http/Kernel.php`:

```
protected $middlewareAliases = [
    'bitrix24.token' => \Leko\Bitrix24\Http\Middleware\EnsureBitrix24Token::class,
];
```

---

🧪 Тестирование
--------------

[](#-тестирование)

```
# Запуск всех тестов
composer test

# С покрытием кода
composer test:coverage

# Статический анализ
composer phpstan

# Code style
composer cs:check
composer cs:fix
```

### Моки для тестирования

[](#моки-для-тестирования)

```
use Leko\Bitrix24\Contracts\LeadClientInterface;

public function test_lead_creation(): void
{
    $mock = Mockery::mock(LeadClientInterface::class);
    $mock->shouldReceive('add')
        ->once()
        ->with(['TITLE' => 'Test Lead'])
        ->andReturn(123);

    $this->app->instance(LeadClientInterface::class, $mock);

    // Ваш тест
}
```

---

🔄 Миграция
----------

[](#-миграция)

### С версии 1.x на 2.x

[](#с-версии-1x-на-2x)

См. [MIGRATION\_GUIDE.md](MIGRATION_GUIDE.md) для подробных инструкций.

Основные изменения:

- Добавлены интерфейсы для всех клиентов
- Новая система событий
- Макросы и traits
- Batch операции

---

❓ FAQ
-----

[](#-faq)

**Как работать с несколькими Bitrix24 аккаунтами?**```
// В config/bitrix24.php добавьте подключения
'connections' => [
    'account1' => [...],
    'account2' => [...],
],

// Используйте
$leads1 = Bitrix24::setConnection('account1')->leads()->list();
$leads2 = Bitrix24::setConnection('account2')->leads()->list();
```

**Как обработать ошибки API?**```
try {
    $leads = Bitrix24::leads()->list();
} catch (\Throwable $e) {
    Log::error('Bitrix24 Error', [
        'message' => $e->getMessage(),
        'trace' => $e->getTraceAsString(),
    ]);
}
```

**Как добавить кеширование?**Используйте trait `HasCaching`:

```
use Leko\Bitrix24\Support\Traits\HasCaching;

class CachedClient extends LeadClient
{
    use HasCaching;

    public function listCached(): array
    {
        return $this->cached('leads', fn() => $this->list(), 600);
    }
}
```

**Как работать с пагинацией?**```
$start = 0;
$perPage = 50;
$allLeads = [];

do {
    $leads = Bitrix24::leads()->list(start: $start);
    $allLeads = array_merge($allLeads, $leads);
    $start += $perPage;
} while (count($leads) === $perPage);
```

---

📖 Документация
--------------

[](#-документация)

- **[EXTENSIBILITY.md](EXTENSIBILITY.md)** - Полное руководство по расширению пакета
- **[ADVANCED\_USAGE.md](ADVANCED_USAGE.md)** - Продвинутые примеры использования
- **[FLEXIBILITY\_SUMMARY.md](FLEXIBILITY_SUMMARY.md)** - Резюме гибкости архитектуры
- **[MIGRATION\_GUIDE.md](MIGRATION_GUIDE.md)** - Руководство по миграции
- **[CHANGELOG.md](CHANGELOG.md)** - История изменений
- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Правила контрибуции

---

🤝 Поддержка
-----------

[](#-поддержка)

- 📧 Email:
- 🐛 Issues: [GitHub Issues](https://github.com/sliva-name/bitrix24-laravel/issues)
- 💬 Discussions: [GitHub Discussions](https://github.com/sliva-name/bitrix24-laravel/discussions)

---

🙏 Благодарности
---------------

[](#-благодарности)

- [Bitrix24 PHP SDK](https://github.com/bitrix24/b24phpsdk) - за основу работы с API
- [Laravel Framework](https://laravel.com) - за отличный фреймворк
- Всем контрибьюторам проекта

---

📄 Лицензия
----------

[](#-лицензия)

Этот пакет является открытым ПО, лицензированным под [MIT license](LICENSE).

---

🌟 Вклад в проект
----------------

[](#-вклад-в-проект)

Мы приветствуем вклад! Пожалуйста:

1. Fork репозитория
2. Создайте feature branch (`git checkout -b feature/amazing-feature`)
3. Commit изменений (`git commit -m 'Add amazing feature'`)
4. Push в branch (`git push origin feature/amazing-feature`)
5. Откройте Pull Request

См. [CONTRIBUTING.md](CONTRIBUTING.md) для подробностей.

---

Сделано с ❤️ командой [Leko Team](https://leko.team)

 [⬆ Вернуться к началу](#-содержание)

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance66

Regular maintenance activity

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

202d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a108b055abdb7f9d47a1518e082cb7ced93100ec0aa37a589400bc070f2b4229?d=identicon)[sliva-name](/maintainers/sliva-name)

---

Top Contributors

[![leko-team](https://avatars.githubusercontent.com/u/16772593?v=4)](https://github.com/leko-team "leko-team (4 commits)")[![renoschubert](https://avatars.githubusercontent.com/u/46114615?v=4)](https://github.com/renoschubert "renoschubert (3 commits)")[![sliva-name](https://avatars.githubusercontent.com/u/67502021?v=4)](https://github.com/sliva-name "sliva-name (1 commits)")

---

Tags

apilaraveloauthwebhookcrmBitrix24

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sliva-name-bitrix24-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/sliva-name-bitrix24-laravel/health.svg)](https://phpackages.com/packages/sliva-name-bitrix24-laravel)
```

###  Alternatives

[kovah/laravel-socialite-oidc

OpenID Connect OAuth2 Provider for Laravel Socialite

2073.7k](/packages/kovah-laravel-socialite-oidc)[alajusticia/laravel-logins

Session management in Laravel apps, user notifications on new access, support for multiple separate remember tokens, IP geolocation, User-Agent parser

2011.0k](/packages/alajusticia-laravel-logins)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)