WP Staging CLI potrafi tworzyć i zarządzać środowiskami WordPress opartymi na Dockerze do lokalnego rozwoju i testów. Ten przewodnik pokazuje, jak dodawać, wyświetlać, usuwać i zarządzać witrynami WordPress.
Co otrzymasz
Każda witryna Docker zawiera:
- PHP-FPM w wybranej przez ciebie wersji PHP
- Serwer WWW Nginx z HTTPS
- Bazę danych MariaDB
- Mailpit do testowania wiadomości e-mail
- Automatyczne certyfikaty SSL przez mkcert
- Konfigurację pliku hosts dla lokalnych domen
Wymagania wstępne
- Docker 20.10.0 lub nowszy
- Docker Compose 2.19.0 lub nowszy
- Minimum 2 rdzenie CPU i 4 GB RAM
Dodawanie nowej witryny
Utwórz nową witrynę WordPress z własną lokalną domeną:
wpstaging add https://mysite.localLub bez protokołu:
wpstaging add mysite.localPotrzebujesz WordPress Multisite?
wpstaging add mysite.local --multisitePo utworzeniu witryny możesz wejść na nią pod adresem https://mysite.local.
Dodawanie witryny z istniejącego pliku Backupu
Utwórz nową witrynę i przywróć ją z pliku Backupu WP Staging w jednym kroku:
wpstaging add mysite.local --from=backup.wpstgLub ze zdalnego adresu URL:
wpstaging add mysite.local --from=https://example.com/backup.wpstgWordPress Multisite:
wpstaging add mysite.local --multisite --from=BACKUP_URLTo zalecany sposób tworzenia lokalnej kopii twojej witryny produkcyjnej. Obsługuje wszystko: konfigurację Dockera, wyodrębnianie Backupu, import bazy danych oraz podmianę adresów URL.
Dostosowywanie konfiguracji witryny
Wersja PHP
Wskaż wersję PHP (domyślnie 8.1):
wpstaging add mysite.local --php=8.2Dostępne wersje PHP zależą od obsługiwanych obrazów Docker.
Wersja WordPress
Zainstaluj konkretną wersję WordPress (domyślnie najnowszą):
wpstaging add mysite.local --wp=6.4.2Własne porty
Zmień domyślne porty, jeśli kolidują z innymi usługami:
wpstaging add mysite.local \
--http-port=8080 \
--https-port=8443 \
--db-port=3307Adres IP kontenera
Domyślnie witryny korzystają z adresów IP z zakresu 127.3.2.x. Możesz wskazać własny adres IP:
wpstaging add mysite.local --container-ip=127.0.0.1Ścieżka środowiska
Zmień miejsce, w którym przechowywane są środowiska Docker (domyślnie: ~/wpstaging):
wpstaging add mysite.local --env-path=/custom/pathWszystkie flagi polecenia add
| Flaga | Domyślnie | Opis |
|---|---|---|
--php | 8.1 | Wersja PHP |
--wp | latest | Wersja WordPress |
--from | – | Ścieżka do pliku Backupu lub adres URL do przywrócenia |
--env-path | ~/wpstaging | Ścieżka do przechowywania środowisk Docker |
--container-ip | 127.3.2.1 | Adres IP kontenera |
--http-port | 80 | Port HTTP Nginx |
--https-port | 443 | Port HTTPS Nginx |
--db-port | 3306 | Port MariaDB |
--db-root | 123456 | Hasło użytkownika root MariaDB |
--mailpit-http-port | 8025 | Port interfejsu webowego Mailpit |
--disable-mailpit | false | Wyłącza kontener Mailpit |
Flagi konfiguracji WordPress
| Flaga | Domyślnie | Opis |
|---|---|---|
--db-name | auto | Nazwa bazy danych WordPress |
--db-user | auto | Użytkownik bazy danych WordPress |
--db-pass | auto | Hasło bazy danych WordPress |
--db-prefix | wp_ | Prefiks tabel WordPress |
--db-host | localhost | Nazwa hosta bazy danych WordPress |
--db-ssl | false | Włącza SSL dla połączenia z bazą danych WordPress |
--admin-user | admin | Nazwa użytkownika administratora WordPress |
--admin-pass | admin | Hasło administratora WordPress |
--admin-email | admin@dev.null | E-mail administratora WordPress |
--secure-credentials | false | Generuje losowe, bezpieczne dane dostępowe |
--multisite | false | Włącza WordPress Multisite |
Wyświetlanie witryn
Wyświetl wszystkie witryny WordPress w twoim środowisku Docker:
wpstaging listPrzykładowy wynik:
HOSTNAME STATUS PHP IP
mysite.local running 8.1 127.3.2.1
dev.local stopped 8.2 127.3.2.2
test.local running 8.0 127.3.2.3Wyświetlanie szczegółów konkretnych witryn
Pobierz szczegółowe informacje o jednej lub kilku witrynach:
wpstaging list mysite.localLub o kilku witrynach naraz:
wpstaging list site1.local site2.localUsuwanie witryn
Usuń konkretną witrynę:
wpstaging del mysite.localUsuń kilka witryn:
wpstaging del site1.local site2.localUsuń wszystkie witryny (z potwierdzeniem):
wpstaging delUwaga: usunięcie witryny powoduje usunięcie wszystkich jej plików, bazy danych i konfiguracji. Tej operacji nie da się cofnąć.
Włączanie/wyłączanie witryn
Wyłącz witrynę bez jej usuwania:
wpstaging disable mysite.localPonownie włącz wyłączoną witrynę:
wpstaging enable mysite.localWyłączone witryny zachowują swoje dane, ale ich kontenery nie są uruchamiane.
Resetowanie witryny
Zresetuj witrynę do świeżej instalacji WordPress:
wpstaging reset mysite.localUsuwa to wszystkie treści WordPress i ponownie instaluje WordPress, zachowując nienaruszoną konfigurację Dockera.
Reset z inną wersją WordPress
Wskaż inną wersję WordPress podczas resetowania:
wpstaging reset mysite.local --wp=6.5Reset i przywracanie z Backupu
Zresetuj witrynę i przywróć z Backupu WP Staging w jednym kroku:
wpstaging reset mysite.local --from=backup.wpstg
wpstaging reset mysite.local --from=https://example.com/backup.wpstgBezpieczne dane dostępowe
Dla większego bezpieczeństwa, zwłaszcza we współdzielonych środowiskach, używaj losowych danych dostępowych:
wpstaging add mysite.local --secure-credentialsGeneruje to losowe hasła dla:
- Użytkownika root MariaDB
- Użytkownika bazy danych WordPress
- Użytkownika administratora WordPress
Wygenerowane dane dostępowe są wyświetlane po utworzeniu witryny.
WordPress Multisite
Utwórz instalację WordPress Multisite:
wpstaging add mynetwork.local --multisiteUwagi dla macOS
Użytkownicy macOS: automatyczne przypisywanie aliasów IP jest domyślnie włączone, dzięki czemu konfiguracja wielu witryn działa bezproblemowo z użyciem zakresu IP loopback 127.3.2.1 – 127.3.2.254. Wymaga to sudo, więc zostaniesz poproszony o hasło.
Wskazówka: skonfiguruj sudo bez hasła dla wpstaging, aby uniknąć ciągłego wpisywania hasła. Instrukcje znajdziesz w FAQ.
Następne kroki
- Sterowanie kontenerami Docker – uruchamiaj, zatrzymuj i zarządzaj kontenerami
- Konfiguracja Dockera – zaawansowane opcje konfiguracyjne
- Tworzenie lokalnej kopii witryny WordPress – pełny samouczek