Wyodrębnianie Backupów w wierszu poleceń

Ten artykuł wyjaśnia, jak wyodrębnić Backup WP Staging w wierszu poleceń za pomocą narzędzia wpstaging cli. Jeśli masz problemy z pracą w wierszu poleceń, możesz wykonać to samo zadanie za pomocą innego narzędzia z graficznym interfejsem użytkownika o nazwie WP Staging restore tool.

wpstaging cli to potężne, wysokowydajne narzędzie wiersza poleceń stworzone do przetwarzania plików Backupu WP Staging w wierszu poleceń na każdym popularnym systemie operacyjnym.

Za pomocą tego narzędzia możesz wyodrębniać, normalizować i sprawdzać zawartość plików Backupu .wpstg utworzonych przez plugin WP Staging. Ten samodzielny ekstraktor jest napisany w Go, co zapewnia wyjątkową szybkość i wydajność, i działa niezależnie od WordPress.

Narzędzie wiersza poleceń `wp-staging-cli` jest częścią planu WP Staging Developer oraz planu Agency i można je pobrać z GitHub.

Contents

Najważniejsze funkcje
- Test wydajności
Instalacja
- Krok 1: pobierz pliki wykonywalne
Powiązane artykuły

Najważniejsze funkcje

Wyodrębnianie plików Backupu i bazy danych: dostęp do całej zawartości plików Backupu .wpstg.
Normalizacja bazy danych: normalizacja plików bazy danych zawartych w Backupie.
Eksport metadanych: wyodrębnianie i wyświetlanie metadanych z pliku Backupu.
Eksport indeksu i nagłówka: pobieranie informacji o indeksie i nagłówku z pliku Backupu.

Test wydajności

wp-staging-cli jest wyjątkowo szybki. Na przykład potrafi wyodrębnić Backup o rozmiarze 20 GB w mniej niż 36 sekund na procesorze AMD Ryzen™ 7 PRO 7840U z szybkim dyskiem SSD pod kontrolą systemu Ubuntu 22.04.

Instalacja

Krok 1: pobierz pliki wykonywalne

Pobierz pliki wykonywalne dla Windows, Linuksa i Mac OS stąd.
Rozpakuj plik ZIP i wybierz odpowiedni plik binarny dla swojego systemu operacyjnego z folderu build.
(Opcjonalnie) Przenieś plik binarny wp-staging-cli do katalogu w swojej zmiennej PATH, aby mieć do niego łatwy dostęp. Na przykład w Linuksie:

ShellScript

mv wp-staging-cli /usr/local/bin/

mv wp-staging-cli /usr/local/bin/

Instrukcja użycia

Aby uruchomić wp-staging-cli, użyj następującego polecenia:

ShellScript

wp-staging-cli [options] <backupfile.wpstg>

wp-staging-cli [options] <backupfile.wpstg>

Argumenty

<backupfile.wpstg>: ścieżka do pliku Backupu WP Staging, który ma zostać przetworzony. Ten argument jest obowiązkowy.

Opcje i argumenty polecenia można podawać w dowolnej kolejności.

Opcje mogą mieć prefiks pojedynczego myślnika ’-’ lub podwójnego myślnika ’–’.
Opcje z wartościami można ustawić ze znakiem '=’ lub bez niego.

Opcje

ShellScript

Commands:
extract - Extract items from the backup. Default if no command is specified.
restore - Restore the backup file.
help - Display all help message.

Arguments:
backupfile.wpstg - Path to the WP Staging backup file that will be processed. This argument is mandatory.

General Options:
-l, --license=<licensekey> - WP Staging Pro License Key. Required to access the backup file.
Alternatively, use the `WPSTGPRO_LICENSE` environment variable.
-o, --outputdir=<path> - Specify the extraction directory path where processed files will be stored. Default: "./wp-staging-cli-output".
-n, --normalizedb - Normalize database files during the `extract` process.
This will replace all WP Staging specific placeholders and allows the sql file to be imported by
any regular db admin tool.

