Einstellungen und Umfang mit WP-CLI

Mit wp cloneworx-backup settings liest und änderst Du die Einstellungen, die für die ganze Website gelten. Mit wp cloneworx-backup scope siehst Du, was zu Deiner Website gehört, und legst fest, was nie in ein Backup kommt.

WP-CLI fehlt noch? Die Anleitung steht in WP-CLI installieren. Alle Befehle des Plugins nennt Die Befehle im Überblick.

Was zu einem Backup-Plan oder zu einem Ziel gehört, steht nicht hier: Das änderst Du mit wp cloneworx-backup plan und wp cloneworx-backup target. Die Ausgaben der Befehle sind englisch.

Die Einstellungen zeigen: settings list

settings list zeigt alle Einstellungen mit ihrem Wert. Ohne Aktion tut wp cloneworx-backup settings dasselbe. Die Aktion hat keine Schalter.

# Alle Einstellungen zeigen
wp cloneworx-backup settings list

Jede Zeile nennt einen Schlüssel und seinen Wert. (default) hinter dem Wert heißt: Der Wert ist die Vorgabe und wurde nie gespeichert. Schalter erscheinen als on oder off. Ist keine E-Mail-Adresse eingetragen, nennt die letzte Zeile die Admin-Adresse der Website: Dorthin gehen die Benachrichtigungen.

Eine Einstellung lesen und setzen: settings get, set

settings get gibt den Wert eines Schlüssels aus. settings set speichert einen neuen Wert. Schlüssel und Wert stehen ohne Schalter hinter der Aktion.

Schlüssel	In der Oberfläche	Erlaubte Werte	Vorgabe
notify_emails	E-Mail-Adressen	bis zu 5 Adressen als ein Wert, durch Komma getrennt	leer: Die Benachrichtigungen gehen an die Admin-Adresse der Website.
notify_errors	Bei Fehlern und Warnungen	on, off	on
notify_success	Bei Erfolg	on, off	off
notify_overdue	Wenn das letzte gute Backup älter ist, als der Plan erlaubt	on, off	on
step_max_seconds	Höchstdauer je Schritt	5 bis 20 (Sekunden)	20
step_pause_seconds	Pause zwischen Schritten	0 bis 60 (Sekunden)	0
log_keep_days	Protokolle aufbewahren für	7 bis 365 (Tage)	30
manual_retention	Max. Sicherungen ohne Plan	1 bis 99	7
remove_all_on_delete	Beim Löschen des Plugins alle Einstellungen und den Index entfernen. Backups bleiben erhalten.	on, off	off

# Eine Einstellung lesen
wp cloneworx-backup settings get step_max_seconds

# Die Höchstdauer je Schritt auf 10 Sekunden setzen
wp cloneworx-backup settings set step_max_seconds 10

# Zwei Empfänger für Benachrichtigungen eintragen
wp cloneworx-backup settings set notify_emails "eins@example.com, zwei@example.com"

# Die E-Mail nach jedem erfolgreichen Backup einschalten
wp cloneworx-backup settings set notify_success on

Nach dem Speichern bestätigt der Befehl Schlüssel und Wert. Nimmt das Plugin einen Wert nicht an, speichert es nichts. Der Befehl endet dann mit einem Fehler und nennt den Grund in Klammern:

Grund	Bedeutung
unknown	Den Schlüssel gibt es nicht.
type	Der Wert hat die falsche Art, zum Beispiel Text statt einer Zahl.
range	Die Zahl liegt außerhalb der Grenzen. Der Befehl nennt die erlaubten Grenzen.
email	Eine Adresse ist keine gültige E-Mail-Adresse.
too_many	Es sind mehr als 5 Adressen.

Was jede Einstellung bewirkt, erklärt Die Seite „Einstellungen“.

Alle Einstellungen zurücksetzen: settings reset

settings reset setzt alle Schlüssel der Tabelle oben auf ihre Vorgaben. Die Ausschlüsse und die Liste der Tabellen bleiben dabei, wie sie sind.

# Alle Einstellungen auf die Vorgaben setzen
wp cloneworx-backup settings reset

Den Umfang zeigen: scope

Der Umfang sagt, was zu Deiner Website gehört: welche Ordner, welche Tabellen der Datenbank und was ausgelassen wird. scope zeigt ihn. Der Teil hinter scope wählt, was Du siehst:

Teil	Was die Ausgabe zeigt
roots	Die Wurzeln mit ihrem Ort auf dem Server. Bei der Datenbank steht database. not found heißt: Das Plugin hat den Ort nicht gefunden. In Klammern stehen Hinweise, zum Beispiel inside für eine Wurzel, die in einer anderen liegt, oder missing für einen Ordner, den es nicht gibt.
tables	Das Präfix und die Zahl der Tabellen, dann jede Tabelle. view kennzeichnet eine View, structure only eine Tabelle, von der nur die Struktur gesichert wird. Eine Warnung nennt Tabellen einer anderen WordPress-Installation in derselben Datenbank: Diese Tabellen werden nicht gesichert.
exclusions	Die geltenden Ausschlussregeln. default in der Überschrift heißt: Es gilt die Vorgabe. stored heißt: Es gelten Deine eigenen Regeln. Darunter stehen die Ordner, die andere Plugins für ihren Cache oder ihre Protokolle festlegen, und was immer ausgeschlossen ist.
all	Alle drei Teile. Das ist die Vorgabe ohne Angabe.

