PHPackages                             fin/user-backup-lib - 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. [File & Storage](/categories/file-storage)
4. /
5. fin/user-backup-lib

ActiveLibrary[File & Storage](/categories/file-storage)

fin/user-backup-lib
===================

Библиотека PHP для резервного копирования пользовательских данных из нескольких баз данных.

v2.1.0(2mo ago)0251↓25.9%MITPHPPHP ^8.0CI passing

Since Jul 29Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/MasyaSmv/UserBackupLib)[ Packagist](https://packagist.org/packages/fin/user-backup-lib)[ RSS](/packages/fin-user-backup-lib/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (4)Dependencies (6)Versions (7)Used By (0)

UserBackupLib
=============

[](#userbackuplib)

[![PHP 8.0+](https://camo.githubusercontent.com/efc33820eea622b7119e4e8f304c3622be923425eb8ee1d34c7b42dbe2c2e847/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e302532422d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/releases/8.0/en.php)[![Composer package](https://camo.githubusercontent.com/f31b330d3fa694022dbe8fd24d2464fd0303f7db7aec13d5c79e4abbba116357/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6d706f7365722d66696e253246757365722d2d6261636b75702d2d6c69622d3838353633303f6c6f676f3d636f6d706f736572266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/fin/user-backup-lib)[![Laravel Support](https://camo.githubusercontent.com/29252a55d2c81bec98e06afca4ec5dbc4c34d57a337938bcc5681be45f5d3e6e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382e782d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com/docs/8.x)[![PHPUnit](https://camo.githubusercontent.com/43fa26aaf8b17c3fef73d235e24553db60e754d935c1223cf535fde1d0e80103/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f504850556e69742d392e362d3336363438383f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://phpunit.de/)[![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#%D1%82%D0%B5%D1%81%D1%82%D1%8B)[![Docs](https://camo.githubusercontent.com/d22e3f44d7e681909e630ac116272f3d031cc34349ad5408a0936164c4c534d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f63732d757365722d2d6261636b75702d2d67756964652d626c7565)](docs/user-backup-guide.md)[![Wiki](https://camo.githubusercontent.com/57cafdf1a02f26ae6f5010ab0728d2595e05edd038b0fd3262291ce968797c35/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f57696b692d4769744875622d626c61636b3f6c6f676f3d676974687562)](https://github.com/MasyaSmv/UserBackupLib/wiki)[![Release](https://camo.githubusercontent.com/d5300e17bb45a6ae0f9faa92ab2f0a4c23029307f93eec8a843be6386b6bc599/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52656c656173652d76322e312e302d677265656e)](https://github.com/MasyaSmv/UserBackupLib/releases/tag/v2.1.0)

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

Документация:

- [README quick start](README.md)
- [Подробный гайд](docs/user-backup-guide.md)
- [GitHub Wiki](https://github.com/MasyaSmv/UserBackupLib/wiki)
- [Laravel integration notes](https://github.com/MasyaSmv/UserBackupLib/wiki/Laravel-Integration)
- [Release notes](https://github.com/MasyaSmv/UserBackupLib/wiki/Release-Notes)

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

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

- Потоковое чтение данных из БД без загрузки всего набора в память.
- Потоковая запись backup JSON в файл.
- Чанковое шифрование больших backup-файлов.
- Потоковое чтение backup-файлов через `streamBackupData()`.
- Объектный сценарий создания backup через `UserBackupCreateOptions`.
- Ручной сценарий создания backup-сервиса.
- Контейнерный сценарий через factory.
- Объектный сценарий очистки через `UserDataScope`.
- Очистка пользовательских данных после backup.

Важные границы
--------------

[](#важные-границы)

- Пакет ориентирован в первую очередь на MySQL-подобный сценарий.
- Generic restore внутри пакета сейчас не реализован.
- Raw rows таблиц остаются массивами, потому что схема таблиц динамическая.
- Runtime-параметры backup use case не должны резолвиться напрямую из контейнера без явного scope.

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

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

```
composer require fin/user-backup-lib
```

Packagist:

-

Быстрый старт
-------------

[](#быстрый-старт)

### Ручной сценарий

[](#ручной-сценарий)

```
use App\Services\UserBackupService;
use App\ValueObjects\UserBackupCreateOptions;

$options = UserBackupCreateOptions::fromLegacy(
    userId: 42,
    accountIds: [101, 102],
    activeIds: [501],
    ignoredTables: ['temp_logs'],
    connections: ['mysql', 'replica'],
);

$backup = UserBackupService::createFromOptions($options);
```

Legacy-совместимый вариант:

```
use App\Services\UserBackupService;

$backup = UserBackupService::create(
    userId: 42,
    accountIds: [101, 102],
    activeIds: [501],
    ignoredTables: ['temp_logs'],
    connections: ['mysql', 'replica'],
);

$backup->fetchAllUserData();

$path = $backup->saveBackupToFile('/tmp/backup_42.json');
// вернется /tmp/backup_42.json.enc
```

### Контейнерный сценарий

[](#контейнерный-сценарий)

```
use App\Contracts\UserBackupServiceFactoryInterface;
use App\ValueObjects\UserDataScope;

$factory = app(UserBackupServiceFactoryInterface::class);

$backup = $factory->make(new UserDataScope(
    userId: 42,
    accountIds: [101, 102],
    activeIds: [501],
    ignoredTables: ['temp_logs'],
));

$backup->fetchAllUserData();
$path = $backup->saveBackupToFile(storage_path('app/backups/user-42.json'));
```

Legacy-совместимый вариант:

```
$backup = $factory->makeForUser(
    userId: 42,
    accountIds: [101, 102],
    activeIds: [501],
    ignoredTables: ['temp_logs'],
);
```

Очистка данных
--------------

[](#очистка-данных)

```
use App\Contracts\UserDataDeletionServiceInterface;
use App\ValueObjects\UserDataScope;

$cleaner = app(UserDataDeletionServiceInterface::class);

$cleaner->deleteScope(new UserDataScope(
    userId: 42,
    accountIds: [101, 102],
    activeIds: [501],
    ignoredTables: ['temp_logs'],
));
```

Legacy-совместимый вариант:

```
$cleaner->deleteUserData(
    userId: 42,
    accountIds: [101, 102],
    activeIds: [501],
    ignoredTables: ['temp_logs'],
);
```

Чтение backup
-------------

[](#чтение-backup)

### Полная расшифровка в массив

[](#полная-расшифровка-в-массив)

```
use App\Services\FileStorageService;

$data = FileStorageService::decryptFile('/tmp/backup_42.json.enc');
```

### Потоковое чтение

[](#потоковое-чтение)

```
use App\Services\FileStorageService;

$storage = new FileStorageService();

foreach ($storage->streamBackupData('/tmp/backup_42.json.enc') as $entry) {
    $table = $entry['table'];
    $row = $entry['row'];
}
```

Совместимость форматов:

- `.json` читается потоково.
- новый чанковый `.json.enc` читается потоково.
- legacy `.enc` поддерживается по совместимости, но не гарантирует ту же memory-efficiency на очень больших файлах.

Конфигурация
------------

[](#конфигурация)

Пакетный конфиг: [config/user-backup.php](config/user-backup.php)

```
return [
    'connections' => ['mysql', 'replica'],
];
```

Правила:

- если `user-backup.connections` пуст, пакет берет все ключи из `database.connections`;
- для шифрования используется стандартный `APP_KEY` Laravel;
- путь сохранения backup выбирает приложение, не пакет.
- параметр `accountIds` в текущей интеграции проекта исторический и по факту содержит ids субсчетов.

Тесты
-----

[](#тесты)

```
php -d pcov.enabled=1 vendor/bin/phpunit --coverage-text --coverage-html build/coverage
```

Текущее покрытие пакета: `100%`.

Структура
---------

[](#структура)

- `src/Contracts/*` — контракты сервисов и factory.
- `src/Services/DatabaseService.php` — потоковое чтение из БД.
- `src/Services/FileStorageService.php` — запись, шифрование и чтение backup-файлов.
- `src/Services/UserBackupService.php` — orchestration backup use case.
- `src/Services/UserBackupServiceFactory.php` — factory для container-friendly сценария.
- `src/Services/UserDataDeletionService.php` — очистка данных.
- `src/ValueObjects/*` — внутренние DTO/value objects.
- `docs/user-backup-guide.md` — полная документация.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance86

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~130 days

Total

3

Last Release

70d ago

Major Versions

v1.0.1 → v2.0.02025-12-26

### Community

Maintainers

![](https://www.gravatar.com/avatar/f29a405df86487468d199f9525b44185d3bd3a81ccca962f75e0517a9ea44682?d=identicon)[MasyaSmv](/maintainers/MasyaSmv)

![](https://avatars.githubusercontent.com/u/6509570?v=4)[olegstan](/maintainers/olegstan)[@olegstan](https://github.com/olegstan)

---

Top Contributors

[![MasyaSmv](https://avatars.githubusercontent.com/u/61746307?v=4)](https://github.com/MasyaSmv "MasyaSmv (54 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/fin-user-backup-lib/health.svg)

```
[![Health](https://phpackages.com/badges/fin-user-backup-lib/health.svg)](https://phpackages.com/packages/fin-user-backup-lib)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[spatie/laravel-health

Monitor the health of a Laravel application

87411.3M152](/packages/spatie-laravel-health)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45344.0k1](/packages/pressbooks-pressbooks)[api-platform/laravel

API Platform support for Laravel

59156.3k11](/packages/api-platform-laravel)[dgtlss/capsule

A Laravel package for backing up databases and files to external sources with notifications

195.6k](/packages/dgtlss-capsule)[outerweb/image-library

Store and link files to your models

1113.8k3](/packages/outerweb-image-library)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)