Скачать db dumper - скачать исходный код db dumper

db dumper

Другие категории

3.7.1

Скачать

Дамп содержимого базы данных

Этот репозиторий содержит простой в использовании класс для дампа базы данных с помощью PHP. В настоящее время поддерживаются MySQL, PostgreSQL, SQLite и MongoDB. За кулисами используются mysqldump , pg_dump , sqlite3 и mongodump .

Вот простые примеры того, как создать дамп базы данных с разными драйверами:

MySQL

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->dumpToFile('dump.sql');

PostgreSQL

 SpatieDbDumperDatabasesPostgreSql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->dumpToFile('dump.sql');

SQLite

 SpatieDbDumperDatabasesSqlite::create()
    ->setDbName($pathToDatabaseFile)
    ->dumpToFile('dump.sql');

При использовании опции includeTables требуется Sqlite версии 3.32.0.

МонгоБД

 SpatieDbDumperDatabasesMongoDb::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->dumpToFile('dump.gz');

Поддержите нас

Мы вкладываем много ресурсов в создание лучших в своем классе пакетов с открытым исходным кодом. Вы можете поддержать нас, купив один из наших платных продуктов.

Мы очень признательны вам за отправку нам открытки из вашего родного города с указанием того, какой из наших пакетов вы используете. Наш адрес вы найдете на странице контактов. Все полученные открытки мы публикуем на нашей виртуальной стене открыток.

Требования

Для создания дампа MySQL-db должен быть установлен mysqldump .

Для создания дампа PostgreSQL-db необходимо установить pg_dump .

Для дампа SQLite-db должен быть установлен sqlite3 .

Для создания дампа необходимо установить mongodump MongoDB-db.

Для сжатия файлов дампа необходимо установить gzip и/или bzip2 .

Установка

Вы можете установить пакет через композитор:

 композитору требуется spatie/db-dumper

Использование

Это самый простой способ создать дамп базы данных MySql:

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->dumpToFile('dump.sql');

Если вы работаете с PostgreSQL, просто используйте этот дампер, большинство методов доступны как в MySql. и PostgreSql-дампер.

 SpatieDbDumperDatabasesPostgreSql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->dumpToFile('dump.sql');

Если двоичный файл mysqldump (или pg_dump ) установлен не в папке по умолчанию, вы можете сообщить об этом пакету с помощью функции setDumpBinaryPath() :

 SpatieDbDumperDatabasesMySql::create()
    ->setDumpBinaryPath('/custom/location')
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->dumpToFile('dump.sql');

Если ваше приложение развернуто и вам необходимо изменить хост (по умолчанию — 127.0.0.1), вы можете добавить функцию setHost() :

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->setHost($хост)
    ->dumpToFile('dump.sql');

Обработка значений AUTO_INCREMENT в дампах

При создании дампа базы данных вам может потребоваться контролировать включение значений AUTO_INCREMENT. Это может иметь решающее значение для предотвращения конфликтов первичных ключей или для обеспечения согласованности идентификаторов при передаче данных между средами.

Пропуск значений AUTO_INCREMENT

Чтобы исключить значения AUTO_INCREMENT из таблиц в дампе, используйте метод SkipAutoIncrement. Это особенно полезно для предотвращения конфликтов при импорте дампа в другую базу данных, где эти конкретные значения AUTO_INCREMENT могут уже существовать, или когда точные значения не имеют значения.

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName('имя_базы_данных')
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->skipAutoIncrement()
    ->dumpToFile('dump.sql');

Включение значений AUTO_INCREMENT в дамп

По умолчанию значения AUTO_INCREMENT включаются в дамп. Однако если вы ранее использовали методskipAutoIncrement и хотите, чтобы значения AUTO_INCREMENT были включены в последующий дамп, используйте метод dontSkipAutoIncrement, чтобы явно включить их.

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName('имя_базы_данных')
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->dontSkipAutoIncrement()
    ->dumpToFile('dump.sql');