# Alles zeigen
wp cloneworx-backup scope

# Nur die Wurzeln zeigen
wp cloneworx-backup scope roots

# Nur die Tabellen zeigen
wp cloneworx-backup scope tables

Die Wurzeln

Eine Wurzel ist ein benannter Teil der Website. Die Namen brauchst Du für --roots bei Backup, Backup-Plan und Restore.

Wurzel	Inhalt
db	Die Tabellen der Datenbank dieser Website.
wp-config	Die Datei wp-config.php. Das Plugin sichert die Datei, spielt sie bei einem Restore aber nie zurück.
wp-content	Alles in wp-content, das nicht zu Plugins, Themes, Must-use-Plugins oder Uploads gehört: Sprachdateien, Drop-ins, Ordner anderer Plugins.
wp-core	Der WordPress-Kern: die Ordner wp-admin und wp-includes und die Dateien, die WordPress im Wurzelordner ausliefert.
wp-mu-plugins	Der Ordner der Must-use-Plugins.
wp-plugins	Der Ordner der Plugins.
wp-themes	Der Ordner der Themes.
wp-uploads	Der Ordner der Uploads.
wp-root	Alles Übrige im Wurzelordner der Website, zum Beispiel .htaccess und robots.txt.

Ausschlussregeln setzen: scope exclusions

Ausschlussregeln gelten für die ganze Website und für jeden Backup-Plan. Was eine Regel trifft, kommt in kein Backup.

Schalter	Bedeutung	Erlaubte Werte
--set	Ersetzt die ganze Liste der Regeln durch die genannten.	Regeln, durch Komma getrennt
--reset	Stellt die Vorgabe wieder her.	ohne Wert
--force	Setzt auch als anderer Benutzer als der, dem die Ordner des Plugins gehören.	ohne Wert

--set und --reset wirken nur zusammen mit dem Teil exclusions. Eine Regel hat eine von drei Formen:

Form	Bedeutung	Beispiel
Name	Eine Datei oder ein Ordner mit genau diesem Namen, in jeder Tiefe und in jeder Wurzel. Mit einem Schrägstrich am Ende trifft die Regel nur Ordner.	.DS_Store, updraft/
Name mit Stern	Ein Name, der so beginnt oder so endet. Erlaubt ist ein Stern, am Anfang oder am Ende.	*.log, backwpup*
Pfad	Ein Pfad in einer Wurzel. Der erste Teil ist der Name der Wurzel. Die Regel trifft den Eintrag und alles darunter.	wp-content/cache

Ein Pfad beginnt mit wp-content, wp-uploads, wp-plugins, wp-themes, wp-mu-plugins, wp-core oder wp-root. Groß- und Kleinschreibung spielen keine Rolle.

# Die geltenden Regeln zeigen
wp cloneworx-backup scope exclusions

# Die Liste durch drei eigene Regeln ersetzen
wp cloneworx-backup scope exclusions --set="wp-content/cache,*.log,.DS_Store"

# Die Vorgabe wiederherstellen
wp cloneworx-backup scope exclusions --reset

Das Plugin prüft jede Regel vor dem Speichern. Ist eine Regel ungültig, speichert es nichts: Der Befehl endet mit einem Fehler und nennt jede ungültige Regel mit dem Grund. Nach dem Speichern nennt er die Zahl der Regeln und zeigt die Liste, die jetzt gilt.

Tabellen nur als Struktur sichern: scope tables

Manche Plugins führen Tabellen für Sitzungen, Protokolle, Caches oder Statistiken, die groß werden. Für solche Tabellen kannst Du festlegen, dass jedes Backup nur die Struktur sichert und die Zeilen auslässt. In der Vorgabe sichert das Plugin jede Tabelle vollständig.

Schalter	Bedeutung	Erlaubte Werte
--structure-only	Ersetzt die Liste der Tabellen, von denen nur die Struktur gesichert wird. Ein leerer Wert leert die Liste.	Namen von Tabellen ohne Präfix, durch Komma getrennt
--force	Setzt auch als anderer Benutzer als der, dem die Ordner des Plugins gehören.	ohne Wert

Der Schalter wirkt nur zusammen mit dem Teil tables.

# Zwei Tabellen nur als Struktur sichern
wp cloneworx-backup scope tables --structure-only="woocommerce_sessions,wfHits"

# Die Liste leeren: wieder jede Tabelle vollständig sichern
wp cloneworx-backup scope tables --structure-only=""

• Der Name steht ohne das Präfix der Tabellen: woocommerce_sessions, nicht wp_woocommerce_sessions.
• Erlaubt sind nur Tabellen dieser Website. Nennst Du eine Tabelle, die es nicht gibt, speichert das Plugin nichts, und der Befehl nennt die unbekannten Namen.
• Die eigenen Tabellen des Plugins stehen nicht zur Wahl: Von ihnen wird immer nur die Struktur gesichert.
• Bei einem Restore bleibt eine solche Tabelle, wie sie auf der Website ist, mit ihren Daten. Gibt es sie dort nicht, legt das Plugin sie leer an.

Nach dem Speichern nennt der Befehl die Zahl der Tabellen und zeigt die Liste aller Tabellen mit ihren Kennzeichen.

Siehe auch

• Die Seite „Einstellungen“
• Festlegen, was gesichert wird
• Benachrichtigungen per E-Mail einrichten
• Das Plugin an Deinen Server anpassen
• Das Plugin deinstallieren