PHPackages                             voral/bx-backup-tools - 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. [Utility & Helpers](/categories/utility)
4. /
5. voral/bx-backup-tools

ActiveLibrary[Utility & Helpers](/categories/utility)

voral/bx-backup-tools
=====================

1.3.0(1y ago)051MITPHPPHP >=8.1CI passing

Since Mar 14Pushed 1y ago2 watchersCompare

[ Source](https://github.com/Voral/BxBackupTools)[ Packagist](https://packagist.org/packages/voral/bx-backup-tools)[ RSS](/packages/voral-bx-backup-tools/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (6)Versions (6)Used By (0)

Утилита для автоматизации работы с бэкапами Битрикс
===================================================

[](#утилита-для-автоматизации-работы-с-бэкапами-битрикс)

[![PHP Tests](https://github.com/Voral/BxBackupTools/actions/workflows/php.yml/badge.svg)](https://github.com/Voral/BxBackupTools/actions/workflows/php.yml/badge.svg)

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

Идея пакета
-----------

[](#идея-пакета)

На нескольких проектах возник ряд смежных задач, и решение вылилось в обобщающий пакет. Задачи связанные с загрузкой самого свежего бекапа сайта на Битрикс на FTP, скачивание файла с FTP и автоматическое развертывание сайта из резервной копии для проверки целостности и развертывание зеркала.

### Основные возможности

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

- Загружать на FTP/SFTP последнюю резервную копию из каталога bitrix/backup.
- Загружать резервные копии по дням недели
- Скачивать с FTP/SFTP резервную копию с учетом, если настроено, логики хранения по дням недели. Как вариант возможно забирать копию предыдущего дня.
- Распаковывать архив, настраивать подключения к БД в .settings.php и dbconn.php
- Отправлять информацию о выполнении скрипта в телеграм канал или в консоль

### Дополнительные возможности

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

За счет создания своих классов унаследованных от необходимых возможно добавлять:

- Свои задачи в ход выполнения
- Своего варианта отправки информации о выполнении
- Своей логики хранения копий на FTP. Логика хранения определяет, каким образом будут распределяться и храниться резервные копии на FTP-сервере (например, по дням недели или месяцам).

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

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

Если проект еще не инициализирован через Composer, выполните команду:

```
composer init
```

Добавить в зависимости

```
composer require voral/bx-backup-tools
```

Скопировать шаблон файла настроек и сконфигурировать под свою задачу. В [конфигурации](https://github.com/Voral/BxBackupTools/blob/master/examples/config.php) из примера есть необходимые комментарии.

По умолчанию утилита ищет конфигурационный файл config.local.php. Однако вы можете создать и другие файлы по шаблону config.\*.php . Например config.dev.php, config.production.php. В примере показано как можно подключать другие настройки.

Обратите внимание: если в каталоге запуска присутствует config.php и config.local.php они будут загружены оба последовательно, т.е. local перезапишет содержащиеся в нем настройки, а которых в нем нет будут взяты из config.php

Обратите внимание: файл конфигурации может содержать чувствительные данные (например, учетные данные FTP). Рекомендуется добавить его в `.gitignore` для предотвращения случайной публикации.

```
cp vendor/voral/bx-backup-tools/examples/config.php config.local.php

```

Скрипты примеров помогут вам быстро начать работу с пакетом. Вы можете адаптировать их под свои задачи.

Для скачивания архива с FTP и развертывание из архива:

```
cp vendor/voral/bx-backup-tools/examples/download.php download.php

```

Для загрузки архива на FTP

```
cp vendor/voral/bx-backup-tools/examples/upload.php upload.php

```

Пример использования
--------------------

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

Подробные примеры с комментариями можно посмотреть в [примерах](https://github.com/Voral/BxBackupTools/tree/master/examples). Примерный шаблон скрипта:

```