--workingdir=<path> - Specify the working directory path where config-related files will be stored. Default: "~/.wp-staging-cli".
--skip-config - Don't reads command options from the configuration file located at "~/.wp-staging-cli/wp-staging-cli.conf".
--siteurl=<siteurl> - Specify a new Site URL.
--db-prefix=<prefix> - Specify a new database table prefix.
--overwrite=<yes|no> - Overwrite the target directory during `extract` and `restore` operations. Default: "yes".
--verify - Verify the integrity of the extracted file.
--yes - Automatically answers "yes" to confirmation prompts.
--confirm-timeout=<num> - Timeout duration (in seconds) for awaiting a "yes" response at confirmation prompts. Default: 30 seconds.
--skip-extract - Don't extract files and use previously extracted and existing files for `restore` process.
For use case, when restore failed, the process can be continued without first extracting all files again.

-or, --only-wproot - Process only the 'wp root' item in the backup.
-ow, --only-wpcontent - Process only the 'wp-content' item in the backup.
-op, --only-plugins - Process only the 'plugins' item in the backup.
-ot, --only-themes - Process only the 'themes' item in the backup.
-om, --only-muplugins - Process only the 'mu-plugins' item in the backup.
-ou, --only-uploads - Process only the 'uploads' item in the backup.
-ol, --only-languages - Process only the 'languages' item in the backup.
-od, --only-dbfile - Process only the database file in the backup.
-oe, --only-dropins - Process only the dropins file in the backup.
-of, --only-file=<string> - Process only items that match the specified string.

-sr, --skip-wproot - Skip processing the 'wp root' item in the backup.
-sw, --skip-wpcontent - Skip processing the 'wp-content' item in the backup.
-sp, --skip-plugins - Skip processing the 'plugins' item in the backup.
-st, --skip-themes - Skip processing the 'themes' item in the backup.
-sm, --skip-muplugins - Skip processing the 'mu-plugins' item in the backup.
-su, --skip-uploads - Skip processing the 'uploads' item in the backup.
-sl, --skip-languages - Skip processing the 'languages' item in the backup.
-sd, --skip-dbfile - Skip processing the database file in the backup.
-se, --skip-dropins - Skip processing the dropins file in the backup.
-sf, --skip-file=<string> - Skip processing items that match the specified string.

-dm, --dump-metadata - Display backup metadata from the backup file.
-di, --dump-index=<data> - Display backup index from the backup file. Use 'data' to show additional information.
-dh, --dump-header - Display backup header from the backup file.
-do, --dump-options - Display the command options that have been parsed.

-d, --debug - Display debug message.
-q, --quiet - Suppress output of processed backup items.
-v, --version - Display version information.
-h, --help - Display all help message.

Restore Options:
-p, --path=<path> - Specify the WordPress root path for restoration. Default: "./".
-wd, --overwrite-db=<yes|no> - Remove database tables not present in the backup. Default: "yes".
-wr, --overwrite-wproot=<yes|no> - Remove files in the WordPress root path that are not in the backup or part of WordPress core. Default: "no".
--db-innodb-strict-mode - Enable InnoDB strict mode if needed. By default, it is turned off during database restoration.
--db-file=<file> - Use the extracted backup SQL file to resume database restoration in case of failure.
--db-insert-batch-size=<num> - Number of queries to batch in a single insert operation. Default: 1000.
--db-insert-multi=<yes|no> - Use multi-row INSERT statements per query to improve performance. Default "yes".

Restore DB Options:
This option overrides the DB-related configuration parsed from the wp-config.php file.
--db-host=<string> - Database Host.
--db-name=<string> - Database Name.
--db-user=<string> - Database User.
--db-pass=<string> - Database Password.
--db-socket=<file> - MySQL socket file path.
--db-charset=<string> - Database charset.
--db-collate=<string> - Database collate.
--db-ssl-ca-cert=<file> - SSL CA file path.
--db-ssl-cert=<file> - SSL certificate file path.
--db-ssl-key=<file> - SSL key file path.
--db-ssl-mode=<mode> - Connects to the database with SSL mode "skip-verify" or "preferred". Default: "skip-verify".

  Commands:
  extract - Extract items from the backup. Default if no command is specified.
  restore - Restore the backup file.
  help    - Display all help message.

