Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- werkzeuge:wp-cli:start [11.08.2026 00:09] – [PATH-Einträge] admin
+++ werkzeuge:wp-cli:start [29.09.2026 05:57] (aktuell) – admin
@@ Zeile 1: / Zeile 1: @@
-<WRAP rww-subpage-header>
+<WRAP rww-page-header>
+<WRAP rww-page-header-main>
-<WRAP rww-subpage-heading>
+<WRAP rww-page-title>
 ====== WP-CLI ======
 </WRAP>
-<WRAP rww-back>
+<WRAP rww-page-icon>
-[[werkzeuge:start|←]] [[werkzeuge:start|Werkzeuge]]
+<iconify mdi:wordpress>
+</WRAP>
 </WRAP>
+<WRAP rww-page-back>
+[[werkzeuge:start|← Werkzeuge]] · [[:start|Startseite]]
+</WRAP>
 </WRAP>
+----
 ===== Was ist WP-CLI? =====
 WP-CLI ist eine Möglichkeit, WordPress über die Kommandozeile zu bedienen.
@@ Zeile 19: / Zeile 26: @@
 Für mich ist WP-CLI noch Neuland. Bis vor Kurzem hatte ich davon noch nie gehört. Diese Seite dokumentiert deshalb nicht nur Befehle, sondern auch meinen praktischen Einstieg und die Dinge, die ich dabei lerne.
 ===== Warum beschäftige ich mich damit? =====
 Auf WP-CLI bin ich im Zusammenhang mit meinen WordPress-Projekten gestoßen.
@@ Zeile 27: / Zeile 36: @@
 Mein Ziel ist nicht, möglichst viele WP-CLI-Befehle auswendig zu lernen. Ich möchte verstehen, welche Befehle mir bei meiner praktischen Arbeit wirklich helfen – und genau diese hier dokumentieren.
 ===== Wie funktioniert WP-CLI grundsätzlich? =====
 WP-CLI arbeitet über die Kommandozeile. Ich öffne ein Terminal, wechsle in das Verzeichnis meiner WordPress-Installation und gebe dort einen WP-CLI-Befehl ein.
@@ Zeile 47: / Zeile 58: @@
 ===== Meine Umgebung =====
 WP-CLI verwende ich derzeit hauptsächlich in meiner lokalen WordPress-Entwicklungsumgebung unter Windows.
@@ Zeile 69: / Zeile 81: @@
 Anschließend kann ich dort die WP-CLI-Befehle für diese WordPress-Installation ausführen.
 ===== Installation und Einrichtung =====
-==== Meine Installation unter Windows ====
-Meine funktionierende WP-CLI-Installation liegt in einem eigenen Ordner innerhalb meiner XAMPP-Installation:
+WP-CLI muss auf dem Rechner installiert und so eingerichtet sein, dass der Befehl ''wp'' im Terminal aufgerufen werden kann.
-<code>
+In diesem Abschnitt dokumentiere ich meine eigene Installation unter Windows – einschließlich der notwendigen Pfade und Einstellungen.
-E:\xampp\wp-cli\
-</code>
-Dort befinden sich die beiden Dateien:
+Wichtig ist mir dabei nicht nur, **was** eingerichtet werden muss, sondern auch **warum**. So kann ich die Einrichtung später nachvollziehen oder auf einem anderen Rechner wiederholen.
-<code>
+==== Meine Installation unter Windows ====
-wp-cli.phar
-wp.bat
-</code>
 Installierte WP-CLI-Version:
@@ Zeile 197: / Zeile 204: @@
 Damit ist bestätigt, dass Windows die Datei ''wp.bat'' findet und WP-CLI über PHP erfolgreich ausgeführt werden kann.
