Wenn du mit dem kostenlosen WP STAGING Plugin eine Staging-Seite erstellst, kann PHP den Vorgang mit einem open_basedir-Einschränkungsfehler abbrechen. Die Meldung bedeutet, dass PHP so konfiguriert ist, dass es nur innerhalb einer festen Liste von Verzeichnissen lesen und schreiben darf, und der Ordner, in dem WP STAGING die Staging-Kopie erstellen möchte, steht nicht auf dieser Liste. Die Lösung besteht darin, dein WordPress-Verzeichnis zur open_basedir-Zeile in deiner php.ini-Datei (oder den PHP-Einstellungen deines Hosters) hinzuzufügen und PHP neu zu starten. Diese Anleitung zeigt dir, wie du die Datei findest, die PHP tatsächlich lädt, sie sicher bearbeitest und was du prüfen solltest, wenn der Fehler nicht verschwindet.
Contents
Hinweis: Wenn du versuchst, eine Staging-Seite mit WP Staging Pro zu erstellen und diesen Fehler bei der Erstellung einer Standard-Staging-Seite erhältst, kannst du die erweiterten Einstellungen verwenden, um die Staging-Seite in einem Unterordner von ‘wp-content’ zu erstellen. Dann kannst du hier aufhören zu lesen.
Wie der open_basedir-Einschränkungsfehler aussieht
open_basedir ist eine PHP-Sicherheitseinstellung, die den Dateizugriff auf eine genehmigte Liste von Verzeichnissen beschränkt. Wenn ein Skript, einschließlich WP STAGING, versucht, auf einen Pfad außerhalb dieser Liste zuzugreifen, verweigert PHP dies und protokolliert eine Warnung. In deinem Server- oder WordPress-Debug-Log liest sie sich typischerweise etwa so:
Warning: open_basedir restriction in effect.
File(/var/www/html/staging) is not within the allowed path(s):
(/var/www/html/) in /var/www/html/... on line ...Möglicherweise gelangst du auch über eine WP STAGING-Meldung auf diese Seite, die erwähnt, dass eine Bootstrap-Datei nicht eingebunden werden konnte, und open_basedir als mögliche Ursache nennt. Beide weisen auf dasselbe Grundproblem hin: Das Verzeichnis, das WP STAGING benötigt, liegt außerhalb der erlaubten Pfade. Der genaue Dateipfad in deiner Meldung sagt dir, welches Verzeichnis zur erlaubten Liste hinzugefügt werden muss.
Warum open_basedir WP STAGING blockiert
Die open_basedir-Direktive wird in der php.ini-Datei festgelegt und beschränkt den Dateizugriff von PHP auf die von dir angegebenen Verzeichnisse. Standardmäßig erstellt WP STAGING die Staging-Seite in einem Unterverzeichnis deines WordPress-Stammverzeichnisses. Wenn dieses Stammverzeichnis oder das Unterverzeichnis, in das geschrieben werden soll, nicht von open_basedir abgedeckt ist, blockiert PHP den Schreibvorgang und die Staging-Seite kann nicht erstellt werden. Wenn du das WordPress-Verzeichnis zur erlaubten Liste hinzufügst, wird die Blockade aufgehoben, ohne die Sicherheitseinstellung abzuschalten.
So behebst du den open_basedir-Einschränkungsfehler
Um den open_basedir-Einschränkungsfehler zu beheben und erfolgreich eine Staging-Seite mit WP STAGING zu erstellen, folge diesen Schritten der Reihe nach:
Schritt 1: Die php.ini-Datei finden, die PHP tatsächlich lädt
Die php.ini-Datei ist die Konfigurationsdatei von PHP, und ihr Speicherort variiert je nach Hosting-Umgebung. Ein Server kann mehr als eine php.ini haben, weshalb das Bearbeiten der falschen Datei der häufigste Grund dafür ist, dass eine Korrektur scheinbar nichts bewirkt. Um die Datei zu finden, die wirklich aktiv ist, erstelle in deinem WordPress-Stammverzeichnis eine kleine Datei namens phpinfo.php mit diesem Inhalt, öffne sie in deinem Browser und lies den Wert von Loaded Configuration File:
<?php phpinfo(); ?>Wenn du Shell-Zugriff hast, gibt php --ini denselben Pfad auf der Kommandozeile aus. Lösche die phpinfo.php-Datei, sobald du den Pfad hast, da sie Serverdetails preisgibt. Wenn du php.ini überhaupt nicht finden oder bearbeiten kannst, springe weiter unten zum Abschnitt über Hoster ohne direkten php.ini-Zugriff.
Schritt 2: Die open_basedir-Direktive ändern
Sobald du die php.ini-Datei gefunden hast, musst du sie bearbeiten, um das Verzeichnis einzuschließen, in dem du deine Staging-Seite erstellen möchtest. Öffne die php.ini-Datei in einem Texteditor und finde die Zeile, die mit open_basedir beginnt. Füge den vollständigen Pfad zu deinem WordPress-Stammverzeichnis (und seinen Unterverzeichnissen) zur bestehenden Liste hinzu. Trenne mehrere Pfade mit einem Doppelpunkt : unter Linux oder einem Semikolon ; unter Windows.
Wenn dein WordPress beispielsweise in /var/www/html/wordpress installiert ist und die open_basedir-Konfigurationszeile in php.ini derzeit lautet:
open_basedir = "/var/www/html/"Musst du sie so ändern, dass das WordPress-Verzeichnis eingeschlossen ist:
open_basedir = "/var/www/html/:/var/www/html/wordpress/"Behalte die Pfade bei, die bereits vorhanden waren. Einen bestehenden Pfad zu entfernen, um Platz zu schaffen, kann andere Teile deiner Seite beschädigen, die davon abhängen.
Schritt 3: Webserver oder PHP-FPM neu starten
Nachdem du die Änderungen an deiner php.ini-Datei gespeichert hast, musst du PHP neu starten, damit die Änderungen wirksam werden. Wenn deine Seite PHP über das integrierte Modul von Apache ausführt, genügt ein Neustart von Apache. Wenn sie mit PHP-FPM läuft (üblich bei Nginx und vielen Managed-Hostern), musst du auch den PHP-FPM-Dienst neu starten, nicht nur den Webserver, sonst bleibt die alte Konfiguration im Speicher. Verwende dein Hosting-Kontrollpanel oder die Dokumentation deines Hosters für den genauen Neustart-Befehl.
Schritt 4: Staging-Seite erneut erstellen
Sobald PHP neu gestartet wurde, versuche erneut, deine Staging-Seite mit WP STAGING zu erstellen. Der open_basedir-Einschränkungsfehler sollte nun behoben sein und der Erstellungsprozess problemlos ablaufen. Um zu bestätigen, dass die neue Einstellung aktiv ist, lade die phpinfo()-Seite aus Schritt 1 neu und prüfe, dass der open_basedir-Wert nun dein WordPress-Verzeichnis enthält.
Wenn du php.ini nicht direkt bearbeiten kannst
Bei Shared- und Managed-Hosting hast du oft keinen direkten Zugriff auf php.ini. Suche in diesem Fall in deinem Hosting-Kontrollpanel nach einem Bereich für PHP-Einstellungen (zum Beispiel einem „MultiPHP INI Editor" oder einem „Select PHP Version"-Bildschirm in cPanel) und lege open_basedir dort fest, oder bitte deinen Hoster, deinen WordPress-Pfad für dich zur erlaubten Liste hinzuzufügen. Wenn du die Servereinstellungen lieber gar nicht anfassen möchtest, kann WP STAGING die Staging-Seite in einem Ordner erstellen, der bereits beschreibbar ist, wie der Hinweis am Anfang dieses Artikels erklärt.
Wenn der open_basedir-Fehler weiterhin auftritt
Wenn der Fehler nach dem Bearbeiten der php.ini und dem Neustart von PHP weiterhin besteht, arbeite diese häufigen Ursachen durch:
- Du hast eine
php.inibearbeitet, die PHP nicht lädt. Überprüfe erneutLoaded Configuration Fileaus Schritt 1 und bearbeite genau diese Datei. - Du hast den Webserver neu gestartet, aber nicht PHP-FPM. Starte auch den PHP-FPM-Dienst neu.
- Das Pfadtrennzeichen ist falsch. Verwende unter Linux einen Doppelpunkt und unter Windows ein Semikolon, und lass kein abschließendes Trennzeichen mit einem leeren Eintrag stehen.
- Dein Hoster erzwingt
open_basedirzentral und ignoriert deine Änderungen. Kontaktiere den Support und bitte darum, den Pfad hinzuzufügen. - Als Abkürzung kannst du die erweiterte WP STAGING-Einstellung verwenden, um die Staging-Seite in einem Unterordner von
wp-contentzu erstellen, der bereits beschreibbar ist.
Fazit
Die open_basedir-Einschränkung ist eine Sicherheitsfunktion, die zwar wichtig ist, aber manchmal mit legitimen Vorgängen wie der Erstellung einer Staging-Umgebung für deine WordPress-Seite in Konflikt geraten kann. Indem du die php.ini-Datei bearbeitest, die PHP tatsächlich lädt, dein WordPress-Verzeichnis zur erlaubten Liste hinzufügst und PHP neu startest, kannst du den Fehler beheben, ohne die Sicherheit deines Servers zu schwächen. Erstelle immer ein Backup deiner php.ini-Datei, bevor du Änderungen vornimmst, und wende dich an deinen Hosting-Anbieter, wenn du unsicher bist, ob du sie selbst bearbeiten solltest.
