Składnia:
funkcja getenv() może być używana z argumentem lub bez. Gdy ta funkcja używa argumentów, zwraca wartość ciągu, a gdy funkcja nie używa argumentu, zwraca tablicę. Obie składnie tej funkcji są pokazane poniżej:
string getenv ( string $ nazwa_zmiennej [, bool $ tylko_lokalna = false ] )Zgodnie z powyższą składnią funkcja getenv() może przyjmować dwa argumenty. Pierwszy argument jest obowiązkowy i służy do pobrania nazwy zmiennej środowiskowej wymaganej do odczytu. Drugi argument jest opcjonalny z wartością domyślną FALSE. Gdy w drugim argumencie zostanie użyta wartość TRUE, ta funkcja zwróci tylko lokalne zmienne środowiskowe.
tablica getenv()Zgodnie z powyższą składnią funkcję getenv() można wywołać bez żadnego argumentu.
Przykład 1: Użycie zmiennej getenv() bez argumentu
Poniższy przykład pokaże listę zmiennych środowiskowych zainstalowanej wersji PHP. Utwórz plik PHP za pomocą następującego skryptu, aby uzyskać listę zmiennych środowiskowych za pomocą funkcji getenv().
Funkcja getenv() jest wywoływana bez żadnego argumentu w skrypcie, a zwrócone wartości są przechowywane w tablicy o nazwie $env_array. Wartości tej tablicy są wypisywane za pomocą przednie pętla.
//Wywołaj funkcję getenv() bez argumentu$env_array =getenv();
Echo "
Lista zmiennych środowiskowych z wartościami to:
";//Wypisz wszystkie nazwy zmiennych środowiskowych z wartościami
foreach ($env_array jako $klucz=>$wartość)
echo "$klucz => $wartość
";
?>
Wynik:
Następujące dane wyjściowe pojawią się po uruchomieniu skryptu z serwera. Pokazuje listę wszystkich zmiennych środowiskowych PHP. Ten wynik może się różnić w zależności od wersji PHP i systemu operacyjnego, w którym działa PHP.
Przykład 2: Przeczytaj określone zmienne środowiskowe
Poniższy przykład pokazuje sposób odczytywania poszczególnych wartości środowiskowych. Utwórz plik PHP za pomocą następującego skryptu.
Cztery zmienne środowiskowe są wypisywane za pomocą funkcji getenv(). "JĘZYK" jest używany w funkcji getenv() do odczytania, który język jest aktualnie ustawiony dla skryptu PHP. „LC_TIME” jest używany w funkcji getenv() do odczytywania nazwy używanego formatowania daty i czasu w PHP. „APACH_LOG_DIR” jest używany w funkcji getenv() do odczytu katalogu dziennika Apache. "ŚCIEŻKA" jest używany w funkcji getenv() do odczytywania wartości zapisanych w ścieżce.
//Wydrukuj nazwę używanego językaEcho " Język: " . getenv("JĘZYK"). "
";
//Wydrukuj nazwę używanego formatowania daty i godziny
Echo " Czas lokalny: " . getenv("LC_TIME"). "
";
//Wydrukuj nazwę katalogu dziennika serwera Apache
Echo " Katalog dziennika Apache: " . getenv("APACHE_LOG_DIR"). "
";
//Wydrukuj wartości zmiennej PATH
Echo " Wartości PATH to: " . getenv("ŚCIEŻKA");
?>
Wynik:
Następujące dane wyjściowe pojawią się po uruchomieniu skryptu z serwera. Pokazuje wartości czterech zmiennych środowiskowych.
Przykład 3: Zdefiniuj i odczytaj zmienną środowiskową
Funkcja getenv() zwraca listę wbudowanych zmiennych środowiskowych PHP. Ale jeśli programista musi utworzyć nową zmienną środowiskową do celów programowania, może to zrobić do. Funkcja putenv() może być użyta do stworzenia nowej zmiennej środowiskowej o wartości. Aby utworzyć nową zmienną środowiskową, nazwa zmiennej, znak równości (=) i wartość zmiennej są ujęte w cudzysłów, który ma być użyty jako wartość argumentu funkcji putenv(). Ale wartości żadnej wbudowanej zmiennej środowiskowej nie można zmienić za pomocą funkcji putenv().
Poniższy przykład pokazuje sposób tworzenia nowej zmiennej środowiskowej za pomocą funkcji putenv() i odczytuje nowo utworzoną zmienną środowiskową za pomocą funkcji getenv(). Utwórz plik PHP za pomocą następującego skryptu.
„REMOTE_ADDR” to wbudowana nazwa zmiennej środowiskowej z wartością drukowaną na początku skryptu. Następnie dla tej zmiennej ustawiana jest nowa wartość i ponownie drukowana. Zostanie utworzona nowa zmienna środowiskowa o nazwie „MY_ENV_VAR” z wartością i wydrukowana później.
// Wydrukuj bieżącą wartość REMOTE_ADDREcho " Aktualny adres zdalny to: " . getenv("REMOTE_ADDR"). "
";
// Spróbuj zmienić wbudowaną zmienną REMOTE_ADDR
putenv("ZDALNY_ADDR=serwer lokalny");
// Wydrukuj wartość REMOTE_ADDR po użyciu putenv()
Echo " Adres zdalny po zmianie to: " . getenv("REMOTE_ADDR"). "
";
// Zdefiniuj niestandardową zmienną środowiskową
putenv("MY_ENV_VAR=TestSrver");
// Wydrukuj niestandardową zmienną środowiskową
Echo "Wartość MY_ENV_VAR to: " . getenv("MY_ENV_VAR");
?>
Wynik:
Następujące dane wyjściowe pojawią się po uruchomieniu skryptu z serwera. Pokazuje, że domyślną wartością „REMOTE_ADDR” jest 127.0.0.1. Kiedy wartość tej zmiennej środowiskowej zostanie zmieniona i ponownie wydrukowana, pokaże swoją poprzednią wartość. Oznacza to, że nie można zmienić wartości wbudowanych zmiennych. Nowo utworzona zmienna środowiskowa jest tutaj poprawnie wypisywana.
Wniosek
Sposoby odczytywania wbudowanych zmiennych środowiskowych i tworzenia nowej zmiennej środowiskowej są pokazane w tym samouczku na różnych przykładach. Istnieje zmienna superglobalna o nazwie $_ENV, której można również użyć do odczytania zmiennej środowiskowej PHP. Pojęcie zmiennychśrodowiskowych w PHP zostanie wyczyszczone po przeczytaniu tego samouczka, a programiści PHP będą mogli używać tych zmiennych w swoich skryptach.