Wyodrębnianie Backupu

Polecenie extract wyciąga pliki i bazę danych z Backupu WP Staging (.wpstg) bez konieczności posiadania działającej instalacji WordPress. Przydaje się to przy odzyskiwaniu po awarii, przeglądaniu zawartości witryny lub przygotowywaniu plików do ręcznego importu.

Co otrzymasz

Po wyodrębnieniu będziesz mieć:

Wszystkie pliki WordPress (rdzeń, motywy, pluginy, pliki przesłane)
Plik SQL bazy danych gotowy do importu
Plik wp-config.php z oryginalnymi ustawieniami

Podstawowe wyodrębnianie

Wyodrębnij wszystkie pliki i bazę danych do domyślnego katalogu wyjściowego (./wpstaging-output):

wpstaging extract backup.wpstg

Lub użyj flagi --from:

wpstaging extract --from=backup.wpstg

Wyodrębnianie ze zdalnego adresu URL

Wyodrębnij bezpośrednio ze zdalnego pliku Backupu, bez konieczności wcześniejszego pobierania go ręcznie:

wpstaging extract --from=https://example.com/backups/backup.wpstg

Lub przekaż adres URL bezpośrednio jako argument:

wpstaging extract https://example.com/backups/backup.wpstg

Co się dzieje:

Weryfikacja zdalnego pliku (rozmiar i format)
Wyświetlenie informacji o Backupie
Prośba o potwierdzenie przed pobraniem
Pobieranie ze wskaźnikiem postępu (obsługuje wznawianie przerwanych pobrań)

Wyodrębnianie do własnego katalogu

Wskaż, gdzie mają zostać wyodrębnione pliki:

wpstaging extract --outputdir=/var/www/restored-site backup.wpstg

Forma skrócona:

wpstaging extract -o /var/www/restored-site backup.wpstg

Wyodrębnianie z normalizacją bazy danych

Backupy WP Staging zawierają w pliku bazy danych specjalne placeholdery. Użyj --normalizedb, aby zastąpić je rzeczywistymi wartościami, dzięki czemu plik SQL będzie gotowy do użycia w standardowych narzędziach bazodanowych:

wpstaging extract --normalizedb backup.wpstg

Zastępuje to placeholdery takie jak:

{WPSTG_TMP_PREFIX} → tymczasowy prefiks tabel
{WPSTG_FINAL_PREFIX} → docelowy prefiks tabel
{WPSTG_NULL} → SQL NULL
{WPSTG_BINARY} → typ danych BINARY

Zmiana adresu URL witryny i prefiksu bazy danych

Wyodrębnij Backup, zmieniając jednocześnie adres URL witryny i prefiks bazy danych pod nowe środowisko:

wpstaging extract --normalizedb \
  --site-url=https://newdomain.com \
  --db-prefix=wp_new_ \
  backup.wpstg

Uwaga: przy używaniu --site-url lub --db-prefix wymagana jest flaga --normalizedb.

Filtrowanie tego, co ma zostać wyodrębnione

Użyj flag --only-*, aby wyodrębnić konkretne części Backupu:

Flaga	Skrót	Opis
`--only-wproot`	`-r`	Wyodrębnia tylko pliki z głównego katalogu WordPress
`--only-wpcontent`	`-w`	Wyodrębnia tylko katalog wp-content
`--only-plugins`	`-i`	Wyodrębnia tylko pluginy
`--only-themes`	`-t`	Wyodrębnia tylko motywy
`--only-muplugins`	`-m`	Wyodrębnia tylko mu-pluginy
`--only-uploads`	`-u`	Wyodrębnia tylko pliki przesłane
`--only-languages`	`-g`	Wyodrębnia tylko pliki językowe
`--only-dbfile`	`-b`	Wyodrębnia tylko plik bazy danych
`--only-dropins`	`-e`	Wyodrębnia tylko pliki drop-in
`--only-file`	`-f`	Wyodrębnia tylko pliki pasujące do podanej nazwy

Przykład – wyodrębnij tylko plik bazy danych:

wpstaging extract --only-dbfile backup.wpstg

Przykład – wyodrębnij tylko pluginy:

wpstaging extract -i backup.wpstg

Pomijanie konkretnych części

Użyj flag --skip-*, aby pominąć określone części przy wyodrębnianiu:

Flaga	Skrót	Opis
`--skip-wproot`	`-R`	Pomija pliki głównego katalogu WordPress
`--skip-wpcontent`	`-W`	Pomija katalog wp-content
`--skip-plugins`	`-I`	Pomija pluginy
`--skip-themes`	`-T`	Pomija motywy
`--skip-muplugins`	`-M`	Pomija mu-pluginy
`--skip-uploads`	`-U`	Pomija pliki przesłane
`--skip-languages`	`-G`	Pomija pliki językowe
`--skip-dbfile`	`-B`	Pomija plik bazy danych
`--skip-dropins`	`-E`	Pomija pliki drop-in
`--skip-file`	`-F`	Pomija pliki pasujące do podanej nazwy

Przykład – wyodrębnij wszystko oprócz plików przesłanych:

wpstaging extract --skip-uploads backup.wpstg

Przykład – pomiń bazę danych i pliki przesłane:

wpstaging extract -B -U backup.wpstg

Weryfikacja wyodrębnionych plików

Sprawdź spójność wyodrębnionych plików, porównując sumy kontrolne z Backupem:

wpstaging extract --verify backup.wpstg

Zachowanie przy nadpisywaniu

Domyślnie wyodrębnianie nadpisuje istniejące pliki. Aby to kontrolować:

# Skip overwriting (default is yes)
wpstaging extract --overwrite=no backup.wpstg

Wszystkie flagi polecenia extract

Flags:
  -o, --outputdir string   Directory for extracted files (default: ./wpstaging-output)
  -n, --normalizedb        Normalize database files during extraction
      --overwrite string   Overwrite existing extraction directory (yes/no) (default "yes")
      --site-url string    Specify a new WordPress site URL
      --verify             Verify integrity of extracted files
      --db-prefix string   Specify a new WordPress database table prefix
      --from string        Backup file path or remote URL (http/https)

Typowe zastosowania

Odzyskiwanie po awarii

Wyodrębnij pliki z Backupu, gdy twoja instalacja WordPress jest uszkodzona:

wpstaging extract --normalizedb --outputdir=/var/www/recovery backup.wpstg

Wyodrębnienie tylko bazy danych do ręcznego importu

Pobierz wyłącznie plik SQL bazy danych:

wpstaging extract --only-dbfile --normalizedb backup.wpstg

Migracja do nowej domeny

Wyodrębnij z nowym adresem URL witryny pod kątem migracji:

wpstaging extract --normalizedb \
  --site-url=https://newsite.com \
  --outputdir=/var/www/newsite \
  backup.wpstg

Następne kroki

Przywracanie WordPressa z Backupu – dla pełnego, zautomatyzowanego przywracania
Sprawdzanie zawartości plików Backupu – podgląd zawartości Backupu przed wyodrębnieniem
Tworzenie lokalnej kopii witryny WordPress – skonfiguruj lokalną kopię opartą na Dockerze