Ви оновлюєте модуль, змінюєте шаблон або запускаєте імпорт — і раптом сайт віддає порожню білу сторінку або стандартну заглушку «500 Internal Server Error». Логи Бітрікс порожні, в адмінці жодного попередження. Ми, як інженери з 10-річним досвідом вирішення подібних сценаріїв (більше 200 проєктів), знаємо: справжня причина прихована за межами CMS — у PHP-логах, конфігурації сервера або неочікуваній поведінці компонентів. Ми виробили чіткий алгоритм, що дозволяє знайти та усунути помилку за 1–3 години в 90% випадків. Вартість діагностики визначається після аналізу, а середня економія часу клієнта — до 70% порівняно з самостійним пошуком.
Чому при 500-й помилці Бітрікс не пише у свій лог?
Ланцюжок ініціалізації Бітрікс: index.php → header.php → /bitrix/modules/main/include/prolog_before.php → підключення БД → ініціалізація модулів → обробка URL → виклик компонентів. Якщо PHP-процес падає на будь-якому етапі до ініціалізації exception_handling із .settings.php, Бітрікс не може записати помилку у свій журнал. Залишаються лише логи веб-сервера та PHP. Налаштувавши exception_handling на запис у файл згідно з документацією, ви збільшуєте шанси отримати stack trace у 3 рази порівняно з базовою конфігурацією.
Як швидко визначити причину?
Діагностика за логами в 3 рази швидша, ніж метод перебору файлів. Ось покрокова інструкція:
Знайдіть лог помилки
Перевіряйте в наступному порядку:
- PHP error log — шлях визначається директивою
error_log у php.ini або конфігу пула php-fpm. Типові розташування: /var/log/php-fpm/www-error.log, /var/log/php/error.log.
- Лог веб-сервера — для nginx:
/var/log/nginx/error.log, для Apache: /var/log/apache2/error.log або /var/log/httpd/error_log.
- Бітрікс-лог —
/bitrix/modules/main/tools/log.txt (якщо налаштований) та журнал подій у БД.
Якщо всі три логи порожні — PHP-процес вбивається OOM-killer'ом або segfault'ом. Перевіряйте /var/log/syslog або dmesg на предмет записів Out of memory: Kill process або segfault.
Приклад швидкої ізоляції
Створіть тестовий файл `test500.php` з вмістом:
```php
Визначте масштаб помилки
500-та може бути глобальною (всі сторінки) або локальною (конкретний розділ). Це одразу звужує область пошуку:
| Масштаб |
Ймовірні причини |
| Всі сторінки |
Помилка в init.php, dbconn.php, .settings.php; падіння БД; вичерпання пам'яті |
| Тільки адмінка |
Пошкодження сесій; помилка в адміністративному скрипті |
| Один розділ/сторінка |
Помилка в компоненті або шаблоні; биті дані інфоблоку |
| Тільки POST-запити |
Перевищено post_max_size; збій CSRF-перевірки |
| Періодично |
Гонки при записі кешу; вичерпання пула з'єднань БД |
Відтворіть з дебагом
Тимчасово додайте на початок index.php (до підключення Бітрікс):
ini_set('display_errors', 1);
error_reporting(E_ALL);
Основні причини та рішення
Вичерпання memory_limit
Найчастіша причина. Бітрікс споживає 128-256 МБ на типовій сторінці каталогу. Масові операції (імпорт, побудова пошукового індексу) можуть вимагати 512 МБ і більше.
Симптом у лозі: Allowed memory size of N bytes exhausted. Рішення: збільшити memory_limit у php.ini або .htaccess до 256M-512M. Якщо споживання аномально високе — профілюйте через xdebug або Blackfire: можливий витік пам'яті в циклі обробки елементів інфоблоку. У 60% випадків ця причина усувається за 30 хвилин.
Помилки в init.php та dbconn.php
Файл /bitrix/php_interface/init.php підключається при кожному хіті. Синтаксична помилка або Fatal Error у ньому валить весь сайт. Аналогічно dbconn.php (застарілий, але часто модифікований файл з параметрами підключення до БД).
Перевірка: перейменуйте init.php у init.php.bak. Якщо сайт запрацював — помилка в ньому. Відновіть файл і шукайте проблемний рядок через бінарний пошук: коментуйте половину коду, перевіряйте, звужуйте.
Конфлікт .htaccess
Бітрікс створює .htaccess в корені та в /bitrix/. Директиви php_value, php_flag викликають 500, якщо PHP працює через php-fpm (не як модуль Apache). Також помилка виникає при mod_rewrite з некоректними правилами.
Перевірка: тимчасово перейменуйте .htaccess. Якщо запрацювало — проблема в директивах. Приберіть php_value/php_flag та перенесіть налаштування в php.ini або конфіг пула.
Падіння MySQL/MariaDB
Бітрікс при неможливості підключитися до БД віддає 500 (якщо не налаштована сторінка-заглушка). Перевіряйте статус сервісу: systemctl status mysql. Часта причина — OOM-killer вбив процес mysqld.
У лозі Бітрікс: DB query error. У лозі MySQL: InnoDB: Fatal error: cannot allocate memory. Рішення: налаштувати innodb_buffer_pool_size адекватно доступній RAM, додати swap, або мігрувати на сервер з достатньою пам'яттю. У 20% випадків перевитрата пам'яті MySQL викликана неоптимальними запитами.
Помилки в компонентах та шаблонах
Якщо 500 виникає на конкретній сторінці — проблема в компоненті. Типові причини:
-
result_modifier.php викликає неіснуючий метод після оновлення модуля
- Шаблон компонента звертається до
$arResult['PROPERTIES']['DELETED_PROP']
- Компонент використовує
CIBlockElement::GetList() з некоректним фільтром, що викликає MySQL-помилку
Для ізоляції: замініть вміст шаблону компонента на <?php print_r($arResult);?>. Якщо сторінка запрацювала — помилка в шаблоні.
Порівняння методів діагностики
| Метод |
Час на пошук |
Точність |
Необхідні інструменти |
| Аналіз логів |
1-3 години |
90% |
Доступ до логів сервера |
| Метод виключення (почергове відключення) |
4-8 годин |
70% |
Доступ до файлової системи |
| Дебаг з xdebug |
2-4 години |
95% |
Встановлений xdebug |
Метод аналізу логів у 3 рази швидший за метод виключення і вимагає лише доступу до логів.
Превентивні заходи
- Налаштуйте
exception_handling у .settings.php із записом у файл — навіть при частковій ініціалізації ядра це збільшує шанси отримати stack trace.
- Моніторте
memory_limit із запасом — якщо середній хіт споживає 180 МБ при ліміті 256 МБ, будь-який сплеск викличе 500.
- Розділяйте cron-процеси та web-процеси за пулами php-fpm з різними
memory_limit — імпорт з лімітом 1 ГБ не вплине на звичайні хіти.
- Тестуйте оновлення на копії сайту. Команда
php /bitrix/modules/main/tools/update_system.php дозволяє оновлювати з CLI, що спрощує відкат.
Що входить в роботу
-
Діагностика: аналіз логів PHP та веб-сервера, перевірка конфігурації
.settings.php та .htaccess, тестування на копії сайту при необхідності.
-
Усунення: правка коду (init.php, компонентів, шаблонів), налаштування параметрів PHP та сервера, оптимізація запитів до БД.
-
Документація: звіт про знайдені причини та виконані дії, рекомендації щодо запобігання повторним збоям.
-
Гарантія: підтримка протягом 7 днів після усунення — якщо помилка повернеться, ми виправимо безкоштовно.
- Консультація: пояснюємо, що сталося та як не допустити в майбутньому.
Оцінимо ваш проєкт: достатньо описати ситуацію та надіслати доступи (FTP/SSH та адмінку). Зв'яжіться з нами — і ми приступимо до діагностики протягом 2 годин. Досвід більше 200 успішних проєктів та 10+ років роботи з Бітрікс — ваша гарантія швидкого та якісного рішення. Отримайте консультацію вже сьогодні!
Розробка та налаштування модулів 1С-Бітрікс
Головна пастка Бітрікса — init.php. Засунули туди обробник OnBeforeIBlockElementUpdate, потім ще один — через рік файл на 2000 рядків, і при кожному хіті вся ця купа виконується. Ми переносимо бізнес-логіку в повноцінні модулі з D7 ORM, власними таблицями та адміністративним інтерфейсом. Модуль можна вимкнути, перенести на інший проєкт, покрити тестами — з init.php нічого з цього не вийде. Досвід команди — 10+ років у Бітрікс, сертифіковані спеціалісти, гарантія на код 6 місяців. Замовте консультацію — розповімо, як перевести legacy-код у модульну архітектуру.
Як модульна архітектура підвищує продуктивність?
Чому init.php — найгірше місце для бізнес-логіки?
Init.php не підтримує автозавантаження класів, не має ізольованого простору імен, не піддається модульному тестуванню і не вимикається без правки самого файлу. Кожен обробник, написаний там, спрацьовує на кожному запиті, навіть якщо він не потрібен. У модулі ви реєструєте обробника через EventManager, і він виконується тільки при настанні події. Різниця в продуктивності — до 3 разів при 10+ обробниках.
Стандартні модулі: типові проблеми та рішення
Інформаційні блоки. Архітектура ІБ — перше, що ми рев'юїмо на будь-якому проєкті. Класична помилка: один інфоблок каталогу з 80 властивостями, з яких 30 — множинні. Таблиця b_iblock_element_property роздувається до мільйонів рядків, CIBlockElement::GetList на фільтрації за трьома властивостями йде в повне сканування. Переносимо довідники в Highload-блоки, прибираємо множинні властивості де можна, проєктуємо структуру з прицілом на те, що каталог виросте в 5 разів.
Інтернет-магазин (sale). Бізнес-правила кошика — окрема історія. Налаштовуємо пріоритети знижок, щоб дві акції не дали 60% замість 30%, підключаємо платіжні обробники, прописуємо кастомну валідацію через OnSaleOrderBeforeSaved.
Пошук. Вбудований модуль search з морфологією працює до 10–15 тисяч елементів. Далі — Elasticsearch. Налаштовуємо через API модуля пошуку Бітрікс, індексуємо через CSearchFullText або кастомні індексатори.
Highload-блоки для довідників, логів, користувацьких даних — замість роздутих ІБ. Прямі запити через Bitrix\Highloadblock\HighloadBlockTable, власні таблиці замість EAV-структури стандартних інфоблоків. Мільйон записів — без деградації.
Поштові події. Налаштування — не лише шаблони в b_event_message. Головне — SPF, DKIM, DMARC на DNS, інакше транзакційні листи летять у спам. Перевіряємо доставність, налаштовуємо bounce-обробку.
Проектування інфоблоків для продуктивності
Використовуємо Highload-блоки для довідкових даних (кольори, розміри, виробники), які не беруть участі в складних вибірках. Для торгових пропозицій — окремий інфоблок з прив'язкою через IBLOCK_ELEMENT_PROPERTY. Увімкнемо INDEX_PROPERTY для часто фільтрованих властивостей. Кешування теговане: при зміні елемента скидається лише пов'язаний кеш. Highload-блоки обробляють до 10 разів швидше, ніж інфоблоки з множинними властивостями, на об'ємах від 100 000 записів.
Розробка кастомних модулів
Кожен модуль — за структурою /local/modules/vendor.modulename/:
-
install/index.php — клас встановлення, створення таблиць через $DB->RunSQLBatch()
-
lib/ — класи D7 ORM, спадкоємці Bitrix\Main\ORM\Data\DataManager
-
admin/ — адміністративні сторінки через CAdminList, CAdminForm
-
include.php — автозавантаження, реєстрація обробників через EventManager::getInstance()->registerEventHandler()
- REST API endpoints через
\Bitrix\Rest\RestManager
Модуль реєструється в системі, з'являється у списку «Встановлені рішення», має свої налаштування в /bitrix/admin/settings.php?mid=vendor.modulename. Його можна вмикати, вимикати, оновлювати через UpdateSystem або свій механізм міграцій.
Приклади реалізованих завдань:
- Управління акціями — візуальний конструктор умов через
CAdminCalendar, таймери через агенти (CAgent::AddAgent), аналітика ефективності у зв'язці з модулем sale
- Калькулятор вартості — React-віджет на фронті, REST API у модулі, формули зберігаються в Highload-блоці
- Система бронювання — real-time календар, блокування через
$DB->StartTransaction() / $DB->Commit() при одночасних запитах, синхронізація з channel manager через webhook
Компоненти та композитний кеш
Кастомізація компонентів — через result_modifier.php і component_epilog.php, не через правку template.php стандартного шаблону. Так ядро оновлюється безболісно.
Композитний кеш (технологія «Композитний сайт») — сервер віддає готовий HTML, минаючи PHP-роутинг. Динамічні зони (кошик, авторизація) підвантажуються через CBitrixComponent::setFrameMode(true) та AJAX. TTFB падає до 30–50 мс. Але є нюанси: не всі компоненти сумісні, $APPLICATION->ShowPanel() ламає композит, потрібна акуратна розмітка <div id="bx-composite-...">.
Маркетплейс: аудит перед встановленням
Перед встановленням модуля з маркетплейсу — обов'язковий аудит. Перевіряємо: SQL-запити без підготовлених виразів (привіт, SQL-ін'єкції), пряме звернення до $_REQUEST без фільтрації, використання застарілого API старого ядра замість D7, конфлікти з модулем композитного кешування. Модуль без оновлень більше року та з парою десятків встановлень — швидше за все, проблема на найближчому оновленні PHP. Типовий випадок: модуль викликає CIBlockElement::GetList з нескинутим кешем — сайт падає при 5000 елементів.
Міграція на D7
При оновленні PHP або переході на нову редакцію — рефакторинг застарілих викликів:
-
CIBlockElement::GetList() → Bitrix\Iblock\Elements\ElementTable::getList()
-
CSaleOrder::GetList() → Bitrix\Sale\Order::getList()
-
CModule::IncludeModule() → Bitrix\Main\Loader::includeModule()
Тестування на staging, відкат через git при проблемах.
Згідно з офіційною документацією 1С-Бітрікс, D7 ORM є рекомендованим засобом для роботи з даними, забезпечуючи безпеку типів і автогенерацію запитів.
Порівняння підходів: Init.php vs Модуль
| Критерій |
Init.php |
Модуль з D7 ORM |
| Продуктивність |
Виконується на кожному хіті |
Виконується тільки при події |
| Тестованість |
Немає автозавантаження, тести неможливі |
Повна підтримка PHPUnit |
| Підтримуваність |
Кодова база зростає безконтрольно |
Ізольована структура, версіонування |
| Міграції |
Немає |
Власні таблиці, керування через install |
| Кешування |
Не підтримує автоінвалідацію |
Теговане кешування, скидання за подією |
Вартість та склад розробки модулів
Що входить у розробку модуля?
- Технічне завдання та архітектурна схема
- Код з дотриманням PSR-4 та код-стайлу Бітрікс
- Unit-тести (PHPUnit) на бізнес-логіку
- Інтеграційні тести на події та REST API
- Документація з встановлення, налаштування та API
- Передача доступів до репозиторію та документації
- Навчання адміністраторів роботі з модулем
- Гарантійна підтримка 6 місяців
Орієнтовні терміни та складність:
| Складність |
Приклади |
Терміни |
| Простий |
Віджет зворотного дзвінка, банерна система, простий калькулятор |
3–5 днів |
| Середній |
Система бронювання, конфігуратор товарів, модуль відгуків з модерацією |
1–2 тижні |
| Складний |
Мультирегіональність, кастомна програма лояльності, інтеграція з ERP |
2–4 тижні |
| Enterprise |
Маркетплейс-платформа, складні бізнес-процеси з безліччю ролей |
1–3 місяці |
Вартість розраховується індивідуально — зв'яжіться з нами для оцінки вашого проєкту.
Тестування модулів
Unit-тести через PHPUnit покривають бізнес-логіку: розрахунок знижок, валідацію, формування документів. Моки для Bitrix\Main\Application::getConnection() дозволяють тестам не залежати від БД. Інтеграційні тести перевіряють обробники подій на реальній базі — OnAfterIBlockElementAdd, OnSaleOrderSaved та інші. REST API endpoints тестуємо через curl або PHPUnit HTTP-клієнт. Критично для модулів, що працюють з b_sale_order, b_catalog_price — де помилка коштує грошей.
Сумісність перевіряється на PHP 7.4, 8.0, 8.1, 8.2 та редакціях: Стандарт, Малий бізнес, Бізнес. Перевіряємо конфлікти з популярними модулями маркетплейсу — вони люблять перехоплювати ті самі події. Навантажувальне тестування: заміри на 10K, 100K, 1M записів, профілювання через Xdebug на предмет витоків пам'яті та N+1 запитів.
Приклади з практики
Модуль акцій для мережі електроніки. Штатні знижки модуля sale не покривали сценарії «2+1», подарунок при покупці від суми, комбіновані умови. Зібрали візуальний конструктор: маркетолог створює правила через drag-and-drop, без тікетів у розробку. Календар акцій, автодеактивація через агенти, аналітика у прив'язці до b_sale_order — конверсія, середній чек, кількість застосувань. Час запуску нової акції впав з двох днів до півгодини.
Калькулятор для будівельників. Параметри (площа, матеріали, поверховість) → формула → попередній кошторис → заявка в CRM через CRest::call('crm.lead.add'). Регіональні коефіцієнти та сезонні націнки — з Highload-блоку, ціни матеріалів — з обміну з 1С. Кількість цільових заявок зросла на третину: клієнти бачать розбивку за статтями до дзвінка менеджеру.
Бронювання для мережі готелів. Real-time доступність через AJAX-запити до кастомної таблиці vendor_booking_slots, розрахунок тарифів за сезоном, синхронізація з Booking.com через channel manager API. Блокування номера при одночасному бронюванні — через SELECT ... FOR UPDATE у транзакції. Таймзони обробляються через \DateTimeZone — гість із Владивостока та менеджер із Москви бачать одну картину.
Оцінимо проєкт за 1 день. Пишіть — розповімо, що входить у розробку під ключ. Зв'яжіться з нами для консультації за вашим проєктом. Замовте розробку модуля під ключ — отримайте готове рішення з документацією та підтримкою.