-----
+==== Praxis-Hinweis ====
-WP-CLI muss auf dem Rechner installiert und so eingerichtet sein, dass der Befehl ''wp'' im Terminal aufgerufen werden kann.
-In diesem Abschnitt dokumentiere ich meine eigene Installation unter Windows – einschließlich der notwendigen Pfade und Einstellungen.
+WP-CLI kann zwar grundsätzlich von überall im Terminal aufgerufen werden, viele WordPress-bezogene Befehle müssen jedoch im Stammverzeichnis der jeweiligen WordPress-Installation ausgeführt werden.
+Beispiel:
+<code>
+cd E:\xampp\htdocs\thecruiserblog
+</code>
+Erst dort weiß WP-CLI eindeutig, mit welcher WordPress-Installation gearbeitet werden soll.
+----
-Wichtig ist mir dabei nicht nur, **was** eingerichtet werden muss, sondern auch **warum**. So kann ich die Einrichtung später nachvollziehen oder auf einem anderen Rechner wiederholen.
 ===== Meine ersten Befehle =====
+Meine ersten WP-CLI-Befehle sollen vor allem dabei helfen, mich mit der Arbeitsweise vertraut zu machen.
+Ich beginne deshalb mit einfachen Befehlen, die Informationen anzeigen und möglichst noch nichts an der WordPress-Installation verändern.
+So kann ich ausprobieren, wie WP-CLI reagiert, wie die Ausgabe im Terminal aussieht und wie ein Befehl grundsätzlich aufgebaut ist.
+==== Wie ist ein WP-CLI-Befehl aufgebaut? ====
+Ein WP-CLI-Befehl beginnt grundsätzlich mit:
+<code>
+wp
+</code>
+Danach folgt der Bereich, mit dem ich arbeiten möchte, und anschließend die gewünschte Aktion.
+Beispiel:
+<code>
+wp core version
+</code>
+Dabei bedeutet:
+  * ''wp'' → WP-CLI aufrufen
+  * ''core'' → mit dem WordPress-Core arbeiten
+  * ''version'' → die installierte Version anzeigen
+Vereinfacht kann ich mir den Aufbau so merken:
+<code>
+wp [Bereich] [Aktion]
+</code>
+Je nach Befehl können anschließend weitere Angaben und Optionen folgen.
 ==== WordPress-Version anzeigen ====
@@ Zeile 240: / Zeile 292: @@
 Der Befehl verändert nichts an der Installation. Er ist für mich besonders praktisch, um schnell zu kontrollieren, mit welcher WordPress-Installation ich gerade arbeite.
-----
+===== Befehle, die ich tatsächlich nutze =====
-Meine ersten WP-CLI-Befehle sollen vor allem dabei helfen, mich mit der Arbeitsweise vertraut zu machen.
+==== search-replace ====
-Ich beginne deshalb mit einfachen Befehlen, die Informationen anzeigen und möglichst noch nichts an der WordPress-Installation verändern.
+Mit ''wp search-replace'' kann ich Zeichenfolgen direkt in der WordPress-Datenbank suchen und ersetzen.
+Typischer Anwendungsfall bei einer lokalen Kopie einer WordPress-Seite:
+<code>
+wp search-replace "ALTE-ADRESSE" "NEUE-ADRESSE" --dry-run
+</code>
+Mit ''--dry-run'' wird zunächst nur geprüft, welche Änderungen durchgeführt würden. Die Datenbank wird dabei noch nicht verändert.
+Das ist für mich der wichtigste erste Schritt, bevor ich einen echten Such- und Ersetzlauf ausführe.
+=== Testlauf ===
+Vor einer tatsächlichen Änderung prüfe ich den Befehl zunächst mit ''--dry-run'':
+<code>
+wp search-replace "ALTE-ADRESSE" "NEUE-ADRESSE" --dry-run
+</code>
+Dabei zeigt WP-CLI an, welche Ersetzungen vorgenommen würden, ohne die Datenbank zu verändern.
+=== Tatsächliche Ersetzung ===
+Erst wenn der Testlauf plausibel aussieht, entferne ich ''--dry-run'':
+<code>
+wp search-replace "ALTE-ADRESSE" "NEUE-ADRESSE"
+</code>
+Dann werden die gefundenen Werte tatsächlich in der Datenbank ersetzt.
+=== Mein Anwendungsfall ===
+Ich habe ''wp search-replace'' beim Aufbau meiner lokalen WordPress-Entwicklungsumgebung verwendet.
+Nach dem Import einer bestehenden WordPress-Installation enthielt die Datenbank noch Verweise auf die bisherige Website-Adresse.
+Mit ''search-replace'' konnte ich diese Verweise auf die Adresse meiner lokalen Installation umstellen.
+Dabei ist ''--dry-run'' besonders wichtig: Zuerst kontrolliere ich, welche Einträge betroffen wären. Erst danach führe ich die tatsächliche Ersetzung aus.
-So kann ich ausprobieren, wie WP-CLI reagiert, wie die Ausgabe im Terminal aussieht und wie ein Befehl grundsätzlich aufgebaut ist.
-===== Befehle, die ich tatsächlich nutze =====
 Dieser Bereich wächst mit meiner praktischen Arbeit.
