README

Панель управления для ускорения разработки на Битрикс. Позволяет управлять кэшем, включать режим отладки и просматривать логи в один клик.

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

🗑 Очистка кэша: Выборочная (компоненты, меню, HTML) или полная
🚫 Отключение кэша: Временная остановка записи кэша для разработки
🟢 DEV-режим: Вывод PHP-ошибок на экран
⚙️ Агенты: Принудительный запуск отложенных задач
📋 Логи: Просмотр последних ошибок прямо в админке
👤 Инфо: Данные о текущей сессии администратора

📋 Требования

1С-Битрикс: Управление сайтом (любая редакция)
PHP 7.4 или выше

🚀 Установка

Рекомендуемый способ установки — через composer.

Вариант 1: Установка через Composer (Рекомендуется)

Настройте путь установки (Опционально) По умолчанию composer установит модуль в bitrix/modules/. Если вы хотите, чтобы модуль находился в local/modules/, добавьте ключи installer-paths в корневой composer.json вашего проекта до установки модуля:

{
    "extra": {
        "installer-paths": {
            "local/modules/{$name}/": ["type:bitrix-module", "type:bitrix-theme"]
        }
    }
}

Установите пакет:

composer require ssnus/bitrix-dev-tools

Вариант 2: Установка через консоль (curl)

Если вы предпочитаете командную строку без composer:

# 1. Переходим в папку для модулей
cd local/modules/

# 2. Скачиваем архив с GitHub 
curl -L https://github.com/ssnus/bitrix-dev-tools/archive/refs/heads/master.zip -o dev.tools.zip

# 3. Распаковываем архив
unzip dev.tools.zip

# 4. Переименовываем папку в нужное имя модуля
mv bitrix-dev-tools-master dev.tools

# 5. Удаляем архив
rm dev.tools.zip

⚙️ Активация модуля в Битрикс

Независимо от способа загрузки файлов (Composer или zip-архив), модуль необходимо установить в панели управления Битрикс:

В админке перейдите: Marketplace → Установленные решения
Найдите «Инструменты разработчика» и нажмите Установить
✅ Модуль автоматически создаст необходимые файлы и настройки доступов.
Меню появится в разделе Сервисы → Dev Tools

Если автоустановка не сработала (Hard fallback)

Если после активации меню не появилось, создайте файл-прокси вручную:

Файл: /bitrix/admin/dev_tools.php

<?php
require_once($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_admin_before.php");
$path = getLocalPath("modules/dev.tools/admin/dev_tools.php");
if ($path) {
    require($_SERVER["DOCUMENT_ROOT"] . $path);
} else {
    ShowError("Module dev.tools not found");
}

🔄 Обновление модуля

Если устанавливали через Composer

Просто выполните команду в корне вашего проекта:

composer update ssnus/bitrix-dev-tools

Если устанавливали вручную (zip-архив)

Удалите старую папку local/modules/dev.tools/ (или bitrix/modules/dev.tools/).
Скачайте новый архив с GitHub и распакуйте его на то же место, как при установке.

⚠️ Важно после обновления: Зайдите в админку Битрикс в раздел Marketplace → Установленные решения, найдите модуль «Инструменты разработчика» и убедитесь, что он установлен. Рекомендуется сбросить кэш Битрикса после обновления файлов модуля.

⚙️ Настройка после установки

Ручная настройка

Если режим отладки не работает после установки, добавьте эту строку в файл /local/php_interface/init.php:

<?php
if (!defined('B_PROLOG_INCLUDED') || B_PROLOG_INCLUDED !== true) die();

// Подключение DevTools
$devToolsPath = getLocalPath("modules/dev.tools/include.php");
if ($devToolsPath) {
    require_once $_SERVER["DOCUMENT_ROOT"] . $devToolsPath;
}

🎯 Использование

После установки в админке появится новая панель:

Управление кэшем: Включайте/выключайте кэш или очищайте выборочно
Режим отладки: Показывает ошибки PHP на странице
Логи: Быстрый просмотр bitrix_error.log

⚠️ Важно: Не оставляйте DEV-режим включённым на рабочем сайте!

🤝 Contributing

Если нашли баг или есть идея для улучшения — создавайте Issue или Pull Request!

ssnus / bitrix-dev-tools

Maintainers

Package info

Statistics

Security