PHP скрипты для реставрации данных 1С-Битрикс

Как восстановить данные с помощью скрипта restore.php из штатной поставки?

В дистрибутиве 1С-Битрикс есть файл /bitrix/modules/main/admin/restore.php, который можно скопировать в корень сайта. Цель: быстрое восстановление без написания дополнительного кода. Случаи использования: когда нет доступа к админ-панели, но есть файлы.

# Скопировать restore.php в корень сайта
cp /path/to/bitrix/modules/main/admin/restore.php /var/www/html/restore.php
# Вызвать в браузере: http://yoursite.com/restore.php
# Далее следовать мастеру.

Restore php (восстановление данных в php)

Пояснение: скрипт запрашивает путь к архиву и параметры восстановления. После выполнения рекомендуется удалить restore.php.

Как выполнить восстановление только базы данных через прямой SQL-запрос?

Если резервная копия базы представлена в виде SQL-дампа, можно восстановить её через PHP-скрипт, используя mysql или mysqli. Цель: восстановление структуры и данных без файлов. Случаи использования: при наличии только дампа базы, когда файлы не повреждены.

<?php
$host = 'localhost';
$user = 'bitrix';
$password = 'bitrix_pass';
$dbname = 'sitemanager';

// Подключение к MySQL без выбора БД для создания/восстановления
$conn = new mysqli($host, $user, $password);
if ($conn->connect_error) {
    die("Ошибка подключения: " . $conn->connect_error);
}

// Чтение файла дампа
$sql = file_get_contents('/path/to/dump.sql');
if ($sql === false) {
    die("Не удалось прочитать файл дампа.");
}

// Выбор базы данных
$conn->select_db($dbname);

// Выполнение SQL (разбиваем на запросы, чтобы избежать ошибок памяти)
$queries = explode(";\n", $sql);
foreach ($queries as $query) {
    $query = trim($query);
    if (!empty($query)) {
        if ($conn->query($query) === false) {
            echo "Ошибка в запросе: " . $conn->error . "
";
        }
    }
}
echo "Восстановление базы завершено.";
$conn->close();
?>

Пояснение: дамп выполняется по частям, чтобы не превысить лимит памяти. Желательно отключить проверку внешних ключей (SET FOREIGN_KEY_CHECKS=0).

Как выполнить восстановление с помощью консольной утилиты BitrixEnv (bitrix restore)?

Если сервер использует BitrixEnv, доступна команда bitrix restore. Цель: автоматизированное восстановление всего сайта. Случаи использования: на выделенных серверах с BitrixEnv.

# Восстановление из последней резервной копии (созданной BitrixEnv)
sudo bitrix restore --full /var/backups/latest.tar.gz

# Только база данных
sudo bitrix restore --db /var/backups/db.sql

# Только файлы
sudo bitrix restore --files /var/backups/files.tar.gz

Пояснение: утилита автоматически обрабатывает конфигурацию веб-сервера и настройки БД. После восстановления требуется проверить работу сайта.

Как выполнить восстановление модулей и конфигурации через API миграций?

Модуль "Миграции данных" (highloadblock) позволяет создавать скрипты восстановления структуры. Цель: точечное восстановление только изменённых сущностей. Случаи использования: при разработке и переносе изменений между окружениями.

<?php
use Bitrix\Highloadblock\HighloadBlockTable;
// Пример восстановления HL-блока по ID
$hlblockId = 1;
$hlblockData = HighloadBlockTable::getById($hlblockId)->fetch();
if ($hlblockData) {
    $entity = HighloadBlockTable::compileEntity($hlblockData);
    $entityClass = $entity->getDataClass();
    // Вставка данных из резервного массива
    $fields = ['UF_NAME' => 'Пример', 'UF_VALUE' => 100];
    $result = $entityClass::add($fields);
    if ($result->isSuccess()) {
        echo "Добавлена запись с ID: " . $result->getId();
    } else {
        print_r($result->getErrorMessages());
    }
}
?>

Пояснение: такой подход подходит для восстановления отдельных справочников или настроек, не затрагивая основную базу.