@@ Zeile 261: / Zeile 351: @@
 So entsteht nach und nach meine persönliche WP-CLI-Kurzreferenz – statt einer langen Liste von Befehlen, die ich vielleicht nie brauche.
 ===== Probleme & Lösungen =====
-WP-CLI funktioniert nicht immer auf Anhieb. Gerade bei der Einrichtung oder bei Befehlen, die auf weitere Programme zugreifen, können Probleme auftreten.
-Hier dokumentiere ich Fehler und Stolpersteine, die mir selbst begegnet sind.
+==== Deprecated-Hinweise beim Aufruf von WP-CLI ====
-Für jeden Fall möchte ich möglichst festhalten:
+=== Was ist passiert? ===
-  * Was wollte ich machen?
+Beim Aufruf eines WP-CLI-Befehls wurden vor der eigentlichen Ausgabe mehrere Hinweise angezeigt:
-  * Was ist passiert?
-  * Welche Fehlermeldung wurde angezeigt?
-  * Was war die Ursache?
-  * Wie habe ich das Problem gelöst?
-So entsteht mit der Zeit eine persönliche Fehlersammlung, in der ich bei einem ähnlichen Problem schnell nachschauen kann.
+<code>
+Deprecated: Using ${var} in strings is deprecated, use {$var} instead
+</code>
+Die Meldungen verweisen auf Dateien im Bereich:
+<code>
+wp-content\uploads\visualcomposer-assets\addons\themeEditor\
+</code>
+Der eigentliche WP-CLI-Befehl wurde anschließend trotzdem ausgeführt.
+=== Ursache ===
+Die Warnung wird nicht von WP-CLI selbst erzeugt.
+Sie stammt aus einer PHP-Datei des Visual-Composer-/Theme-Editor-Bereichs:
+<code>
+wp-content\uploads\visualcomposer-assets\addons\themeEditor\themeEditor\LayoutController.php
+</code>
+Dort werden Variablen innerhalb eines Heredoc-Strings in der veralteten Schreibweise
+<code>
+${sidebarWidth}
+${contentWidth}
+</code>
+verwendet.
+Die aktuelle PHP-Version meldet diese Schreibweise als veraltet.
+Die empfohlene Schreibweise lautet:
+<code>
+{$sidebarWidth}
+{$contentWidth}
+</code>
+Die Warnung verhindert die Ausführung von WP-CLI nicht. Der eigentliche Befehl wird anschließend weiterhin korrekt ausgeführt.
+=== Lösung / Umgang ===
+Aktuell ist keine direkte Änderung notwendig.
+Die Meldung ist eine ''Deprecated''-Warnung. Sie weist darauf hin, dass eine ältere PHP-Schreibweise verwendet wird, verhindert die Ausführung des eigentlichen WP-CLI-Befehls aber nicht.
+Da die betroffene Datei unter
+<code>
+wp-content\uploads\visualcomposer-assets\
+</code>
+liegt, ändere ich sie vorerst nicht manuell.
+Der Bereich wirkt wie generierter bzw. von Visual Composer bereitgestellter Code. Eine manuelle Änderung könnte bei einem späteren Update oder Neuaufbau wieder überschrieben werden.
+Mein aktueller Umgang damit:
+  * Warnung zur Kenntnis nehmen
+  * eigentliche WP-CLI-Ausgabe kontrollieren
+  * keine manuelle Änderung am generierten Code
+  * bei einem späteren Update prüfen, ob die Warnung verschwindet
+<WRAP rww-to-top>
+[[#wp-cli|↑]]
+</WRAP>