Arguments:
  backupfile.wpstg  - Path to the WP Staging backup file that will be processed. This argument is mandatory.

General Options:
  -l,  --license=<licensekey>       - WP Staging Pro License Key. Required to access the backup file.
                                      Alternatively, use the `WPSTGPRO_LICENSE` environment variable.
  -o,  --outputdir=<path>           - Specify the extraction directory path where processed files will be stored. Default: "./wp-staging-cli-output".
  -n,  --normalizedb                - Normalize database files during the `extract` process.
                                      This will replace all WP Staging specific placeholders and allows the sql file to be imported by
                                      any regular db admin tool.

       --workingdir=<path>          - Specify the working directory path where config-related files will be stored. Default: "~/.wp-staging-cli".
       --skip-config                - Don't reads command options from the configuration file located at "~/.wp-staging-cli/wp-staging-cli.conf".
       --siteurl=<siteurl>          - Specify a new Site URL.
       --db-prefix=<prefix>         - Specify a new database table prefix.
       --overwrite=<yes|no>         - Overwrite the target directory during `extract` and `restore` operations. Default: "yes".
       --verify                     - Verify the integrity of the extracted file.
       --yes                        - Automatically answers "yes" to confirmation prompts.
       --confirm-timeout=<num>      - Timeout duration (in seconds) for awaiting a "yes" response at confirmation prompts. Default: 30 seconds.
       --skip-extract               - Don't extract files and use previously extracted and existing files for `restore` process.
                                      For use case, when restore failed, the process can be continued without first extracting all files again.

  -or, --only-wproot                - Process only the 'wp root' item in the backup.
  -ow, --only-wpcontent             - Process only the 'wp-content' item in the backup.
  -op, --only-plugins               - Process only the 'plugins' item in the backup.
  -ot, --only-themes                - Process only the 'themes' item in the backup.
  -om, --only-muplugins             - Process only the 'mu-plugins' item in the backup.
  -ou, --only-uploads               - Process only the 'uploads' item in the backup.
  -ol, --only-languages             - Process only the 'languages' item in the backup.
  -od, --only-dbfile                - Process only the database file in the backup.
  -oe, --only-dropins               - Process only the dropins file in the backup.
  -of, --only-file=<string>         - Process only items that match the specified string.

  -sr, --skip-wproot                - Skip processing the 'wp root' item in the backup.
  -sw, --skip-wpcontent             - Skip processing the 'wp-content' item in the backup.
  -sp, --skip-plugins               - Skip processing the 'plugins' item in the backup.
  -st, --skip-themes                - Skip processing the 'themes' item in the backup.
  -sm, --skip-muplugins             - Skip processing the 'mu-plugins' item in the backup.
  -su, --skip-uploads               - Skip processing the 'uploads' item in the backup.
  -sl, --skip-languages             - Skip processing the 'languages' item in the backup.
  -sd, --skip-dbfile                - Skip processing the database file in the backup.
  -se, --skip-dropins               - Skip processing the dropins file in the backup.
  -sf, --skip-file=<string>         - Skip processing items that match the specified string.

  -dm, --dump-metadata              - Display backup metadata from the backup file.
  -di, --dump-index=<data>          - Display backup index from the backup file. Use 'data' to show additional information.
  -dh, --dump-header                - Display backup header from the backup file.
  -do, --dump-options               - Display the command options that have been parsed.

  -d,  --debug                      - Display debug message.
  -q,  --quiet                      - Suppress output of processed backup items.
  -v,  --version                    - Display version information.
  -h,  --help                       - Display all help message.