Используйте URL-адрес базы данных

В некоторых приложениях или средах учетные данные базы данных предоставляются в виде URL-адресов, а не отдельных компонентов. В этом случае вы можете использовать метод setDatabaseUrl вместо отдельных методов.

 SpatieDbDumperDatabasesMySql::create()
    ->setDatabaseUrl($databaseUrl)
    ->dumpToFile('dump.sql');

При предоставлении URL-адреса пакет автоматически анализирует его и передает отдельные компоненты соответствующему дамперу.

Например, если вы укажете URL-адрес mysql://username:password@hostname:3306/dbname , дамп будет использовать хост hostname , работающий на порту 3306 , и подключится к dbname с username и password .

Дамп определенных таблиц

Использование массива:

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->includeTables(['таблица1', 'таблица2', 'таблица3'])
    ->dumpToFile('dump.sql');

Использование строки:

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->includeTables('таблица1, таблица2, таблица3')
    ->dumpToFile('dump.sql');

Не используйте таблицу columns_statics со старой версией службы MySql.

Чтобы использовать « --column-statistics=0 » в качестве опции в команде mysqldump, вы можете использовать метод doNotUseColumnStatistics() .

Если вы установили mysqldump 8 , он по умолчанию запрашивает таблицу columns_statics в базе данных Information_schema . В какой-то старой версии MySql (сервиса), например 5.7, эта таблица не существует. Таким образом, у вас может возникнуть исключение во время выполнения mysqldump. Чтобы избежать этого, вы можете использовать метод doNotUseColumnStatistics() .

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->doNotUseColumnStatistics()
    ->dumpToFile('dump.sql');

Исключение таблиц из дампа

Вы можете исключить таблицы из дампа, используя массив:

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->excludeTables(['таблица1', 'таблица2', 'таблица3'])
    ->dumpToFile('dump.sql');

Или с помощью строки:

 SpatieDbDumperDatabasesMySql::create()
    ->setDbName($имя_базы_данных)
    ->setUserName($userName)
    ->setPassword($пароль)
    ->excludeTables('таблица1, таблица2, таблица3')
    ->dumpToFile('dump.sql');

Не пишите операторы CREATE TABLE, которые создают каждую выгруженную таблицу.

Вы можете использовать doNotCreateTables , чтобы предотвратить запись операторов создания.

 $dumpCommand = MySql::create()
    ->setDbName('имя_базы_данных')
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->doNotCreateTables()
    ->getDumpCommand('dump.sql', 'credentials.txt');

Не записывать данные строки

Вы можете использовать doNotDumpData , чтобы предотвратить запись данных строки.

 $dumpCommand = MySql::create()
    ->setDbName('имя_базы_данных')
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->doNotDumpData()
    ->getDumpCommand('dump.sql', 'credentials.txt');

Добавление дополнительных опций

Если вы хотите добавить произвольную опцию в команду дампа, вы можете использовать addExtraOption

 $dumpCommand = MySql::create()
    ->setDbName('имя_базы_данных')
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->addExtraOption('--xml')
    ->getDumpCommand('dump.sql', 'credentials.txt');

Если вы работаете с MySql, вы можете установить имя базы данных, используя --databases в качестве дополнительной опции. Это особенно полезно при использовании в сочетании с опцией mysqldump --add-drop-database (см. документацию mysqldump).

 $dumpCommand = MySql::create()
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->addExtraOption('--имя базы данных')
    ->addExtraOption('--add-drop-database')
    ->getDumpCommand('dump.sql', 'credentials.txt');

В MySql у вас также есть возможность использовать дополнительную опцию --all-databases . Это полезно, если вы хотите запустить полную резервную копию всех баз данных в указанном соединении MySQL.

 $dumpCommand = MySql::create()
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->addExtraOption('--все-базы данных')
    ->getDumpCommand('dump.sql', 'credentials.txt');

