WP-CLI
Odniesienie do WP-CLI (Pro)
Automatyzuj tworzenie kopii zapasowych, przywracanie, importowanie, wdrażanie instalatora, odzyskiwanie po awarii i przemieszczanie z poziomu powłoki. Pełna zgodność z interfejsem administratora Multisite Migrate — do każdego polecenia z wyjątkiem pomocy wymagana jest licencja Pro.
Wymagania
- WP-CLI installed on the server (or SSH session).
- Multisite Migrate plugin active; run commands from the WordPress root (
wpmust load the site). - Licencja profesjonalna — every command except
helprequires Multisite Migrate Pro. Plus and Free licenses cannot use WP-CLI. - WordPress capability:
manage_options(single site) ormanage_network(multisite network tasks).
Rozpoczęcie
wp multisite-migrate help
wp multisite-migrate help --topic=restore
wp multisite-migrate backup --help
wp multisite-migrate listhelp prints a full command tree, capability notes, and copy-paste examples. Use --topic=backup|restore|import|jobs|installer|recovery|staging|caps to filter sections. Per-command flags are documented with native WP-CLI --help.
Drzewo poleceń
| Polecenie | Cel |
|---|---|
backup | Uruchom zadanie tworzenia kopii zapasowej (lokalne i opcjonalne przesyłanie do chmury) |
restore <job-id> | Przywracanie tego samego serwera lub migracja adresów URL z opcjami topologii |
import | Zarejestruj archiwum z dysku, adresu URL lub chmury; opcjonalne przywracanie łańcuchowe |
list | Wyświetl listę ukończonych zadań tworzenia kopii zapasowych lub przywracania |
status <job-id> | Postęp zadania, procent i metadane |
cancel <job-id> | Anuluj uruchomione zadanie |
delete <job-id> | Usuń rekord zadania i archiwum lokalne, jeśli są obecne |
prefetch <job-id> | Przed przywróceniem pobierz kopię zapasową w chmurze |
manifest <job-id> | Wydrukuj manifest archiwum w formacie JSON |
migration-preview <job-id> | Podgląd mapowania adresów URL i tabel na potrzeby migracji |
info | Wersja wtyczki, silnik i podsumowanie licencji |
health | Rozszerzenia PHP, miejsce na dysku, ścieżki przechowywania |
cleanup | Usuń tymczasowe pliki importu i pliki robocze |
prune | Zastosuj zasady przechowywania do starych lokalnych kopii zapasowych |
installer | Zainstaluj instalator obok kopii zapasowej lub pobierz bootstrap PHP |
recovery | Ustaw, uruchom lub zresetuj punkt odzyskiwania po awarii |
list-remote <channel> | Wyświetlaj zdalne kopie zapasowe (gdrive, s3, sftp, dropbox) |
staging | Utwórz, usuń lub wypchnij do podwitryny tymczasowej |
help | Wydrukuj to odwołanie w terminalu |
Kopia zapasowa
wp multisite-migrate backup
wp multisite-migrate backup --upload --destination=gdrive
wp multisite-migrate backup --scope=network --profile=full
wp multisite-migrate backup --scope=subsite --profile=db --incrementalCommon flags: --upload, --destination=local|gdrive|s3|sftp|ftp|dropbox, --scope=network|subsite, --profile=full|db|files|media|plugins|themes|custom, --incremental, --quiet.
Przesyłanie do chmury wymaga skonfigurowanej pamięci masowej w chmurze Plus/Pro Przechowywanie w chmurze. Zasięg sieci jest dostępny dla administratorów sieci na platformie Free+; Zadania sieciowe administratora podwitryny nadal podlegają regułom dotyczącym stanowisk/możliwości.
Przywróć
wp multisite-migrate restore 42 --yes
wp multisite-migrate restore 42 --mode=db --no-safety-snapshot
wp multisite-migrate restore 42 --migration --old-url=https://old.example --new-url=https://new.example --yesFlagi topologii odzwierciedlają Przywracanie Multisite w interfejsie administracyjnym:
--topology-import=subsite_on_network+--topology-target-url=…— kopia witryny na istniejącą sieć--topology-import=network_to_subsite+--topology-target-blog-id=…— kopia sieci do slotu witryny--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--passphrase=…dla.venc- Scalanie współdzielonych użytkowników (domyślnie włączone w dwóch trybach lądowania w sieci):
--user-merge/--no-user-merge,--uid-fields=_customer_user,_other_meta,--reset-imported-passwords,--send-password-reset-email
wp multisite-migrate restore 42 --topology-import=subsite_on_network --topology-target-url=https://network.example/site/ --user-merge --uid-fields=_customer_user --yesDługie przywracanie pokazuje pasek postępu. Snapshot bezpieczeństwa działa, chyba że --no-safety-snapshot. Użyj --yes, by pominąć potwierdzenie nadpisania.
Importuj
wp multisite-migrate import /var/backups/site.zip
wp multisite-migrate import --url=https://cdn.example/backup.zip
wp multisite-migrate import --from=gdrive --remote-id=FILE_ID --name=site.zip
wp multisite-migrate import /path/archive.zip --restore --via-worker --yesRemote URL and cloud channels require Pro (CAP_REMOTE_IMPORT). Chain --restore to start restore immediately; add --via-worker for in-plugin restore instead of installer deploy.
Zarządzanie pracą
wp multisite-migrate list --type=backup --format=table --limit=50
wp multisite-migrate status 42
wp multisite-migrate cancel 42
wp multisite-migrate delete 42
wp multisite-migrate manifest 42
wp multisite-migrate migration-preview 42list supports --format=table|json|csv. Subsite admins on multisite see only their scope unless they have network cap.
Instalator & pusty serwer
wp multisite-migrate installer 42
wp multisite-migrate installer 42 --bridge
wp multisite-migrate installer pobieranie --type=php
wp multisite-migrate installer pobieranie 42 --type=phpWdraża tego samego kreatora co Importuj → Otwórz instalator. --bridge uses wp-admin MU-plugin proxy when archives are protected. pobieranie writes bootstrap PHP beside your shell (Pro CAP_INSTALLER).
See also Migracja empty-server.
Odzyskiwanie po awarii
wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery resetMecze Kopie zapasowe → Odzyskiwanie: in-place overwrite from a pinned full backup with WordPress core. Disable site-wide with define('MM_DISALLOW_RECOVERY', true); in wp-config.php.
Inscenizacja
wp multisite-migrate staging create --slug=staging --title="Staging"
wp multisite-migrate staging delete --slug=staging
wp multisite-migrate staging push --job-id=42Requires Pro CAP_STAGING. Same flows as Staging w przewodniku przywracania.
Konserwacja
wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdriveMożliwości licencji
Po bramce Pro poszczególne polecenia mogą wymagać dodatkowych możliwości (takich samych jak interfejs administratora):
| Możliwości | Przykłady CLI |
|---|---|
CAP_CLI | All commands except help — Pro only |
CAP_CLOUD | backup --upload, prefetch, list-remote |
CAP_REMOTE_IMPORT | import --url, import --from=* |
CAP_MULTISITE | Przepływy administracyjne w całej sieci wymagające bramy obsługującej wiele lokalizacji (zobacz pomoc CLI) |
CAP_INSTALLER | installer pobieranie |
CAP_STAGING | staging * |
CAP_NETWORK_SPLIT | split-network, split-status, split-cancel, split-resume, restore --topology-import=extract_site_standalone |
Przepisy scenariuszowe
| Scenariusz | Polecenia |
|---|---|
| Podstrona → samodzielna migracja | wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes |
| Podziel sieć → archiwa w poszczególnych lokalizacjach | wp multisite-migrate split-network --yes then split-status — see przewodnik podziału sieci |
| Wznów nieudany podział | wp multisite-migrate split-resume --yes then split-status |
| Archiwum sieciowe → jedna samodzielna witryna | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify |
| Sprawdź pozostałe adresy URL | wp multisite-migrate migration-verify --old-url=… |
| Potwierdzono wyszukiwanie-zamień | wp multisite-migrate search-replace --old=… --new=… --yes |
| Podwitryna → istniejąca sieć (połącz użytkowników) | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes |
| Sieć → miejsce na podwitrynę (połącz użytkowników) | wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes |
| Import sieciowy bez scalania użytkowników | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes |
| Połącz użytkowników + zresetuj hasła | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --yes |
| Zaimportuj, a następnie instalator | wp multisite-migrate import /path/backup.zip --restore |
| Zaimportuj, a następnie przywróć w wtyczce | wp multisite-migrate import /path/backup.zip --restore --via-worker --yes |
| Kopia zapasowa tylko w chmurze → przywracanie | wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes |
| Wdróż instalator (most) | wp multisite-migrate installer <id> --bridge |
| Punkt przywracania po awarii | wp multisite-migrate recovery set --job-id=<id> then recovery launch |
Flagi globalne
--quiet— suppress progress messages on long jobs--porcelain— machine-readable progress lines
Powiązane przewodniki
Często zadawane pytania dotyczące WP-CLI
Automatyzacja powłoki wymaga wersji Pro. Użyj pomocy na serwerze dla listy poleceń na żywo.
Jakiej licencji potrzebuję do WP-CLI?
Zawodowiec W wersjach Free i Plus nie można uruchamiać poleceń Multisite Migrate WP-CLI (z wyjątkiem przeglądania pomocy, jeśli jest dostępna).
Gdzie powinienem uruchamiać polecenia wp?
Z katalogu głównego WordPress, więc WP-CLI ładuje witrynę. Wtyczka Multisite Migrate musi być aktywna.
Czy mogę zautomatyzować harmonogramy za pomocą interfejsu CLI?
Tak w wersji Pro — polecenia tworzenia kopii zapasowych, przywracania, importowania, instalowania, odzyskiwania i przemieszczania odzwierciedlają interfejs administratora. Zobacz sekcję z przepisami powyżej.
Jak scalić użytkowników podczas przywracania do sieci za pośrednictwem WP-CLI?
Użyj opcji --topology-import=subsite_on_network lub network_to_subsite. Łączenie współdzielonych użytkowników jest domyślnie włączone; w razie potrzeby przekaż --no-user-merge, aby pominąć, lub --uid-fields i --reset-imported-passwords. Zobacz sekcję przywracania i przepisy powyżej.
Czy zwrot pieniędzy w dniu 14 ma zastosowanie, jeśli korzystam tylko z WP-CLI?
Tak. Nowe zakupy Plus lub Pro obejmują gwarancję zwrotu pieniędzy 14 w ciągu dnia, niezależnie od tego, czy wolisz interfejs administratora, czy WP-CLI.