Sintassi:
La funzione getenv() può essere utilizzata con o senza argomento. Quando questa funzione utilizza gli argomenti, restituisce il valore stringa e quando la funzione non utilizza argomenti, restituisce un array. Entrambe le sintassi di questa funzione sono mostrate di seguito:
string getenv ( string $varname [, bool $local_only = false ])Secondo la sintassi sopra, la funzione getenv() può prendere due argomenti. Il primo argomento è obbligatorio e viene utilizzato per prendere il nome della variabile d'ambiente richiesta per la lettura. Il secondo argomento è facoltativo con un valore predefinito di FALSE. Quando viene utilizzato TRUE nel secondo argomento, questa funzione restituirà solo le variabili di ambiente locali.
array getenv()Secondo la sintassi sopra, la funzione getenv() può essere chiamata senza alcun argomento.
Esempio 1: utilizzo della variabile getenv() senza argomento
L'esempio seguente mostrerà l'elenco delle variabili di ambiente della versione installata di PHP. Crea un file PHP con il seguente script per ottenere l'elenco delle variabili di ambiente utilizzando la funzione getenv().
La funzione getenv() viene chiamata senza alcun argomento nello script e i valori restituiti vengono memorizzati in un array denominato $env_array. I valori di questo array sono stampati usando il foreach ciclo continuo.
//Chiama la funzione getenv() senza argomenti$env_array =getnv();
eco "
L'elenco delle variabili di ambiente con i valori è:
";//Stampa tutti i nomi delle variabili d'ambiente con i valori
foreach ($env_array come $chiave=>$valore)
echo "$chiave => $valore
";
?>
Produzione:
Il seguente output apparirà dopo aver eseguito lo script dal server. Mostra l'elenco di tutte le variabili d'ambiente del PHP. Questo output può variare in base alla versione PHP e al sistema operativo, in cui PHP è in esecuzione.
Esempio 2: leggere le variabili di ambiente specifiche
L'esempio seguente mostra il modo di leggere i particolari valori dell'ambiente. Crea un file PHP con il seguente script.
Le quattro variabili d'ambiente vengono stampate usando la funzione getenv(). "LINGUAGGIO" è usato nella funzione getenv() per leggere quale lingua è attualmente impostata per lo script PHP. “LC_TIME” viene utilizzato nella funzione getenv() per leggere il nome di formattazione di data e ora utilizzato in PHP. “APACHE_LOG_DIR” è usato nella funzione getenv() per leggere la directory di log di Apache. "SENTIERO" viene utilizzato nella funzione getenv() per leggere i valori memorizzati nel percorso.
//Stampa il nome della lingua usataeco " Linguaggio: " . getenv("LINGUA"). "
";
//Stampa il nome della formattazione della data e dell'ora usati
eco " Ora locale: " . getenv("LC_TIME"). "
";
//Stampa il nome della directory di log del server apache
eco " Directory di registro di Apache: " . getenv("APACHE_LOG_DIR"). "
";
//Stampa i valori della variabile PATH
eco " I valori di PATH sono: " . getenv("PERCORSO");
?>
Produzione:
Il seguente output apparirà dopo aver eseguito lo script dal server. Mostra i valori delle quattro variabili d'ambiente.
Esempio 3: definire e leggere la variabile di ambiente
La funzione getenv() restituisce l'elenco delle variabili di ambiente integrate del PHP. Ma se il programmatore ha bisogno di creare una nuova variabile d'ambiente per scopi di programmazione, può farlo. La funzione putenv() può essere utilizzata per creare una nuova variabile d'ambiente con un valore. Per creare una nuova variabile di ambiente, il nome della variabile, il segno di uguale (=) e il valore della variabile sono racchiusi tra virgolette da utilizzare come valore dell'argomento della funzione putenv(). Ma il valore di qualsiasi variabile di ambiente incorporata non può essere modificato utilizzando la funzione putenv().
L'esempio seguente mostra come creare una nuova variabile d'ambiente usando la funzione putenv() e legge la variabile d'ambiente appena creata usando la funzione getenv(). Crea un file PHP con il seguente script.
"REMOTE_ADDR" è un nome di variabile di ambiente integrato con un valore che viene stampato all'inizio dello script. Successivamente, viene impostato un nuovo valore per questa variabile e stampato di nuovo. Viene creata una nuova variabile di ambiente denominata "MY_ENV_VAR" con un valore e stampata successivamente.
// Stampa il valore corrente di REMOTE_ADDReco " L'attuale indirizzo remoto è: " . getenv("REMOTE_ADDR"). "
";
// Prova a cambiare la variabile REMOTE_ADDR incorporata
putenv("REMOTE_ADDR=serverlocale");
// Stampa il valore di REMOTE_ADDR dopo aver usato putenv()
eco " L'indirizzo remoto dopo la modifica è: " . getenv("REMOTE_ADDR"). "
";
// Definisce una variabile d'ambiente personalizzata
putenv("MY_ENV_VAR=TestSrver");
// Stampa la variabile d'ambiente personalizzata
eco "Il valore di MY_ENV_VAR è: " . getenv("MY_ENV_VAR");
?>
Produzione:
Il seguente output apparirà dopo aver eseguito lo script dal server. Mostra che il valore predefinito di "REMOTE_ADDR" è 127.0.0.1. Quando il valore di questa variabile d'ambiente viene modificato e ristampato, mostrerà il suo valore precedente. Ciò significa che il valore delle variabili integrate non può essere modificato. La variabile d'ambiente appena creata viene stampata correttamente qui.
Conclusione
I modi di leggere le variabili d'ambiente integrate e creare una nuova variabile d'ambiente sono mostrati in questo tutorial usando diversi esempi. Esiste una variabile superglobale denominata $_ENV che può essere utilizzata anche per leggere la variabile d'ambiente di PHP. Il concetto di variabili d'ambiente in PHP verrà chiarito dopo aver letto questo tutorial e i programmatori PHP saranno in grado di utilizzare queste variabili nei loro script.