{"id":5803,"date":"2021-03-24T14:19:26","date_gmt":"2021-03-24T13:19:26","guid":{"rendered":"https:\/\/pomoc.dhosting.pl\/?post_type=manual_kb&#038;p=5803"},"modified":"2026-07-22T13:43:40","modified_gmt":"2026-07-22T11:43:40","slug":"jak-dziala-i-czemu-sluzy-opcja-open_basedir","status":"publish","type":"manual_kb","link":"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/","title":{"rendered":"Jak dzia\u0142a i czemu s\u0142u\u017cy opcja open_basedir?"},"content":{"rendered":"<p><strong>open_basedir<\/strong>\u00a0ogranicza dost\u0119p skrypt\u00f3w PHP do plik\u00f3w w katalogu danej\u00a0<strong>strony WWW<\/strong>. W dPanelu ta opcja jest domy\u015blnie aktywna dla ka\u017cdej nowo dodanej strony WWW.<\/p>\n<p>Ustawienie pomaga okre\u015bli\u0107, z kt\u00f3rych katalog\u00f3w skrypt PHP mo\u017ce korzysta\u0107 podczas pracy z plikami. Ma znaczenie wtedy, gdy aplikacja, wtyczka lub w\u0142asny skrypt pr\u00f3buje odczyta\u0107 albo otworzy\u0107 plik wskazany \u015bcie\u017ck\u0105.<\/p>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_85 ez-toc-wrap-left counter-flat ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Spis tre\u015bci<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Jak_dziala_open_basedir\" >Jak dzia\u0142a open_basedir?<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Jaki_komunikat_pojawia_sie_przy_blokadzie_open_basedir\" >Jaki komunikat pojawia si\u0119 przy blokadzie open_basedir?<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Co_oznacza_open_basedir_dla_strony_WWW\" >Co oznacza open_basedir dla strony WWW?<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#open_basedir_a_katalog_strony_WWW\" >open_basedir a katalog strony WWW<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Aktywne_open_basedir_a_wylaczone_open_basedir\" >Aktywne open_basedir a wy\u0142\u0105czone open_basedir<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Jakie_sa_ryzyka_po_wylaczeniu_open_basedir\" >Jakie s\u0105 ryzyka po wy\u0142\u0105czeniu open_basedir?<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Kiedy_komunikat_open_basedir_jest_normalnym_zachowaniem\" >Kiedy komunikat open_basedir jest normalnym zachowaniem?<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Co_zrobic_gdy_strona_pokazuje_blad_open_basedir\" >Co zrobi\u0107, gdy strona pokazuje b\u0142\u0105d open_basedir?<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-dziala-i-czemu-sluzy-opcja-open_basedir\/#Podsumowanie\" >Podsumowanie<\/a><\/li><\/ul><\/nav><\/div>\n<h2><span class=\"ez-toc-section\" id=\"Jak_dziala_open_basedir\"><\/span>Jak dzia\u0142a open_basedir?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p><strong>open_basedir<\/strong>\u00a0to ustawienie PHP, kt\u00f3re ogranicza list\u0119 plik\u00f3w dost\u0119pnych dla interpretera PHP. Gdy jest aktywne, skrypt mo\u017ce odwo\u0142ywa\u0107 si\u0119 tylko do plik\u00f3w znajduj\u0105cych si\u0119 w strukturze katalogu przypisanego do danej strony WWW.<\/p>\n<p>Przed wykonaniem operacji na pliku PHP sprawdza wskazan\u0105 \u015bcie\u017ck\u0119. Dotyczy to mi\u0119dzy innymi pr\u00f3b otwarcia, odczytu lub u\u017cycia pliku przez funkcje PHP pracuj\u0105ce na \u015bcie\u017ckach.<\/p>\n<p>Przyk\u0142adem jest funkcja\u00a0<code class=\"\" data-line=\"\">fopen()<\/code>. Je\u015bli skrypt pr\u00f3buje otworzy\u0107 plik, PHP sprawdza, czy ten plik znajduje si\u0119 w dozwolonym katalogu. Je\u015bli \u015bcie\u017cka wychodzi poza struktur\u0119 danej strony WWW, polecenie nie zostanie wykonane.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Jaki_komunikat_pojawia_sie_przy_blokadzie_open_basedir\"><\/span>Jaki komunikat pojawia si\u0119 przy blokadzie open_basedir?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Gdy skrypt pr\u00f3buje uzyska\u0107 dost\u0119p do pliku poza dozwolonym katalogiem, interpreter PHP zwraca komunikat:<\/p>\n<pre class=\"wp-block-code\"><code class=\"\" data-line=\"\">Warning: open_basedir restriction in effect<\/code><\/pre>\n<p>To jest spodziewane zachowanie. Komunikat oznacza, \u017ce PHP zatrzyma\u0142o pr\u00f3b\u0119 dost\u0119pu do pliku spoza katalogu przypisanego do danej strony WWW.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Co_oznacza_open_basedir_dla_strony_WWW\"><\/span>Co oznacza open_basedir dla strony WWW?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Dla wi\u0119kszo\u015bci stron WWW aktywna opcja\u00a0<strong>open_basedir<\/strong>\u00a0nie wymaga \u017cadnych dzia\u0142a\u0144. Strona dzia\u0142a poprawnie, je\u015bli jej pliki, biblioteki i zasoby znajduj\u0105 si\u0119 w katalogu przypisanym do tej strony.<\/p>\n<p>Komunikat o ograniczeniu mo\u017ce pojawi\u0107 si\u0119 wtedy, gdy aplikacja lub wtyczka pr\u00f3buje u\u017cy\u0107 pliku z innej lokalizacji. Mo\u017ce to wynika\u0107 z konfiguracji \u015bcie\u017cek, sposobu dzia\u0142ania skryptu lub u\u017cycia \u015bcie\u017cki bezwzgl\u0119dnej prowadz\u0105cej poza katalog strony.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"open_basedir_a_katalog_strony_WWW\"><\/span>open_basedir a katalog strony WWW<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p><strong>Katalog strony WWW<\/strong>\u00a0to miejsce, w kt\u00f3rym znajduj\u0105 si\u0119 pliki danej strony. Gdy\u00a0<strong>open_basedir<\/strong>\u00a0jest aktywne, ten katalog wyznacza dozwolony obszar pracy dla operacji PHP na plikach.<\/p>\n<p>Je\u015bli skrypt odwo\u0142uje si\u0119 do pliku wewn\u0105trz katalogu strony, operacja mo\u017ce zosta\u0107 wykonana zgodnie z pozosta\u0142ymi ustawieniami PHP i uprawnieniami pliku. Je\u015bli skrypt wskazuje plik poza t\u0105 struktur\u0105, PHP blokuje operacj\u0119 i zwraca ostrze\u017cenie.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Aktywne_open_basedir_a_wylaczone_open_basedir\"><\/span>Aktywne open_basedir a wy\u0142\u0105czone open_basedir<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li><strong>Aktywne open_basedir<\/strong>\u00a0ogranicza skrypty PHP do katalogu danej strony WWW. Pomaga oddzieli\u0107 pliki jednej strony od plik\u00f3w znajduj\u0105cych si\u0119 poza jej struktur\u0105.<\/li>\n<li><strong>Wy\u0142\u0105czone open_basedir<\/strong>\u00a0usuwa to ograniczenie po stronie PHP. Skrypt mo\u017ce wtedy pr\u00f3bowa\u0107 odwo\u0142ywa\u0107 si\u0119 do plik\u00f3w poza katalogiem strony, je\u015bli pozwalaj\u0105 na to inne ustawienia i uprawnienia.<\/li>\n<\/ul>\n<p>Wy\u0142\u0105czenie\u00a0<strong>open_basedir<\/strong>\u00a0mo\u017ce by\u0107 potrzebne tylko w szczeg\u00f3lnych przypadkach, gdy aplikacja musi korzysta\u0107 z plik\u00f3w poza katalogiem strony WWW. Przed tak\u0105 zmian\u0105 warto sprawdzi\u0107, czy aplikacja nie mo\u017ce dzia\u0142a\u0107 z plikami umieszczonymi w dozwolonej strukturze katalog\u00f3w.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Jakie_sa_ryzyka_po_wylaczeniu_open_basedir\"><\/span>Jakie s\u0105 ryzyka po wy\u0142\u0105czeniu open_basedir?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Po wy\u0142\u0105czeniu\u00a0<strong>open_basedir<\/strong>\u00a0skrypt PHP nie jest ju\u017c ograniczony przez t\u0119 konkretn\u0105 regu\u0142\u0119 do katalogu danej strony WWW. Oznacza to szerszy zakres mo\u017cliwych odwo\u0142a\u0144 do plik\u00f3w.<\/p>\n<p>Najwa\u017cniejsze ryzyka to:<\/p>\n<ul>\n<li><strong>wi\u0119kszy zakres dost\u0119pu skryptu<\/strong>\u00a0&#8211; skrypt mo\u017ce pr\u00f3bowa\u0107 pracowa\u0107 na plikach spoza katalogu strony WWW,<\/li>\n<li><strong>wi\u0119ksze skutki b\u0142\u0119dnej konfiguracji<\/strong>\u00a0&#8211; nieprawid\u0142owa \u015bcie\u017cka w aplikacji mo\u017ce wskazywa\u0107 miejsce poza struktur\u0105 danej strony,<\/li>\n<li><strong>wi\u0119ksze skutki podatno\u015bci w kodzie<\/strong>\u00a0&#8211; je\u015bli aplikacja ma luk\u0119 pozwalaj\u0105c\u0105 na zmian\u0119 \u015bcie\u017cek, brak open_basedir mo\u017ce zwi\u0119kszy\u0107 zakres plik\u00f3w, do kt\u00f3rych skrypt b\u0119dzie pr\u00f3bowa\u0142 si\u0119 odwo\u0142a\u0107,<\/li>\n<li><strong>s\u0142absza separacja plik\u00f3w<\/strong>\u00a0&#8211; strony dzia\u0142aj\u0105ce w r\u00f3\u017cnych katalogach s\u0105 mniej chronione przed odwo\u0142aniami wykonywanymi przez skrypty PHP z innej lokalizacji.<\/li>\n<\/ul>\n<p>Z tego powodu wy\u0142\u0105czenie\u00a0<strong>open_basedir<\/strong>\u00a0warto traktowa\u0107 jako wyj\u0105tek, a nie domy\u015blne ustawienie. Zwykle lepiej dostosowa\u0107 \u015bcie\u017cki aplikacji lub przenie\u015b\u0107 wymagane pliki do katalogu danej strony WWW.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Kiedy_komunikat_open_basedir_jest_normalnym_zachowaniem\"><\/span>Kiedy komunikat open_basedir jest normalnym zachowaniem?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Komunikat\u00a0<code class=\"\" data-line=\"\">Warning: open_basedir restriction in effect<\/code>\u00a0jest spodziewanym zachowaniem, gdy skrypt pr\u00f3buje wyj\u015b\u0107 poza dozwolon\u0105 struktur\u0119 katalog\u00f3w. Nie oznacza awarii PHP. Oznacza, \u017ce mechanizm ograniczaj\u0105cy dost\u0119p do plik\u00f3w zadzia\u0142a\u0142.<\/p>\n<p>W takiej sytuacji warto sprawdzi\u0107:<\/p>\n<ul>\n<li>jak\u0105 \u015bcie\u017ck\u0119 do pliku wskazuje skrypt,<\/li>\n<li>czy plik znajduje si\u0119 w katalogu danej strony WWW,<\/li>\n<li>czy aplikacja lub wtyczka nie u\u017cywa \u015bcie\u017cki bezwzgl\u0119dnej prowadz\u0105cej poza katalog strony,<\/li>\n<li>czy wymagany plik mo\u017cna przenie\u015b\u0107 do dozwolonej struktury katalog\u00f3w,<\/li>\n<li>czy konfiguracja aplikacji wskazuje poprawny katalog.<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Co_zrobic_gdy_strona_pokazuje_blad_open_basedir\"><\/span>Co zrobi\u0107, gdy strona pokazuje b\u0142\u0105d open_basedir?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ol>\n<li>Sprawd\u017a pe\u0142n\u0105 tre\u015b\u0107 komunikatu b\u0142\u0119du i nazw\u0119 pliku, kt\u00f3rego dotyczy ostrze\u017cenie.<\/li>\n<li>Ustal, czy wskazana \u015bcie\u017cka znajduje si\u0119 w katalogu danej strony WWW.<\/li>\n<li>Je\u015bli \u015bcie\u017cka wychodzi poza katalog strony, popraw konfiguracj\u0119 aplikacji lub wtyczki.<\/li>\n<li>Je\u015bli aplikacja wymaga pliku z innej lokalizacji, rozwa\u017c przeniesienie tego pliku do katalogu strony WWW.<\/li>\n<li>Je\u015bli nie masz pewno\u015bci, czy zmiana jest bezpieczna, skontaktuj si\u0119 z pomoc\u0105 techniczn\u0105 przed wy\u0142\u0105czeniem ograniczenia.<\/li>\n<\/ol>\n<p>Je\u015bli problem dotyczy dzia\u0142ania konkretnej wersji PHP, pomocny mo\u017ce by\u0107 osobny artyku\u0142 o zmianie wersji PHP w dPanelu:\u00a0<a href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/zmiana-wersji-php\/\">Jak zmieni\u0107 wersj\u0119 PHP?<\/a>.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Podsumowanie\"><\/span>Podsumowanie<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p><strong>open_basedir<\/strong>\u00a0ogranicza dost\u0119p skrypt\u00f3w PHP do katalogu danej strony WWW. Dzi\u0119ki temu skrypt nie mo\u017ce swobodnie odwo\u0142ywa\u0107 si\u0119 do plik\u00f3w poza struktur\u0105 tej strony.<\/p>\n<p>Opcja jest domy\u015blnie aktywna dla ka\u017cdej nowo dodanej strony WWW w dPanelu. Jej wy\u0142\u0105czenie mo\u017ce zwi\u0119kszy\u0107 zakres dost\u0119pu skrypt\u00f3w do plik\u00f3w, dlatego warto robi\u0107 to tylko wtedy, gdy jest to potrzebne i po sprawdzeniu konfiguracji aplikacji.<\/p>\n","protected":false},"author":6,"featured_media":10957,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[95,109],"manual_kb_tag":[3517,1586,1587,1588,1589,1590,655,3516],"class_list":["post-5803","manual_kb","type-manual_kb","status-publish","format-standard","has-post-thumbnail","hentry","manualknowledgebasecat-hosting","manualknowledgebasecat-strony-www","manual_kb_tag-polski-hosting","manual_kb_tag-open_basedir","manual_kb_tag-basedir","manual_kb_tag-separacja-katalogow-stron-www","manual_kb_tag-jak-dziala-open_basedir","manual_kb_tag-czemu-sluzy-open_basedir","manual_kb_tag-hosting","manual_kb_tag-web-hosting"],"_links":{"self":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb\/5803","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/users\/6"}],"version-history":[{"count":3,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb\/5803\/revisions"}],"predecessor-version":[{"id":17013,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb\/5803\/revisions\/17013"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/media\/10957"}],"wp:attachment":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/media?parent=5803"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manualknowledgebasecat?post=5803"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb_tag?post=5803"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}