Restore Options:
  -p,  --path=<path>                - Specify the WordPress root path for restoration. Default: "./".
  -wd, --overwrite-db=<yes|no>      - Remove database tables not present in the backup. Default: "yes".
  -wr, --overwrite-wproot=<yes|no>  - Remove files in the WordPress root path that are not in the backup or part of WordPress core. Default: "no".
       --db-innodb-strict-mode      - Enable InnoDB strict mode if needed. By default, it is turned off during database restoration.
       --db-file=<file>             - Use the extracted backup SQL file to resume database restoration in case of failure.
       --db-insert-batch-size=<num> - Number of queries to batch in a single insert operation. Default: 1000.
       --db-insert-multi=<yes|no>   - Use multi-row INSERT statements per query to improve performance. Default "yes".

Restore DB Options:
  This option overrides the DB-related configuration parsed from the wp-config.php file.
       --db-host=<string>           - Database Host.
       --db-name=<string>           - Database Name.
       --db-user=<string>           - Database User.
       --db-pass=<string>           - Database Password.
       --db-socket=<file>           - MySQL socket file path.
       --db-charset=<string>        - Database charset.
       --db-collate=<string>        - Database collate.
       --db-ssl-ca-cert=<file>      - SSL CA file path.
       --db-ssl-cert=<file>         - SSL certificate file path.
       --db-ssl-key=<file>          - SSL key file path.
       --db-ssl-mode=<mode>         - Connects to the database with SSL mode "skip-verify" or "preferred". Default: "skip-verify".

Przykłady:

ShellScript

wp-staging-cli --license=WPSTGPRO_LICENSE --outputdir=./wpstgbackup backup.wpstg
wp-staging-cli --license=WPSTGPRO_LICENSE --normalizedb --dbprefix=newprefix --siteurl=https://example.com backup.wpstg

wp-staging-cli --license=WPSTGPRO_LICENSE --outputdir=./wpstgbackup backup.wpstg
wp-staging-cli --license=WPSTGPRO_LICENSE --normalizedb --dbprefix=newprefix --siteurl=https://example.com backup.wpstg

Z krótkimi opcjami:

ShellScript

wp-staging-cli -l WPSTGPRO_LICENSE -o ./wpstgbackup backup.wpstg
wp-staging-cli -l WPSTGPRO_LICENSE -n -dp newprefix -su https://example.com backup.wpstg

wp-staging-cli -l WPSTGPRO_LICENSE -o ./wpstgbackup backup.wpstg
wp-staging-cli -l WPSTGPRO_LICENSE -n -dp newprefix -su https://example.com backup.wpstg

Ustawianie klucza licencyjnego za pomocą zmiennej środowiskowej

Samodzielny ekstraktor wymaga aktywnej licencji WP Staging Pro. (Plan Agency lub Developer)
Dla wygody możesz ustawić klucz licencyjny za pomocą zmiennej środowiskowej:

W systemach uniksowych:

ShellScript

export WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

export WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

W wierszu poleceń systemu Windows:

PowerShell

set WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

set WPSTGPRO_LICENSE=WPSTGPRO_LICENSE_KEY

Współtworzenie wp-staging-cli

Chętnie przyjmiemy twój wkład w wp-staging-cli! Jeśli masz sugestie, zgłoszenia błędów lub chcesz dorzucić kod, otwórz zgłoszenie w repozytorium na GitHubie.

Wyodrębnianie Backupów w wierszu poleceń na Linuksie, MacOS lub Windows

Najważniejsze funkcje

Test wydajności

Instalacja

Krok 1: pobierz pliki wykonywalne

Instrukcja użycia

Argumenty

Ustawianie klucza licencyjnego za pomocą zmiennej środowiskowej

Współtworzenie wp-staging-cli

Autor: Rene Hermenau

Categories

Najważniejsze funkcje

Test wydajności

Instalacja

Krok 1: pobierz pliki wykonywalne

Instrukcja użycia

Argumenty

Ustawianie klucza licencyjnego za pomocą zmiennej środowiskowej

Współtworzenie wp-staging-cli

Powiązane artykuły

Autor: Rene Hermenau

Categories