fin/user-backup-lib

UserBackupLib

Библиотека для выгрузки, удаления и восстановления данных пользователя по явному плану: какие строки принадлежат пользователю, задаёт приложение декларацией правил, а не имя колонки user_id. Выгрузка и удаление отбирают строки одними и теми же селекторами, поэтому бэкап всегда покрывает то, что будет удалено.

Что в пакете

Сам план собирает приложение: провайдеры правил по доменам, профили операций, подключения.

Формат файла

• v2 (saveBackup) — шапка @meta (владелец, версия формата и плана) и секции таблиц с подключением: {"@meta":{...},"tables":[{"connection":"mysql","table":"...","rows":[...]}]}.
• v1 (saveToFile) — {"table":[rows]} без шапки. Пишется только для совместимости и тестов, читается всегда.

Запись атомарная: файл пишется во временный, порция дописывается до конца, закрытие проверяется, готовый файл публикуется переименованием. Недописанный бэкап не может выглядеть готовым (BackupWriteIncompleteException, BackupFileCloseException).

Сжатие и шифрование

Зашифрованный файл (*.enc) — это строки, каждая строка — шифротекст Crypt порции сжатого JSON. Сжатие делается до шифрования: шифротекст уже не сжимается, а base64 в конверте Crypt раздувает данные ещё в 1,78 раза.

• Формат — gzip, zlib уровня 6, потоково (deflate_init / inflate_init): файл целиком в память не читается. Замер на реальных бэкапах: 163 МБ JSON → 7 МБ меньше чем за секунду, итоговый файл в 13–30 раз меньше прежнего.
• Файлы, записанные до сжатия, читаются без изменений: сжатый поток распознаётся по сигнатуре gzip 1f 8b после расшифровки, а JSON с байта 0x1f начинаться не может.
• Оборванный или повреждённый сжатый поток не принимается за целый: BackupDecompressionException (user_backup.decompression_failed, стадия и число прочитанных байт в context()). Ошибка сжатия — BackupCompressionException.
• Незашифрованный файл (encrypt: false) пишется простым JSON без сжатия.
• Сжатие и распаковка подменяются биндингом контрактов BackupStreamCompressor и BackupStreamDecoder; FileStorageService о формате сжатия не знает.

Чтение

use UserDataBackup\Contracts\FileStorageServiceInterface;

$storage = app(FileStorageServiceInterface::class);

$header = $storage->readHeader($path);          // v1 → BackupHeader::legacy()

foreach ($storage->streamBackupData($path) as $entry) {
    // ['connection' => ..., 'table' => ..., 'row' => [...]]
}

Что удалено

Старый движок эвристического удаления и выгрузки по колонке user_id (UserBackupService, UserBackupServiceFactory, UserDataDeletionService, BackupProcessor, DatabaseService, UserDataScope, конфиг user-backup.connections) удалён: его заменил план. Гайд docs/user-backup-guide.md описывает удалённый API и оставлен как история.

Тесты

vendor/bin/phpunit