# Резервное копирование и восстановление данных расширения

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

- Хранение данных в Хранилище пар «ключ-значение» Plesk,
- Хранение данных в базах данных SQLite,
- Использование хуков резервного копирования SDK.

## Хранилище пар «ключ-значение» Plesk

Это рекомендуемый способ, подходящий в большинстве случаев. Идея этого способа – хранить данные расширения и работать с ними с помощью следующих методов:

- pm_Client::setSetting() и pm_Client::getSetting() для данных клиента и реселлера,
- pm_Domain::setSetting() и pm_Domain::getSetting() для данных подписки или домена,
- pm_Settings:set() и pm_Settings::get() для любого типа данных.

Таким образом, все данные будут храниться в Хранилище пар «ключ-значение» Plesk, для которого автоматически создается резервная копия, включающая и остальные данные Plesk. Кроме того, данные из хранилища пар «ключ-значение» могут быть безопасно и корректно восстановлены. В итоге можно сказать, что этот подход избавляет вас от необходимости выполнения каких-либо дополнительных шагов по резервному копированию и восстановлению данных расширения.

## Базы данных SQLite

Все данные, сохраненные расширением в локальной базе данных, будут сохранены в файловой системе в папке `/var/` в Plesk (используйте метод pm_Context::getVarDir() для получения ее точного местонахождения). Эта папка автоматически сохраняется Plesk при каждом резервном копировании сервера. Данные расширения будут восстановлены вместе с остальными данными Plesk во время полного восстановления сервера.

Примечание

Данные расширения не включаются в резервную копию, если она выполняется только для подписки или учетной записи клиента или реселлера.

Примечание

Данные расширения не будут восстановлены в случае частичного восстановления (выбранных учетных записей или подписок) из полной резервной копии сервера.

Для обеспечения целостности данных вашего расширения, пожалуйста, имейте в виду следующую важную информацию.

Предупреждение

В ходе восстановления данных Plesk из резервной копии ID некоторых восстановленных объектов Plesk могут измениться. Если ваше расширение сохраняет в базе данных ID таких объектов Plesk, после восстановления они могут устареть и стать некорректными.

Использование GUID или имен в качестве ссылок на объекты Plesk там, где это необходимо, поможет сохранить целостность данных вашего расширения в ходе процессов резервного копирования и восстановления.

## Хуки резервного копирования SDK

В редких случаях, когда специфика определенных данных расширения делает невозможным использование хранилища пар «ключ-значение», вместо него можно использовать механизм хуков резервного копирования SDK.

Классы pm_Hook_Backup_Client, pm_Hook_Backup_Domain и pm_Hook_Backup_Server предоставляют методы `backup()` и `restore()`. В зависимости от характера данных, один или несколько этих классов надо использовать для создания классов расширения, которые наследуют и перезаписывают методы `backup()` и `restore()` с соответствующими инструкциями, объясняющими, как сохранять и восстанавливать тот или иной тип данных.