Обратите внимание, что использование ->addExtraOption('--databases dbname') или ->addExtraOption('--all-databases') переопределит имя базы данных, установленное при предыдущем вызове ->setDbName() .

Использование сжатия

Если вы хотите, чтобы выходной файл был сжат, вы можете использовать класс компрессора.

Из коробки идут два компрессора:

GzipCompressor — сжимает дамп вашей базы данных с помощью gzip . Перед использованием убедитесь, что в вашей системе установлен gzip .
Bzip2Compressor — сжимает дамп вашей базы данных с помощью bzip2 . Перед использованием убедитесь, что в вашей системе установлен bzip2 .

 $dumpCommand = MySql::create()
    ->setDbName('имя_базы_данных')
    ->setUserName('имя пользователя')
    ->setPassword('пароль')
    ->useCompressor(new GzipCompressor()) // или `new Bzip2Compressor()`->dumpToFile('dump.sql.gz');

Создание собственного компрессора

Вы можете создать свой собственный компрессор, реализуя интерфейс Compressor . Вот как выглядит этот интерфейс:

 пространство имен SpatieDbDumperCompressors;компрессор интерфейса
{публичная функция useCommand(): строка;публичная функция useExtension(): строка;
}

useCommand должен просто возвращать команду сжатия, в которую будет перекачиваться дамп базы данных. Вот реализация GzipCompression .

 пространство имен SpatieDbDumperCompressors; класс GzipCompressor реализует Compressor
{публичная функция useCommand(): строка {return 'gzip';
    } Публичная функция useExtension(): строка {return 'gz';
    }
}

Тестирование

 $ тест композитора

Журнал изменений

Пожалуйста, посетите CHANGELOG для получения дополнительной информации о том, что изменилось за последнее время.

Содействие

Пожалуйста, смотрите ВКЛАД для получения подробной информации.

Уязвимости безопасности

Пожалуйста, ознакомьтесь с нашей политикой безопасности, чтобы узнать, как сообщать об уязвимостях безопасности.

Кредиты

Фрик Ван дер Хертен
Все участники

Первоначальная поддержка PostgreSQL была предоставлена Адриано Мачадо. Поддержку SQlite предоставил Петр Мацейканец.

Лицензия

Лицензия MIT (MIT). Дополнительную информацию см. в файле лицензии.

Расширять

Дополнительная информация

Версия 3.7.1
Тип Другие категории
Время обновления 2024-12-20
размер 15.66KB
От Github

Связанные приложения

ip location db

2024-11-10
yugabyte db

2024-11-06
Приложение панели инструментов БД

2024-02-25
Системное приложение Beluga DB

2023-06-21
Почтовый сервер DB Mail Pro

2009-07-06
Класс подкачки ASP Kin_Db_Pager

2009-05-19

db dumper

Дамп содержимого базы данных

Поддержите нас

Требования

Установка

Использование

Обработка значений AUTO_INCREMENT в дампах

Пропуск значений AUTO_INCREMENT

Включение значений AUTO_INCREMENT в дамп

Используйте URL-адрес базы данных

Дамп определенных таблиц

Не используйте таблицу columns_statics со старой версией службы MySql.

Исключение таблиц из дампа

Не пишите операторы CREATE TABLE, которые создают каждую выгруженную таблицу.

Не записывать данные строки

Добавление дополнительных опций

Использование сжатия

Создание собственного компрессора

Тестирование

Журнал изменений

Содействие

Уязвимости безопасности

Кредиты

Лицензия

ip location db

yugabyte db

Приложение панели инструментов БД

Системное приложение Beluga DB

Почтовый сервер DB Mail Pro

Класс подкачки ASP Kin_Db_Pager

chat.petals.dev

GPT Prompt Templates

GPTyped

termwind

wp functions

slugify

waymo open dataset

termwind

wp functions