Jak naprawić błąd open_basedir restriction

Utworzenie środowiska staging dla witryny WordPress pozwala testować zmiany, aktualizacje i nowe funkcje bez ryzyka dla stabilności żywej witryny. WP Staging to popularny plugin, który to ułatwia, pozwalając użytkownikom utworzyć witrynę staging w podkatalogu instalacji WordPress.

Podczas tego procesu możesz napotkać błąd open_basedir restriction, który uniemożliwia utworzenie witryny staging w katalogu głównym WordPress. Ten błąd jest związany z dyrektywą bezpieczeństwa w konfiguracji PHP, ograniczającą pliki, do których PHP ma dostęp, do konkretnego katalogu i jego podkatalogów. Ten artykuł przeprowadzi cię przez kroki rozwiązania tego problemu i pomyślnego utworzenia witryny staging.

Uwaga: Jeśli próbujesz utworzyć witrynę staging z WP Staging Pro i otrzymujesz ten błąd przy próbie utworzenia domyślnej witryny staging, możesz użyć zaawansowanego ustawienia, aby utworzyć witrynę staging w podfolderze „wp-content”. Wtedy możesz przestać tu czytać.

Zrozumienie open_basedir restriction

Dyrektywa open_basedir to środek bezpieczeństwa implementowany w pliku php.ini, który ogranicza dostęp PHP do plików tylko do określonych katalogów. Kiedy WP Staging próbuje utworzyć witrynę staging w katalogu nie ujętym w ścieżce open_basedir, wywołuje to błąd restriction.

Jak naprawić błąd open_basedir restriction

Aby rozwiązać błąd open_basedir restriction i pomyślnie utworzyć witrynę staging z WP Staging, postępuj zgodnie z tymi krokami:

Krok 1: Znajdź plik php.ini

Plik php.ini to plik konfiguracyjny PHP. Jego lokalizacja może się różnić w zależności od środowiska Hostingu. Typowe lokalizacje to katalog główny konta Hostingu lub konkretny katalog dla wersji PHP. Możesz musieć skonsultować dokumentację dostawcy Hostingu lub wsparcie, aby znaleźć dokładną lokalizację.

Krok 2: Zmodyfikuj dyrektywę open_basedir

Po zlokalizowaniu pliku php.ini musisz go zedytować, by uwzględnić katalog, w którym chcesz utworzyć witrynę staging. Otwórz plik php.ini w edytorze tekstu i znajdź linię zaczynającą się od open_basedir. Dodaj pełną ścieżkę do katalogu głównego WordPress (i jego podkatalogów) do istniejącej listy. Wiele ścieżek rozdzielaj dwukropkiem : w Linux lub średnikiem ; w Windows.

Na przykład, jeśli twój WordPress jest zainstalowany w /var/www/html/wordpress, a linia konfiguracji open_basedir w php.ini obecnie brzmi:

ShellScript
open_basedir = "/var/www/html/"

Musisz ją zmodyfikować, by uwzględnić katalog WordPress:

ShellScript
open_basedir = "/var/www/html/:/var/www/html/wordpress/"

Krok 3: Zrestartuj serwer webowy

Po zapisaniu zmian w pliku php.ini musisz zrestartować serwer webowy, aby zmiany weszły w życie. Proces restartu serwera różni się w zależności od środowiska Hostingu i używanego oprogramowania serwera. Częste serwery webowe to Apache i Nginx. Użyj panelu kontrolnego Hostingu lub skonsultuj dokumentację dostawcy Hostingu, by uzyskać wskazówki, jak zrestartować serwer.

Krok 4: Spróbuj ponownie utworzyć witrynę staging

Po zrestartowaniu serwera webowego spróbuj ponownie utworzyć witrynę staging z WP Staging. Błąd open_basedir restriction powinien teraz zostać rozwiązany, a proces tworzenia powinien przebiec bez problemu.

Podsumowanie

Restrykcja open_basedir to funkcja bezpieczeństwa, która – choć ważna – czasami może zakłócać legalne operacje, takie jak tworzenie środowiska staging dla witryny WordPress. Starannie modyfikując plik php.ini i upewniając się, że serwer webowy rozpoznaje te zmiany, możesz pokonać tę przeszkodę. Zawsze wykonuj Backup pliku php.ini przed wprowadzeniem zmian i skonsultuj się z dostawcą Hostingu, jeśli nie masz pewności co do samodzielnego wprowadzania tych modyfikacji. To podejście nie tylko rozwiązuje natychmiastowy problem, ale też zachowuje integralność bezpieczeństwa środowiska serwera.

Updated on 23 maja, 2026

Rene Hermenau

Autor: Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.