Написання unit-тестів для модулів 1С-Бітрікс
Unit-тести для модулів Бітрікс — завдання з подвійною складністю. Перша — код модулів часто написаний із прямими викликами статичних методів ядра (CIBlockElement::GetList(), \Bitrix\Main\Application::getInstance()), які не можна підмінити моком. Друга — тести вимагають завантаженого ядра Бітрікс, що робить їх повільнішими за звичайні unit-тести. Рішення: чіткий поділ тестованої логіки від інфраструктурного коду Бітрікс.
Принцип тестованої архітектури
Нетестований код:
// Бізнес-логіка змішана з інфраструктурою — не можна протестувати ізольовано
public function calculateDiscount(int $userId): float
{
$user = \CUser::GetByID($userId)->Fetch(); // статичний виклик Бітрікс
$orders = \CSaleOrder::GetList([], ['USER_ID' => $userId])->Fetch();
return $orders['count'] > 10 ? 0.15 : 0.05;
}
Тестований код:
// Логіка відокремлена, залежності інжектуються
class DiscountCalculator
{
public function __construct(
private UserRepositoryInterface $users,
private OrderRepositoryInterface $orders,
) {}
public function calculate(int $userId): float
{
$user = $this->users->findById($userId);
$orderCount = $this->orders->countByUserId($userId);
return $orderCount > 10 ? 0.15 : 0.05;
}
}
Репозиторії реалізуються через Bitrix API у продакшн-коді та через моки у тестах.
Інфраструктура тестів
Bootstrap для PHPUnit із завантаженням ядра Бітрікс (коли без нього не обійтись):
// tests/bootstrap.php
define('NO_KEEP_STATISTIC', true);
define('NOT_CHECK_PERMISSIONS', true);
define('BX_WITH_ON_AFTER_EPILOG', false);
define('BX_NO_ACCELERATOR_RESET', true);
$_SERVER['DOCUMENT_ROOT'] = realpath(__DIR__ . '/../../../..');
require_once $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
\Bitrix\Main\Loader::includeModule('your.module');
Для чистих unit-тестів без ядра Бітрікс — окремий bootstrap без prolog_before.php, лише Composer autoload.
Приклади unit-тестів
Тест бізнес-логіки (без ядра):
class DiscountCalculatorTest extends TestCase
{
private DiscountCalculator $calculator;
protected function setUp(): void
{
$this->calculator = new DiscountCalculator(
users: $this->createStub(UserRepositoryInterface::class),
orders: $this->createConfiguredMock(
OrderRepositoryInterface::class,
['countByUserId' => 5]
),
);
}
public function testLessThan10OrdersGivesBasicDiscount(): void
{
$this->assertSame(0.05, $this->calculator->calculate(1));
}
public function testMoreThan10OrdersGivesPremiumDiscount(): void
{
$repo = $this->createConfiguredMock(
OrderRepositoryInterface::class,
['countByUserId' => 15]
);
$calc = new DiscountCalculator($this->createStub(UserRepositoryInterface::class), $repo);
$this->assertSame(0.15, $calc->calculate(1));
}
}
Тест із використанням ORM Бітрікс (інтеграційний):
class BookingTableTest extends \Bitrix\Main\Test\TableTest
{
protected static function getTable(): string
{
return BookingTable::class;
}
public function testCreateBooking(): void
{
$result = BookingTable::add([
'ROOM_ID' => 1,
'DATE_FROM' => new \Bitrix\Main\Type\Date('2026-04-01'),
'DATE_TO' => new \Bitrix\Main\Type\Date('2026-04-05'),
'STATUS' => 'pending',
]);
$this->assertTrue($result->isSuccess(), implode(', ', $result->getErrorMessages()));
$this->assertGreaterThan(0, $result->getId());
}
}
Покриття та пріоритизація
Не потрібно покривати тестами 100% коду — це нерентабельно для Бітрікс-проєктів. Пріоритети:
| Пріоритет | Що тестуємо |
|---|---|
| Високий | Розрахунки цін, знижок, вартості доставки |
| Високий | Бізнес-логіка станів (статусна машина) |
| Високий | Парсери та маппінг даних (імпорт із 1С, Excel) |
| Середній | Валідатори вхідних даних |
| Середній | Алгоритми формування звітів |
| Низький | Шаблони компонентів, UI-логіка |
Метрики покриття
Підключення Xdebug для вимірювання покриття:
<!-- phpunit.xml -->
<coverage processUncoveredFiles="true">
<include>
<directory suffix=".php">local/modules/your.module/lib</directory>
</include>
<report>
<html outputDirectory="coverage-report"/>
</report>
</coverage>
Цільове покриття для ключової бізнес-логіки — 80%+. Для інфраструктурного коду (репозиторії, адаптери) — достатньо інтеграційних тестів.
Що входить до написання unit-тестів
- Аудит коду модуля на тестованість, рефакторинг точок впровадження залежностей
- Налаштування PHPUnit із bootstrap для оточення Бітрікс
- Написання тестів для бізнес-логіки: розрахунки, статусні машини, парсери
- Налаштування звіту покриття через Xdebug
- Інтеграція запуску тестів у CI (GitHub Actions / GitLab CI)
- Документація щодо запуску тестів і додавання нових